Intégrer Adobe Sign

Déployez l’intégration Adobe Sign pour numériser rapidement et en toute sécurité chaque accord et approbation.

Avec l’intégration Citrix Adobe Sign, les utilisateurs peuvent effectuer les actions suivantes :

• Envoyer un modèle et charger des accords pour signature.
• Afficher une liste des accords Adobe Sign en attente de signature. Les utilisateurs peuvent signer l’accord depuis Citrix Workspace.
• Afficher une liste des accords Adobe Sign envoyés pour signature. Les utilisateurs peuvent également annuler un accord envoyé.
• Afficher une liste des accords Adobe Sign terminés avec les détails. Les utilisateurs peuvent également partager les accords reçus.
• Afficher une liste des accords Adobe Sign annulés avec les détails.
• Gérer et modifier les contrats de modèle.

Votre avis nous intéresse ! Veuillez fournir vos commentaires pour ce modèle d’intégration au fur et à mesure que vous l’utilisez. Pour tout problème, notre équipe surveille également nos forums dédiés quotidiennement.

Pour plus de détails sur les micro-apps, consultez Utiliser les micro-apps Adobe Sign.

Vérifier les conditions préalables

Une fois l’intégration avec Adobe Sign configurée, vous aurez besoin de ces artefacts pour ajouter l’intégration dans les micro-apps Citrix Workspace :

• URL de base : https://api.in1.adobesign.com/
• ID de groupe Adobe Sign : cet identifiant de groupe représente votre identifiant de groupe d’utilisateurs pour votre compte administrateur.
• Accords par utilisateur : il s’agit du nombre d’accords à stocker dans le cache pour chaque utilisateur. La valeur maximale est 100. Nous recommandons de 15 à 30 accords par utilisateur.
• URL d’autorisation : https://{HostName}.com/public/oauth
• URL du jeton : https://{HostName}.com/oauth/token
• URL du jeton d’actualisation : https://{HostName}.com/oauth/refresh
• Étendue : user_read:self user_write:self user_login:self agreement _read:self agreement _write:self agreement _send:self application_write:self application_write:self library_write:self
• ID du client : l’ID du client est la chaîne représentant les informations d’inscription client uniques au serveur d’autorisation.
• Clé secrète client : la clé secrète client représente la chaîne unique générée lors de la configuration de l’intégration de l’application cible.
• État du relais : AUCUN
• Limitation du taux de demande : 500 demandes par seconde
• Délai d’expiration des demandes : 120

Remarque

Il est recommandé de toujours utiliser OAuth 2.0 comme méthode d’authentification de service lorsque cette méthode est disponible. OAuth 2.0 garantit que votre intégration respecte la conformité maximale en matière de sécurité avec votre micro-app configurée.

Créer un compte de service

L’intégration nécessite l’accès régulier à votre instance Adobe Sign. Nous vous recommandons de créer un compte utilisateur dédié. Ce compte doit être un compte administrateur Adobe Sign doté de privilèges d’administrateur complets.

Pour configurer un nouveau compte, consultez la section Création d’un compte Adobe Sign gratuit.

Activer les API

Aucune limite d’API n’est mentionnée dans Adobe Sign. Les limites de transactions Adobe Sign sont décrites à la page suivante : https://helpx.adobe.com/in/sign/using/transaction-limits.html. Vous pouvez choisir la formule qui vous convient en fonction de vos besoins.

Configurer l’application du client OAuth

Configurez le client OAuth pour écrire les données via l’intégration. Pour plus d’informations sur l’utilisation d’Adobe Sign, reportez-vous au Guide de prise en main (Adobe Sign).

1. Connectez-vous au compte d’administrateur Adobe Sign : https://secure.echosign.com/public/login
2. Sélectionnez Account et sélectionnez API Applications dans la section Adobe Sign APIs.
3. Sélectionnez Create et créez deux nouvelles applications.

4. Pour la première application, collez les URL de redirection dans le champ Redirect Uri.

   • https://{yourmicroappserverurl}.us.iws.cloud.com/app/api/auth/serviceAction/callback
   • https://{yourmicroappserverurl}.us.iws.cloud.com/admin/api/gwsc/auth/serverContext
