Initial preparations

Sign agreements and order certificates

Before you can start integrating with Signicat's implementation of BankID, you must have signed an agreement with Signicat and obtained the required merchant certificates. For more details, see Sign agreements and order certificates.

Initial setup in Dashboard

If you do not have an account already, then you need to sign up to the Signicat Dashboard for free and complete the initial preparations. To do this:

1. Sign up to the Signicat Dashboard and register your profile.
2. Ensure that you have created an organisation.
3. Create an account. To do this:
   1. Go to Signicat Dashboard > Organisation, then select + Add account.
   2. Enter an account name, choose the type of account that you want to create, then select Create.
4. Create a domain. To do this:
   1. Go to Signicat Dashboard > Settings > Domain management, then select + Add domain.
   2. To create a standard domain, enter a domain name. Then, select Add domain.
   3. To create a custom domain, follow the instructions in the Custom domains documentation.

Account types

We recommend that you create a sandbox account to test our services before going live. Sandbox and production accounts must be set up separately.

Add Swedish BankID

Once your Dashboard account is configured (see above), you must add Swedish BankID to the list of supported eIDs.

Note

Before you can add Swedish BankID in the Dashboard, you must configure access with an onboarding manager. To get help with this, please contact us.

To add Swedish BankID to your account:

1. In the Signicat Dashboard, navigate to Products > eID Hub > eIDs.
2. Select Add new.
3. Choose Swedish BankID from the list.
4. Select Add to activate the eID.

Select a protocol for authentication with Swedish BankID

To establish a connection between Signicat's BankID Authentication implementation and your application, you need to use one of the following standard authentication protocols:

• OpenID Connect
• SAML 2.0
• Signicat's Authentication REST API

For details about these protocols, see the eID Hub documentation. The eID Hub Quick start guide also gives some advice on choosing a protocol.

Select Sign API v2 for signing with Swedish BankID

To establish a connection between Signicat's BankID Signing implementation and your application, you need to use the Sign API v2.

Next steps

Continue the integration with your chosen integration method:

Integration with OIDC

Integrate with BankID Authentication using OpenID Connect

Integration with Authentication REST API

Integrate with BankID Authentication using Signicat Authentication REST API

Integration with SAML 2.0

See the general eID Hub documentation

Integration with Sign API v2

Integrate with BankID Signing using Signicat Sign API v2