Ready to Learn?Ex Libris products all provide open APIs

Tech Blog


SAML with Azure

Tamar Fuches on December 4th, 2016

Following are instructions for configuring and using Microsoft Azure as an IDP with Alma: 
  1. Create Microsoft account, and register to Azure.
  2. In the left hand navigation pane, click on Azure Active Directory.
  3. Click on the App registrations tab, and click Add.
  4. Follow the prompts and create a new web application.  
  5. Name it "Alma", Application Type "Web app / API". Provide the Alma Sign-On URL (https://###SERVER_DOMAIN###/mng/login, e.g. This represents the service provider issuer (entity ID of Alma). In Azure the field is called "App ID URI". Changing it afterwards is possible but we noticed that with some browser it's problematic. If you are not able to save changes, try with IE.
  6. Add the Assertion Consumer Service URL (https://###SERVER_DOMAIN###/mng/pdsHandleLogin) in the "Reply URLs" section.
  7. Azure will generate a metadata document.  Under "App registrations" click on the "Endpoints" link at the top of the App registration page. If you have both Primo and Alma note that the metadata and endpoints are the same for all apps registered with this Azure Active Directory.

Copy the FEDERATION METADATA DOCUMENT URL. You will need it in order to define the Alma SAML integration profile (see below).

Azure SAML new UI
Note: unlike other IdPs Azure doesn't require the certificate from the SP (Alma).


Configuring the SAML integration profile in Alma

  1. Define a SAML integration profile in Alma - see OLH for more details.
  2. In the Alma SAML integration profile, select Metadata upload method: Metadata link. Supply the link to Azure metadata file, as copied in step 6 above:
  3. Press Populate fields. Alma will automatically populate the following fields:
    - IdP issuer
    - IdP login URL
    - IdP single logout service
    - Certificate
  4. Define the following field as a match point for user details:
    - User ID location: User ID in an attribute element
    - User ID attribute name:

Note that if you make changes in Azure configuration, the integration profile in Alma might need to be updated in order to reflect these changes.