Intégration à DocuSign

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 7 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.

    Remarque :
    DocuSign a supprimé le champ lastLogin de l’API Utilisateurs. Ainsi, les dernières activités des utilisateurs ne sont 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 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 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 photo 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 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 UN URI sous 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 (clé secrète 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 fournir 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éé à l’étape 10.
      Secret client La clé secrète de votre DocuSign compte de démonstration é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 sous la forme https://account-d.docusign.com/oauth/userinfo.
    22. Sous l’onglet En-têtes, sélectionnez Autorisation sous CLÉ et saisissez Support <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 invoquer 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 sur votre compte de production.
    31. Sélectionner Actions > Start-Go- Revue 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 contenu de production.
    34. Sélectionnez votre photo de profil.
    35. Sélectionnez Accéder à l’administrateur.
    36. Dans le volet gauche, sélectionnez INTÉGRATIONS > Applications et clés.
      Localisez l’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

    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, demandez le module d’extension DocuSignGestion des actifs logiciels - Gestion des licences SaaS (sn_sam_saas_int) auprès 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 de création du 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 le 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, Intégration DocuSign
      ID client ID client de l’application OAuth créée à 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 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éé à l’étape 39.
      Type de profil Type de profil d'intégration. Cette valeur est automatiquement définie sur 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 Table des autorisations utilisateur minimales .

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

      • 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 de récupération n’est pas déclenché ou le processus de réclamation n’est pas initié.

    4. Sélectionnez Soumettre.
      Votre ServiceNow instance crée une ébauche de profil d’intégration.
    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 de téléchargement d’abonnements, mais pas les API de récupération d’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 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.

    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éer 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 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 vos résultats de 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é.