Intégration à DocuSign

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 6 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 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 Users. 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.

    Important :
    Minimisez les risques de sécurité et protégez les informations en n’accordant l’accès qu’aux utilisateurs ou aux autorisations d’API nécessaires.
    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 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 API provenant d’une intégration précédente prête à être utilisée en production, passez à l’étape 33.
      • Si vous n’avez pas sauvegardé votre secret client, 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. Dans 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 UN URI dans le champ URI de redirection de 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, 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 Postman App 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 Clé d’intégration de votre DocuSign compte démo créée à 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. Entrez 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 le 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é et la valeur d’autorisation 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 aux applications et aux 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 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

    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) auprès du 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 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 Tout > 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 2. 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 de 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 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 défini sur 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. Sélectionnez Soumettre.
    4. 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 .

    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 de logiciel.
    Remarque :
    Gestion des actifs logiciels Extrait les événements à partir du moment où vous commencez à télécharger les abonnements 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 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 de logiciel.

    Créez des autorisations logicielles pour les modèles logiciels générés automatiquement afin de suivre les logiciels utilisés par rapport aux logiciels possédés.
    Le rapprochement s’exécute également sur vos abonnements en tant que 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 dans la vue Utilisation de la licence (Software Asset Workspace). Utilisez ces résultats pour déterminer votre position de conformité de licence et pour remédier à toute non-conformité.