SAP Cloud Identity Services
SAP Cloud Identity Services are a group of services on SAP BTP that manage identity and access across cloud and on-premise systems. They provide single sign-on, user provisioning, and policy-based authorization.
The services comprise:
- Identity Authentication (IAS) — cloud-based authentication, SSO (OIDC/SAML 2.0), corporate IdP federation, conditional authentication, and user store management. Acts as the identity provider for SAP BTP applications.
- Identity Provisioning (IPS) — identity lifecycle management as a service. Synchronizes users and groups between source and target systems (SAP and non-SAP) with full and delta read modes, real-time provisioning, and transformation support.
- Identity Directory — the central user store. Provides SCIM 2.0 REST API, custom schemas, and generates the Global User ID distributed by IPS to SAP cloud applications.
- Authorization Management (AMS) — policy-based authorization for BTP applications. Developers define policies in Data Control Language (DCL); administrators refine and assign them via the administration console.
Related Skills
- sap-btp-connectivity — destination service and connection authentication mechanics (OAuth client credentials, principal propagation through Cloud Connector)
- sap-cap-capire — CAP application-level auth usage (role templates, @requires annotations, cds deploy with xs-security.json)
- sap-btp-best-practices — high-level security governance and production deployment patterns
- sap-btp-cloud-platform — BTP account setup, subaccount configuration, service instance creation
When to Use This Skill
- Registering an OIDC or SAML 2.0 application in IAS
- Configuring corporate identity provider federation (IdP proxy)
- Establishing trust between a BTP subaccount and an IAS tenant
- Setting up Identity Provisioning source/target systems and jobs
- Writing or refining AMS authorization policies (DCL)
- Migrating from XSUAA to IAS-based authentication
- Troubleshooting token validation, audience, or issuer mismatch errors
- Configuring conditional authentication (risk-based, MFA)
- Integrating IAS with the SAP BTP Identity service (automatic OIDC app creation)
Quick Reference
| Service |
Purpose |
Key Objects |
| IAS |
Authentication & SSO |
Applications (OIDC/SAML), IdPs, conditional auth, user store |
| IPS |
User/group provisioning |
Source systems, target systems, proxy systems, transformations, jobs |
| Identity Directory |
User persistence |
Users, groups, custom schemas, Global User ID |
| AMS |
Policy-based authorization |
Authorization policies, DCL rules, policy templates, restrictions |
Identity Authentication (IAS)
IAS is the entry point for authentication in SAP BTP applications. It supports OIDC and SAML 2.0 protocols, acts as an identity provider or a proxy to corporate IdPs, and provides conditional authentication based on user attributes, email domain, user group, or IP range.
Application Registration
Register applications in the IAS admin console under Applications and Resources > Applications. Each application defines:
- Application Type — OIDC or SAML 2.0
- Trust Configuration — SP metadata upload (SAML) or redirect URIs (OIDC)
- Authentication — method, conditional rules, IdP selection
- User Attributes — which attributes are sent in tokens/assertions
When using the SAP BTP Identity service (xsuaa replacement), the service instance automatically creates an OIDC application in IAS. No manual registration is needed.
Corporate IdP Federation
IAS can act as a proxy: end users authenticate at a corporate IdP (Azure AD, Okta, etc.), and IAS bridges the token for SAP applications. Configure under Applications and Resources > Corporate Identity Providers.
For details, see references/identity-authentication.md.
Identity Provisioning (IPS)
IPS synchronizes users and groups between systems. It supports source, target, and proxy system types with configurable transformations and scheduling.
Key Concepts
- Source systems — read users/groups from (e.g., SAP SuccessFactors, Azure AD, SAP S/4HANA Cloud)
- Target systems — write users/groups to (e.g., IAS tenant, SAP BTP XSUAA, SAP Analytics Cloud)
- Proxy systems — hybrid scenarios where IPS reads from one system and writes through another
- Transformations — JSON-based attribute mappings between source and target schemas
- Jobs — scheduled or on-demand provisioning runs (full or delta read)
- Real-time provisioning — immediate entity propagation from source to target
For details, see references/identity-provisioning.md.
Authorization Management (AMS)
AMS enables policy-based, instance-level authorization for BTP applications. Developers define authorization policies in Data Control Language (DCL) — an SQL-like language — and deploy them with the application. Administrators refine policies in the IAS admin console.
Policy Lifecycle
- Developer defines policies in DCL and deploys with the application
- Base policies appear in the IAS admin console under Authorization Policies
- Administrator creates custom policies (copies of base) with refined restrictions
- Administrator assigns policies to users via groups
DCL Example
DEFINE POLICY SalesOrderAccess
AS (SELECT FROM SalesOrder
WHERE buyer = CONTEXT('userIdentityLogonName')
OR region = CONTEXT('userAttributes.region'));
For details, see references/authorization-management.md.
XSUAA to IAS Migration
SAP is migrating BTP authentication from XSUAA (SAP Authorization and Trust Management Service) to Cloud Identity Services. The recommended posture:
- New BTP applications: Use the Identity service (BTP service) + IAS. The Identity service automates OIDC application creation in IAS.
- Existing XSUAA applications: Coexistence is supported. Migration is incremental — SAP recommends migrating authentication to IAS while keeping XSUAA for backward compatibility.
- Authorization: SAP is replacing XSUAA scope-based authorization with AMS policy-based authorization for new applications. Existing role-collection patterns remain supported.
For the full migration guide, see references/xsuaa-to-ias-migration.md.
Trust Configuration
Trust between BTP subaccounts and IAS is established automatically when using the Identity service. For manual configurations:
- SAML 2.0: Upload SP metadata XML to the IAS application trust configuration
- OIDC: Configure redirect URIs, post-logout URIs, and client authentication
BTP Subaccount Trust
In the BTP cockpit, under Security > Trust Configuration, the IAS tenant appears after establishing the service binding. The Identity service creates the trust automatically.
For details, see references/troubleshooting.md and references/app-integration-patterns.md.
Common Errors and Solutions
| Error |
Cause |
Solution |
Invalid redirect URI |
Redirect URI in IAS app doesn't match the approuter callback URL |
Add the exact URI (including protocol and trailing slash) in IAS app > Trust > Redirect URIs |
Token audience mismatch |
Token aud claim doesn't include the expected client ID |
Verify the application's client ID matches the one in IAS; check the Identity service binding |
Trust not established |
BTP subaccount has no trust to the IAS tenant |
Re-bind the Identity service instance or manually add IAS as trust configuration in BTP cockpit |
Missing role collections |
User has no roles assigned in BTP |
Assign role collections in BTP cockpit > Security > Role Collections, or configure AMS policies |
401 on service-to-service call |
Client credentials invalid or missing |
Regenerate client secret/certificate; verify binding credentials |
SAML assertion expired |
Clock drift between IdP and IAS |
Synchronize system clocks; check IAS tenant SAML settings |
Provisioning job failed |
Source/target system connection issue |
Check system properties, certificates, and connectivity in IPS admin console |
Issuer mismatch in token |
IAS tenant URL changed or wrong tenant |
Verify the iss claim matches the IAS tenant URL configured in the BTP trust |
Bundled Resources
references/identity-authentication.md — IAS app registration, OIDC/SAML configuration, corporate IdP federation, conditional authentication, user store
references/identity-provisioning.md — IPS source/target/proxy systems, jobs, transformations, real-time provisioning, troubleshooting
references/authorization-management.md — AMS policy language (DCL), policy lifecycle, CAP/BTP integration, instance-based authorization
references/xsuaa-to-ias-migration.md — XSUAA vs IAS decision guide, coexistence, migration steps, role-collection mapping
references/app-integration-patterns.md — Approuter + IAS, CAP + IAS/AMS, SAPUI5 frontends, mTLS/certificate auth for service-to-service
references/troubleshooting.md — Trust errors, token validation failures, audience/issuer mismatches, SAML vs OIDC pitfalls
Documentation Links
1---
2name: sap-btp-cloud-identity-services
3description: |
4 SAP Cloud Identity Services for BTP applications: Identity Authentication (IAS), Identity Provisioning (IPS), and Authorization Management (AMS). Use when configuring authentication for BTP apps, setting up OIDC or SAML app registrations, federating corporate identity providers, establishing subaccount trust, provisioning users, writing AMS authorization policies, migrating from XSUAA to IAS-based authentication, or troubleshooting token and trust errors.
5license: GPL-3.0
6metadata:
7 source: https://skillmd.com/skills/secondsky/sap-btp-cloud-identity-services
8 maintainer: "Eduard Jiglau"
9 maintainer_email: "hello@sap-ai-skills.com"
10 website: "https://sap-ai-skills.com"
11 version: "2.4.1"
12 last_verified: "2026-06-12"
13 documentation_source: https://help.sap.com/docs/cloud-identity-services
14 ias_docs: https://github.com/SAP-docs/btp-cloud-identity-services
15 integration_guide: https://help.sap.com/viewer/b95c3d5bab324a3a8409eee5267a5b75/Cloud/en-US/27947dfb325047018603446439050a6b.html
16 cap_ias_guide: https://cap.cloud.sap/docs/guides/integration/platform/ias-xsuaa
17---
18
19# SAP Cloud Identity Services
20
21SAP Cloud Identity Services are a group of services on SAP BTP that manage identity and access across cloud and on-premise systems. They provide single sign-on, user provisioning, and policy-based authorization.
22
23The services comprise:
24
25- **Identity Authentication (IAS)** — cloud-based authentication, SSO (OIDC/SAML 2.0), corporate IdP federation, conditional authentication, and user store management. Acts as the identity provider for SAP BTP applications.
26- **Identity Provisioning (IPS)** — identity lifecycle management as a service. Synchronizes users and groups between source and target systems (SAP and non-SAP) with full and delta read modes, real-time provisioning, and transformation support.
27- **Identity Directory** — the central user store. Provides SCIM 2.0 REST API, custom schemas, and generates the Global User ID distributed by IPS to SAP cloud applications.
28- **Authorization Management (AMS)** — policy-based authorization for BTP applications. Developers define policies in Data Control Language (DCL); administrators refine and assign them via the administration console.
29
30## Related Skills
31
32- **sap-btp-connectivity** — destination service and connection authentication mechanics (OAuth client credentials, principal propagation through Cloud Connector)
33- **sap-cap-capire** — CAP application-level auth usage (role templates, @requires annotations, cds deploy with xs-security.json)
34- **sap-btp-best-practices** — high-level security governance and production deployment patterns
35- **sap-btp-cloud-platform** — BTP account setup, subaccount configuration, service instance creation
36
37## When to Use This Skill
38
39- Registering an OIDC or SAML 2.0 application in IAS
40- Configuring corporate identity provider federation (IdP proxy)
41- Establishing trust between a BTP subaccount and an IAS tenant
42- Setting up Identity Provisioning source/target systems and jobs
43- Writing or refining AMS authorization policies (DCL)
44- Migrating from XSUAA to IAS-based authentication
45- Troubleshooting token validation, audience, or issuer mismatch errors
46- Configuring conditional authentication (risk-based, MFA)
47- Integrating IAS with the SAP BTP Identity service (automatic OIDC app creation)
48
49## Quick Reference
50
51| Service | Purpose | Key Objects |
52|---------|---------|-------------|
53| IAS | Authentication & SSO | Applications (OIDC/SAML), IdPs, conditional auth, user store |
54| IPS | User/group provisioning | Source systems, target systems, proxy systems, transformations, jobs |
55| Identity Directory | User persistence | Users, groups, custom schemas, Global User ID |
56| AMS | Policy-based authorization | Authorization policies, DCL rules, policy templates, restrictions |
57
58## Identity Authentication (IAS)
59
60IAS is the entry point for authentication in SAP BTP applications. It supports OIDC and SAML 2.0 protocols, acts as an identity provider or a proxy to corporate IdPs, and provides conditional authentication based on user attributes, email domain, user group, or IP range.
61
62### Application Registration
63
64Register applications in the IAS admin console under **Applications and Resources** > **Applications**. Each application defines:
65- **Application Type** — OIDC or SAML 2.0
66- **Trust Configuration** — SP metadata upload (SAML) or redirect URIs (OIDC)
67- **Authentication** — method, conditional rules, IdP selection
68- **User Attributes** — which attributes are sent in tokens/assertions
69
70When using the **SAP BTP Identity service** (`xsuaa` replacement), the service instance automatically creates an OIDC application in IAS. No manual registration is needed.
71
72### Corporate IdP Federation
73
74IAS can act as a proxy: end users authenticate at a corporate IdP (Azure AD, Okta, etc.), and IAS bridges the token for SAP applications. Configure under **Applications and Resources** > **Corporate Identity Providers**.
75
76For details, see `references/identity-authentication.md`.
77
78## Identity Provisioning (IPS)
79
80IPS synchronizes users and groups between systems. It supports source, target, and proxy system types with configurable transformations and scheduling.
81
82### Key Concepts
83
84- **Source systems** — read users/groups from (e.g., SAP SuccessFactors, Azure AD, SAP S/4HANA Cloud)
85- **Target systems** — write users/groups to (e.g., IAS tenant, SAP BTP XSUAA, SAP Analytics Cloud)
86- **Proxy systems** — hybrid scenarios where IPS reads from one system and writes through another
87- **Transformations** — JSON-based attribute mappings between source and target schemas
88- **Jobs** — scheduled or on-demand provisioning runs (full or delta read)
89- **Real-time provisioning** — immediate entity propagation from source to target
90
91For details, see `references/identity-provisioning.md`.
92
93## Authorization Management (AMS)
94
95AMS enables policy-based, instance-level authorization for BTP applications. Developers define authorization policies in **Data Control Language (DCL)** — an SQL-like language — and deploy them with the application. Administrators refine policies in the IAS admin console.
96
97### Policy Lifecycle
98
991. **Developer** defines policies in DCL and deploys with the application
1002. **Base policies** appear in the IAS admin console under **Authorization Policies**
1013. **Administrator** creates custom policies (copies of base) with refined restrictions
1024. **Administrator** assigns policies to users via groups
103
104### DCL Example
105
106```sql
107DEFINE POLICY SalesOrderAccess
108 AS (SELECT FROM SalesOrder
109 WHERE buyer = CONTEXT('userIdentityLogonName')
110 OR region = CONTEXT('userAttributes.region'));
111```
112
113For details, see `references/authorization-management.md`.
114
115## XSUAA to IAS Migration
116
117SAP is migrating BTP authentication from XSUAA (SAP Authorization and Trust Management Service) to Cloud Identity Services. The recommended posture:
118
119- **New BTP applications**: Use the **Identity service** (BTP service) + IAS. The Identity service automates OIDC application creation in IAS.
120- **Existing XSUAA applications**: Coexistence is supported. Migration is incremental — SAP recommends migrating authentication to IAS while keeping XSUAA for backward compatibility.
121- **Authorization**: SAP is replacing XSUAA scope-based authorization with AMS policy-based authorization for new applications. Existing role-collection patterns remain supported.
122
123For the full migration guide, see `references/xsuaa-to-ias-migration.md`.
124
125## Trust Configuration
126
127Trust between BTP subaccounts and IAS is established automatically when using the Identity service. For manual configurations:
128
129- **SAML 2.0**: Upload SP metadata XML to the IAS application trust configuration
130- **OIDC**: Configure redirect URIs, post-logout URIs, and client authentication
131
132### BTP Subaccount Trust
133
134In the BTP cockpit, under **Security** > **Trust Configuration**, the IAS tenant appears after establishing the service binding. The Identity service creates the trust automatically.
135
136For details, see `references/troubleshooting.md` and `references/app-integration-patterns.md`.
137
138## Common Errors and Solutions
139
140| Error | Cause | Solution |
141|-------|-------|----------|
142| `Invalid redirect URI` | Redirect URI in IAS app doesn't match the approuter callback URL | Add the exact URI (including protocol and trailing slash) in IAS app > Trust > Redirect URIs |
143| `Token audience mismatch` | Token `aud` claim doesn't include the expected client ID | Verify the application's client ID matches the one in IAS; check the Identity service binding |
144| `Trust not established` | BTP subaccount has no trust to the IAS tenant | Re-bind the Identity service instance or manually add IAS as trust configuration in BTP cockpit |
145| `Missing role collections` | User has no roles assigned in BTP | Assign role collections in BTP cockpit > Security > Role Collections, or configure AMS policies |
146| `401 on service-to-service call` | Client credentials invalid or missing | Regenerate client secret/certificate; verify binding credentials |
147| `SAML assertion expired` | Clock drift between IdP and IAS | Synchronize system clocks; check IAS tenant SAML settings |
148| `Provisioning job failed` | Source/target system connection issue | Check system properties, certificates, and connectivity in IPS admin console |
149| `Issuer mismatch in token` | IAS tenant URL changed or wrong tenant | Verify the `iss` claim matches the IAS tenant URL configured in the BTP trust |
150
151## Bundled Resources
152
1531. `references/identity-authentication.md` — IAS app registration, OIDC/SAML configuration, corporate IdP federation, conditional authentication, user store
1542. `references/identity-provisioning.md` — IPS source/target/proxy systems, jobs, transformations, real-time provisioning, troubleshooting
1553. `references/authorization-management.md` — AMS policy language (DCL), policy lifecycle, CAP/BTP integration, instance-based authorization
1564. `references/xsuaa-to-ias-migration.md` — XSUAA vs IAS decision guide, coexistence, migration steps, role-collection mapping
1575. `references/app-integration-patterns.md` — Approuter + IAS, CAP + IAS/AMS, SAPUI5 frontends, mTLS/certificate auth for service-to-service
1586. `references/troubleshooting.md` — Trust errors, token validation failures, audience/issuer mismatches, SAML vs OIDC pitfalls
159
160## Documentation Links
161
162- [SAP Cloud Identity Services](https://help.sap.com/docs/cloud-identity-services) — main documentation
163- [What Are Cloud Identity Services](https://help.sap.com/docs/cloud-identity-services/cloud-identity-services/what-is-identity-authentication) — service overview
164- [Operation Guide](https://help.sap.com/docs/cloud-identity-services/cloud-identity-services/operation-guide) — administration console guide
165- [Configuring Authorization Policies](https://help.sap.com/docs/cloud-identity-services/cloud-identity-services/configuring-authorization-policies) — AMS administration
166- [Configuring Provisioning Systems](https://help.sap.com/docs/cloud-identity-services/cloud-identity-services/configuring-provisioning-systems) — IPS setup
167- [Identity Service of SAP BTP](https://help.sap.com/docs/cloud-identity-services/cloud-identity-services/integrating-service-with-identity-service-of-sap-btp) — automatic IAS integration
168- [CAP IAS/XSUAA Guide](https://cap.cloud.sap/docs/guides/integration/platform/ias-xsuaa) — CAP framework integration
169- [SAP-docs GitHub Mirror](https://github.com/SAP-docs/btp-cloud-identity-services) — plain markdown documentation