Intégrer Docusign à au niveau de l’organisation

L’intégration de Docusign votre Gestion des actifs logiciels application au service au niveau de l’organisation vous permet de suivre vos abonnements logiciels et les données de consommation d’enveloppe.

Remarque :

L’intégration Docusign au niveau de l’organisation est effectuée à l’aide de l’API de flux de données, de sorte que les dernières activités de l’utilisateur 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
Télécharger la consommation	administrateur	Aucun champ d’application

Ce processus s’applique aux Zurich patchs 4 - Gestion des actifs logicielsGestion des licences SaaS (sn_sam_saas_int) 16.0.8 et Gestion des actifs logiciels (sn_itam_samp) 2.1.0 à partir de la version.

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).
   Vous pouvez utiliser n’importe quel sous-compte pour vous connecter qui est ensuite promu au compte de production correspondant.
2. Accédez à l’onglet Administrateur.
   • 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 15.
   • Si votre clé d’intégration API n’est pas enregistrée, vous devez en générer une nouvelle.
3. Dans le volet de navigation latéral, sélectionnez Profil du compte et copiez l’ID d’organisation pour le sécuriser en vue d’une utilisation ultérieure.
4. Accédez à la 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, saisissez un nom unique pour votre application dans le champ Nom de l’application et sélectionnez CRÉER UNE APPLICATION.
7. Sur la page de profil de votre application, sélectionnez Clé d’intégration tierce dans le champ Type d’intégration .
8. Copiez la valeur de la clé d’intégration et sécurisez-la pour une utilisation ultérieure.
   Important :

   Vous devez demander à l’équipe d’assistance Docusign d’activer l’API de flux de données sur la clé d’intégration que vous générez. Si vous utilisez un plan Enterprise Pro, l’API de flux de données est gratuite pour vous avec la gestion de l’organisation. Si vous utilisez un plan de niveau inférieur, vous pouvez opter pour Gestion des organisations en tant que module complémentaire. Pour plus d’informations, contactez l’équipe d’assistance Docusign .
9. Sélectionnez Enregistrer.
10. Dans la section Applications et clés d’intégration , recherchez l’application que vous venez de créer dans la liste Nom de l’application.
11. Sélectionner Actions > Sélectionner un compte de mise en service.
    Une Docusign fenêtre de connexion s’affiche vous invitant à saisir les informations d’identification de votre Docusign compte.
12. Entrez vos Docusign informations d’identification.
13. Sélectionnez un compte de production dans la fenêtre qui s’affiche et vous invite à choisir un compte de production auprès duquel vous souhaitez promouvoir votre clé d’intégration.
    Le champ État de mise en service indique En attente d’approbation. Pour une vérification réussie de la mise en service, votre application doit répondre aux exigences de mise en service pour chaque API qu’elle utilise. Pour en savoir plus sur les étapes d’examen de la mise en service, consultez la rubrique Docusign documentation.
14. Une fois l’intégration approuvée, l’état de mise en service passe à Afficher en production.
15. Connectez-vous à votre Docusign compte de production et vérifiez que la même clé d’intégration a été promue au compte de production.

Générer une paire de clés RSA pour Docusign l’intégration

Générez des clés RSA pour intégrer l’application Docusign à votre ServiceNow instance.

Avant de commencer

Docusign Conditions requises :

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

Pourquoi et quand exécuter cette tâche

L’intégration au niveau de l’organisation Docusign permet d’accéder à tous les sous-comptes à l’aide d’une clé d’intégration unique générée dans un sous-compte.

Procédure

1. Connectez-vous à votre Docusign compte de contenu de production.
2. Accédez à l’onglet Administrateur.
3. Accédez à la INTÉGRATIONS > Applications et clés.
4. En regard de votre application, sélectionnez Actions > Modifier.
5. Sélectionnez Générer RSA et enregistrez l’ID de la paire de clés, la clé publique et la clé privée pour une utilisation ultérieure.

Générer un certificat de magasin de clés Java

Générez un certificat Java Key Store (JKS) pour l’authentification JSON Web Token (JWT) de votre Docusign profil d’intégration.

Avant de commencer

Rôle requis : admin

Procédure

1. Ouvrez un éditeur de texte pour code, tel que Sublime Text, et créez un fichier.
2. Collez la clé privée que vous avez générée à partir de votre Docusign application d’intégrateur.

   Pour plus d'informations, consultez Générer une paire de clés RSA pour Docusign l’intégration.

   Remarque :

   Assurez-vous d’inclure le début et la fin de la clé privée.
3. Enregistrez le fichier avec l’extension .key.
   Par exemple, privatekey.key.
4. Ouvrez l’interface de ligne de commande (CLI) et accédez au répertoire où vous avez enregistré le fichier avec l’extension .key.
5. Créez un certificat signé par une autorité de certification à l’aide de votre clé privée en exécutant la commande :

   openssl req -new -x509 -key <file-name>.key -out <certificate-name>.pem -days 1095

   Vous êtes invité à fournir des détails tels que le nom du pays et le nom de la province.
6. Saisissez les détails requis.
7. Créez un fichier PKCS 12 à l’aide de votre clé privée et du certificat signé par l’autorité de certification en exécutant la commande :

   openssl pkcs12 -export -in <certificate-name>.pem -inkey <file-name>.key -certfile <certificate-name>.pem -out <PKCS-12-file-name>.p12

   Vous êtes invité à fournir un mot de passe pour le fichier.
