Step 11: Configure Alfresco Process Services - Step 11: Configure Alfresco Process Services - Alfresco - Identity Service - Alfresco/Identity-Service/1.7/Identity-Service/Identity-Service/Tutorials/Single-Sign-On-SSO-Guide/SAML/Step-11-Configure-Alfresco-Process-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

Alfresco Process Services (APS) has two sets of properties that need to be configured to setup SSO. One set synchronizes APS with an LDAP directory and the other set configure with the Identity Service.

  1. Configuration for LDAP synchronization can be achieved manually for WAR file deployments using the activiti-ldap-properties file or reference an external file for Docker and Kubernetes deployments:
Property Description
ldap.authentication.enabled Sets whether LDAP authentication is enabled. This needs to be false as LDAP is only being used for user synchronization, for example false
ldap.authentication.java.naming.provider.url The URL of the LDAP instance, for example ldaps://ldap.example.com:636
ldap.synchronization.java.naming.security.principal The user used to access the LDAP directory to perform the synchronization, for example uid=admin,ou=system
ldap.synchronization.java.naming.security.credentials The password for the user set in ldap.synchronization.java.naming.security.principal, for example secret
ldap.synchronization.full.enabled Sets whether full LDAP synchronization is enabled or not, for example true
ldap.synchronization.full.cronExpression The cron expression describing how often the full synchronization should run, for example 0 0 0 ?
ldap.synchronization.differential.enabled Sets whether differential LDAP synchronization is enabled or not, for example true
ldap.synchronization.differential.cronExpression The cron expression describing how often the differential synchronization should run, for example 0 0 /4 * ?
ldap.synchronization.userSearchBase The section of the LDAP directory to restrict user synchronization to, for example ou=users,dc=alfresco,dc=com
ldap.synchronization.groupSearchBase The section of the LDAP directory to restrict group synchronization to, for example ou=groups,dc=alfresco,dc=com
  1. Configuration with the Alfresco Process Services can be achieved manually for WAR file deployments using the activiti-identity-service.properties or reference an external file for Docker and Kubernetes deployments:
Property Description
keycloak.enabled Sets whether Process Services will use the Identity Service to authenticate against, for example true
keycloak.realm The realm name configured in the Identity Service for the Alfresco applications, for example alfresco
keycloak.auth-server-url The base URL of the Identity Service, for example https://ids.example.com/auth
keycloak.ssl-required Sets whether SSL is mandatory for access or not, for example all
keycloak.resource The Client ID set up in the Identity Service for Process Services. The client needs to exist underneath the realm set for keycloak.realm or IDENTITYSERVICEREALM, for example alfresco
keycloak.principal-attribute The attribute to identify users by for authentication. This needs to be set to email for Process Services, for example email
keycloak.public-client The adapter will not send credentials for the client to the Identity Service if this is set to true, for example true
keycloak.always-refresh-token Sets whether a token should be refreshed for every request or not, for example true
keycloak.autodetect-bearer-only This should be set to true to serve both a web application and web services, for example true
keycloak.token-store The location of where account information token should be stored, for example cookie
keycloak.enable-basic-auth Sets whether basic authentication is also supported by the Identity Service, for example true