5. Sélectionnez et choisissez l’option OAuth Configure et activez toutes les étendues avec modificateur en tant que groupe.
6. Répétez cette procédure pour la deuxième application OAuth.
7. Obtenez les informations Client Id et Client Secret à partir des deux applications OAuth et enregistrez-les pour une utilisation ultérieure. Vous utiliserez ces valeurs pour l’authentification de service et l’authentification des actions de service lors de la configuration de l’intégration.

Configurer le groupe et obtenir l’ID de groupe

Les groupes permettent de créer des sous-ensembles distincts d’utilisateurs ayant accès à différents documents de bibliothèque et associés à différents paramètres. Pour plus d’informations, consultez la section Créer et gérer des groupes (Adobe Sign).

1. Connectez-vous au compte d’administrateur Adobe Sign : https://secure.echosign.com/public/login
2. Sélectionnez Account, puis la section Groups .
3. Sélectionnez Create New Group pour ajouter un nouveau groupe.
4. Entrez un nom approprié pour le groupe.
5. Sélectionnez et choisissez l’option Group Setting pour trouver Group Id sur la page de configuration.
6. Ajoutez ou importez des utilisateurs aux groupes.

Ajouter l’intégration aux micro-apps Citrix Workspace

Ajoutez l’intégration Adobe Sign aux micro-apps Citrix Workspace pour vous connecter à votre application. Des micro-apps prêtes à l’emploi sont proposées, ainsi que des notifications et des actions préconfigurées qui sont prêtes à être utilisées dans votre espace de travail.

Procédez comme suit :

1. Sur la page Intégrations de micro-apps, sélectionnez Ajouter nouvelle intégration et Ajouter une nouvelle intégration à partir des modèles fournis par Citrix.
2. Choisissez la vignette Adobe Sign.
3. Donnez un nom à l’intégration.

4. Renseignez la section Paramètres du connecteur :

   • Entrez l’URL de base de l’instance : https://api.in1.adobesign.com/
   • Sélectionnez une icône pour l’intégration dans la bibliothèque d’icônes ou gardez l’icône par défaut.
   • Saisissez votre ID de groupe Adobe Sign. Pour plus d’informations, consultez Configurer le groupe et obtenir l’ID de groupe.
   • Entrez les accords par utilisateur. Il s’agit du nombre d’accords à stocker dans le cache pour chaque utilisateur. La valeur maximale est 100. Nous recommandons de 15 à 30 accords par utilisateur.

5. Sous Authentification du service, sélectionnez OAuth 2.0 dans le menu Méthode d’authentification et complétez les détails d’authentification. Les options d’authentification sont présélectionnées. Assurez-vous que ces options sont sélectionnées lorsque vous effectuez le processus. Utilisez le protocole de sécurité OAuth 2.0 pour générer des jetons de demande/autorisation pour l’accès délégué. Il est recommandé de toujours utiliser OAuth 2.0 comme méthode d’authentification de service lorsque cette méthode est disponible. OAuth 2.0 garantit que votre intégration respecte la conformité maximale en matière de sécurité avec votre micro-app configurée.

   1. Sélectionnez Code d’autorisation dans le menu Type d’autorisation. Permet d’octroyer un code temporaire que le client échange contre un jeton d’accès. Le code est obtenu à partir du serveur d’autorisation où vous pouvez afficher les informations demandées par le client. Seul ce type d’autorisation permet un emprunt d’identité de l’utilisateur sécurisé. Cela affiche l’URL de rappel que vous utilisez lors de l’enregistrement de votre application.
   2. Sélectionnez Corps de la requête dans le menu Autorisation de jeton et Type de contenu du jeton pour URL du formulaire codée.
   3. Entrez l’URL du jeton d’actualisation : https://{HostName}/oauth/refresh.
   4. Assurez-vous que les éléments suivants sont saisis sous Étendue : user_read:self user_write:self user_login:self agreement _read:self agreement _write:self agreement _write:self agreement _send:self application_write:self application_write:self library_write:self
   5. Saisissez votre ID client. L’ID du client est la chaîne représentant les informations d’inscription client uniques au serveur d’autorisation. Vous obtenez cet élément, ainsi que la clé secrète client lorsque vous avez configuré le serveur OAuth. Ajoutez l’URL de rappel que vous voyez sur la page de configuration de l’intégration.
   6. Entrez la Clé secrète client. La clé secrète client représente la chaîne unique générée lors de la configuration de l’intégration de l’application cible.

