Experience Platform bietet eine große Flexibilität bei den Authentifizierungsprotokollen, die Partnern sowie Kundinnen und Kunden zur Verfügung stehen. Sie können Ihr Ziel so konfigurieren, dass es alle Authentifizierungsmethoden unterstützt, die dem Branchenstandard entsprechen, z. B. OAuth2, Authentifizierung von Bearer-Token, Kennwortauthentifizierung und viele mehr.
Auf dieser Seite wird beschrieben, wie Sie Ihr Ziel mithilfe Ihrer bevorzugten Authentifizierungsmethode einrichten. Basierend auf der Authentifizierungskonfiguration, die Sie beim Erstellen Ihres Ziels verwenden, werden den Kundinnen und Kunden beim Herstellen einer Verbindung zum Ziel in der Experience Platform-Benutzeroberfläche unterschiedliche Arten von Authentifizierungsseiten angezeigt.
Informationen dazu, wo diese Komponente in eine mit Destination SDK erstellte Integration passt, finden Sie im Diagramm in der Dokumentation zu Konfigurationsoptionen oder auf den folgenden Übersichtsseiten zur Zielkonfiguration:
Bevor Kundinnen und Kunden Daten aus Platform in Ihr Ziel exportieren können, müssen sie eine neue Verbindung zwischen Experience Platform und Ihrem Ziel herstellen, indem sie die Schritte im Tutorial Zielverbindung befolgen.
Wenn Sie durch Destination SDK ein Ziel erstellen, wird im Abschnitt customerAuthenticationConfigurations
definiert, was Kundinnen und Kunden im Authentifizierungsbildschirm sehen. Abhängig vom Zielauthentifizierungstyp müssen Kundinnen und Kunden verschiedene Authentifizierungsdetails angeben, z. B.:
Sie können Details zur Kundenauthentifizierung über den Endpunkt /authoring/destinations
konfigurieren. Detaillierte Beispiele für API-Aufrufe, in denen Sie die auf dieser Seite angezeigten Komponenten konfigurieren können, finden Sie auf den folgenden API-Referenzseiten.
In diesem Artikel werden alle unterstützten Konfigurationen für die Kundenauthentifizierung beschrieben, die Sie für Ihr Ziel verwenden können, und es wird gezeigt, was in der Experience Platform-Benutzeroberfläche zu sehen sein wird, basierend auf der Authentifizierungsmethode, die Sie für Ihr Ziel eingerichtet haben.
Für die Konfiguration der Kundenauthentifizierung müssen Sie keine Parameter konfigurieren. Sie können die auf dieser Seite angezeigten Snippets kopieren und in Ihre API-Aufrufe einfügen, wenn Sie eine Zielkonfiguration erstellen oder aktualisieren, und Ihren Benutzerinnen und Benutzern wird der entsprechende Authentifizierungsbildschirm in der Platform-Benutzeroberfläche angezeigt.
Bei allen von Destination SDK unterstützten Parameternamen und Werten wird nach Groß-/Kleinschreibung unterschieden. Um Fehler bei der Groß-/Kleinschreibung zu vermeiden, verwenden Sie bitte die Parameternamen und -werte genau wie in der Dokumentation dargestellt.
Die nachstehende Tabelle beschreibt ausführlich, welche Integrationstypen die auf dieser Seite beschriebenen Funktionen unterstützen.
Integrationstyp | Unterstützt Funktionen |
---|---|
Echtzeit-Integrationen (Streaming) | Ja |
Dateibasierte (Batch-)Integrationen | Ja |
Wenn Sie eine der auf dieser Seite beschriebenen Kundenauthentifizierungskonfigurationen verwenden, legen Sie den Parameter authenticationRule
im Zielversand immer auf "CUSTOMER_AUTHENTICATION"
fest, wie unten dargestellt.
{
"destinationDelivery":[
{
"authenticationRule":"CUSTOMER_AUTHENTICATION",
"destinationServerId":"{{destinationServerId}}"
}
]
}
Die einfache Authentifizierung wird bei Echtzeit-Integrationen (Streaming) in Experience Platform unterstützt.
Wenn Sie den einfachen Authentifizierungstyp konfigurieren, müssen Benutzerinnen und Benutzer einen Benutzernamen und ein Kennwort eingeben, um eine Verbindung zu Ihrem Ziel herzustellen.
Um die einfache Authentifizierung für Ihr Ziel einzurichten, konfigurieren Sie den ParametercustomerAuthenticationConfigurations
über den Endpunkt /destinations
wie unten angezeigt:
"customerAuthenticationConfigurations":[
{
"authType":"BASIC"
}
]
Wenn Sie den Bearer-Authentifizierungstyp konfigurieren, müssen Benutzerinnen und Benutzer das Bearer-Token eingeben, das sie von Ihrem Ziel erhalten.
Um die Authentifizierung des Bearer-Typs für Ihr Ziel einzurichten, konfigurieren Sie den ParametercustomerAuthenticationConfigurations
über den Endpunkt /destinations
, wie unten angezeigt:
"customerAuthenticationConfigurations":[
{
"authType":"BEARER"
}
]
Benutzer wählen Mit Ziel verbinden aus, um den OAuth 2-Authentifizierungsfluss für Ihr Ziel auszulösen (siehe folgendes Beispiel für das Ziel „Benutzerdefinierte Twitter-Zielgruppen“). Detaillierte Informationen zum Konfigurieren der OAuth 2-Authentifizierung für Ihren Ziel-Endpunkt finden Sie in der entsprechenden Authentifizierungsseite für Destination SDK OAuth 2.
Um die OAuth2-Authentifizierung für Ihr Ziel einzurichten, konfigurieren Sie den ParametercustomerAuthenticationConfigurations
über den Endpunkt /destinations
, wie unten angezeigt:
"customerAuthenticationConfigurations":[
{
"authType":"OAUTH2"
}
]
Die Amazon S3-Authentifizierung wird für dateibasierte Ziele in Experience Platform unterstützt.
Wenn Sie den Authentifizierungstyp Amazon S3 konfigurieren, müssen Benutzerinnen und Benutzer die S3-Anmeldeinformationen eingeben.
Um die Amazon S3-Authentifizierung für Ihr Ziel einzurichten, konfigurieren Sie den ParametercustomerAuthenticationConfigurations
über den Endpunkt /destinations
, wie unten angezeigt:
"customerAuthenticationConfigurations":[
{
"authType":"S3"
}
]
Die Azure Blob Storage-Authentifizierung wird für dateibasierte Ziele in Experience Platform unterstützt.
Wenn Sie den Authentifizierungstyp Azure Blob konfigurieren, müssen Benutzerinnen und Benutzer die Verbindungszeichenfolge eingeben.
Um die Azure Blob-Authentifizierung für Ihr Ziel einzurichten, konfigurieren Sie den Parameter customerAuthenticationConfigurations
im Endpunkt /destinations
wie unten angezeigt:
"customerAuthenticationConfigurations":[
{
"authType":"AZURE_CONNECTION_STRING"
}
]
Die Azure Data Lake Storage-Authentifizierung wird für dateibasierte Ziele in Experience Platform unterstützt.
Wenn Sie den Authentifizierungstyp Azure Data Lake Storage konfigurieren, müssen Benutzerinnen und Benutzer die Azure-Service-Prinzipalanmeldeinformationen und ihre Mandanteninformationen eingeben.
Um die Azure Data Lake Storage (ADLS)-Authentifizierung für Ihr Ziel einzurichten, konfigurieren Sie den customerAuthenticationConfigurations
-Parameter im /destinations
-Endpunkt, wie unten angezeigt:
"customerAuthenticationConfigurations":[
{
"authType":"AZURE_SERVICE_PRINCIPAL"
}
]
Die SFTP-Authentifizierung mit Passwort wird für dateibasierte Ziele in Experience Platform unterstützt.
Wenn Sie den SFTP-Authentifizierungstyp mit Passwort konfigurieren, müssen Benutzer den SFTP-Benutzernamen und das Passwort sowie die SFTP-Domain und den Port eingeben (der standardmäßige Port ist 22).
Um die SFTP-Authentifizierung mit einem Kennwort für Ihr Ziel einzurichten, konfigurieren Sie den customerAuthenticationConfigurations
-Parameter im /destinations
-Endpunkt, wie unten angezeigt:
"customerAuthenticationConfigurations":[
{
"authType":"SFTP_WITH_PASSWORD"
}
]
Die SFTP-Authentifizierung mit dem SSH-Schlüssel wird für dateibasierte Ziele in Experience Platform unterstützt.
Wenn Sie den Authentifizierungstyp SFTP mit SSH-Schlüssel konfigurieren, müssen Benutzer den SFTP-Benutzernamen und SSH-Schlüssel sowie die SFTP-Domain und den Port eingeben (der standardmäßige Port ist 22).
Um die SFTP-Authentifizierung mit dem SSH-Schlüssel für Ihr Ziel einzurichten, konfigurieren Sie den customerAuthenticationConfigurations
-Parameter im /destinations
-Endpunkt, wie unten angezeigt:
"customerAuthenticationConfigurations":[
{
"authType":"SFTP_WITH_SSH_KEY"
}
]
Die Google Cloud Storage-Authentifizierung wird für dateibasierte Ziele in Experience Platform unterstützt.
Wenn Sie die Google Cloud Storage Authentifizierungstyp: Benutzer müssen ihre Google Cloud Storage Zugriffsschlüssel-ID und geheimer Zugriffsschlüssel.
Um die Google Cloud Storage-Authentifizierung für Ihr Ziel einzurichten, konfigurieren Sie den customerAuthenticationConfigurations
-Parameter im /destinations
-Endpunkt wie unten angezeigt:
"customerAuthenticationConfigurations":[
{
"authType":"GOOGLE_CLOUD_STORAGE"
}
]
Nach dem Lesen dieses Artikels sollten Sie besser verstehen, wie Sie die Benutzerauthentifizierung für Ihre Zielplattform konfigurieren können.
Weitere Informationen zu den anderen Zielkomponenten finden Sie in den folgenden Artikeln: