Adobe Experience Platform-Spoke einrichten

Integrieren Sie Ihr Adobe Experience PlatformAccount bei Ihrem ServiceNow Instanz. Erstellen Sie in eine anwenderdefinierte OAuth-Anwendung Adobe Experience PlatformUnd authentifizieren Sie Anforderungen von ServiceNow.

Vorbereitungen

• Anforderung IntegrationHub Abonnement
• Adobe Experience Platform-Spoke aktivieren
• Erforderliche Rolle: Administrator

Warum und wann dieser Vorgang ausgeführt wird

Die Adobe Experience Platform-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 Key Store-Zertifikat an den an Adobe Experience Platform-Spoke

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

Vorbereitungen

• Gültiges Java-Schlüsselspeicher-Zertifikat
• 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 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 Anhangssymbol ( ) Und hängen Sie ein JKS-Zertifikat an.
5. Klicken Sie Auf Validiert Speicher/Zertifikate .

Ergebnisse

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

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

Erstellen Sie einen JSON Web Token (JWT)-Signaturschlüssel, der Ihrem Java Keystore-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 an die vorherige 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 Ihrem einen JSON-Webtoken-Anbieter (JWT) hinzu ServiceNow Instanz.

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-Provider .
   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 „Standard-Ansprü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 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 zu hinzugefügt ServiceNow Instanz.

Registrieren Adobe Experience PlatformAls OAuth-Provider

Verwenden Sie die Informationen, die während der Erstellung und Konfiguration eines Adobe ID-Accounts generiert wurden, um sich zu registrieren Adobe Experience PlatformAls OAuth-Provider 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 Meldung an Welche Art von OAuth-Anwendung?
3. Wählen Sie Verbindung zu einem fremden OAuth-Provider herstellen aus.
   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 Adobe ID-Account-Konfiguration 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 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 Ein 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 die aus Umleitungs-URL .
   • Das System wird ausgefüllt OAuth-Entitätsprofil Mit Gewährungstyp Als 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-Provider-Datensatz für aus JWT-Anbieter , Beispiel: 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 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 Platform

Erstellen Sie Anmeldeinformationsdatensätze für den von Ihnen erstellten Adobe ID-Account. Die Adobe Experience Platform-SpokeAlias für Verbindungen und Anmeldeinformationen verwendet diese Anmeldeinformationen zum Autorisieren von Aktionen.

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 Meldung 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_ingestion 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 .
   Betrifft	Dieses Feld gilt nicht.
   Reihenfolge	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 Platform-SpokeWird erstellt.

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

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

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 die Batch-Erfassung und ein anderer für die Datensammlung. Führen Sie diese Schritte aus, um jeden Alias dem jeweiligen zuzuordnen Adobe Experience PlatformAPI.

Prozedur

1. Navigieren zu Alle > Verbindungen und Anmeldeinformationen > Aliasse für Verbindungen und Anmeldeinformationenan.
2. Öffnen Sie die erforderliche Adobe Experience Platform-SpokeDatensatz.
   Hinweis:

   Es gibt zwei Verbindungs- und Anmeldeinformationsdatensätze: AEP Und AEP_ingestion . Die AEP Datensatz ist für die Dateneingangsverwaltung und Batch-Erfassung, und AEP_ingestion 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.
   Anmeldeinformation	Anmeldeinformationsdatensatz, für den Sie erstellt haben Adobe Experience Platform. Wählen Sie beispielsweise aus AEP Und AEP_ingestion .
   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 Platform. 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 gilt nicht.
   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 Platform-SpokeIst eingerichtet und in integriert ServiceNow Instanz.