Configuring the authentication method when connecting to core services

You can change the authentication method used to access core services.

Before you begin

Agile Service Manager must be installed and running.

To configure the authentication method when connecting to core services, you use the username and password supplied during the Agile Service Manger installation, or use the default asm username and password.

About this task

Agile Service Manger services have access to two mechanisms of authentication:
Basic authentication (default)
Environment variable based using the ASM_USER and ASM_PASS variables configured in $ASM_HOME/.env
LDAP
LDAP authentication configured using environment variables in $ASM_HOME/.env

Procedure

Switch authentication method

  1. The values of the ASM_AUTHENTICATOR parameter in .env determine the authentication method:
    • com.ibm.itsm.topology.service.auth.BasicAuthenticator
    • com.ibm.itsm.topology.service.auth.LdapAuthenticator

Configure authentication access details

  1. Once you have defined the authentication method, configure access details:
    • If using basic authentication, edit $ASM_HOME/.env and change the values for ASM_USER and ASM_PASS
    • If using LDAP authentication, edit $ASM_HOME/.env and change the following values:
      Service name
      LDAP_SERVICE_NAME: ${LDAP_SERVICE_NAME:-localhost}
      Service port
      LDAP_SERVICE_PORT: ${LDAP_SERVICE_PORT:-389}
      SSL
      LDAP_USE_SSL: ${LDAP_USE_SSL:-0}
      LDAP base
      LDAP_BASE_DN: ${LDAP_BASE_DN:-dc=example,dc=com}

Supply authentication credentials to Swagger

  1. To run REST requests via Swagger, you must use the configured username and password.
    Tip: When changing user credentials in Swagger, the interface sometimes prevents you from logging out.
    Workaround: Restart your browser.