SAP Fiori & UI5基礎
SAP Fiori Authentication and SSO Basics: A Practical Trust Setup Guide
Learn how SAP Fiori authentication and single sign-on work, how to establish trust with an identity provider, and how to troubleshoot login, certificate, and user-mapping problems.
SAP Fiori authentication connects the browser, the Fiori launchpad, the ABAP front-end server, and an identity provider. A successful login proves who the user is; authorization then determines which applications, catalogs, spaces, pages, and backend actions the user can access.
This guide focuses on the operational sequence for a trust setup and the evidence to collect when single sign-on fails. For the broader user experience and application architecture, see SAP Fiori overview.
Understand the Fiori SSO request path
A typical browser flow starts when a user opens the Fiori launchpad URL. The front-end server redirects the browser to the configured identity provider. After the user authenticates, the identity provider returns a signed assertion or token to the front-end server. The server validates the response, maps the external identity to an SAP user, creates the authenticated session, and serves the launchpad.
The main trust relationships are between the front-end server and identity provider and between the identity provider and user directory. TLS protects the network connections, while signing certificates protect the integrity of the authentication response.
Authentication does not assign business access. The mapped SAP user still needs the correct PFCG roles and launchpad content. Use SAP Fiori role and catalog assignment when the user can sign in but cannot see an application.
Prepare the trust configuration
Collect the configuration values before changing either side of the trust:
- Fiori launchpad URL and the externally visible host name
- Front-end server host name and HTTPS port
- Identity provider issuer or entity ID
- Service provider entity ID
- Assertion consumer service URL
- Identity provider login URL
- Signing certificate and its expiration date
- User attribute used for mapping, such as an email address or corporate user ID
- Clock source and time zone on the participating systems
The public names used in the metadata and browser URL must describe the same reachable service. A reverse proxy or load balancer can change the externally visible host, protocol, or port, so include those values in the design rather than using only the internal application-server name.
Establish trust by exchanging metadata or by entering the required endpoints and certificate values on both sides. Validate the certificate chain, certificate purpose, issuer, and validity period. Record the certificate owner and renewal process before enabling production traffic.
For the surrounding launchpad administration sequence, see SAP Fiori Launchpad admin setup.
Configure identity mapping
The identity provider must send an attribute that the front-end server can map deterministically to an SAP user. Common choices include a corporate user ID, email address, or a directory attribute maintained specifically for SAP access.
Choose one canonical value and use the same normalization rules everywhere. Decide how to handle case, spaces, domain suffixes, renamed users, and duplicate values. A successful identity-provider login with no matching SAP user produces an access failure after authentication, so test mapping with a real non-privileged user before testing administrative accounts.
Keep authentication attributes separate from authorization data. Groups or claims can support role-assignment processes, but the launchpad still depends on the SAP user and its assigned roles. Review the user and role design with SAP login and access SSO concept when the same identity is used across several SAP entry points.
Validate the launchpad session
Test the complete browser path in a private browsing session after each major change. This avoids stale cookies and makes the redirect sequence easier to inspect.
- Open the exact HTTPS launchpad URL.
- Confirm that the browser redirects to the expected identity provider.
- Complete authentication with a test user.
- Confirm that the browser returns to the expected assertion consumer service URL.
- Confirm that the launchpad creates a session.
- Open an application assigned to the test user.
- Execute a representative read and write action when the test scope permits it.
- Sign out and verify that a new browser session requires the intended login behavior.
The test should cover both a user with valid launchpad content and a user whose authentication succeeds but whose application access is intentionally limited. This separates login success from authorization and application-startup behavior.
Troubleshoot common SSO failures
Start with the point at which the flow stops:
| Symptom | Evidence to inspect | Likely investigation area |
|---|---|---|
| The browser never reaches the identity provider | Browser network trace and proxy logs | Launchpad URL, reverse proxy routing, HTTPS, redirect configuration |
| The identity provider rejects the request | Identity-provider audit event | Service provider identifier, redirect URL, trust metadata |
| The response is rejected after login | Front-end authentication logs and browser response | Signature certificate, issuer, audience, destination, clock difference |
| Login succeeds but no SAP session appears | Front-end server logs and cookies | Assertion consumer service, cookie scope, host name, proxy headers |
| Authentication succeeds but the user is rejected | User mapping evidence and SAP user record | Attribute name, value normalization, user status |
| The launchpad opens without the expected tiles | Role, catalog, space, and page assignments | PFCG role design and launchpad content assignment |
| An application opens but fails during data access | Application and backend logs | Backend authorization, RFC or HTTP connectivity, service activation |
Capture timestamps in UTC, the affected user ID, the launchpad host, the identity-provider event ID, and the browser correlation information. Avoid placing passwords, private keys, or complete authentication assertions in tickets or shared logs.
Manage certificates and clock alignment
Certificate maintenance is part of normal SSO operations. Track the signing certificate expiration date, the certificate currently trusted by the front-end server, and the certificate published by the identity provider. Plan overlap where the trust configuration supports more than one valid certificate during renewal.
Check the system clocks on the browser-facing infrastructure, front-end server, identity provider, and directory services. SAML assertions contain time conditions, so a material clock difference can cause a valid-looking response to be rejected. Use a consistent time source and verify the result after daylight-saving or infrastructure changes.
After a certificate or endpoint change, test a new private browser session, an existing browser session, and the sign-out flow. Keep a rollback record containing the previous metadata and certificate fingerprints.
Separate Fiori authentication from SAP GUI access
SAP GUI and SAP Fiori can use related users and identity sources while presenting different authentication paths. A transaction launched through SAP GUI does not prove that the browser-facing Fiori trust configuration is correct, and a successful Fiori login does not prove that every SAP GUI connection is configured identically.
Use the entry point that matches the work being tested. For Fiori, inspect the browser redirect, identity-provider event, front-end session, and launchpad content. For a GUI transaction, inspect the SAP GUI connection and its own login path. This distinction prevents a working GUI login from masking a Fiori trust or cookie problem.
Use a controlled change sequence
Apply SSO changes in a non-production system first, then promote the tested metadata, certificates, endpoint values, and mapping rules through the normal change process.
A practical sequence is:
- Export the current trust metadata and record certificate fingerprints.
- Confirm the externally visible Fiori URL and proxy behavior.
- Configure or update the identity-provider trust.
- Configure the corresponding front-end trust and user mapping.
- Test authentication with a restricted test user.
- Test launchpad content and one representative application.
- Test sign-out, session expiry, and a second user mapping.
- Record evidence and the rollback procedure.
Keep emergency access available through a controlled administrative path while changing SSO. Protect that path with strong credentials, restricted network access, and monitoring. Review the launchpad configuration after upgrades, proxy changes, identity-provider changes, and certificate renewal.