Adobe Experience-Plattform Spoke einrichten

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 7 Minuten Lesedauer

    • Integrieren Sie Ihre Adobe Experience-PlattformAccount bei Ihrem ServiceNowInstanz. Erstellen Sie eine anwenderdefinierte OAuth-Anwendung in Adobe Experience-PlattformUnd authentifizieren Sie Anforderungen von ServiceNow.

    Vorbereitungen

    • Anforderung IntegrationHubAbonnement
    • Adobe Experience-Plattform Spoke aktivieren
    • Erforderliche Rolle: Administrator

    Warum und wann dieser Vorgang ausgeführt wird

    Die Adobe Experience-Plattform SpokeKann auch mithilfe der Konfigurationsvorlagen für Verbindungen und Anmeldeinformationen eingerichtet werden. Bei Verwendung von Vorlagen kann jedoch jeweils nur ein Satz von Alias-Datensätzen verwendet werden.

    Hängen Sie ein Java-Schlüsselspeicher-Zertifikat an an an Adobe Experience-Plattform Spoke

    Aktivieren Sie die Authentifizierung des JWT-Bearer-Gewährungs-Tokens, indem Sie ein gültiges Java Keystore (JKS)-Zertifikat an anhängen Adobe Experience-Plattform Spoke.

    Vorbereitungen

    • Gültiges Java-Schlüsselspeicherzertifikat
    • Erforderliche Rolle: Administrator

    Prozedur

    1. Navigieren zu Alle > Systemdefinition > Zertifikatean.
    2. Klicken Sie auf Neu.
    3. Füllen Sie im Formular die Felder aus.
      Tabelle : 1. X.509-Zertifikatformularfelder
      Feld Beschreibung
      Name Name zur eindeutigen Identifizierung des Datensatzes. Beispiel: AEP-Zertifikat .
      Ablaufbenachrichtigung Option zum Senden einer Benachrichtigung, wenn das Zertifikat bald abläuft.
      Benachrichtigung bei Ablauf Anwender, die benachrichtigt werden sollen, wenn das Zertifikat abläuft.
      Tage vor Ablauf benachrichtigen Anzahl der Tage, die eine Benachrichtigung gesendet werden soll, 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 Aus Java-Schlüsselspeicher .
      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 Inhalte des X509-Zertifikats.
    4. Klicken Sie auf das Symbol „Anhänge“ ( Symbol für Anhänge) Und hängen Sie ein JKS-Zertifikat an.
    5. Klicken Sie Auf Validieren Sie Speicher/Zertifikate .

    Ergebnisse

    Das JKS-Zertifikat wird erstellt und an angehängt Adobe Experience-Plattform Spoke.

    Erstellen Sie einen JWT-Signaturschlüssel für Adobe Experience-Plattform Spoke

    Erstellen Sie einen JSON-Webtoken-Signaturschlüssel (JWT), der Ihrem Java-Schlüsselspeicher-Zertifikat zugewiesen werden soll.

    Vorbereitungen

    Erforderliche Rolle: Administrator

    Prozedur

    1. Navigieren zu Alle > System-OAuth > JWT-Schlüsselan.
    2. Klicken Sie auf Neu.
    3. Füllen Sie im Formular die Felder aus.
      Tabelle : 2. JWT-Schlüssel-Formularfelder
      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 Aus Adobe Experience-Plattform Spoke.
      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-Anbieter für Adobe Experience-Plattform Spoke

    Fügen Sie Ihrem einen JSON-Webtoken-Anbieter (JWT) hinzu ServiceNowInstanz.

    Vorbereitungen

    Erforderliche Rolle: Administrator

    Prozedur

    1. Navigieren zu Alle > System-OAuth > JWT-Anbieteran.
    2. Klicken Sie auf Neu.
    3. Füllen Sie im Formular die Felder aus.
      Tabelle : 3. Formularfelder des JWT-Anbieters
      Feld Beschreibung
      Name Nname zur eindeutigen Identifizierung des JWT-Providers. Beispiel: AEP-JWT-Anbieter .
      Ablaufintervall (Sek.) Anzahl in Sekunden zum Festlegen der Lebensdauer von JWT-Provider-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 Werte für ein iss , Untergeordnet , Und aud In der zugehörigen Liste „Standardansprüche“.
      Siehe Adobe Experience-Plattform 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-Anbieter wird zu hinzugefügt ServiceNowInstanz.

    Registrieren Adobe Experience-PlattformAls OAuth-Anbieter

    Verwenden Sie die Informationen, die während der Erstellung und Konfiguration eines Adobe ID-Accounts generiert wurden, um sich zu registrieren Adobe Experience-PlattformAls OAuth-Anbieter und zulassen, dass die Instanz OAuth 2,0-Token anfordert.

    Vorbereitungen

    Erforderliche Rolle: Administrator

    Prozedur

    1. Navigieren zu Alle > System-OAuth > Applikationsregistrierungan.
    2. Klicken Sie auf Neu.
      Das System zeigt die Nachricht an Welche Art von OAuth-Anwendung?
    3. Wählen Sie Aus Stellen Sie eine Verbindung zu einem externen OAuth-Anbieter her .
      Das System zeigt ein leeres Formular „Anwendungsregistrierungen“ an.
    4. Füllen Sie im Formular die Felder aus.
      Feld Wert erforderlich
      Name Name zur eindeutigen Identifizierung des Datensatzes. Geben Sie beispielsweise ein AEP OAuth .
      Client-ID Verbraucherschlüssel, den Sie während der Konfiguration des Adobe ID-Accounts generiert haben.
      Geheimer Clientschlüssel Verbrauchergeheimnis, das Sie während der Konfiguration des Adobe ID-Accounts generiert haben.
      OAuth-API-Skript Skript zum Anpassen der Anforderung und Antwort. Wählen Sie Aus OAuthUtilAEP .
      Standardgewährungstyp Zum Erstellen des Tokens verwendeter Gewährungstyp. Wählen Sie Aus JWT-Bearer .
      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 Aus Adobe Experience-Plattform.
      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. Eingabetaste https://ims-na1.adobelogin.com/ims/exchange/jwt/ .
      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 aus Umleitungs-URL .
      • Das System wird ausgefüllt OAuth-Entitätsprofil Mit Gewährungstyp AS JWT-Bearer . Beispiel: OAuth-Entitätsprofil Wird standardmäßig erstellt Name , AEP default_Profile
    6. Öffnen Sie den Datensatz des OAuth-Entitätsprofils.
    7. Wählen Sie den JWT-Anbieterdatensatz für aus JWT-Anbieter , Beispiel: AEP-JWT-Anbieter .
    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 neu. 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-Plattform

    Erstellen Sie Anmeldeinformationsdatensätze für den von Ihnen erstellten Adobe ID-Account. Die Adobe Experience-Plattform SpokeDer Alias für Verbindungen und Anmeldeinformationen verwendet diese Anmeldeinformationen, um Aktionen zu autorisieren.

    Vorbereitungen

    Erforderliche Rolle: Administrator

    Warum und wann dieser Vorgang ausgeführt wird

    Sie müssen zwei Anmeldeinformationsdatensätze erstellen: Einen für die Dateneingangsverwaltung und die Batch-Erfassung und einen anderen für die Datensammlung.

    Prozedur

    1. Navigieren zu Alle > Verbindungen und Anmeldeinformationen > Anmeldeinformationenan.
    2. Klicken Sie auf Neu.
      Das System zeigt die Nachricht an Welche Art von Anmeldeinformationen möchten Sie erstellen? .
    3. Wählen Sie OAuth 2.0-Anmeldeinformationen aus.
      Im Popup-Fenster wird ein leeres OAuth 2,0-Anmeldeinformationsformular angezeigt.
    4. Füllen Sie im Formular die Felder aus.
      Feld Wert erforderlich
      Name Name zur eindeutigen Identifizierung des Datensatzes. Geben Sie beispielsweise ein AEP Für Dateneingangsverwaltung und Batch-Erfassung, und AEP_Erfassung Für Datensammlung.
      Aktiv Option zur aktiven Verwendung des Anmeldeinformationsdatensatzes.
      OAuth-Einheitenprofil OAuth-Profil, das Sie bei der Registrierung von erstellt haben SalesforceApp als OAuth-Anbieter verbunden. Wählen Sie beispielsweise aus AEP OAuth default_Profile .
      Beschreibung 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 OAuth-Token abrufen Zugehöriger Link zum Generieren des OAuth-Tokens.

    Ergebnisse

    Die Anmeldeinformationsdatensätze für Adobe Experience-Plattform SpokeWird erstellt.

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

    Erstellen Sie Verbindungsdatensätze zu Ihrem Adobe ID-Account. Die Adobe Experience-Plattform SpokeDer Alias für Verbindungen und Anmeldeinformationen verwendet diese Verbindungen, um Aktionen in auszuführen Adobe Experience-Plattform.

    Vorbereitungen

    Erforderliche Rolle: Administrator

    Warum und wann dieser Vorgang ausgeführt wird

    Standardmäßig sind zwei Alias-Datensätze für Verbindungen und Anmeldeinformationen verfügbar: Einer für die Dateneingangsverwaltung und Batch-Erfassung und ein anderer für die Datensammlung. Führen Sie diese Schritte aus, um jeden Alias dem jeweiligen zuzuordnen Adobe Experience-PlattformAPI.

    Prozedur

    1. Navigieren zu Alle > Verbindungen und Anmeldeinformationen > Aliasse für Verbindungen und Anmeldeinformationenan.
    2. Öffnen Sie die erforderliche Adobe Experience-Plattform SpokeDatensatz.
      Hinweis:
      Es gibt zwei Verbindungs- und Anmeldeinformationsdatensätze: AEP Und AEP_Erfassung . Die AEP Der Datensatz ist für die Dateneingangsverwaltung und die Batch-Erfassung, und AEP_Erfassung Ist für die Datensammlung.
    3. Von Verbindungen Klicken Sie auf die Registerkarte Neu .
      Das System zeigt ein leeres HTTP(s)-Verbindungsformular an.
    4. Geben Sie diese Werte ein.
      Feld Wert erforderlich
      Name Name zur eindeutigen Identifizierung des Verbindungsdatensatzes. Geben Sie beispielsweise ein AEP-Plattform Für Dateneingangsverwaltung und Batch-Erfassung, und AEP-dcs Für Datensammlung.
      Anmeldeinformationen Anmeldeinformationsdatensatz, für den Sie erstellt haben Adobe Experience-Plattform. Wählen Sie beispielsweise aus AEP Und AEP_Erfassung .
      Verbindungsalias Alias-Datensatz, der dieser Verbindung zugeordnet ist.
      URL-Builder
      Hinweis:
      Aktivieren Sie das Kontrollkästchen nicht.
      Verbindungs-URL Basis-URL, mit der eine Verbindung hergestellt werden soll Adobe Experience-Plattform.
      • Wenn der Verbindungsdatensatz für die Dateneingangsverwaltung und die Batch-Erfassung vorgesehen ist, geben Sie ein https://platform.adobe.io/ .
      • Wenn der Verbindungsdatensatz für die Datensammlung vorgesehen ist, geben Sie ein https://dcs.adobedc.net .
      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. In Attribute Geben Sie diese Werte auf der Registerkarte ein.
      • Interner Name der Sandbox in Sandbox .
        Hinweis:
        Stellen Sie sicher, dass Sie den internen Namen der erforderlichen Sandbox und nicht ihre Bezeichnung in angeben Sandbox . Um den internen Namen der erforderlichen Sandbox abzurufen, verwenden Sie die Aktion „alle Sandboxen abrufen“.
      • Wenn der Verbindungsdatensatz für die Dateneingangsverwaltung und die Batch-Erfassung vorgesehen ist, geben Sie ein API-Schlüssel Und Organisations-ID .
      • Wenn der Verbindungsdatensatz für ist Streaming-Erfassung , Eingabetaste Organisations-ID .
    6. Klicken Sie mit der rechten Maustaste in den Header Kopfzeile des Formulars, und wählen Sie Speichern aus.

    Ergebnisse

    Die Adobe Experience-Plattform SpokeIst eingerichtet und in integriert ServiceNowInstanz.