Complete the following installation instructions for SimpleSAMLphp on a branch in a non-production environment:
Download the latest version of the SimpleSAMLphp library.
Extract the SimpleSAMLphp library to the root directory of your repository (the directory that contains your
docroot
acquia-utils
andlibrary
directories). Be sure to append the SimpleSAMLphp version number to the name of this directory (for example,simplesamlphp-1.17.7
).In the root directory of your repository, create a symbolic link from the library to
simplesamlphp
in the same directory in which the library is located. Using the directory namesimplesamlphp-1.17.7
from the previous step, enter a command similar to the following:ln -s simplesamlphp-1.17.6 simplesamlphp
This symlink allows you to upgrade SimpleSAMLphp by adding the new version and then updating the symlink. It also ensures the web interface is publicly accessible, while keeping the configuration outside of a web-accessible directory. When correctly symlinked, your directory should resemble the following example:
dr-xr-s--- 9 www-data meow 4096 May 19 20:55 docroot -r--r----- 1 www-data meow 655 Apr 1 21:17 .gitignore dr-xr-s--- 2 www-data meow 4096 Apr 1 21:17 library -r--r----- 1 www-data meow 598 Apr 1 21:17 README.acquia lrwxrwxrwx 1 www-data meow 20 May 12 18:17 simplesamlphp -> simplesamlphp-1.17.6 dr-xr-s--- 18 www-data meow 4096 May 12 18:17 simplesamlphp-1.14.10 dr-xr-s--- 18 www-data meow 4096 May 12 18:17 simplesamlphp-1.17.6
Change to your
docroot
directory, and then create a symbolic link forsimplesaml
. The symlink should point to thewww
directory in the SimpleSAMLphp library. For example:cd docroot ln -s ../simplesamlphp/www simplesaml
The preceding commands ensure the web interface is publicly accessible at
http://[www.example.com]/simplesaml
while keeping the configuration outside of a web-accessible directory. When correctly symlinked, your directory should resemble the following example:-r--r----- 1 www-data examplesite 5382 Apr 1 21:17 README.txt -r--r----- 1 www-data examplesite 1550 Apr 1 21:17 robots.txt dr-xr-s--- 2 www-data examplesite 4096 Apr 1 21:17 scripts lrwxrwxrwx 1 www-data examplesite 20 May 12 18:17 simplesaml -> ../simplesamlphp/www
Important
When upgrading SimpleSAMLphp, add the
acquia_config.php
file to the new folder and update it if needed. If SimpleSAMLphp can’t access theacquia_config.php
file, Cloud Platform will display errors in the SimpleSAMLphp log file.Install and enable the simpleSAMLphp Authentication module version 7.x-3.x to your codebase.
Important
Drupal’s administrative interface will display information on several pages that indicates SimpleSAMLphp isn’t active.
Do not enable Activate authentication via SimpleSAMLphp until you have completed all other steps in this process. If you enable this option before authentication is completely configured, you won’t be able to sign in to your website.
If you prematurely enable this setting and are locked out of your website, you can either use the
drush uli
command to sign in, or you can temporarily disable the simpleSAMLphp Authentication module with Drush. For help, see Disabling modules that block sites on Cloud Platform.Add the location of your
SimpleSAMLphp_auth
library to yoursettings.php
file, based on your subscription type:Add the following lines to your
settings.php
file on lines that precede the Acquia require line, depending on your installed version of Drupal:if (file_exists('/var/www/site-php')) { $conf['simplesamlphp_auth_installdir'] = "/var/www/html/" . $_ENV['AH_SITE_NAME'] . "/simplesamlphp"; }
After completing these steps, you must next configure your config.php file.