Show Menu
THEMEN×

SAML 2.0-Authentifizierungs-Handler

AEM umfasst einen SAML -Authentifizierungs-Handler. Dieser Handler unterstützt das SAML  2.0-Authentifizierungsanforderungsprotokoll (Web-SSO-Profil), das die HTTP POST -Bindung verwendet.
Folgendes wird unterstützt:
  • Signierung und Verschlüsselung von Nachrichten
  • Automatische Erstellung von Benutzern
  • Synchronisieren von Gruppen mit vorhandenen Gruppen in AEM
  • Vom Service Provider initiierte Authentifizierung und vom Identitätsanbieter
Dieser Handler speichert die verschlüsselte SAML-Antwortnachricht im Benutzerknoten ( usernode/samlResponse ), um die Kommunikation mit dritten Dienstleistern zu erleichtern.
Hier finden Sie eine Demonstration zur Integration von AEM und SAML.
Einen End-to-End-Community-Artikel finden Sie hier : Integrieren von SAML mit „Adobe Experience Manager“.

Konfigurieren des SAML 2.0-Authentifizierungs-Handlers

Die Web-Konsole bietet Zugriff auf die SAML  2.0-Authentifizierungs-Handler-Konfiguration namens Adobe Granite SAML 2.0 Authentication Handler . Die folgenden Eigenschaften können festgelegt werden.
Der SAML 2.0-Authentifizierungs-Handler ist standardmäßig deaktiviert. Sie müssen mindestens eine der folgenden Eigenschaften festlegen, um den Handler zu aktivieren:
  • POST-URL des Identitätsanbieters
  • Entitäts-ID des Dienstleisters
SAML-Assertionen werden signiert und optional verschlüsselt. Damit dies funktioniert, müssen Sie zumindest das öffentliche Zertifikat des Identitätsanbieters im TrustStore angeben. Weitere Informationen finden Sie in Hinzufügen des Identitätsanbieterzertifikats zum TrustStore .
Pfad -Repository-Pfad, für den dieser Authentifizierungshandler von Sling verwendet werden sollte. Wenn dieser leer ist, wird der Authentifizierungs-Handler deaktiviert.
Service Ranking OSGi Framework Service Ranking Wert, um die Reihenfolge anzugeben, in der dieser Dienst aufgerufen werden soll. Dies ist ein ganzzahliger Wert, wobei höhere Werte vorrangig sind.
IDP-Zertifikatalias Der Alias des IdP-Zertifikats im globalen TrustStore. Wenn diese Eigenschaft nicht angegeben wird, ist der Authentifizierungs-Handler deaktiviert. Im Kapitel „Identitätsanbieterzertifikat zum AEM-TrustStore hinzufügen“ weiter unten finden Sie Informationen dazu, wie Sie dies einrichten.
Identitäts-Provider-URL des IDP, an den die SAML-Authentifizierungsanfrage gesendet werden soll. Wenn diese Eigenschaft nicht angegeben wird, ist der Authentifizierungs-Handler deaktiviert.
Der Hostname des Identitätsanbieters muss der OSGi-Konfiguration Apache Sling Referrer Filter hinzugefügt werden. Weitere Informationen finden Sie im Abschnitt Web-Konsole .
Dienstanbieter-Entitäts-ID -ID, die diesen Dienstanbieter eindeutig mit dem Identitätsanbieter identifiziert. Wenn diese Eigenschaft nicht angegeben wird, ist der Authentifizierungs-Handler deaktiviert.
Standardmäßige Umleitung Der Standardspeicherort, zu dem nach erfolgreicher Authentifizierung umgeleitet wird.
Dieser Ort wird nur verwendet, wenn das Cookie request-path nicht festgelegt ist. Wenn Sie eine Seite unterhalb des konfigurierten Pfads ohne gültiges Login-Token anfordern, wird der angeforderte Pfad in einem Cookie gespeichert und der Browser nach erfolgreicher Authentifizierung erneut an diesen Speicherort weitergeleitet wird.
User-ID-Attribut Der Name des Attributs mit der Benutzer-ID, mit der der Benutzer authentifiziert und im CRX-Repository erstellt wird.
Die Benutzer-ID wird nicht aus dem Knoten saml:Subject der SAML-Assertion abgerufen, sondern aus diesem saml:Attribute .
Verwenden Sie Verschlüsselung , ob dieser Authentifizierungshandler verschlüsselte SAML-Zusicherungen erwartet.
CRX-Benutzer automatisch erstellen Geben Sie an, ob nach erfolgreicher Authentifizierung automatisch nicht vorhandene Benutzer im Repository erstellt werden sollen.
Falls die automatische Erstellung von CRX-Benutzern deaktiviert ist, müssen die Benutzer manuell erstellt werden.
Zu Gruppen hinzufügen, ob ein Benutzer nach erfolgreicher Authentifizierung automatisch CRX-Gruppen hinzugefügt werden soll oder nicht.
Gruppenmitgliedschaft Der Name des Attributs saml:Attribute, das eine Liste der CRX-Gruppen enthält, denen dieser Benutzer hinzugefügt werden sollte.

Identitätsanbieterzertifikat zum AEM TrustStore hinzufügen

SAML-Assertionen werden signiert und optional verschlüsselt. Damit dies funktionieren kann, müssen Sie mindestens das öffentliche Zertifikat des IdP im Repository bereitstellen. Dazu müssen Sie Folgendes tun:
  1. Wechseln Sie zu http:/serveraddress:serverport/libs/granite/security/content/truststore.html
  2. Klicken Sie auf den Link TrustStore erstellen
  3. Geben Sie das Kennwort für den TrustStore ein und klicken Sie auf Speichern .
  4. Klicken Sie auf TrustStore verwalten .
  5. Laden Sie das IdP-Zertifikat hoch.
  6. Beachten Sie das Zertifikatalias. Im Folgenden Beispiel lautet das Alias admin#1436172864930 .

Den Dienstleisterschlüssel- und -zertifikatkette dem AEM-Schlüsselspeicher hinzufügen

Die folgenden Schritte sind obligatorisch. Andernfalls wird die folgende Ausnahme ausgelöst: com.adobe.granite.keystore.KeyStoreNotInitialisedException: Uninitialised system trust store
  1. Edit the authentication-service user.
  2. Erstellen Sie einen KeyStore, indem Sie unter Kontoeinstellungen auf KeyStore erstellen klicken.
Die folgenden Schritte sind nur erforderlich, wenn der Handler Nachrichten signieren oder entschlüsseln kann.
  1. Laden Sie die Datei mit dem privaten Schlüssel hoch, indem Sie auf Datei mit privatem Schlüssel auswählen klicken. Der Schlüssel muss im PKCS#8-Format mit DER-Kodierung vorliegen.
  2. Laden Sie durch Klicken auf Zertifikatkettendateien auswählen die Zertifikatdatei hoch.
  3. Weisen Sie ein Alias zu, wie im Folgenden gezeigt:

Logger für SAML konfigurieren

Sie können einen Logger einrichten, um alle Probleme zu debuggen, die aufgrund der falschen Konfiguration von SAML entstehen können. Gehen Sie dazu wie folgt vor:
  1. Going to the Web Console, at http://localhost:4502/system/console/configMgr
  2. Search for and click on the entry called Apache Sling Logging Logger Configuration
  3. Erstellen Sie einen Logger mit folgender Konfiguration:
    • Protokollebene: Debug
    • Protokolldatei: logs/saml.log
    • Logger: com.adobe.granite.auth.saml