6. Sous Authentification des actions de service, activez Utiliser authentification utilisateur distincte dans Actions. L’authentification des actions de service s’authentifie au niveau de l’action de service. Les options d’authentification sont présélectionnées. Assurez-vous que ces options sont sélectionnées lorsque vous effectuez le processus.

   1. Sélectionnez OAuth 2.0 dans le menu Méthode d’authentification et complétez les détails d’authentification.
   2. Sélectionnez Code d’autorisation dans le menu Type d’autorisation. Permet d’octroyer un code temporaire que le client échange contre un jeton d’accès. Le code est obtenu à partir du serveur d’autorisation où vous pouvez afficher les informations demandées par le client. Seul ce type d’autorisation permet un emprunt d’identité de l’utilisateur sécurisé. Cela affiche l’URL de rappel que vous utilisez lors de l’enregistrement de votre application.
   3. Sélectionnez Corps de la requête dans le menu Autorisation de jeton.
   4. L’URL d’autorisation est pré-remplie.
   5. L’URL du jeton est pré-remplie.
   6. Assurez-vous que les éléments suivants sont saisis sous Étendue : user_read:self user_write:self user_login:self agreement _read:self agreement _write:self agreement _write:self agreement _send:self application_write:self library_write:self library_read:self
   7. Saisissez votre ID client. L’ID du client est la chaîne représentant les informations d’inscription client uniques au serveur d’autorisation. Vous obtenez cet élément, ainsi que la clé secrète client lorsque vous avez configuré le client OAuth. Ajoutez l’URL de rappel que vous voyez sur la page de configuration de l’intégration.
   8. Entrez la Clé secrète client. La clé secrète client représente la chaîne unique générée lors de la configuration de l’intégration de l’application cible.
7. Sélectionnez Enregistrer pour continuer.

8. Sous Autorisation OAuth, sélectionnez Autoriser pour vous connecter avec votre compte de service. Une fenêtre contextuelle apparaît avec un écran de connexion Google.

   1. Entrez le nom d’utilisateur et le mot de passe de votre compte de service, puis sélectionnez Connexion.
   2. Sélectionnez Accepter.

Ajouter une action de redirection aux boutons Ouvrir accord

Configurez cette action Accéder à l’URL avec votre nom d’hôte pour les boutons suivants afin d’activer la fonctionnalité de bouton Ouvrir accord pour ces micro-apps. Cette configuration Aller à l’URL redirige les utilisateurs vers la page détaillée de l’enveloppe spécifique dans DocuSign. Accédez à chaque bouton ci-dessous pour effectuer cette action :

Micro-app	Page	Bouton
Accords en cours	Détails des accords en cours	Ouvrir accord
Accords annulés	Détails des accords annulés	Ouvrir accord
Accords annulés	Accord annulé	Ouvrir accord
Accords terminés	Détails des accords terminés	Ouvrir accord
Accords terminés	Accord terminé	Ouvrir accord

Procédez comme suit :

1. Accédez au premier bouton répertorié ci-dessus, sélectionnez-le et sélectionnez l’onglet Actions à droite.
2. Dans le champ Ajouter une action, sélectionnez Aller à l’URL.
3. Dans le champ Modèle d’URL, remplacez la {Your Adobe Sign Host} partie de l’URL par votre nom d’hôte. Recherchez votre nom d’hôte Adobe Sign dans l’URL de votre instance Adobe Sign en suivant ce modèle : https://{hostname}.in1.adobesign.com/public/login. Par exemple, https://citrixwsi.in1.adobesign.com/public/login.

4. Répétez maintenant cette procédure pour les autres boutons, en remplaçant la partie {Your Abobe Sign Host} de l’URL par votre nom d’hôte.

   

Vous êtes maintenant prêt à définir et exécuter votre première synchronisation de données. Pour plus d’informations sur les règles de synchronisation, ainsi que sur la synchronisation qui ne respecte pas ses règles de planification et de veto, consultez la section Synchroniser les données.

