--- title: KerberosIdentityAssertionPlugin description: Configure KerberosIdentityAssertionPlugin to validate Kerberos tickets locally in PingGateway with service login objects and trusted realms component: pinggateway version: 2024.11 page_id: pinggateway:reference:KerberosIdentityAssertionPlugin canonical_url: https://docs.pingidentity.com/pinggateway/2026/reference/KerberosIdentityAssertionPlugin.html llms_txt: https://docs.pingidentity.com/pinggateway/llms.txt docs_for_agents: https://developer.pingidentity.com/build-with-ai/docs-for-agents.md revdate: 2026-06-02T09:47:34Z superseded_by: https://docs.pingidentity.com/pinggateway/2026/reference/KerberosIdentityAssertionPlugin.html section_ids: KerberosIdentityAssertionPlugin-usage: Usage KerberosIdentityAssertionPlugin-properties: Properties KerberosIdentityAssertionPlugin-example: Examples KerberosIdentityAssertionPlugin-moreinfo: More information --- # KerberosIdentityAssertionPlugin Use with an [IdentityAssertionHandler](IdentityAssertionHandler.html) to validate Kerberos authentication tickets locally. The KerberosIdentityAssertionPlugin doesn't support Windows New Technology LAN Manager (NTLM) tokens. ## Usage ```json { "name": string, "type": "KerberosIdentityAssertionPlugin", "config": { "serviceLogin": ServiceLogin reference, "trustedRealms": [configuration_expression, ...] } } ``` ## Properties * `"serviceLogin"`: *ServiceLogin [reference](preface.html#definition-reference), required* A service account object to log PingGateway in to the Kerberos server so that PingGateway can act on user tokens. PingGateway will be able to validate user tokens, for example. PingGateway provides the following service account objects for the KerberosIdentityAssertionPlugin: * UsernamePasswordServiceLogin Log PingGateway in to the Kerberos server by using a service account username and password. ```json { "type": "UsernamePasswordServiceLogin", "config": { "username": configuration_expression, "passwordSecretId": configuration expression, "secretsProvider": SecretsProvider reference } } ``` * `"username"`: *configuration expression\, required* Service username. * `"passwordSecretId"`: *configuration expression\, required if the proxy requires authentication* The secret ID of the service account password. * `"secretsProvider"`: *SecretsProvider reference, required* The [SecretsProvider](SecretsProvider.html) to query for the password. - KeytabServiceLogin Log PingGateway in to the Kerberos server by using a Keytab file. | | | | - | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | | This service account object is less secure than UsernamePasswordServiceLogin; use it only for testing or to ease migration. In production environments, always use the most secure options available. | ```json { "type": "KeytabServiceLogin", "config": { "username": configuration_expression, "keytabFile": configuration expression, "executor": ScheduledExecutorService reference } } ``` * `"username"`: *configuration expression\, required* Service username. * `"keytabFile"`: *configuration expression\, required* Path to the keytab file. Both the username and keytabFile are required for login. * `"executor"`: *ScheduledExecutorService [reference](preface.html#definition-reference), optional* An executor service to schedule the execution of tasks during a keytab service login. Default: [ScheduledExecutorService](ScheduledExecutorService.html) or an executor service declared in the heap. - `"trustedRealms"`: *array of configuration expression<[strings](preface.html#definition-string)>, optional* A list of one or more Kerberos realms that are expected to match the principal's realm from the user's Kerberos ticket. Kerberos tickets are accepted only if the principal's realm matches a realm in the list. Default: Empty ## Examples ```json { "type": "KerberosIdentityAssertionPlugin", "config": { "serviceLogin": "UsernamePasswordServiceLogin", "trustedRealms": ["EXAMPLE.COM"] } } ``` ```json { "type": "UsernamePasswordServiceLogin", "config": { "username": "igsa", "passwordSecretId": "igsa.id", "secretsProvider": "mySecretsProvider" } } ``` When using a Kerberos keytab file, generate it for PingGateway with the Windows `ktpass` command. The following commands add and view a Service Principal Name (SPN) for the PingGateway service account, `igsa`, and generate a keytab file for PingGateway in the `example.com` realm mapped to the service account username. Run the commands as the Windows Administrator to ensure you have access to everything necessary: ```powershell # Add the SPN for the service account: PS C:\path\to> setspn -s HTTP/ig.example.com igsa # View the SPN for the service account: PS C:\path\to> setspn -l igsa Registered ServicePrincipalNames for CN=igsa,CN=Users,DC=example,DC=com: HTTP/ig.example.com # Generate the keytab file: PS C:\path\to> ktpass -out keytab.file -princ HTTP/ig.example.com@EXAMPLE.COM -pass ` +rndPass -maxPass 256 -mapuser igsa -crypto All -ptype KRB5_NT_PRINCIPAL -kvno 0 ``` In the PingGateway configuration, you can use the Kerberos principal as the username: ```json { "type": "KeytabServiceLogin", "config": { "username": "HTTP/ig.example.com@EXAMPLE.COM", "keytabFile": "/path/to/keytab.file" } } ``` ## More information [org.forgerock.openig.assertion.plugin.kerberos.KerberosIdentityAssertionPlugin](../_attachments/apidocs/org/forgerock/openig/assertion/plugin/kerberos/KerberosIdentityAssertionPlugin.html) [org.forgerock.openig.assertion.plugin.IdentityAssertionPlugin](../_attachments/apidocs/org/forgerock/openig/assertion/plugin/IdentityAssertionPlugin.html) [org.forgerock.openig.handler.assertion.IdentityAssertionClaims](../_attachments/apidocs/org/forgerock/openig/handler/assertion/IdentityAssertionClaims.html) The following APIs are used in this class: * [Kerberos: The Network Authentication Protocol](https://web.mit.edu/kerberos/www/index.html) * [Kerberos Authentication Overview](https://learn.microsoft.com/en-us/windows-server/security/kerberos/kerberos-authentication-overview) * [Kerberos Requirements](https://docs.oracle.com/en/java/javase/17/security/kerberos-requirements.html) * [Single Sign-on Using Kerberos in Java](https://docs.oracle.com/en/java/javase/17/security/part-iii--deploying-single-sign-kerberos-environment.html) * [Troubleshooting Security](https://docs.oracle.com/en/java/javase/17/security/troubleshooting-security.html) * [How do I enable debug logging for troubleshooting Kerberos and WDSSO issues in AM (All versions)?](https://support.pingidentity.com/s/article/How-do-I-enable-debug-logging-for-troubleshooting-Kerberos-and-WDSSO-issues-in-PingAM)