Adobe Experience Platform-Spoke einrichten

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 7 Minuten Lesedauer

    • Integrieren Sie Ihr Adobe Experience Platform -Konto mit Ihrer ServiceNow -Instanz. Erstellen Sie eine benutzerdefinierte OAuth-Anwendung in Adobe Experience Platform, und authentifizieren Sie Anforderungen von ServiceNow.

    Vorbereitungen

    • IntegrationHub-Abonnement anfordern
    • Adobe Experience Platform-Spoke aktivieren
    • Erforderliche Rolle: admin

    Warum und wann dieser Vorgang ausgeführt wird

    Adobe Experience Platform-Spoke kann auch mithilfe der Konfigurationsvorlagen für Verbindungen und Anmeldeinformationen eingerichtet werden. Bei Verwendung von Vorlagen kann jedoch jeweils nur ein Satz von Aliasdatensätzen verwendet werden.

    Hängen Sie ein Java Key Store-Zertifikat an den an Adobe Experience Platform-Spoke

    Aktivieren Sie die JWT Bearer Grant-Token-Authentifizierung, indem Sie ein gültiges JKS-Zertifikat (Java KeyStore) an Adobe Experience Platform-Spokeanhängen.

    Vorbereitungen

    • Gültiges Java KeyStore-Zertifikat
    • Erforderliche Rolle: admin

    Prozedur

    1. Navigieren zu Alle > Systemdefinition > Zertifikate.
    2. Klicken Sie auf Neu.
    3. Füllen Sie die Felder des Formulars aus.
      Tabelle : 1. Formularfelder X.509-Zertifikat
      Feld Beschreibung
      Name Name zur eindeutigen Identifizierung des Datensatzes. Beispiel: AEP-Zertifikat.
      Ablaufbenachrichtigung Option zum Senden einer Benachrichtigung, wenn das Zertifikat abläuft.
      Benachrichtigung bei Ablauf Benutzer, die benachrichtigt werden sollen, wenn das Zertifikat abläuft.
      Tage vor Ablauf benachrichtigen Anzahl der Tage zum Senden einer Benachrichtigung, bevor das Zertifikat abläuft.
      Aktiv Option zur aktiven Verwendung des Zertifikats.
      Format Zertifikatformat. Die Instanz unterstützt die Formate PEM und DER.
      Typ Typ des Zertifikats. Wählen Sie Java Key Store aus.
      Gültig ab Datum, ab dem das Zertifikat gültig ist.
      Läuft ab Datum, an dem das Zertifikat abläuft.
      Läuft in Tagen ab Anzahl der Tage, bis das Zertifikat abläuft.
      Schlüsselspeicher-Passwort Passwort, das dem Zertifikat zugeordnet ist.
      Kurzbeschreibung Zusammenfassung des Zertifikats.
      PEM-Zertifikat Inhalt des X509-Zertifikats.
    4. Klicken Sie auf das Anhangsymbol ( Anhangsymbol), und hängen Sie ein JKS-Zertifikat an.
    5. Klicken Sie auf Speicher/Zertifikate validieren.

    Ergebnisse

    Das JKS-Zertifikat wird erstellt und an Adobe Experience Platform-Spokeangehängt.

    Erstellen Sie einen JWT-Signierschlüssel für Adobe Experience Platform-Spoke

    Erstellen Sie einen JWT-Signierschlüssel (JSON Web Token), um ihn Ihrem Java KeyStore-Zertifikat zuzuweisen.

    Vorbereitungen

    Erforderliche Rolle: admin

    Prozedur

    1. Navigieren zu Alle > System-OAuth > JWT-Schlüssel.
    2. Klicken Sie auf Neu.
    3. Füllen Sie die Felder des Formulars aus.
      Tabelle : 2. Felder des Formulars „JWT-Schlüssel“.
      Feld Beschreibung
      Name Name zur eindeutigen Identifizierung des JWT-Signierschlüssels. Beispiel: AEP JWT-Schlüssel.
      Signatur-Schlüsselspeicher Gültiges JKS-Zertifikat, das in der vorherigen Aufgabe angehängt wurde. Beispiel: AEP-Zertifikat.
      Schlüssel-ID Schlüssel-ID, um zu identifizieren, welcher Schlüssel verwendet wird, wenn mehrere Schlüssel zum Signieren von Token verwendet werden.
      Anwendung Anwendungsbereich, der diesen Datensatz enthält. Wählen Sie Adobe Experience Platform-Spoke aus.
      Signaturalgorithmus Algorithmus zum Signieren mit dem JWT-Schlüssel.
      Signaturschlüssel-Passwort Passwort, das dem Signaturschlüssel zugeordnet ist.
      Aktiv Option zur aktiven Verwendung des Zertifikats.
    4. Klicken Sie auf Absenden.

    Ergebnisse

    Der JWT-Schlüssel wird erstellt und dem JKS-Zertifikat zugewiesen.

    Erstellen Sie einen JWT-Provider für Adobe Experience Platform-Spoke

    Fügen Sie Ihrer ServiceNow -Instanz einen JSON-Web-Token-Provider (JWT) hinzu.

    Vorbereitungen

    Erforderliche Rolle: admin

    Prozedur

    1. Navigieren zu Alle > System-OAuth > JWT-Anbieter.
    2. Klicken Sie auf Neu.
    3. Füllen Sie die Felder des Formulars aus.
      Tabelle : 3. Felder des Formulars „JWT-Provider“.
      Feld Beschreibung
      Name Nname zur eindeutigen Identifizierung des JWT-Providers. Beispiel: AEP JWT Provider.
      Ablaufintervall (Sek.) Zahl in Sekunden zum Festlegen der Lebensdauer von JWT-Provider-Token.
      Signierkonfiguration JWT-Signierschlüssel aus dem vorherigen Schritt. Beispiel: AEP JWT-Schlüssel.
    4. Klicken Sie mit der rechten Maustaste auf den Formularheader und wählen Sie Speichern aus.
      Die zugehörigen Listen „Standardansprüche“ und „Benutzerdefinierte Ansprüche“ werden angezeigt.
    5. Geben Sie Werte für iss, subund aud in die zugehörige Liste Standardansprüche ein.
      Siehe Adobe Experience Platform -Dokumentation für -Anweisungen.
    6. Geben Sie diese Werte in die zugehörige Liste „Benutzerdefinierte Ansprüche“ ein.
      Feld Wert
      Anspruchname https://ims-na1.adobelogin.com/s/entdataservices_sdk
      Anspruchwerttyp Wahr|Falsch
      Anspruchwert wahr
    7. Klicken Sie auf Aktualisieren.

    Ergebnisse

    Der JWT-Provider wird Ihrer Instanz ServiceNow hinzugefügt.

    Registrieren Sie Adobe Experience Platform als OAuth-Provider

    Verwenden Sie die Informationen, die während der Erstellung und Konfiguration des Adobe ID-Kontos generiert wurden, um Adobe Experience Platform als OAuth-Provider zu registrieren und der Instanz die Anforderung von OAuth 2.0-Token zu ermöglichen.

    Vorbereitungen

    Erforderliche Rolle: admin

    Prozedur

    1. Navigieren zu Alle > System-OAuth > Applikationsregistrierung.
    2. Klicken Sie auf Neu.
      Die Meldung Welche Art von OAuth-Anwendung?wird angezeigt.
    3. Wählen Sie Verbindung zu einem fremden OAuth-Provider herstellen aus.
      Das System zeigt ein leeres Anwendungsregistrierungsformular an.
    4. Füllen Sie die Felder des Formulars aus.
      Feld Wert erforderlich
      Name Name zur eindeutigen Identifizierung des Datensatzes. Geben Sie beispielsweise AEP OAuthein.
      Client-ID Verbraucherschlüssel, den Sie während der Adobe ID-Kontokonfiguration generiert haben.
      Geheimer Clientschlüssel Geheimer Verbraucherschlüssel, den Sie während der Adobe ID-Kontokonfiguration generiert haben.
      OAuth-API-Skript Skript zum Anpassen der Anforderung und Antwort. Wählen Sie OAuthUtilAEP aus.
      Standardgewährungstyp Zum Erstellen des Tokens verwendeter Gewährungstyp. Wählen Sie JWT Bearer aus.
      Lebensdauer von Aktualisierungstoken Zeit in Sekunden, die das Aktualisierungstoken gültig ist. Die Standardzeit beträgt 8.640.0000 Sekunden.
      PKCE erforderlich Option, damit öffentliche Clients PKCE für eine Autorisierung anfordern können.
      Hinweis:
      Sie können nur den Autorisierungscode als Standardgewährungstyp verwenden, wenn PKCE aktiviert ist.
      Anwendung Anwendungsbereich, der diesen Datensatz enthält. Wählen Sie Adobe Experience Platform aus.
      Zugänglich von Anwendungsbereich, von dem aus auf diese Registrierung zugegriffen werden kann.
      Aktiv Option zur aktiven Verwendung der Anwendungsregistrierung.
      Autorisierungs-URL Dieses Feld muss leer gelassen werden.
      Token-URL OAuth-Servertoken-Endpunkt. Geben Sie https://ims-na1.adobelogin.com/ims/exchange/jwt/ ein.
      Token-Sperr-URL Dieses Feld muss leer gelassen werden.
      Umleitungs-URL Dieses Feld muss leer gelassen werden.
      Gegenseitige Authentifizierung aktivieren Option zur Verwendung der gegenseitigen Authentifizierung für die Anforderung und den Widerruf von Token. Für diese Option muss ein Profil für gegenseitige Authentifizierung angegeben werden.
      Anmeldeinformationen senden Client-Anmeldeinformationen in der Anforderung.
    5. Klicken Sie mit der rechten Maustaste auf den Formularheader und wählen Sie Speichern aus.
      • Das System validiert die OAuth-Anmeldeinformationen und füllt die Umleitungs-URLaus.
      • Das System füllt das OAuth-Entitätsprofil mit dem GewährungstypJWT Bearer. Zum Beispiel wird ein OAuth-Entitätsprofil mit dem Standardnamen AEP default_profileerstellt
    6. Öffnen Sie den Datensatz des OAuth-Entitätsprofils.
    7. Wählen Sie den JWT-Provider-Datensatz für JWT-Provideraus, z. B. AEP JWT-Provider.
    8. Klicken Sie auf Aktualisieren.

    Ergebnisse

    Die Instanz kann OAuth 2.0-Token für die Spoke anfordern.
    Hinweis:
    Wenn ein OAuth-Token abläuft, generiert die Spoke in den meisten Fällen automatisch ein neues Token. Wenn ein Token abläuft und nicht erneut generiert wird, kann ein Administrator das Spoke-OAuth-Token erneut generieren.

    Erstellen Sie Anmeldeinformationsdatensätze für Adobe Experience Platform

    Erstellen Sie Datensätze für Anmeldeinformationen für das von Ihnen erstellte Adobe ID-Konto. Der Alias für Verbindungen und Anmeldeinformationen Adobe Experience Platform-Spoke verwendet diese Anmeldeinformationen zum Autorisieren von Aktionen.

    Vorbereitungen

    Erforderliche Rolle: admin

    Warum und wann dieser Vorgang ausgeführt wird

    Sie müssen zwei Anmeldeinformationsdatensätze erstellen. eine für Dateneingangsverwaltung und Batch-Erfassung und eine andere für die Datenerfassung.

    Prozedur

    1. Navigieren zu Alle > Verbindungen und Anmeldeinformationen > Berechtigungen.
    2. Klicken Sie auf Neu.
      Das System zeigt die Meldung Welche Art von Anmeldeinformationen möchten Sie erstellen? an..
    3. Wählen Sie OAuth 2.0-Anmeldeinformationen aus.
      Das Pop-up-Fenster zeigt ein leeres Formular für die OAuth 2.0-Anmeldeinformationen an.
    4. Füllen Sie die Felder des Formulars aus.
      Feld Wert erforderlich
      Name Name zur eindeutigen Identifizierung des Datensatzes. Geben Sie beispielsweise AEP für Dateneingangsverwaltung und Batch-Erfassung und AEP_Ingestion für die Datenerfassung ein.
      Aktiv Option zur aktiven Verwendung des Anmeldeinformationsdatensatzes.
      OAuth-Einheitenprofil OAuth-Profil, das Sie erstellt haben, als Sie die verbundene App Salesforce als OAuth-Provider registriert haben. Wählen Sie beispielsweise AEP OAuth default_profile aus.
      Betrifft Dieses Feld ist nicht anwendbar.
      Reihenfolge Reihenfolge zum Anwenden dieser Anmeldeinformationen. Geben Sie z. B. 100ein.
    5. Speichern Sie den Datensatz.
    6. Klicken Sie auf den zugehörigen Link OAuth-Token abrufen, um das OAuth-Token zu generieren.

    Ergebnisse

    Die Anmeldeinformationsdatensätze für Adobe Experience Platform-Spoke werden erstellt.

    Erstellen Sie Verbindungsdatensätze für Adobe Experience Platform-Spoke

    Erstellen Sie Verbindungsdatensätze für Ihren Adobe ID-Account. Der Alias für Verbindungen und Anmeldeinformationen Adobe Experience Platform-Spoke verwendet diese Verbindungen zum Ausführen von Aktionen in Adobe Experience Platform.

    Vorbereitungen

    Erforderliche Rolle: admin

    Warum und wann dieser Vorgang ausgeführt wird

    Standardmäßig sind zwei Aliasdatensätze für Verbindungen und Anmeldeinformationen verfügbar. eine für Dateneingangsverwaltung und Batch-Erfassung und eine andere für die Datenerfassung. Führen Sie diese Schritte aus, um jeden Alias der jeweiligen Adobe Experience Platform -API zuzuordnen.

    Prozedur

    1. Navigieren zu Alle > Verbindungen und Anmeldeinformationen > Aliasse für Verbindungen und Anmeldeinformationen.
    2. Öffnen Sie den erforderlichen Datensatz Adobe Experience Platform-Spoke.
      Hinweis:
      Es gibt zwei Verbindungs- und Anmeldeinformationsdatensätze. AEP und AEP_Ingestion. Der AEP -Datensatz dient der Dateneingangsverwaltung und Batch-Erfassung, und AEP_Ingestion dient der Datenerfassung.
    3. Klicken Sie auf der Registerkarte Verbindungen auf Neu.
      Das System zeigt ein leeres HTTP(s)-Verbindungsformular an.
    4. Geben Sie die folgenden Werte ein.
      Feld Wert erforderlich
      Name Name zur eindeutigen Identifizierung des Verbindungsdatensatzes. Geben Sie beispielsweise AEP-Plattform für Dateneingangsverwaltung und Batch-Erfassung und AEP-DCs für Datenerfassung ein.
      Anmeldeinformation Anmeldeinformationsdatensatz, den Sie für Adobe Experience Platformerstellt haben. Wählen Sie beispielsweise AEP und AEP_Ingestion aus.
      Verbindungsalias Alias-Datensatz, der dieser Verbindung zugeordnet ist.
      URL-Builder
      Hinweis:
      Aktivieren Sie das Kontrollkästchen nicht.
      Verbindungs-URL Basis-URL für die Verbindung mit Adobe Experience Platform.
      • Wenn der Verbindungsdatensatz für die Dateneingangsverwaltung und Batch-Erfassung vorgesehen ist, geben Sie https://platform.adobe.io/ein.
      • Wenn der Verbindungsdatensatz für die Datenerfassung vorgesehen ist, geben Sie https://dcs.adobedc.netein.
      MID-Server verwenden Dieses Feld ist nicht anwendbar.
      Aktiv Option zur aktiven Verwendung dieser Verbindung.
      Domäne Domäne, in der die Aktion oder Aktivität ausgeführt wird.
    5. Geben Sie auf der RegisterkarteAttribute diese Werte ein.
      • Interner Name der Sandbox in Sandbox.
        Hinweis:
        Stellen Sie sicher, dass Sie den internen Namen der erforderlichen Sandbox und nicht deren Bezeichnung in Sandbox angeben. Um den internen Namen der erforderlichen Sandbox zu erhalten, verwenden Sie die Aktion Alle Sandboxen abrufen.
      • Wenn der Verbindungsdatensatz für die Dateneingangsverwaltung und Batch-Erfassung vorgesehen ist, geben Sie API-Schlüssel und Organisations-IDein.
      • Wenn der Verbindungsdatensatz für die Streaming-Erfassung vonist, geben Sie Organisations-IDein.
    6. Klicken Sie mit der rechten Maustaste in den Header des Formulars und wählen Sie Speichern aus.

    Ergebnisse

    Adobe Experience Platform-Spoke wird eingerichtet und in die Instanz ServiceNow integriert.