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. Click the name of your organisation at the top left of the screen and then select Manage.
2. Under Organisation management, 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

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 protocols

Signicat supports the standard OIDC and SAML 2.0 protocols. In addition, we offer the Signicat Authentication REST API.

Choice of protocol depends on what you prefer and what you want to achieve. The Authentication REST API gives you a lot of flexibility and is easy to set up. Between the other two, we recommend using OIDC, since SAML 2.0 is much more complex to implement on your side and usually requires a federation agent already in place. OIDC is industry standard and you do not need to manage user sessions on your own (like with the Authentication REST API).

For more information about the different protocol types, 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.