Step 2: Configure clients for Alfresco Content Services - Step 2: Configure clients for Alfresco Content Services - Alfresco - Identity Service - Alfresco/Identity-Service/1.7/Identity-Service/Identity-Service/Tutorials/Single-Sign-On-SSO-Guide/LDAP/Step-2-Configure-clients-for-Alfresco-Content-Services - 1.7

Identity Service

Platform
Alfresco
Product
Identity Service
Release
1.7
ft:lastPublication
2026-05-06T19:15:55.570000
ft:locale
en-US
ArchiveStatus
Archived

Clients need to be created and configured for Alfresco Office Services (AOS) and Desktop Sync if they are used. The configuration steps for these additional clients can be ignored if they are not used.

  1. Sign in to the administrator console of ACS as an administrator. The URL of the administrator console is https://repo.example.com:443/alfresco/service/enterprise/admin.
  2. Navigate to Directories > Single Sign-On (SAML) and download the service provider certificate using the Download SP Certificate button.
  3. Run the following command on the downloaded certificate using Terminal or the Command Line:

    keytool -keystore idp.jks -storepass password -alias idpCert -import -file <path to>/alfrescoSamlSpPublicCert.cer
    
  4. Sign in to the administrator console of the Identity Service as an administrator. The URL of the Identity Service administrator console is https://ids.example.com/auth/admin.

  5. Create a new client for AOS under the Alfresco realm or the realm you created in step 1 setting the following:

    In the Settings tab:

    • A unique and identifiable Client ID.
    • A Client Protocol of SAML
    • A valid Base URL, for example: https://repo.example.com/alfresco
    • An identifiable Name that will be displayed.
    • The Login Theme is set to Alfresco
    • Set the Valid Redirect URIs using a wildcard *, for example: https://repo.example.com/alfresco/* and https://ids.example.com/*
    • Set Master SAML Processing URL and IDP Initiated SSO URL Name to the same value that you used for Client ID.
    • Set Logout Service POST Binding URL: https://repo.example.com/alfresco/service/saml/-default-/aos/logout-request
    • Make sure that the Front Channel Logout property is off.
    • Save the settings.

    In the SAML Keys tab:

    • Click the Import button:
      • Set Key Alias to idpCert
      • Set Store Password to password
      • Select the file idp.jks generated in step 3 of this section as the Import File.
      • Import the certificate.

    In the Mappers tab:

    • Click the Add Builtin button and add X500 email, X500 givenName and X500 surname.
    • Edit each mapper and set SAML Attribute Name to match the value of Property and set SAML Attribute NameFormat to Basic.
    • Save the edits.
  6. Create a new client for Desktop Sync under the Alfresco realm or the realm you created in step 1 setting at least the following :

    In the Settings tab:

    • A unique and identifiable Client ID .
    • The Valid Redirect URI must be set to http://127.0.0.1*, http://localhost*.
    • Implicit Flow Enabled is switched off.