19.3 Configuration de votre environnement ServiceNow

REMARQUE

Les étapes de mise en oeuvre ci-dessous sont inspirées de la documentation disponible sur le portail ServiceNow. Vous pouvez trouver cette documentation ici. Toutefois, suivez plutôt les étapes ci-dessous.

Tout d'abord, vérifiez que vous êtes bien connecté à votre instance ServiceNow.

ServiceNow

19.3.1 Certificats

Dans cette étape, vous devez joindre un Key Store Java valide. Vous avez créé ce Key Store Java dans l’exercice précédent, le nom du fichier Java Key Store que vous avez créé est aep.jks.

Dans ServiceNow, dans le navigateur de filtres, entrez le terme de recherche Certificats. Cliquez sur Certificats sous Définition du système.

ServiceNow

Vous verrez alors ceci. Cliquez sur Nouveau.

ServiceNow

Vous verrez alors un formulaire vide. Renseignez les champs de formulaire comme suit :

  • Nom : Certificat AEP
  • Format : PEM
  • Type : ouvrez la liste déroulante et sélectionnez Java Key Store.

(pour les autres champs, conservez la sélection par défaut)

ServiceNow

Après avoir sélectionné le Key Store ​Java, vous verrez ceci. Click the attachment icon in the top right side of your screen.

ServiceNow

Dans la fenêtre contextuelle, cliquez sur Choisir un fichier.

ServiceNow

Dans la fenêtre contextuelle, accédez au dossier JKS sur votre bureau et sélectionnez le fichier aep.jks. Cliquez sur Ouvrir.

ServiceNow

Vous verrez alors ceci, cliquez sur le X pour fermer la fenêtre contextuelle.

ServiceNow

Ensuite, saisissez le mot de passe du Key Store Java dans le champ Key Store Password.

ServiceNow

Cliquez ensuite sur Valider les magasins/certificats.

ServiceNow

Vous devriez alors voir le message Valid key_store.

ServiceNow

Le certificat du magasin de clés Java est maintenant attaché à votre instance ServiceNow.

19.3.2 Clés JWT

Vous allez maintenant créer une clé de signature JSON Web Token (JWT) à affecter à votre certificat Java Key Store.

Dans ServiceNow, dans le Navigateur de filtres, entrez le terme de recherche Clés ​JWT. Cliquez sur Clés ​JWT.

ServiceNow

Vous verrez alors ceci. Cliquez sur Nouveau.

ServiceNow

Vous verrez alors un formulaire vide.

ServiceNow

Renseignez les champs de formulaire comme suit :

  • Nom : Clés JWT AEP
  • Fichier de stockage des clés de signature : sélectionnez le certificat que vous avez joint à l’étape précédente, nommé Certificat AEP.
  • Mot de passe de la clé de signature : saisissez le mot de passe Java Key Store que vous avez saisi lors de la création du Key Store Java dans l’exercice 19.2.

(pour les autres champs, conservez la sélection par défaut)

Vous devriez maintenant avoir ceci :

ServiceNow

Cliquez sur Envoyer. Vous serez redirigé vers la présentation des clés ​JWT.

ServiceNow

Votre clé JWT est créée et affectée à votre certificat JKS.

19.3.3 Fournisseurs JWT

Vous allez maintenant ajouter un fournisseur JSON Web Token (JWT) à votre instance ServiceNow.

Dans ServiceNow, dans le Navigateur de filtres, saisissez le terme de recherche Fournisseurs ​JWT. Cliquez sur Fournisseurs ​JWT.

ServiceNow

Vous verrez alors ceci. Cliquez sur Nouveau.

ServiceNow

Vous verrez alors un formulaire vide.

ServiceNow

Renseignez les champs de formulaire comme suit :

  • Nom : Fournisseur JWT AEP
  • Configuration de la signature : sélectionnez la clé JWT que vous avez créée à l’étape précédente, qui s’appelait AEP JWT Keys.

