Skip to main content
Skip table of contents

Configure authentication methods for Smart ID Self-Service login screen

This article includes updates for Smart ID 22.10.

This article describes how to configure login authentication methods for Smart ID Self-Service.

  1. Open this file for editing: <SMARTIDHOME>/docker/compose/selfservice/docker-compose.yml.

  2. Set the options for the login screen. This is done in the CONFIG_JSON environment variable, see Set properties for Smart ID Self-Service.

If an option is not set, it will be interpreted as true.

This example shows all login options. For information about how to configure and enable SAML, click here.

Example: config.json all login options

JS
{
  "userPassword": {
	// If enabled, will show the user/password form
    "enabled": true
  },

  "saml": {
	// If enabled, it will check if SAML authentication is configured, and if true, will show the SAML login button
    "enabled": true,
	// If enforced, instead of having a button, the user will automatically be redirected to the SAML authentication page. Only works if SAML is enabled and configured
    "enforced": true
  },

"clientCert": {
    // If enabled, will show the client certificate login button. To make it functional you have to use the correct port. The port has to be configured in your server.xml. It also has to be set up in Identity Manager Admin.
    "enabled": true,
    // Fill the "httpsPort" property with the port configured in your server.xml. The port should be the one with the property "clientAuth="true"" in the server.xml file. The property will be used to do the redirection from the http scheme to the https and then trigger the client certicate login.
    "httpsPort": "8444"
  }
}
  1. When done editing, restart the container for Smart ID Self-Service.

Example: Username/password and SAML

To only show the username/password form and the SAML button, set only the properties that need to be disabled.

JS
{
  "saml": {
	"enforced": false
  },

  "clientCert": {
	"enabled": false
  }
}

Additional information


JavaScript errors detected

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

If this problem persists, please contact our support.