OpenID issues are painfully difficult to diagnose. This is because a lot of the process occurs behind the scenes, and that a lot of relying parties and OpenID providers (including SimpleID) do not implement the specification properly.

How to troubleshoot

Here are some tips on troubleshooting.

  • Test whether you can log into SimpleID itself. Try to log into and out of SimpleID itself. If you can’t, this means that there is something wrong with your SimpleID installation, or your identity file. You may wish to review the Getting Started Guide.

  • Try logging into another web site using SimpleID. Some web sites, even some very well-known ones, do not implement the OpenID specification fully. This means that SimpleID will report warnings or errors when logging into these web sites.

    Try to log into different web sites to see if the problem is confined to just one particular web site.

  • Enable logging. You can temporarily enable logging so that you or the developers can see what is going on. Note that sensitive security information may be written into the log file. Only enable logging when performing troubleshooting, and disable it when you are done.

  • See if other users are experiencing the same problems. The knowledge base contains commonly encountered problems and their solutions. Searching through SimpleID’s bug/support database may reveal useful information.

If all else fails, you may consider raising a ticket.

Logging

SimpleID enables a log file to be written as it processes OpenID requests. The log file, when produced, contains information on what is happening behind the scenes in an OpenID authentication session, which may provide useful information for troubleshooting purposes.

Note that sensitive security information may be written into the log file. Only enable logging when performing troubleshooting, and disable it when you are done.

To enable logging, open config.php, and edit the log_file and log_level options.

To disable logging, set log_file to an empty string.

Note that these configuration options may not exist in your copy of the config.php file, if you have upgraded from a previous version of SimpleID. You can safely copy these configuration options from the latest config.php.dist file into your config.php file.