(pour les autres champs, conservez la sélection par défaut)

Ensuite, cliquez avec le bouton droit sur l’en-tête du formulaire comme indiqué dans la capture d’écran. Cliquez sur Enregistrer.

ServiceNow

Vous verrez alors ceci.

ServiceNow

Vous devez maintenant mettre à jour les valeurs pour iss, sub et aud. Vous pouvez les trouver dans votre projet Adobe I/O.

Accédez à votre projet Adobe I/O, qui doit toujours être ouvert dans un autre onglet de navigateur, puis cliquez sur Générer JWT.

ServiceNow

Vous verrez alors ceci. Dans la charge utile ​JWT, vous trouverez les valeurs que vous devez entrer dans ServiceNow.

ServiceNow

Entrez ces valeurs dans l’écran Fournisseur JWT ServiceNow, comme indiqué ci-dessous.

  • aud : https://ims-na1.adobelogin.com/c/f2bea01fc9414913bae8e0564e6c81cd (cette URL est utilisée pour s’authentifier auprès d’Adobe I/O et fait référence à votre ID de client)

  • iss : A71C5A0C536804740A490D44@AdobeOrg (il s’agit de votre ID d’organisation IMS)

  • sub : CF2377955F96EBC90A495E88@techacct.adobe.com (ID du compte technique de votre projet Adobe I/O)

Vous devriez maintenant avoir ceci.

ServiceNow

Ensuite, cliquez avec le bouton droit sur l’en-tête du formulaire comme indiqué dans la capture d’écran. Cliquez sur Enregistrer.

ServiceNow

Après l’enregistrement, cliquez sur Demandes ​personnalisées comme indiqué dans la capture d’écran ci-dessus. Vous verrez alors ceci.

ServiceNow

Cliquez doublon dans chaque colonne de la ligne contenant le texte Insérer une nouvelle ligne….

ServiceNow

Saisissez les valeurs suivantes :

  • Nom de la demande : https://ims-na1.adobelogin.com/s/ent_dataservices_sdk
  • Type de valeur de revendication : true|false
  • Valeur de revendication : true

Vous devriez maintenant avoir ceci. Click Update to save your changes.

ServiceNow

Le fournisseur JWT est ajouté à votre instance ServiceNow.

19.3.4 Fournisseur OAuth

Vous allez maintenant enregistrer Adobe Experience Platform en tant que fournisseur OAuth et autoriser l’instance à demander des jetons OAuth 2.0.

Dans ServiceNow, dans le navigateur de filtres, entrez le terme de recherche Registre ​d'applications. Cliquez sur Registre ​des applications.

ServiceNow

Vous verrez alors ceci. Cliquez sur Nouveau.

ServiceNow

Cliquez sur Se connecter à un fournisseur OAuth tiers.

ServiceNow

Vous verrez alors un formulaire vide.

ServiceNow

Renseignez les champs de formulaire comme suit :

  • Nom : entrer OAuth AEP

  • ID client : copier/coller l’ID ​client depuis votre projet Adobe I/O

  • Secret client : copier/coller la clé secrète ​client à partir de votre projet Adobe I/O

    FYI : Vous trouverez votre ID de client et votre clé secrète client ici, dans votre projet Adobe I/O.

    ServiceNow

  • Script de l'API OAuth : sélectionner OAuthUtilAEP

  • Type de subvention par défaut : sélectionner JWT Bearer

  • URL du jeton : saisissez https://ims-na1.adobelogin.com/ims/exchange/jwt/ (FYI) pour modifier l’URL du jeton, vous devez d’abord déverrouiller l’URL du jeton de champ en cliquant sur l’icône de verrouillage située sur le côté droit du champ, comme indiqué dans la capture d’écran ci-dessus.

  • Envoyer les informations d'identification : Dans le corps de la requête (encodé dans l’URL du formulaire)

(pour les autres champs, conservez la sélection par défaut)

Vous devriez maintenant avoir ceci.

