Intégration avec DocuSign

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 2024
  • 6 minutes de lecture

    • Vous pouvez intégrer votre ServiceNow instance au DocuSign service pour suivre vos abonnements logiciels et récupérer les licences inutilisées.

    DocuSign Les achats effectués par l’intermédiaire de revendeurs ne sont pas pris en compte dans le DocuSign système de facturation standard. Par conséquent, aucune valeur n’est renvoyée via les API pour la consommation d’enveloppe disponible pour ServiceNow.

    Remarque :
    DocuSign a supprimé le champ lastLogin de l’API Utilisateurs. Les dernières activités des utilisateurs ne sont donc pas suivies dans le cadre de cette intégration.

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

    Enregistrer une DocuSign application

    Enregistrez une DocuSign application via le portail d’administration 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 d’API 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 gauche, 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. Sur le formulaire Ajouter une clé d’intégration, fournissez un nom dans le champ Nom de l’application et sélectionnezCRÉER UNE APPLICATION.
    7. Sélectionnez AJOUTER URI sous le champ URI de redirection dans la section Paramètres supplémentaires .
    8. Ajoutez 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 et 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 donnez un nom à la collection.
    14. Sélectionnez l’onglet Autorisation .
    15. Dans le menu Liste Type, 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 démo créé à l’étape 10.
      Secret client La clé secrète de votre DocuSign compte 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 GET en tant que https://account-d.docusign.com/oauth/userinfo.
    22. Dans 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 Envoyer et vérifiez que votre demande est terminée.
      L’ID de compte s’affiche dans le corps de la réponse.
    24. Dupliquez la demande GET.
      Copiez la clé d’autorisation et la valeur sous En-têtes.
    25. Mettez à jour l’URL dans le champ GET en tant que 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 un minimum de 20 appels d’API pour enregistrer votre application via le portail d’administration DocuSign .
    27. Accédez à Applications et Clés d’intégration sur le portail d’administration DocuSign .
    28. Sélectionner Actions > Afficher le tableau de bord de l’API à côté de votre application.
    29. Attendez quelques minutes pour DocuSign 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 demande est terminé. Vous pouvez promouvoir l’application vers votre compte de production.
    31. Sélectionner Actions > Revue Start-Go-Live 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 contenu de production.
    34. Sélectionnez votre image de profil.
    35. Sélectionnez Accéder à l’administrateur.
    36. Dans le volet gauche, 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. À côté de votre application, sélectionnez Actions > Modifier.
    38. Sélectionnez AJOUTER 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

    Créez un profil d’intégration 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 (com.sn_sam_saas_int) à partir de ServiceNow Store.

    ServiceNow Rôle requis : sam_integrator ou admin

    Pourquoi et quand exécuter cette tâche

    Si vous utilisez Software Asset Workspace, l’option permettant de créer le profil d’intégration dans l’interface DocuSign 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 Profil d’intégration DocuSign.
      Espace de travail des ressources logicielles
      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. Renseignez les champs du formulaire.
      Tableau 1. Formulaire Profil d’intégration
      Champ Valeur
      Nom d'affichage Nom du profil d’intégration. Par exemple, l’intégration DocuSign
      ID client ID client pour l’application OAuth créé à l’étape 10 dans le SaaS compte administrateur.
      URL de redirection URL du fournisseur OAuth vers lequel vous êtes redirigé après l’authentification. Cette valeur est automatiquement renseignée.
      ID de compte technique ID de compte API de votre DocuSign compte de production.
      URL d’instance URL de la page de connexion utilisée pour accéder à votre DocuSign compte de production. Ce champ est automatiquement https://account.docusign.com.
      Secret client Mot de passe associé à l’ID client créé à l’étape 39.
      Type de profil Type de profil d'intégration. Cette valeur est automatiquement définie sur Abonnement DocuSign.
    3. Cliquez sur Envoyer.
    4. Sur le profil d’intégration, sélectionnez Obtenir un jeton OAuth et suivez les étapes pour obtenir un jeton OAuth.

    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, consultez Réviser une règle de réclamation logicielle.
    Remarque :
    Gestion des actifs logiciels Extrait les événements à partir du moment où vous commencez à télécharger les abonnements des utilisateurs, 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 utilisateur, qui sont actualisés quotidiennement.

    Passez en revue toutes les règles de réclamation générées automatiquement pour récupérer les abonnements des utilisateurs. Pour plus d'informations, consultez Réviser une règle de réclamation logicielle.

    Créez des autorisations logicielles pour les modèles logiciels générés automatiquement afin de suivre le logiciel utilisé par rapport au logiciel possédé.
    Le rapprochement s’exécute également sur vos abonnements sous la forme d’une tâche planifiée ou à la demande. Vous pouvez afficher les résultats de votre rapprochement dans la console de licence (Gestion des actifs logiciels application classique) ou la vue Utilisation de la licence (Software Asset Workspace). Utilisez ces résultats pour déterminer votre position de conformité de licence et pour corriger toute non-conformité.