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.
Prerequisites
Identity Manager is installed, see Install Identity Manager.
Credentials for the connection to Nexus GO Cards
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.
Set the following properties in smartid.env:
Property | Values |
|---|---|
IDM_CAAS_CLIENT_ID | Client id |
IDM_CAAS_CLIENT_SECRET | Client secret |
IDM_CAAS_ORGANISATION_ID | Organisation id |
IDM_CAAS_HOSTNAME | hostname is optional, but if used, it shall have the value cards.nxsas.com |
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):
Property | Values | Comment |
|---|---|---|
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 cards.nxsas.com |
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:
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
Refresh Nexus GO Cards fields button: Click this button to get/refresh the input fields of the Nexus GO Cards Layout.
FieldsName: The input fields of the Nexus GO Cards Layouts are listed on the right.
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.
On the left side you see the available data pools fields of Identity Manager
Set up Nexus GO card template
In Identity Manager Admin, go to Home > Cards.
To add a new Nexus GO card template:
Click New. Enter Name and Description.
Choose a Data pool.
Click Save+Edit.
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.
In the General tab, configure the card panel:
Select Card from Nexus GO Cards as Credential Material. You will get all available Nexus GO Cards layouts.
Select None as Production Component.
Select a layout from the Available Nexus GO Cards Layouts list and drag-and-drop it to Nexus GO Cards Layout.
To edit a layout, click the pen.
To delete a layout, click the bin.
In the Permissions tab, you add permissions.
Click Save. If any mandatory settings are missing, an error message will be shown. Otherwise, there will be a message saying "Successful saving".