Set properties for Smart ID Self-Service

This article includes updates for Smart ID 23.04.22.

This article describes how to set properties for Smart ID Self-Service.

<SMARTIDHOME>

In this article, <SMARTIDHOME> refers to /home/nexus, but this can be different depending on the setup.

Open this file for editing: <SMARTIDHOME>/docker/compose/selfservice/docker-compose.yml.
Modify the environment variables (See table below for supported variables).
The prime.baseUrl in APPLICATION_YAML by default uses the variables SMARTID_INGRESS_DOMAIN and IDM_OPERATOR_DOMAIN_PREFIX which you can set in <SMARTIDHOME>/docker/compose/smartid.env.
Restart the Self-Service container.

Environment variable	Default value in SmartID package

Environment variable

Default value in SmartID package

APPLICATION_YAML

{
    "prime": {
        "baseUrl": "https://${IDM_OPERATOR_DOMAIN_PREFIX}.${SMARTID_INGRESS_DOMAIN}",
        "tenantId": 1,
        "instanceId": "selfservice_default_instance"
    }
}

CONFIG_JSON

{
  "languages": {
    "supportedLanguages": [ "en" ],
    "defaultLanguage": "en"
  },
  "theme": "default",
  "application": {
    "applicationPt1": "Smart ID",
    "applicationPt2": "Self-Service",
    "footer": {
      "lines": [
        {
          "content": "Copyright &copy; 2011-${currentYear} <a href=\"https://nexusgroup.com\" target=\"_blank\" rel=\"noopener noreferrer\">Technology Nexus Secured Business Solutions AB</a>",
          "html": true,
          "visible": "loginPage"
        }
      ]
    }
  },
  "openTasks": {
    "enabled": true
  },
  "imageCropper": {
    "selectorVisible": true,
    "ratio": "input"
  },
  "userPassword": {
    "enabled": true
  },
  "saml": {
    "enabled": true,
    "enforced": false
  },
  "clientCert": {
    "enabled": true,
    "httpsPort": "8444"
  }
}

The httpsPort depends on the server configuration. This configuration is done in the server.xml file.

For the imageCropper property, the default ratios are "free", "input" (keep aspect ratio), "16:9", and "3:4".

To adjust the choices in the drop-down list for Self-Service users, you can add another line, for example, ratios: [free, "16:9"].

APPLICATION_YAML

prime.baseUrl in APPLICATION_YAML is mandatory, the container will not start if it is not set.

The default configuration for prime.baseUrl is to go through the ingress domain (public URL). See Configure URLs to other Smart ID components on how to configure this property correctly.