Pour plus d’informations sur les points de terminaison d’API et les entités de table, consultez la section Spécifications du connecteur Adobe Sign.

Utiliser les micro-apps Adobe Sign

Les intégrations d’application existantes sont fournies avec des micro-apps prêtes à l’emploi. Commencez avec ces micro-apps et personnalisez-les en fonction de vos besoins.

Envoyer des accords : permet d’envoyer un modèle et charger des accords pour signature.

Notification ou Page	Workflows de cas d’utilisation
Page Mon modèle	Permet de fournir une liste de modèles d’accords disponibles pour l’utilisateur avec des options de création et d’envoi aux utilisateurs pour accord à l’aide de l’option de chargement.
Page Envoyer un accord	Permet à l’utilisateur d’envoyer un accord aux destinataires à l’aide de l’option de chargement.
Page Envoyer un modèle	Permet à l’utilisateur d’envoyer des modèles d’accords aux destinataires.

Mes accords reçus : fournit une liste des accords Adobe Sign en attente de signature de l’utilisateur. Un utilisateur peut signer le formulaire d’accord.

Notification ou Page	Workflows de cas d’utilisation
Notification Nouvel accord reçu	Les destinataires sont informés de tous les nouveaux accords créés.
Notification Nouvel accord modifié	Les destinataires sont informés de tous les nouveaux accords créés avec une option Trier par.
Notification Rappels d’accord	Les destinataires sont informés des accords non signés qui sont en attente depuis une semaine.
Page Mes accords reçus	Fournit une liste personnalisée de tous les accords reçus.
Page Détails des accords reçus	Les détails d’un accord reçu sont affichés avec les options Signer l’accord et Envoyer à un autre destinataire.
Page Accord reçu	Les détails d’un accord reçu sont affichés avec les options Signer l’accord et Envoyer à un autre destinataire.
Page Partager accord	Permet aux destinataires de partager les accords reçus avec d’autres utilisateurs.
Page Signer l’accord	Permet aux destinataires de signer et de remplir des accords.

Accords en cours : liste des accords Adobe Sign en cours pour signature. L’utilisateur peut également annuler l’accord envoyé.

Notification ou Page	Workflows de cas d’utilisation
Page Mes accords envoyés	Fournit une liste personnalisée des accords envoyés.
Page Détails des accords en cours	Permet aux utilisateurs d’afficher des informations détaillées sur l’accord envoyé sélectionné, y compris les options Annuler l’accord et Ouvrir accord.

Accords terminés : liste et détails des accords Adobe Sign terminés. L’utilisateur peut également partager les accords reçus.

Notification ou Page	Workflows de cas d’utilisation
Notification Accord signé	L’expéditeur de l’accord est informé des accords signés.
Page Accords terminés	Fournit une liste personnalisée des accords terminés.
Page Détails des accords terminés	Permet aux utilisateurs d’afficher des informations détaillées sur un accord terminé sélectionné avec les options Envoyer à un autre destinataire et Ouvrir accord à partir de la page d’action.
Page Accord terminé	Permet aux utilisateurs d’afficher des informations détaillées sur un accord terminé sélectionné avec les options Envoyer à un autre destinataire et Ouvrir accord à partir du flux de notification.
Page Partager accord	Permet aux destinataires de partager les accords reçus avec d’autres utilisateurs.

Accords annulés : liste et détails des accords Adobe Sign annulés.

Notification ou Page	Workflows de cas d’utilisation
Notification Accord annulé	Les destinataires de l’accord sont informés des accords annulés.
Page Accord annulé	Fournit une liste personnalisée des accords annulés.
Page Détails des accords annulés	Permet aux utilisateurs d’afficher des informations détaillées sur un accord annulé sélectionné avec l’option Ouvrir accord.
Page Accord annulé	Permet aux utilisateurs d’afficher des informations détaillées sur un accord annulé sélectionné avec l’option Ouvrir accord.

Gérer les accords : gérez et modifiez les modèles d’accords.

Notification ou Page	Workflows de cas d’utilisation
Page Mes modèles	Fournit une liste personnalisée de modèles.
Page Gérer le modèle	Permet aux utilisateurs de modifier les modèles sélectionnés dans Citrix Workspace.