Skip to main content
Skip table of contents

Integrate Nexus GO Cards to Identity Manager

This article is valid for Smart ID 22.04 and later.

This article describes how to set up the connection and configuration of Nexus GO Cards layouts in Smart ID Identity Manager.


Step-by-step instructions

Do settings in smartid.env and SYSTEM_PROPERTIES

In Smart ID Identity Manager, an implemented connector is responsible to connect to Nexus GO Cards and sending card jobs.

The configuration has changed slightly compared to the Smart ID release 21.04.

  1. Set the following properties in smartid.env:




Client id


Client secret


Organisation id


hostname is optional, but if used, it shall have the value

  1. Set the following properties in docker-compose.yml of Identity Manager Operator to order cards through Identity Manager, and in Identity Manager Admin to select card layouts and map input fields (under SYSTEM_PROPERTIES):






Client id



Client secret



Organisation id



hostname is optional, but if used, it shall have the value

Set up a Nexus GO Cards Layout in Identity Manager

When selecting the component Nexus GO Cards Layouts in Identity Manager Admin, all configured Nexus GO Cards layouts will be listed on the right hand side. They are displayed with name and description and can be sorted by each of those columns.

Set permissions

If you can not see the component Nexus GO Cards Layouts in the Identity Manager Admin home tree, you have to expand the Administrator roles:

  1. Go to Home>Roles>BaseRoleBootstrapAdmin and select the Nexus GO Cards Layouts checkbox.

Select unique name for new Nexus GO Cards Layout

When creating a new Nexus GO Cards Layout, you have to choose a unique name. The available list of Nexus GO Cards Layout Names are listed in the drop-down list.

Configure Nexus GO Cards Layout

  1. Refresh Nexus GO Cards fields button: Click this button to get/refresh the input fields of the Nexus GO Cards Layout.

  2. FieldsName: The input fields of the Nexus GO Cards Layouts are listed on the right.

  3. Value: You can assign data fields of a data pool to input fields as a 'Value' by drag-and-drop. You can also write a fixed, static value to the Value field. All required input fields have to be filled up.

  4. On the left side you see the available data pools fields of Identity Manager

Set up Nexus GO card template

  1. In Identity Manager Admin, go to Home > Cards.

  2. To add a new Nexus GO card template:

    1. Click New. Enter Name and Description.

    2. Choose a Data pool.

    3. Click Save+Edit.

  3. Select a State Graph from the selection box. New tabs are displayed, one for each state in the connected state graph. Each tab needs at least a default form to be configured.

  4. In the General tab, configure the card panel:

    1. Select Card from Nexus GO Cards as Credential Material. You will get all available Nexus GO Cards layouts.

    2. Select None as Production Component.

  5. Select a layout from the Available Nexus GO Cards Layouts list and drag-and-drop it to Nexus GO Cards Layout.

    1. To edit a layout, click the pen.

    2. To delete a layout, click the bin.

  6. In the Permissions tab, you add permissions.

  7. Click Save. If any mandatory settings are missing, an error message will be shown. Otherwise, there will be a message saying "Successful saving".

Additional information

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.