ServiceNow

Ensuite, cliquez avec le bouton droit sur l’en-tête du formulaire comme indiqué dans la capture d’écran. Cliquez sur Enregistrer.

ServiceNow

Après avoir cliqué sur Enregistrer, le message d’erreur suivant s’affiche :

Les enregistrements du fournisseur JWT de votre configuration sont absents dans un ou plusieurs profils d'entité : AEP OAuth default_profil. Un enregistrement de fournisseur JWT doit être mappé à l’enregistrement de profil d’entité lorsque le type d’octroi est JWT Bearer.

C'est normal, et vous allez mettre à jour la configuration maintenant pour corriger ça.

ServiceNow

Faites défiler la page vers le bas et cliquez sur le champ AEP OAuth default_profil comme indiqué ci-dessous.

ServiceNow

Vous verrez alors ceci.

ServiceNow

Dans le champ Fournisseur ​JWT, sélectionnez le Fournisseur JWT que vous avez créé précédemment, qui est nommé Fournisseur JWT AEP. Cliquez ensuite sur Mettre à jour.

ServiceNow

Après avoir cliqué sur Mettre à jour, vous reviendrez sur l’écran Fournisseur OAuth et le message d’erreur qui s’y trouvait n’est plus. Click Update to save your changes.

ServiceNow

Votre instance ServiceNow peut désormais demander des jetons OAuth 2.0 pour l’orateur.

19.3.5 Dossiers d’identification

Dans ServiceNow, dans le navigateur de filtres, entrez le terme de recherche Informations d’identification. Cliquez sur Informations d’identification.

ServiceNow

Vous verrez alors ceci. Vous devez maintenant créer deux enregistrements d’informations d’identification, l’un pour Data Inlet et l’autre pour Data Ingestion.

AEP_Ingestion

Cliquez sur Nouveau.

ServiceNow

Cliquez sur OAuth 2.0 Credentials.

ServiceNow

Vous verrez alors un formulaire vide.

ServiceNow

Renseignez les champs de formulaire comme suit :

  • Nom : AEP_Ingestion
  • Profil d'entité OAuth : sélectionner AEP OAuth default_profil

(pour les autres champs, conservez la sélection par défaut)

Vous devriez maintenant avoir ceci.

ServiceNow

Ensuite, cliquez avec le bouton droit sur l’en-tête du formulaire comme indiqué dans la capture d’écran. Cliquez sur Enregistrer.

ServiceNow

Vous verrez alors ceci. Le message d’erreur est attendu. Pour afficher le message d’erreur, cliquez sur Obtenir le jeton OAuth.

ServiceNow

Vous verrez alors cette fenêtre contextuelle qui doit permettre au flux de jeton OAuth de message d’être terminé avec succès.

ServiceNow

AEP

Cliquez sur Nouveau.

ServiceNow

Cliquez sur OAuth 2.0 Credentials.

ServiceNow

Vous verrez alors un formulaire vide.

ServiceNow

Renseignez les champs de formulaire comme suit :

  • Nom : AEP
  • Profil d'entité OAuth : sélectionner AEP OAuth default_profil

(pour les autres champs, conservez la sélection par défaut)

Vous devriez maintenant avoir ceci.

ServiceNow

Ensuite, cliquez avec le bouton droit sur l’en-tête du formulaire comme indiqué dans la capture d’écran. Cliquez sur Enregistrer.

ServiceNow

Vous verrez alors ceci. Le message d’erreur est attendu. Pour corriger le message d’erreur, cliquez sur Obtenir le jeton OAuth.

ServiceNow

Vous verrez alors cette fenêtre contextuelle qui doit permettre au flux de jeton OAuth de message d’être terminé avec succès.

ServiceNow

Les enregistrements d’informations d’identification pour l’appel Adobe Experience Platform sont maintenant créés dans votre instance ServiceNow et ServiceNow est désormais capable de s’authentifier auprès de Adobe I/O et peut désormais interagir avec Adobe Experience Platform.

