Adobe Experience Platform-Spoke einrichten

  • Freigeben Version: Xanadu
  • Aktualisiert 1. August 2024
  • 7 Minuten Lesedauer

    • Integrieren Sie Ihren Account Adobe Experience PlatformServiceNow in die Instanz []. Erstellen Sie eine anwenderdefinierte 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 mit den Konfigurationsvorlagen für Verbindungen und Anmeldeinformationen eingerichtet werden. Bei Verwendung von Vorlagen kann jedoch jeweils nur ein Satz von Aliasdatensätzen verwendet werden.

    Fügen Sie ein Java Key Store-Zertifikat an an Adobe Experience Platform-Spoke

    Aktivieren Sie die JWT-Bearer-Grant-Token-Authentifizierung, indem Sie ein gültiges Java KeyStore-Zertifikat (JKS) 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-Signaturschlüssel für die Adobe Experience Platform-Spoke

    Erstellen Sie einen JSON Web Token (JWT)-Signaturschlüssel, 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. Formularfelder „JWT-Schlüssel“.
      Feld Beschreibung
      Name Name zur eindeutigen Identifizierung des JWT-Signaturschlü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 den Adobe Experience Platform-Spoke

    Fügen Sie Ihrer -Instanz ServiceNow 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. Formularfelder des JWT-Providers
      Feld Beschreibung
      Name Nname zur eindeutigen Identifizierung des JWT-Anbieters. Beispiel: AEP JWT Provider.
      Ablaufintervall (Sek.) Anzahl in Sekunden zum Festlegen der Lebensdauer von JWT-Anbieter-Token.
      Signierkonfiguration JWT-Signaturschlü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 „Anwenderdefinierte Ansprüche“ werden angezeigt.
    5. Geben Sie in der zugehörigen Liste „Standardansprüche“ Werte für „iss“, „ sub“ und „aud“ ein.
      Siehe Adobe Experience Platform Dokumentation für Anweisungen.
    6. Geben Sie diese Werte in die zugehörige Liste „Anwenderdefinierte 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-Anbieter

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

    Vorbereitungen

    Erforderliche Rolle: admin

    Prozedur

    1. Navigieren zu Alle > System-OAuth > Applikationsregistrierung.
    2. Klicken Sie auf Neu.
      Das System zeigt die Meldung Welche Art von OAuth-Anwendung?
    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 Konfiguration des Adobe ID-Kontos generiert haben.
      Geheimer Clientschlüssel Von Ihnen während der Konfiguration des Adobe ID-Kontos generiertes Verbrauchergeheimnis.
      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.000 Sekunden.
      PKCE erforderlich Option, damit öffentliche Clients für eine Autorisierung PKCE obligatorisch machen können.
      Hinweis:
      Sie können den Autorisierungscode nur dann 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 Tokenanforderung und -sperrung. Für diese Option muss ein Profil für gegenseitige Authentifizierung angegeben werden.
      Anmeldeinformationen senden Anmeldeinformationen für Client 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ährungstyp als JWT Beareraus. Beispiel: OAuth-Entitätsprofil wird 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 neu generiert wird, kann ein Administrator das OAuth-Spoke-Token neu generieren.

    Erstellen Sie Anmeldeinformationsdatensätze für Adobe Experience Platform

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

    Vorbereitungen

    Erforderliche Rolle: admin

    Warum und wann dieser Vorgang ausgeführt wird

    Sie müssen zwei Datensätze für Anmeldeinformationen erstellen. eine für die Verwaltung von Dateneingängen und die Batch-Erfassung und eine für die Datenerfassung.

    Prozedur

    1. Navigieren zu Alle > Verbindungen und Anmeldeinformationen > Akadem. Grade.
    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 die Verwaltung von Dateneingängen 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-Anbieter registriert haben. Wählen Sie beispielsweise AEP OAuth default_profile aus.
      Betrifft Dieses Feld ist nicht anwendbar.
      Bestellung Reihenfolge zum Anwenden dieser Anmeldeinformationen. Geben Sie z. B. 100 ein.
    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, um Aktionen in Adobe Experience Platformauszuführen.

    Vorbereitungen

    Erforderliche Rolle: admin

    Warum und wann dieser Vorgang ausgeführt wird

    Standardmäßig sind zwei Aliasse für Verbindungs- und Anmeldeinformationen verfügbar. eine für die Verwaltung von Dateneingängen und die Batch-Erfassung und eine für die Datenerfassung. Führen Sie diese Schritte aus, um jeden Alias der entsprechenden 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 Datensätze für Verbindungs- und Anmeldeinformationen. AEP und AEP_Ingestion Der AEP -Datensatz dient der Verwaltung von Dateneingängen und der 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 Platform für die Verwaltung von Dateneingängen und Batch-Erfassung und AEP DCs für die Datenerfassung ein.
      Anmeldeinformationen 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 Verwaltung von Dateneingängen 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 diese Werte auf der RegisterkarteAttribute ein.
      • Interner Name der Sandbox in Sandbox.
        Hinweis:
        Stellen Sie sicher, dass Sie den internen Namen der erforderlichen Sandbox und nicht ihre 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 Verwaltung von Dateneingängen und die Batch-Erfassung vorgesehen ist, geben Sie den API-Schlüssel und die Organisations-IDein.
      • Wenn der Verbindungsdatensatz für Streaming-Erfassunggilt, geben Sie Organisations-IDein.
    6. Klicken Sie mit der rechten Maustaste in den Header Kopfzeile des Formulars, und wählen Sie Speichern aus.

    Ergebnisse

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