Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents

Overview

This document give instructions for installing the simpleSAMLphp framework. simpleSAMLphp is an alternative to using the Internet2 Shibboleth service provider software. This means that if you want to use simpleSAMLphp, then you do not have to install the Internet2 shibd software.

Install simpleSAMLphp

Download SimpleSAMLphp:

http://code.google.com/p/simplesamlphp/downloads/

Note

Note
This document was written for simpleSAMLphp 1.6.2. If you notice significant difference between it and the version you are trying to install, please let us know.

Code Block

Install it in /var, then sym link it to simplesamlphp:
ln -s /var/simplesamlphp-1.6.2 /var/simplesamlphp

Configure Apache

Apache has to know where SimpleSAMLphp is located. So, in ssl.conf add the following in the VirtualHost section:

Code Block

Alias /simplesaml /var/simplesamlphp/www

The restart Apache:

Code Block

sudo /sbin/service httpd restart

Configure SP

See the "Configuring the SP" section of the following doc:

http://simplesamlphp.org/docs/

After you generate the X509 cert, edit config/authsources.php and make 'default-sp' section look like this:

Code Block

// An authentication source which can authenticate against both SAML 2.0
// and Shibboleth 1.3 IdPs.
'default-sp' => array(
     'saml:SP',
     'privatekey' => 'saml.pem',
     'certificate' => 'saml.crt',
     // The entity ID of this SP.
     // Can be NULL/unset, in which case an entity ID is generated based on the metadata URL.
     'entityID' => 'https://hostname.ucsf.edu/simplesaml/module.php/saml/sp/metadata.php/default-sp',

     // The entity ID of the IdP this should SP should contact.
     // Can be NULL/unset, in which case the user will be shown a list of available IdPs.
     'idp' => 'https://d5n1.ucsf.edu/idp/shibboleth',

     // The URL to the discovery service.
     // Can be NULL/unset, in which case a builtin discovery service will be used.
     'discoURL' => NULL,
),

Set Admin Password and Contact Info

Code Block

In /var/simplesamlphp/config/config.php set 'auth.adminpassword' to the password of your choosing, then set the following:

'technicalcontact_name'     => 'Your app or department name',
'technicalcontact_email'    => 'your.support.email@ucsf.edu',

Convert MyAccess Metadata

Use the following URL to convert the MyAccess IdP metadata to simpleSAMLphp metadata: /admin/metadata-converter.php

Once parsed, you want the saml20-idp-remote metadata. Copy this and replace the contents of the following file:

Code Block

/var/simplesamlphp/metadata/saml20-idp-remote.php

Don't forget to put <?php at the top!

Also, for the SingleLogoutService, change it to look like this:

Code Block

'SingleLogoutService' => 'https://d5n1.ucsf.edu/idp/shib_logout.jsp?url=https://hostname.ucsf.edu',
//array (
//),

Configure PHP

PHP needs to have mcrypt enabled, to do this, do the following (assuming you are on a Linux RedHat or CentOS system):

Code Block

sudo yum -y install php-mcrypt.x86_64
sudo /sbin/service httpd restart

Integrate With MyAccess

At this point you are ready to integrate with MyAccess. You should open up a service ticket with ITS (http://help.ucsf.edu/ then click on "Submit a ticket for ITS or School of Nursing IT") and include the following information:

Subject indicating that the request is for "MyAccess Shibboleth test or production"
Attributes you want to get back from their IdP (and if you want ones that were not covered above, then you need to ask them for the OID for the attribute and configure it in attribute-map.xml)
URL for your metadata (so that they can download the metadata, or attach the metadata file to the ticket)
Indicate which attributes you would like to receive from MyAccess

To get the metadata for your simpleSAMLphp installation, go to the following URL (you will have to authenticate to simpleSAMLphp using the password you used in the configuration when installing simpleSAMLphp):

https://hostname.ucsf.edu/simplesaml/module.php/saml/sp/metadata.php/default-sp