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 have claimed your identity URL properly. Try testing your identity URL using the Check your OpenID tool.

    This tool will see if your identity URL is providing the minimum information required for your URL is claimed. If there are issues, please review the documentation on how to claim your identity URL for further information.

    Note that this tool currently only tests for OpenID 1.0. It does not test claims of identity URLs using OpenID 2.0.

  • 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 0.7 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 SIMPLEID_LOGFILE and SIMPLEID_LOGLEVEL options.

To disable logging, set SIMPLEID_LOGFILE 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.