19.3 Configuration de votre environnement ServiceNow

Tout d'abord, vérifiez que vous êtes bien connecté à votre instance 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.

Vous verrez alors ceci. Cliquez sur Nouveau.

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)

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

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

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

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

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

Cliquez ensuite sur Valider les magasins/certificats.

Vous devriez alors voir le message Valid key_store.

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.

Vous verrez alors ceci. Cliquez sur Nouveau.

Vous verrez alors un formulaire vide.

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 :

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

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.

Vous verrez alors ceci. Cliquez sur Nouveau.

Vous verrez alors un formulaire vide.

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.

Vous verrez alors ceci.

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.

Vous verrez alors ceci. Dans la charge utile ​​JWT, vous trouverez les valeurs que vous devez entrer dans 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.

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

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

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

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.

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.

Vous verrez alors ceci. Cliquez sur Nouveau.

Cliquez sur Se connecter à un fournisseur OAuth tiers.

Vous verrez alors un formulaire vide.

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.

  

• 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.

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

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.

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

Vous verrez alors ceci.

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.

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.

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.

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.

Cliquez sur OAuth 2.0 Credentials.

Vous verrez alors un formulaire vide.

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.

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

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

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

AEP

Cliquez sur Nouveau.

Cliquez sur OAuth 2.0 Credentials.

Vous verrez alors un formulaire vide.

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.

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

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

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

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.

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

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

Vous verrez alors ceci.

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

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

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

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

Click the back button.

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

Vous serez alors de retour ici :

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

Vous verrez alors ceci.

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

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 :

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

Click the back button.

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

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