Configurer une instance pour l’intégration ServiceNow CPQ

Configurez une ServiceNow instance, générez un jeton Web JSON (JWT) et authentifiez les appels d’API vers Logik.ai.

Avant de commencer

Rôle requis : admin

Procédure

1. Validez que l’application CPQ Integration est installée sur votre ServiceNow instance en procédant comme suit
   1. Accédez à : https://<service_instance_url>/oauth_entity.do ?sys_id=3b119df83b566210a0c0989e53e45a15
   2. Vérifiez que le registre d’application de l’interface utilisateur de l’administrateur Logik.AI existe avec un ClientID et un secret.
      Ces informations sont utilisées ultérieurement.
2. Dans un répertoire de votre ordinateur local, créez les certificats privés et publics à l’aide d’OpenSSL, puis utilisez l’outil clé pour convertir le certificat du format PKCS au format JKS.
   1. Créez la clé privée en entrant : openssl genrsa -out private.key 2048
      La clé est créée dans un fichier nommé private.key.
   2. Créez un certificat auto-signé qui utilise la clé privée en saisissant : openssl req -new -x509 -key private.key -out publickey.cer -days 3650
      Vous êtes invité à saisir les informations qui sont incluses dans votre demande de certificat. Le certificat, nommé publickey.cer, contient la clé publique dérivée de la clé privée et des métadonnées, telles que l’objet et l’émetteur. Le certificat est signé numériquement à l’aide de la clé privée.
   3. Créez un fichier de magasin de clés PKCS#12 (un fichier .p12) en saisissant : openssl pkcs12 -export -in publickey.cer -inkey private.key -out keystore.p12 -name « <cert_name> »
      Ce fichier de magasin de clés regroupe le certificat signé et la clé privée et définit l’alias de l’entrée clé+certificat dans le magasin de clés. Le fichier est chiffré à l’aide d’un mot de passe (également appelé mot de passe d’exportation). Ce mot de passe est requis pour importer et exporter le certificat.
   4. Convertissez le fichier keystore .p12 (PKCS#12) au format .jks (Java KeyStore) en saisissant : keytool -importkeystore -srckeystore keystore.p12 -srcstoretype pkcs12 -destkeystore keystore.jks
      • Vous êtes invité à entrer le mot de passe d’exportation de l’étape 2c pour lire la clé privée et le certificat à partir du fichier .p12.
      • Vous êtes invité à saisir un nouveau mot de passe de magasin de clés pour protéger le fichier de magasin de clés JKS. Enregistrez et conservez ce mot de passe pour plus tard, car il est nécessaire pour configurer l’instance ServiceNow .
3. Dans l’instance ServiceNow , connectez-vous en tant qu’administrateur et procédez comme suit :
   1. Définissez l’intégration CPQ comme champ d’application actuel à l’aide de l’icône de menu de sélection du champ d’application dans le menu de navigation unifiée.
   2. Dans le filtre de navigation, entrez sys_properties.list et ouvrez la glide.security.file.mime_type.validation propriété système.
      Définissez la valeur sur faux, puis sélectionnez Soumettre.
   3. Accédez à https://<service_instance_url>/sys_certificate.do ?sys_id=90b3439e2beeea1001bff246f291bf4b et procédez comme suit :
      • Joignez le fichier keystore.jks créé à l’étape 2d à l’enregistrement de certificat. Saisissez le mot de passe du magasin de clés de l’étape 2d dans le champ Mot de passe du magasin de clés.
      • Sélectionnez Actif.
      • Enregistrez le certificat.
      • (Facultatif). Validez le certificat à l’aide du lien connexe pour le certificat K509.
   4. Accédez à https://<service_instance_url>/jwt_keystore_aliases.do ?sys_id=3ab40bde2beeea1001bff246f291bfc8.
      Saisissez le mot de passe de magasin de clés de l’étape 2d comme clé de signature et sauvegardez l’enregistrement.
   5. Dans le filtre de navigation, entrez sys_properties.list et ouvrez la glide.security.file.mime_type.validation propriété système.
      Définissez la valeur sur vrai, puis sélectionnez Soumettre.
4. Configurez l’authentification API en créant les rôles d’utilisateur d’intégration inclus avec les Gestion de la relation client pour les ventes applications :
   1. Créez un utilisateur d’intégration.
      • Accédez à la Tous > Sécurité de système > Utilisateurs et groupes > Utilisateurs.
      • Créez un nouvel utilisateur en sélectionnant Nouveau.
      • Saisissez l’ID utilisateur, le prénom et le nom de famille.
      • Sélectionnez Soumettre.
      • Ouvrez l’enregistrement utilisateur, puis dans l’onglet Rôle, sélectionnez Modifier.
      • Ajoutez les rôles suivants :
        • snc_internal
        • sn_sales_common.agent_de_vente
        • sn_csm_pricing. intégrateur_tarification
        • sn_prd_pm_adv.catalog_integrator
        • sn_quote_mgmt_core.quote_integrator
        • sn_ind_tmt_orm.intégrateur_commande
        • sn_opty_mgmt_core.opportunity_integrator
        • sn_sales_cart.cart_integrator
   2. Accédez à : https://<service_instance_url>/oauth_entity_list.do ?sysparm_query=sys_id=99a63a9e2baeea1001bff246f291bf57
5. Personnalisez la vue de liste pour ajouter la colonne Utilisateur de l’application OAuth .
   Utilisez l’icône Mettre à jour la liste personnalisée .
   1. Dans la vue de liste, double-cliquez sur le champ Utilisateur de l’application OAuth pour le modifier.
   2. Définissez l’utilisateur créé à l’étape 4a comme celui de l’enregistrement d’API Logik.ai.
      Si vous ne pouvez pas modifier ce champ, vérifiez que vous êtes dans le bon périmètre (intégration CPQ).
   3. Ouvrez cet enregistrement d’API Logik.ai.
   4. Sélectionnez Actif et enregistrez l’enregistrement.
   5. Passez au périmètre global.
   6. Créez une propriété système.
      • Dans le filtre de navigation, saisissez sys_properties.list.
      • Sélectionnez Nouveau.
      • Saisissez le nom de la propriété glide.oauth.inbound.client.credential.grant_type.enabled.
      • Sélectionnez les icônes de modification pour les rôles de lecture et d’écriture, puis sélectionnez administrateur pour chacun.
      • Définissez la valeur sur vrai.
      • Sélectionnez Mettre à jour.