8. Saisissez le mot de passe d’exportation ou le mot de passe du keystore source.
9. Créez le fichier JKS en exécutant cette commande :

   keytool -importkeystore -srckeystore <PKCS-12-file-name>.p12 -srcstoretype pkcs12 -destkeystore <JKS-certificate-filename>.jks -deststoretype JKS

   Vous êtes invité à fournir un mot de passe pour le fichier JKS.
10. Fournissez le même mot de passe pour les mots de passe de magasin de clés de destination et source.

Créer un profil d’intégration au niveau de l’organisation 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 (sn_sam_saas_int) auprès de ServiceNow Store.

ServiceNow Rôle requis : sam_integrator

Pourquoi et quand exécuter cette tâche

Un profil d’intégration au niveau de l’organisation utilise l’API Data Docusign Feed (Flux de données) qui récupère des données détaillées sur les abonnements et la consommation dans l’ensemble d’une organisation. Il agrège les données de tous les sous-comptes d’une organisation, offrant une vue centralisée de l’activité et de l’utilisation des enveloppes.

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.

   Interface	Action
   Interface utilisateur principale	Accédez à la Tous > Actifs Logiciels > Licence SaaS > Profils d'intégration directe. Sélectionnez Nouveau. Sélectionnez le profil d’intégration DocuSign.
   Espace de travail actifs logiciels	Accédez à la Opérations de licence > Abonnements de l'utilisateur > Profils d'intégration directe. Sélectionnez Nouveau. Sélectionnez DocuSign dans la liste déroulante. 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 de l’organisation.
   Date de début du contrat	Date à laquelle l’accord contractuel est entré en vigueur. Cette date n’est pas la même que la date de création de votre Docusign compte.
   Type de profil	Type de profil d'intégration. Cette valeur est automatiquement définie sur l’abonnement DocuSign.
   ID d'organisation	ID d’organisation auquel ce compte appartient. Vous pouvez trouver cette valeur dans votre Docusign compte sous l’onglet Administrateur. Accédez au profil du compte et copiez l’ID de l’organisation.
   Période de renouvellement (mois)	Fréquence à laquelle la consommation de l’enveloppe est renouvelée. Par exemple, si vous saisissez une période de renouvellement de trois mois, les données de consommation sont renouvelées tous les trois mois. La période de renouvellement régit le cycle de consommation et est distincte de la durée globale du contrat.

3. Examinez les rôles d’utilisateur requis ou les autorisations d’API spécifiés dans le champ Configuration du processus 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 Télécharger la consommation est cochée par défaut. Vous pouvez vérifier les données de consommation détaillées dans le tableau de Docusign consommation. Les données de cette table de consommation sont dans le fuseau horaire UTC.

4. Sélectionnez Envoyer.
   Une ébauche de profil d’intégration est créée.

   Le champ Connexion et informations d’identification s’affiche et est automatiquement défini sur sn_sam_saas_int. Docusign_OAuth_with_JWT.

5. Ouvrez l’enregistrement des alias de connexion et d’informations d’identification en sélectionnant l’icône d’aperçu en regard du champ Connexion et informations d’identification , puis en sélectionnant Ouvrir l’enregistrement dans l’aperçu de l’enregistrement.
6. Dans le formulaire Alias de connexion et d’informations d’identification, sélectionnez le lien connexe Créer une connexion et des informations d’identification .
7. Renseignez les champs de la boîte de dialogue Créer une connexion et des informations d’identification.

   Tableau 3. Boîte de dialogue Créer une connexion et des informations d’identification

   Champ	Description
   Information de connexion
   Nom de la connexion	Nom de la connexion.
   URL de connexion	Ce champ est automatiquement défini sur https://api.docusign.net.
   Informations d'identification
   Clé d’intégration	Clé d’intégration de l’API que vous avez générée au cours de la Enregistrer une Docusign application procédure.
   ID de la paire de clés	ID de la paire de clés de la clé privée que vous avez générée au cours de la Générer une paire de clés RSA pour Docusign l’intégration procédure.
   URI de l’audience	Saisissez account.docusign.com comme URI.
   Mot de passe de magasin de clé	Mot de passe associé au fichier JKS chargé que vous avez créé au cours de la Générer un certificat de magasin de clés Java procédure.

8. Localisez le fichier JKS sur votre appareil en sélectionnant Magasin de clés.

   Pour plus d’informations sur la création du fichier JKS, reportez-vous à la section Générer un certificat de magasin de clés Java.

9. Sélectionnez Créer et obtenir un jeton OAuth.
10. 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.

Que faire ensuite

Une fois l’intégration connectée, votre ServiceNow instance crée automatiquement des modèles logiciels 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 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
• Travaux planifiés
• Résultats de la tâche planifiée
• Identificateurs d'abonnement non reconnus
• 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.

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.

• Pour plus d’informations sur la création d’autorisations d’utilisation du logiciel dans l’interface utilisateur principale, reportez-vous Gestion des actifs logiciels à la section Créer des droits au format Gestion des actifs logiciels classique.
• Pour plus d’informations sur la création d’autorisations d’utilisation du logiciel dans Software Asset Workspace, reportez-vous à la section Créer des droits dans l’espace de travail.
• Pour plus d’informations sur la création d’autorisations d’utilisation du logiciel à l’aide du playbook, reportez-vous à la Gestion des actifs logiciels section Créer des droits à l’aide de la procédure guidée.

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é.

• Pour plus d’informations sur l’exécution du rapprochement dans l’application Gestion des actifs logiciels classique, reportez-vous à la section Exécuter le rapprochement de logiciel au format Gestion des actifs logiciels classique.
• Pour plus d’informations sur l’exécution du rapprochement dans Software Asset Workspace, reportez-vous à la section Exécuter le rapprochement de logiciel dans l’espace de travail.