Configurer un DocuSign spoke à l’aide de l’octroi de code d’autorisation

Intégrez l’instance et DocuSign le ServiceNow spoke à l’aide du code d’autorisation pour authentifier les ServiceNow demandes.

Avant de commencer

• Demandez un Hub d'intégration abonnement.
• Activer le spoke DocuSign .
• Rôle requis : admin

Important :

Si vous configurez un spoke DocuSign à l’aide de l’octroi de code d’autorisation, vous n’avez pas besoin de configurer le spoke à l’aide de l’autorisation JWT.

Configurer le compte DocuSign

Configurez une application OAuth personnalisée à partir de votre compte DocuSign pour activer l’authentification avec le spoke DocuSign.

Pourquoi et quand exécuter cette tâche

Effectuez ces étapes à partir de votre compte DocuSign. Consultez la documentation du Centre de développement DocuSign pour obtenir des instructions sur la création et la configuration d’applications personnalisées. DocuSign utilise un webhook scripté pour envoyer des données de document signé à l’instance ServiceNow . Cela permet aux concepteurs de flux de mettre en pause un flux jusqu’à ce qu’un document soit signé et d’utiliser les données des documents dans le flux.

Avant de commencer

Conditions requises pour DocuSign :

• Compte DocuSign
• Application DocuSign configurée pour s’intégrer à ServiceNow
• Rôle requis : administrateur DocuSign

Procédure

1. Connectez-vous au compte DocuSign en tant qu’administrateur.
2. Depuis votre compte DocuSign, enregistrez votre application.
   Remarque :

   Assurez-vous de sélectionner l’option Accorder le code d’autorisation pour l’application utilisateur.
3. Générez une clé d’intégrateur et une clé secrète.
4. Enregistrez les valeurs de clé d’intégration et de clé secrète pour inscrire l’application en tant que fournisseur OAuth tiers sur votre ServiceNow instance.
   Vous avez besoin de ces valeurs lorsque vous Configurer la connexion pour le spoke DocuSign.
5. Ajoutez l’URL de ServiceNow redirection OAuth dans votre compte DocuSign.
   1. Accédez à la Intégrations > Application et clés.
   2. Sous Applications et clés d’intégration, recherchez l’application requise.
   3. Pour l’application requise, cliquez sur la liste déroulante Actions , puis sur Modifier.
   4. Sous Paramètres supplémentaires, cliquez sur Ajouter un URI et ajoutez le point de terminaison de rappel OAuth au format suivant : https://<instance>.service-now.com/oauth_redirect.do.
      
6. Obtenez la valeur de l’URI de base de compte à partir du compte DocuSign.
   1. Accédez à la Intégrations > Application et clés.
   2. Sous Informations sur mon compte, vous pouvez trouver la valeur de l’URI de base du compte.
      
   3. Copiez et enregistrez cette valeur pour une utilisation ultérieure.

Configurer la connexion pour le spoke DocuSign

Intégrez l’instance ServiceNow et l’instance de compte DocuSign à l’aide de l’attribution du code d’autorisation pour authentifier les demandes ServiceNow.

Avant de commencer

Rôle requis : admin

Procédure

1. Accédez à la Tout > Concepteur de flux.
2. Cliquez sur l’onglet Connexions .
3. Saisissez DocuSign dans le champ Rechercher toutes les connexions.
4. Localisez l’alias de DocuSign et cliquez sur Afficher les détails.
   Remarque :

   Ne cliquez pas sur Ajouter une connexion.

   
5. Si vous configurez le spoke pour la première fois, cliquez sur Configurer.
   
6. Renseignez les champs du formulaire Configurer la connexion.

   Tableau 1. Formulaire Configurer la connexion

   Champ	Description
   Nom de la connexion	Nom unique pour identifier la connexion.
   URL de connexion	URI de base de compte pour la connexion à l’environnement DocuSign. Cette valeur peut être obtenue à partir de votre compte DocuSign. Pour plus d'informations, reportez-vous à la section Configurer le compte DocuSign.
   Version d'API	Version de l’API DocuSign. La valeur par défaut est v2.1.
   URL d'autorisation	URL d’autorisation DocuSign. Pour Developer Sandbox Environment (Environnement sandbox pour développeurs), saisissez https://account-d.docusign.com/oauth/auth. Pour Live Production System (Système de production en direct), saisissez https://account.docusign.com/oauth/auth.
   URL de jeton	URL à partir de laquelle l’instance ServiceNow obtient le jeton d’accès. Pour Developer Sandbox Environment (Environnement sandbox pour développeurs), saisissez https://account-d.docusign.com/oauth/token. Pour Live Production System (Système de production en direct), saisissez https://account.docusign.com/oauth/token. Pour plus d’informations, consultez Référence du point de terminaisonPost Go-Live and User Info (Publier la mise en service et les informations utilisateur) dans la documentation du Centre de développement DocuSign.
   ID client OAuth	Clé d’intégrateur de votre compte DocuSign.
   Secret client OAuth	Clé secrète (secret client) de votre compte DocuSign.
   URL de redirection OAuth	Point de terminaison de rappel OAuth au format suivant : https://<instance>.service-now.com/oauth_redirect.do. Remarque : Assurez-vous d’ajouter cette URL à votre compte DocuSign. Pour plus d'informations, reportez-vous à la section Configurer le compte DocuSign.

   

7. Cliquez sur Configurer et obtenir le jeton OAuth.