# Troubleshooting

# Check status

You can view the status of ELO Modern Authentication at the following URL:

https://<server>:<port>/ix-<repository>/plugin/de.elo.ix.plugin.rest/auth2/status

You have to be logged in to see the complete status information.

# Recovery URL

If you can no longer log in the configuration as an administrator, there is a recovery URL. This is shown on the configuration page. Keep this URL secure.

The recovery URL schema is as follows:

https://<Server>:<Port>/ix-<Repository>/plugin/auth2/rescue

# Re-enable access to the ELO system via ELO access data

You can re-enable access to the ELO system with ELO access data. This can be useful if you can no longer log in the configuration as an administrator or single sign-on via an OpenID provider is no longer possible.

In the ELO Indexserver configuration, set the option loginWithEloCredentialsEnabled to true.

For more information on this option, refer to the documentation ELO Indexserver > Basics > Indexserver Configure Options (opens new window).

# Troubleshooting via logs

If errors occur with ELO Modern Authentication, you can use logs to check them.

First, request a browser log. The browser log lists the redirects between ELO, the proxy, and the respective provider. Here, you can check whether there is an issue with redirects.

If the Access denied error message occurs, you can check the ELO Indexserver log to see what caused the error.

# Redirect to wrong URL

If the system redirects to the wrong URL during authentication, you can configure reverse proxies. The figure in the chapter Reverse proxies > Basics shows the basic structure and changes to the URLs.

In the ELO Modern Authentication configuration, in the Fixed domain field you can set an address to redirect authentication to. For more information, refer to the chapter Configuration > Login Config.

# OpenID provider configuration: 'Error: Connection timed out: connect' error message

This error message appears by the Issuer field if the ELO server is unable to reach the OpenID provider. There may be an issue with the firewall configuration.

If you use an Internet proxy (explicit web proxy), the ELO Application Server may need to be configured accordingly. You will have to configure the Internet proxy settings as Tomcat Java Option via the ELO Server Setup. For more information, refer to the documentation ELO Server > Custom Install > 'Application Servers' tab > ELO Server Engines (opens new window).

# Configuration for multiple repositories

If you use multiple repositories in one instance, they share a login configuration. This means if you configure an authentication method for one repository, this configuration applies to all other repositories in the same instances as well.

To apply changes to the authentication configuration in an Indexserver instance to all repositories, you will have to restart the other Indexserver instances.

If you want the repositories to use different login configurations, you will need separate ELO servers and ELO installations.

Last updated: November 6, 2025 at 8:34 PM