Authentication fails with Internal Server Error (500) after installing or upgrading to Agent 5.x

Last updated Sep 14, 2020

The purpose of this article is to provide assistance if you cannot log in to the resource being protected by the agent after installing or upgrading the agent. You will see an HTTP 500 response when this happens with a corresponding "Internal Server Error (500)" error and NPE. This issue affects both Web and Java Agents.


You receive an HTTP 500 response or the following message is shown when you attempt to access the resource being protected by the agent:

"server_error Internal Server Error"

The following error is shown in the OAuth2Provider debug log when this happens:

OAuth2Provider:05/05/2020 14:27:16:488 AM BST: Thread[https-jsse-nio-443-exec-4,5,main]: TransactionId[65513f3e-18f1-44c7-9a28-c5c90327f933-595237]
WARNING: An unexpected exception occurred while handling an OAuth2 request
Internal Server Error (500) - The server encountered an unexpected condition which prevented it from fulfilling the request
   at org.restlet.resource.ServerResource.doHandle(
   at org.restlet.resource.ServerResource.get(
   at org.restlet.resource.ServerResource.doHandle(
   at org.restlet.resource.ServerResource.doNegotiatedHandle(
   at org.restlet.resource.ServerResource.doConditionalHandle(
   at org.restlet.resource.ServerResource.handle(
Caused by: java.lang.NullPointerException
   at org.forgerock.openam.oauth2.AgentClientRegistration.createIDTokenJwt(
   at org.forgerock.openidconnect.OpenIdConnectToken.createJwt(
   at org.forgerock.openidconnect.OpenIdConnectToken.toMap(

Recent Changes

Installed or upgraded to Agent 5.x.


The agent JWT creation fails because of the NPE (Null Pointer Exception) seen in the logs, which signifies an underlying issue with the keystore. Common keystore issues that cause this error are (but not limited to):

  • The key is missing.
  • The key alias name is incorrect (for example, you have not changed the 'test' key alias).
  • The keypair has not been generated correctly.
  • The keystore type is wrong.


This issue can be resolved by identifying what is wrong with the keystore and fixing it. If you are not using the default key alias (or it doesn't exist in the keystore you are using), begin by ensuring you follow the steps in one of the following guides to create new key aliases depending on which agent you are using:

If this does not resolve it, other resources that might help are:

See Also

redirect_uri_mismatch error occurs after upgrading to, or installing Web Agents 5.x

Redirect loop between AM and Agent 5.x after successful authentication

Apache Web Agent 5.x does not start after installing it on RHEL or CentOS configured with SELinux

Web Agents › User Guide › Default Login Redirection Mode

Java Agents › User Guide › Default Login Redirect Mode

Web Agents User Guide › Custom Login Redirection Mode

Java Agents › User Guide › Custom Login Redirect Mode

Related Training


Related Issue Tracker IDs


Copyright and TrademarksCopyright © 2020 ForgeRock, all rights reserved.