Configuring preauthentication

To configure preauthentication

1. Log in to BMC Helix SSO Admin Console.

2. In the left navigation panel of the Add Realm or Edit Realm page, click Authentication.

3. From the Authentication Type list, select PREAUTH.

4. In the User ID field, enter the name of the JWT entry to be used for user identification.

   Important

   Because a JWT is generated and provided by a third-party system, the name of the claim containing the User ID is arbitrary. Consult the documentation of your third-party product to find out the actual JWT claim name containing the User ID value used for integration.

5. In the Certificate field, copy the certificate of the server that signs the JWT. 

   Important

   The certificate must be in Privacy Enhanced Mail (PEM) format.

6. (Optional) To allow an originating application to open a target application through iframe, in the ALLOW-FROM Domain(s) field, enter the name of the originating application. 
   You can specify the target server as follows:
   
   • * - wildcard. Allowed for all domains.
   • hostname - Allowed for specified domain, ignoring port.
   • hostname:port - Allowed for exact match host:port.

   • proto://hostname:port - Allowed for exact match host:port. 

   For information about cross launching, see Enabling cross launch for applications integrated with different BMC Helix SSO servers.

7. Click Save.

Where to go from here

After you have configured a realm for preauthentication, you must configure the BMC Helix SSO agent to expect JWT by GET or POST method. For more information, see Configuring the BMC Helix SSO agent.