Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  1. Edit httpd.conf :
    • Shibboleth includes configuration directives in the files /opt/shibboleth-sp/etc/shibboleth/apache.config , /opt/shibboleth-sp/etc/shibboleth/apache2.config , and /opt/shibboleth-sp/etc/shibboleth/apache22.config which must be Included in the httpd.conf file used locally. Be wary of placing the Include directive in the wrong VirtualHost .
      Code Block
      none
      none
      
      # Example for Apache 2.2.x
      Include /opt/shibboleth-sp/etc/shibboleth/apache22.config
      
    • The UseCanonicalName directive should be set to On or resource mapping errors will result.
    • Ensure that the ServerName directive is properly set, and that Apache is being started with SSL enabled.
  2. /opt/shibboleth-sp/sbin/shibd must be independently started and run in order to handle access requests. In most cases, the build process ensures that shibd can locate the configuration file and schemas, but the SHIBCONFIG and SHIBSCHEMAS environment variables may be used as well. Command line options can also be used to specify them.
    • Remember to set DYLD_INSERT_LIBRARIES to /opt/shibboleth-sp/lib/libshib-target.dylib:/opt/shibboleth-sp/lib/libshib.dylib and DYLD_LIBRARY_PATH to /opt/shibboleth-sp/lib at runtime.
  3. By default, the Shibboleth module is configured to log information on behalf of Apache to /opt/shibboleth-sp/var/log/httpd/native.log , though this can be changed by modifying the .logger files pointed to by the configuration. For this log to be created, Apache must have permission to write to this file, which may require that the file be manually created and permissions assigned to whatever user Apache is configured to run under. If the file does not appear when Apache runs with the modules loaded, check for permission problems or change the location used.
  4. shibd creates its own separate logs at /opt/shibboleth-sp/var/log/shibboleth/shibd.log and must have appropriate write permissions itself as well.

...