Nexus' software components have new names:

Nexus PRIME -> Smart ID Identity Manager
Nexus Certificate Manager -> Smart ID Certificate Manager
Nexus Hybrid Access Gateway -> Smart ID Digital Access component
Nexus Personal -> Smart ID clients

Go to Nexus homepage for overviews of Nexus' solutions, customer cases, news and more.

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

Expand/Collapse All


Step-by-step instruction

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:

    IDM_CAAS_HOSTNAMEhostname is optional, but if used, it shall have the value
  2. 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):

    caasCommunicationService.clientId${IDM_CAAS_CLIENT_ID}Client id
    caasCommunicationService.clientSecret${IDM_CAAS_CLIENT_SECRET}Client secret
    caasCommunicationService.organisationId${IDM_CAAS_ORGANISATION_ID}Organisation id
    caasCommunicationService.hostname${IDM_CAAS_HOSTNAME}hostname is optional, but if used, it shall have the value

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

  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".

This article is valid for Smart ID 22.04 and later.

Related information