Skip to main content

Configure your account

This page guides you through the initial configurations needed to establish a connection with Personalausweis through Signicat.

Initial preparations​

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 Personalausweis in the Dashboard​

You can now add Personalausweis as an eID in the Signicat Dashboard. To do this:

  1. In the Signicat Dashboard, navigate to Products > eID and Wallet Hub > eIDs.
  2. Select + Add new in the top right.
  3. Choose the eID from the list. Add any required configuration, then select Add.
  4. Now, review that the eID is available and set to "Active" in the eIDs list.

Preview an authentication flow​

Personalausweis offers a few options to test your integration. Find out how in the Test information documentation.

To preview how an authentication flow looks like, in the Signicat Dashboard:

  1. In the Signicat Dashboard, navigate to Products > eID and Wallet Hub > eIDs.
  2. Select Test eIDs in the top right.
  3. Optional. If you activated other eIDs. Choose Personalausweis as the identity provider from the list.
  4. Follow the authentication flow in the AusweisApp.

Below, you can find the screenshots covering the steps in the desktop app using the Internal card simulator in AusweisApp.


Note that you can also test your integration after you have established a connection with an authentication protocol.

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 and Wallet Hub) servers. Signicat handles the connection with Personalausweis separately, therefore acting as a message broker between your application and Personalausweis.

With Signicat you can integrate using the following authentication protocols:

With Signicat you can integrate using the following authentication protocols:

Picking a protocol

OIDC and SAML 2.0 are official identity protocols. We recommend using OIDC since implementing SAML 2.0 involves more advanced steps.

The Authentication REST API - developed and maintained by Signicat - offers more flexibility and supports headless and redirect integration flow(s) (grant type).

You can find integration guides and more information about each protocol in the Signicat eID and Wallet Hub documentation.

Set up the protocol​

To integrate to Personalausweis with OIDC or the Signicat Authentication REST API, select one of the guides below:

Integration with OIDC
Integrate with Personalausweis using OpenID Connect
Integration with REST API
Integrate with Personalausweis using Signicat Authentication REST API

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

For more information about the different protocol types, see the Signicat eID and Wallet 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