Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Minor
Info

This article includes updates for Smart ID 22.10.3.

This article describes the initial configuration of Smart ID Identity Manager

...

to be done after installation.

Prerequisites

Expand
titlePrerequisites

Step-by-step instruction

Expand
titleLog in to Identity Manager Admin
  1. Log in to Identity Manager Admin as a bootstrap administrator, with username admin and password admin.
  2. In Language, select your preferred language.


Expand
titleUpload license file

If a license file has not yet been uploaded, you get a message asking you to do so:

  1. Click Choose file.
  2. Browse for the Identity Manager Admin license file in <delivery folder>\Server\3-licences\. Click Open to view the license details.
  3. Click Save.


Expand
titleUpload configuration file

If you have a ready, customer-specific configuration file in .zip format, you can now upload it.

Warning

New from PRIME 3.8.1: To be able to properly view and upload a configuration file, you must first edit the admin user and make the setting described in step 5 and 6 under heading "Create users for administration". When you have done the setting, log out and log in to PRIME Designer again.

  1. In Identity Manager Admin, go to the Configuration File tab.
  2. Click Upload configuration and then Select file.
  3. Browse for the provided configuration .zip file and then click Open. The configuration is read and checked for syntax. The contents of the configuration are displayed in the popup.
  4. Start the import by clicking Upload. When the upload is completed, close the window with Close.

    The configuration file has now been uploaded.
Note
titleSymbolic name handling

The handling of symbolic names depends on the source, case, and database. For more information, see Symbolic names in Smart ID Identity Manager. 



Expand
titleCreate users for administration

To create users with administrative rights, follow the instruction below. Several people can be registered as administrators. It is of course important that passwords are kept secret.

Warning

When you create users for administration it is necessary to allow the created administrators to see the Configuration File tab. Otherwise it is not possible for them to upload any configuration. This is covered in the steps below and is new from PRIME 3.8.1.

For each user:

  1. Go to Home > User Administration.
    If you have uploaded a configuration, all the users defined in that configuration are now displayed.
  2. Click +New. Enter a User Name, Password, and Full user name.
  3. Click Save + Edit. A view is displayed, that shows the available roles on the left.
  4. Select Administrator on the left. Click the right arrow button to add the Administrator role to the new user.
  5. Select the Permissions tab and then the General tab.
  6. Check Configuration File. This is necessary to allow the created administrators to upload configurations.
  7. Click Save, and close the form.

    The new users will now appear in the User Administration panel.
Note

If only one person or a few persons have administrator rights, then absence, a forgotten password or lost login credentials can lead to administrators being locked out. To avoid this, the login name and credential of an emergency administrator can be stored in a secure place to only be accessed through emergency procedures.

The procedures for managing this emergency login should be defined in the IT security policy of your organization. The double verification principle should be applied, so that no single person can log in themselves with the emergency login.



Expand
titleEdit system.properties

Before you can delete the bootstrap administrator, you must do this update in system.properties.

  1. Edit system.properties and update these rows:

    Code Block
    titleEdit system.properties
    cronUsername.encrypted=NEW_ADMIN_USER 
    cronPassword.encrypted=NEW_ADMIN_PW


  2. Restart Tomcat, so the new admin user is used for the scheduler.


Expand
titleDelete bootstrap administrator account
  1. Go to Home > User Administration.
  2. Select the bootstrap administrator, admin.
  3. Click Delete and confirm the deletion with Yes.
    The bootstrap administrator is now deleted, and only the administrators you have created can log in to Identity Manager Admin. When the configuration has also been uploaded to the Identity Manager

...

  1. Operator, the same is also valid there.

    The customization of the application is now complete and Identity Manager is ready for operation.


Expand
titleSettings for client authentication

If you use client authentication to log in to Identity Manager or Smart ID Self-Service, such as browser-based smart card or soft token login, do the following to avoid failure of CA connector calls during card production with Identity Manager and CardSDK:

  1. Open the file system.properties for editing.
  2. Specify https ports without client authentication for CA connector calls and JPKIEncoder downloads by CardSDK:

    Code Block
    titleConfigure overrides
    # if you use client-auth to log into Identity Manager or Smart ID Self-Service you need to configure overrides to non-client-auth HTTPS ports here,
    # otherwise the CardSDK trying to download the JPKIEncoder or the JPKIEncoder calling an integrated CA connector will not be able to connect
    
    # for JPKIEncoder download:
    webappUrlInfo.httpsOverridePort=18443
    
    # for CA connector calls:
    webServer.httpsOverridePort=18443

...

This article is valid for Smart ID 20.11 and later.

Related information

...