Technical documentation for implementation of MojeID

Edition: 3.1

• Legal Notice

Tree of Content

• 1. Introduction
• 2. Terminology
• 3. Getting started with MojeID
  • 3.1. Basics of MojeID
  • 3.2. MojeID Identity
  • 3.3. Communication with MojeID
    • 3.3.1. Communication via OpenID Connect
  • 3.4. Favicon
    • 3.4.1. Settings in OpenID Connect
    • 3.4.2. Settings for SAML
  • 3.5. Pairing MojeID with NIA
• 4. MojeID Support Implementation
  • 4.1. Implementation via OpenID Connect (OIDC)
    • 4.1.1. Overview of Libraries and Modules
    • 4.1.2. Implementation Process Overview
    • 4.1.3. Client Registration
    • 4.1.4. Requesting Login via MojeID
    • 4.1.5. Initiation
    • 4.1.6. Requesting Identity Authentication
    • 4.1.7. Performing Authentication
    • 4.1.8. Response to Authentication
    • 4.1.9. Requesting Token
    • 4.1.10. Requesting Data
    • 4.1.11. MojeID LITE Library
    • 4.1.12. Identity verification request with a NIA-paired account
  • 4.2. Implementation via SAML
    • 4.2.1. Identity verification request with a NIA-paired account
  • 4.3. Problems with Implementation
    • 4.3.1. Differences Between the Protocols
    • 4.3.2. Transition to a Different Protocol
    • 4.3.3. Adjusting Communication with MojeID Server
• 5. Interface for Creating MojeID Accounts
  • 5.1. Requesting Creation of a MojeID Account
  • 5.2. Checking Data Validity
  • 5.3. Completing Registration
• 6. Logging out of MojeID
• 7. MojeID Test Instance
  • 7.1. Test Accounts
  • 7.2. Mutual Endpoints
  • 7.3. OpenID Connect
  • 7.4. SAML
• 8. Appendices
  • 8.1. Appendix 1 – List of Data to be Handed Over (OpenID Connect)
  • 8.2. Appendix 3 – List of Data to be Handed Over (SAML)
  • 8.3. Appendix 4 – List of Data to be Handed Over (SAML specs.nic.cz)
  • 8.4. Appendix 5 – List of Data for Registration
  • 8.5. Appendix 6 – Examples and Solution of Error Messages
    • 8.5.1. Error Messages on Test Instance
    • 8.5.2. Problems Verifying the Return Address
    • 8.5.3. Problems with Unencrypted Connection
    • 8.5.4. Selecting Required Logging Method
    • 8.5.5. Problems with Library for PHP
    • 8.5.6. Error Messages in JSON (OIDC)
  • 8.6. Appendix 7 – Correct Implementation Procedure
• 9. Record of Changes