19.3.6 Enregistrements de connexion

Dans ServiceNow, dans le navigateur de filtres, saisissez le terme de recherche Connection & Credential Aliases. Cliquez sur Alias ​de connexion et d’identification.

ServiceNow

Vous verrez alors ceci. Vous verrez déjà deux enregistrements de connexion existants, AEP et AEP_Ingestion.

ServiceNow

Ensuite, ouvrez l'enregistrement de connexion nommé AEP en cliquant dessus.

Vous verrez alors ceci.

ServiceNow

Dans l’onglet Connexions , cliquez sur Nouveau. Vous verrez alors un formulaire de connexion ​HTTP(s) vide.

ServiceNow

Renseignez les champs de formulaire comme suit :

  • Nom : Plateforme AEP
  • Informations d’identification : sélectionner AEP
  • URL de connexion : saisissez https://platform.adobe.io/
  • Attributes Sandbox : entrez le nom de votre Adobe Experience Platform (n’entrez pas l’identifiant de votre sandbox). Votre sandbox est --aepSandboxId--là.
  • Clé d'API d'attributs : collez la clé API de votre intégration Adobe I/O, dans ce cas : f2bea01fc9414913bae8e0564e6c81cd
  • Attributs ID d'organisation : saisissez l’ID d’organisation IMS de votre instance Adobe Experience Platform, dans l’exemple suivant : A71C5A0C536804740A490D44@AdobeOrg
REMARQUE

Pour le champ URL de connexion, vous devrez peut-être indiquer une autre valeur si votre instance Adobe Experience Platform est hébergée dans un centre de données spécifique. Si votre instance est hébergée dans le centre de données des Pays-Bas, l’URL de connexion doit être définie sur https://platform-nld2.adobe.io/. Si votre instance est hébergée dans le centre de données en Australie, l’URL de connexion doit être définie sur https://platform-aus5.adobe.io/.

Votre formulaire de connexion HTTP doit maintenant se présenter comme suit :

ServiceNow

Cliquez avec le bouton droit sur l’en-tête du formulaire, puis cliquez sur Enregistrer.

ServiceNow

Click the back button.

ServiceNow

Vous verrez ensuite que votre connexion HTTP est ajoutée au formulaire Connexion. Click the back button.

ServiceNow

Vous serez alors de retour ici :

ServiceNow

Ensuite, ouvrez l'enregistrement de connexion nommé AEP_Ingestion en cliquant dessus.

Vous verrez alors ceci.

ServiceNow

Dans l’onglet Connexions , cliquez sur Nouveau. Vous verrez alors un formulaire de connexion ​HTTP(s) vide.

ServiceNow

Renseignez les champs de formulaire comme suit :

  • Nom : AEP dcs
  • Informations d’identification : select AEP_Ingestion
  • URL de connexion : saisissez https://dcs.adobedc.net
  • Attributes Sandbox : entrez le nom de votre Adobe Experience Platform (n’entrez pas l’identifiant de votre sandbox). Votre sandbox est --aepSandboxId--là.
  • Attributs ID d'organisation : saisissez l’ID d’organisation IMS de votre instance Adobe Experience Platform, dans l’exemple suivant : A71C5A0C536804740A490D44@AdobeOrg

Votre formulaire de connexion HTTP doit maintenant se présenter comme suit :

ServiceNow

Cliquez avec le bouton droit sur l’en-tête du formulaire, puis cliquez sur Enregistrer.

ServiceNow

Click the back button.

ServiceNow

Vous verrez ensuite que votre connexion HTTP est ajoutée au formulaire Connexion. Click the back button.

ServiceNow

Vous avez maintenant terminé la configuration de l’intégration entre Adobe Experience Platform et ServiceNow.

Étape suivante : 19.4 Configuration de l’interface utilisateur ServiceNow

Revenir au module 19

Revenir à tous les modules

Sur cette page