Skip to main content

Set up in the Dashboard

On this page, you can find instructions for configuring and adding mojeID to your Signicat account.

Before you begin​

  1. Make sure you have completed the initial preparations.
  2. Sign up to the Signicat Dashboard.

Create a production account​

Production account required

Note that you can use mojeID only in a production account. It is not possible to test mojeID in a separate test/sandbox environment as mojeID only offers access to mojeID in production where transactions are billed.

Note that you can only add mojeID to your production account after KIR has approved your application.

Existing account

If you intend to add mojeID to an existing production account in the Signicat Dashboard, skip this step.

Once you have received approval from KIR, you can create a production account in the Signicat Dashboard:

  1. Go to Signicat Dashboard > Organisation management.
  2. Click Add Account.
  3. Enter the name of your account under Account Name.
  4. Tick the Production account type.
  5. Click Create to create the new account.

Add a domain​

To connect your application with mojeID, you must set up a custom domain in your Signicat account.

For instructions on how to add a custom domain, see the domains documentation. After you add a custom domain, return to this page to activate mojeID in your account.

Add mojeID​

You can now add mojeID as an eID in your account. To do this:

  1. In the Signicat Dashboard, navigate to Products > eID Hub > eIDs.
  2. Select + Add new in the top right.
  3. Choose mojeID from the list.
  4. In the mojeID configuration page, enter the following fields:
    • Reason for requesting authentication: Text displayed to the end-user to justify the purpose of an authentication flow. We recommend you write the reason in Polish.
    • Business name: Unique identifier of your business name as registered with KIR during the onboarding process. Signicat onboarding managers enter the business name provided by KIR. Note that this cannot be changed.
    mojeID configuration

    mojeID configuration

  5. Select Add to save the configuration and activate mojeID.
Success

You have now added mojeID in the Dashboard.

You can see mojeID listed and enabled with "Active" status in the eIDs list.

Set up a connection with a protocol​

To establish a connection between Signicat and your application, you need to use an authentication protocol.

Note that you only need to connect to Signicat (eID Hub) servers. Signicat handles the connection with mojeID separately, therefore acting as a message broker between your application and mojeID.

Choose a protocol​

Supported authentication protocols

Signicat supports the standard OpenID Connect (OIDC) and SAML 2.0 protocols. In addition, we offer our bespoke Signicat Authentication REST API.

The protocol you choose depends your goals and preferences. The Authentication REST API provides flexibility and an easy setup. Otherwise, we recommend OIDC, since SAML 2.0 is much more complex to implement and usually requires a federation agent. OIDC is an industry standard with managed user sessions, unlike the Authentication REST API.

To learn more about these authentication protocols, see the Signicat eID Hub documentation.

Set up the protocol​

To follow along a mojeID integration with OIDC or the Signicat Authentication REST API, select one of the guides below:

Integration with OIDC
Integrate with mojeID using OpenID Connect
Integration with REST API
Documentation coming soon

For information on how to set up an integration with SAML 2.0, see the eID Hub - Set up SAML 2.0 documentation.

For more information about the different protocol types, see the Signicat eID Hub documentation.

Data and attributes​

To learn more about attributes, scopes and claims supported by each authentication protocol, visit the Attributes reference page.

On this page