Intégrer Docusign au niveau du compte

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 8 minutes de lecture

    • L’intégration de Docusign votre Gestion des actifs logiciels application au service vous permet de suivre vos abonnements logiciels et de récupérer les licences inutilisées.

    Docusign Les achats effectués par l’intermédiaire de revendeurs ne sont pas reflétés dans le système de Docusign facturation standard. Ainsi, aucune valeur n’est renvoyée via les API pour la consommation d’enveloppe disponibles pour ServiceNow.

    Important :
    Docusign a supprimé le champ lastLogin de l’API Utilisateurs, de sorte que les dernières activités de l’utilisateur ne sont plus suivies dans le cadre de cette intégration. L’application Gestion des actifs logiciels crée maintenant des candidats à la réclamation en fonction de la date d’affectation de l’abonnement.

    Pour plus d’informations sur le Docusign service, consultez le site DocuSign Developer.

    Important :
    Minimisez les risques de sécurité et protégez les informations en accordant l’accès uniquement aux autorisations nécessaires de l’utilisateur ou de l’API.
    Tableau 1. Autorisations utilisateur minimales
    Processus Rôle d’utilisateur requis dans l’application Docusign Périmètres d’authentification
    Télécharger les abonnements administrateur Aucun champ d’application
    Récupérer l'abonnement administrateur Aucun champ d’application

    Enregistrer une Docusign application

    Enregistrez une Docusign application via le portail administrateur Docusign .

    Avant de commencer

    Docusign Rôle requis : admin

    Procédure

    1. Connectez-vous à votre Docusign compte de démonstration (non-production).
    2. Sélectionnez votre image de profil.
    3. Sélectionnez Mes applications et mes clés.
      • Si vous disposez déjà d’une clé d’intégration API provenant d’une intégration précédente prête à être utilisée en production, passez à l’étape 33.
      • Si votre secret client n’est pas enregistré, vous devez en générer un nouveau.
    4. Dans le volet latéral, sélectionnez INTÉGRATIONS > Applications et clés.
    5. Dans la section Applications et clés d’intégration , sélectionnez AJOUTER UNE APPLICATION ET UNE CLÉ D’INTÉGRATION.
    6. Dans le formulaire Ajouter une clé d’intégration, indiquez un nom dans le champ Nom de l’application et sélectionnezCRÉER UNE APPLICATION.
    7. Sélectionnez AJOUTER UN URI dans le champ URI de redirection dans la section Paramètres supplémentaires .
    8. Ajouter https://oauth.pstmn.io/v1/browser-callback.
    9. Sélectionnez à nouveau AJOUTER UN URI et ajoutez https:// instance ServiceNow.service-now.com/oauth_redirect.do.
    10. Sélectionnez AJOUTER UNE CLÉ SECRÈTE.
      Enregistrez la clé d’intégration (ID client) et la clé secrète (secret client) dans un emplacement sécurisé pour les utiliser ultérieurement dans l’application Postman, ainsi que la clé d’intégration (ID client) dans l’instance ServiceNow .
    11. Sélectionnez Enregistrer.
    12. Téléchargez la dernière version de l’application Postman et ignorez la connexion.
    13. Sélectionner Nouvelle collection et attribuez un nom à la collection.
    14. Sélectionnez l’onglet Autorisation .
    15. Dans le menu Liste de types, sélectionnez OAuth 2.0.
    16. Fournissez un nom et renseignez les champs de l’onglet Options de configuration pour créer un jeton :
      Champ Valeur
      URL de rappel https://oauth.pstmn.io/v1/browser-callback
      URL d'authentification https://account-d.docusign.com/oauth/auth
      URL du jeton d’accès https://account-d.docusign.com/oauth/token
      ID client La clé d’intégration de votre Docusign compte de démonstration créée à l’étape 10.
      Secret client La clé secrète de votre Docusign compte de démo, étape 10.
    17. Sélectionnez Obtenir un nouveau jeton d’accès.
      Vous êtes redirigé vers .Docusign
    18. Sélectionnez Accepter.
    19. Une fois le jeton d’accès collecté et l’authentification terminée, copiez le jeton d’accès pour l’utiliser ultérieurement.
    20. Sélectionnez Nouvelle demande pour créer une demande GET pour votre ID de compte.
    21. Saisissez l’URL dans le champ OBTENIR sous la forme d’https://account-d.docusign.com/oauth/userinfo.
    22. Sous l’onglet En-têtes, sélectionnez Autorisation sous CLÉ et saisissez Porteur <jeton d’accès que vous avez copié lors de l’authentification> sous Valeur.
    23. Sélectionnez Send (Envoyer) et vérifiez que votre demande est terminée.
      L’ID de compte est affiché dans le corps de la réponse.
    24. Dupliquez la demande GET.
      Copiez la clé et la valeur d’autorisation sous En-têtes.
    25. Mettez à jour l’URL dans le champ OBTENIR sur https://demo.docusign.net/restapi/v2/accounts/<account-id>/users.
      Ici, account-id est l’ID que vous avez enregistré à partir de la demande précédente.
    26. Sélectionnez Envoyer 20 fois pour effectuer 20 appels d’API.
      Vous devez appeler au minimum 20 appels d’API pour enregistrer votre application via le Docusign portail administrateur.
    27. Accédez aux applications et aux clés d’intégration sur le portail de l’administrateur Docusign .
    28. Sélectionner Actions > Afficher le tableau de bord de l’API à côté de votre application.
    29. Attendez quelques minutes Docusign pour enregistrer les 20 appels d’API.
    30. Accédez à la INTÉGRATIONS > Applications et clés et sélectionnez Soumettre pour révision.
      Après 5 à 20 minutes, l’examen de votre application est terminé. Vous pouvez promouvoir l’application auprès de votre compte de production.
    31. Sélectionner Actions > Start-Go- Révision en direct pour promouvoir l’application auprès du compte de production.
    32. Sélectionnez un compte de production éligible pour gérer la clé d’intégration.
    33. Connectez-vous à votre Docusign compte de production.
    34. Sélectionnez votre image de profil.
    35. Sélectionnez Accéder à l’administrateur.
    36. Dans le volet latéral, sélectionnez INTÉGRATIONS > Applications et clés.
      Localisez votre ID de compte API à utiliser pour le profil d’intégration dans votre ServiceNow instance.
    37. En regard de votre application, sélectionnez Actions > Modifier.
    38. Sélectionnez AJOUTER UN URI et ajoutez https:// instance ServiceNow.service-now.com/oauth_redirect.do.
    39. Sélectionnez AJOUTER UNE CLÉ SECRÈTE.
      Enregistrez la clé secrète (secret client) de votre compte de production dans un emplacement sécurisé pour l’utiliser dans votre ServiceNow instance.
    40. Sélectionnez Enregistrer.

    Créer un profil d’intégration Docusign au niveau du compte

    Créez un profil d’intégration Docusign au niveau du compte pour suivre les abonnements logiciels et optimiser la gestion des licences pour le Docusign service.

    Avant de commencer

    Pour créer un profil d’intégration Docusign , demandez le module d’extension Gestion des actifs logiciels - Gestion des licences SaaS (sn_sam_saas_int) auprès de ServiceNow Store.

    ServiceNow Rôle requis : sam_integrator

    Pourquoi et quand exécuter cette tâche

    Si vous utilisez Espace de travail des actifs logiciels, l’option permettant de créer le profil d’intégration Docusign dans Interface utilisateur principale est inactive.

    Procédure

    1. Accédez au profil d’intégration.
      InterfaceAction
      Interface utilisateur principale
      1. Accédez à la Tous > Actifs Logiciels > Licence SaaS > Profils d'intégration directe.
      2. Sélectionnez Nouveau.
      3. Sélectionnez le profil d’intégration DocuSign.
      Espace de travail actifs logiciels
      1. Accédez à la Opérations de licence > Abonnements de l'utilisateur > Profils d'intégration directe.
      2. Sélectionnez Nouveau.
      3. Sélectionnez DocuSign dans la liste déroulante.
      4. Sélectionnez Continuer.
    2. Remplissez les champs du formulaire.
      Tableau 2. Formulaire Profil d’intégration
      Champ Description
      Nom d'affichage Nom du profil d’intégration. Par exemple, l’intégration DocuSign
      Type d'intégration La valeur par défaut est définie sur Niveau du compte.
      ID client ID client pour l’application OAuth créé dans le SaaS compte administrateur de la Enregistrer une Docusign application procédure.
      URL de redirection URL du fournisseur OAuth vers lequel vous êtes redirigé après authentification. Cette valeur est automatiquement renseignée.
      ID de compte technique ID de compte API de votre Docusign compte de production.
      URL de l'instance URL de la page de connexion utilisée pour accéder à votre Docusign compte de production. Ce champ est automatiquement défini sur https://account.docusign.com.
      Secret client Mot de passe associé à l’ID client créé dans la Enregistrer une Docusign application procédure.
      Type de profil Type de profil d'intégration. Cette valeur est automatiquement définie sur l’abonnement DocuSign.
    3. Examinez les rôles d’utilisateur requis ou les autorisations d’API spécifiés dans le champ de configuration du fournisseur pour chaque processus afin de minimiser les risques de sécurité et d’optimiser SaaS les licences.
      Remarque :
      Pour plus d’informations sur les rôles et les champs d’application requis, consultez la table Autorisations utilisateur minimales .

      • La case Télécharger les abonnements est cochée par défaut et vous ne pouvez pas la décocher.

      • La case Récupérer les abonnements est cochée par défaut. Si vous ne souhaitez pas récupérer les abonnements, vous pouvez décocher cette case. Si vous l’effacez, les candidats à la suppression sont créés, mais le flux secondaire d’abonnement à la récupération n’est pas déclenché ou le processus de réclamation n’est pas lancé.

    4. Sélectionnez Envoyer.
      Une ébauche de profil d’intégration est créée.
    5. Sur le profil d’intégration, sélectionnez Obtenir un jeton OAuth et suivez les étapes pour obtenir un jeton OAuth.
      Remarque :
      Pour connaître le rôle requis pour effectuer cette étape, consultez la table Autorisations utilisateur minimales .
    6. Sur le formulaire de profil d’intégration, sélectionnez Valider la connexion pour vérifier les détails de connexion et d’informations d’identification de cette intégration.

      La validation de la connexion vérifie les API Télécharger les abonnements, mais pas les API Récupérer les abonnements.

    Résultats

    Vous pouvez afficher les événements effectués par des utilisateurs individuels jusqu’à un an avant la date actuelle. Pour plus d’informations, reportez-vous à la section Examiner une règle de réclamation de logiciel. Gestion des actifs logiciels extrait les événements à partir du moment où vous commencez à télécharger les abonnements de l’utilisateur, quelle que soit la date de création du profil.

    Que faire ensuite

    Une fois l’intégration connectée, votre ServiceNow instance crée automatiquement des modèles logiciels, des règles de réclamation et des abonnements logiciels qui sont actualisés quotidiennement.

    Après avoir créé un profil d’intégration, affichez les informations relatives au profil dans le Espace de travail des actifs logiciels en accédant à Opérations de licence > Abonnement de l'utilisateur > Profils d'intégration directe. Vous pouvez sélectionner un profil d’intégration pour afficher les listes connexes suivantes. Si toutes les listes connexes suivantes ne sont pas visibles pour un profil d’intégration dans la vue par défaut, vous pouvez sélectionner la vue d’intégration personnalisée dans l’onglet Détails :
    • Modèles logiciels
    • Identificateurs d'abonnement non reconnus
    • Travaux planifiés
    • Résultats de la tâche planifiée
    • Abonnements logiciels
    • Règle d'exclusion de l'identificateur d'abonnement
    • Règle d'exclusion de l'utilisateur de l'abonnement

    Après avoir créé un profil d’intégration, vous pouvez définir des règles d’exclusion des abonnements afin d’exclure certains abonnements du calcul des coûts de licence. Pour plus d'informations, consultez Exclusions d’abonnements pour SaaS les applications SSO et.

    Si vous souhaitez configurer plusieurs profils d’intégration avec des connexions uniques, créez des alias enfants pour gérer différentes configurations et paramètres pour chaque profil d’intégration. Pour plus d'informations, consultez Créez un alias enfant pour configurer plusieurs profils d’intégration.

    Passez en revue toutes les règles de réclamation générées automatiquement pour récupérer les abonnements utilisateur. Pour plus d'informations, consultez Examiner une règle de réclamation de logiciel.

    Créez des autorisations d’utilisation du logiciel pour les modèles logiciels générés automatiquement afin de comparer les logiciels utilisés aux logiciels possédés.
    Le rapprochement s’exécute également sur vos abonnements en tant que tâche planifiée ou sur demande. Vous pouvez afficher les résultats de votre rapprochement dans la console de licence (Gestion des actifs logiciels application classique) ou dans la vue Utilisation de la licence (Software Asset Workspace). Utilisez ces résultats pour déterminer votre position en matière de conformité de licence et corriger toute non-conformité.