Configuring SimpleSAMLphp as a Service Provider

This section explains how to configure the WSO2 Identity Server with SimpleSAMLphp as a service provider. Initially, it is necessary to setup SimpleSAMLphp as a service provider. The steps below are tested with Ubuntu.

To setup SimpleSAMLphp as a service provider

1. Install Apache.

   # apt-get install apache2

2. Install PHP and related extensions.

   # apt-get install php5 # apt-get install php5-cli # apt-get install php5-common # apt-get install php5-curl # apt-get install php-pear # apt-get install php5-mcrypt

3. Install SimpleSAMLphp using the following commands.

   # cd /var/simplesamlphp/ # wget https://github.com/simplesamlphp/simplesamlphp/releases/download/simplesamlphp-1.11.0/simplesamlphp-1.11.0.tar.gz # tar xvf simplesamlphp-1.11.0.tar.gz # mv simplesamlphp-1.11.0 simplesamlphp # cd simplesamlphp # cp -r metadata-templates/*.php metadata/ # cp -r config-templates/*.php config

4. Configure SimpleSAMLphp web in Apache.

   # cd /var/www/html # ln -s /var/simplesamlphp/simplesamlphp/www simplesaml

5. Start Apache.

   # apachectl start

6. Access the SimpleSAMLphp web app from the following location: http://localhost/simplesaml.

7. Set the SimpleSAMLphp administrator login configuration as follows:

   # cd /var/simplesamlphp/simplesamlphp # vi config/config.php

8. Look for 'auth.adminpassword' and change its value from the default and save the file.

9. Click on 'Login as administrator' from the web page http://localhost/simplesaml.

10. Add a Service Provider to SimpleSAMLphp.

    # cd /var/simplesamlphp/simplesamlphp # vi config/authsources.php

11. Add the following section to the file and save.

    'wso2-sp' => array( 'saml:SP', // The entity ID of this SP. // Can be NULL/unset, in which case an entity ID is generated based on the metadata URL. 'entityID' => 'simplesaml', // 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://localhost:9443/samlsso', // The URL to the discovery service. // Can be NULL/unset, in which case a builtin discovery service will be used. 'discoURL' => NULL, ),

    Here we assume WSO2 IS is running in localhost on 9443.

12. Add the Identity Provider metadata.

    # cd /var/simplesamlphp/simplesamlphp # vi metadata/saml20-idp-remote.php

13. Add the following section to the file and save.

    $metadata['https://localhost:9443/samlsso'] = array( 'name' => array( 'en' => 'WSO2 IS', 'no' => 'WSO2 IS', ), 'description' => 'Login with WSO2 IS SAML2 IdP.', 'SingleSignOnService' => 'https://localhost:9443/samlsso', 'SingleLogoutService' => 'https://localhost:9443/samlsso', 'certFingerprint' => '6bf8e136eb36d4a56ea05c7ae4b9a45b63bf975d' );

14. Note that metadata ['https://localhost:9443/samlsso'] should match value of 'idp' in step 11.

15. Install WSO2 Identity Server. The WSO2 Identity Server is available for download here.

16. Start WSO2 Identity Server and add a Service Provider under SAML SSO.

17. In the Main menu of the management console, click List under Identity Providers. Then click Resident Identity Provider.

18. On the page that appears, open the SAML2 Web SSO Configuration section under Inbound Authentication Configuration.

19. The ID value of the identity provider should be the SAML endpoint of the Identity Server: https://{yourhost}:{port}/samlsso

20. Test SimpleSAMLphp.

21. Go to http://localhost/simplesaml and then to "Authentication" and click on "Test configured authentications sources"

22. Pick "wso2-sp". You are redirected to WSO2 IS SAML2 IdP for login.