Adobe Sign pour SharePoint Online - Guide d’installation des flux de travail

Les actions des flux de travaux Adobe Sign pour SharePoint Online permettent aux administrateurs des flux de travaux SharePoint d’ajouter des actions Adobe Sign dans les flux de travaux SharePoint par le biais du concepteur des flux de travaux SharePoint. La solution est disponible pour les instances en ligne de Microsoft SharePoint en tant que module externe. Elle permet aux utilisateurs de créer un flux de travaux de liste sur une liste personnalisée ou une bibliothèque de documents, lesquelles peuvent être employées par les utilisateurs de SharePoint pour

• Envoyer des documents à un destinataire unique ou les envoyer à un groupe de destinataires en utilisant des listes SharePoint et en mappant les données des listes SharePoint dans les documents lorsque les documents sont envoyés pour signature.
• Vérifiez le statut de l’accord.
• Annulez l’accord après son envoi pour signature.
• Téléchargez l’accord signé dans une pièce jointe de liste (en cas de listes personnalisées) ou comme document portant un nom différent (en cas de bibliothèques de documents)

Conditions requises

La solution Adobe Sign peut uniquement être installée et configurée par un administrateur Microsoft SharePoint. Vous devez en outre disposer de privilèges d’administration sur le serveur SharePoint pour installer la solution. Pour connaître les autorisations système supplémentaires pouvant être requises pour l’installation des modules externes SharePoint, consultez la documentation SharePoint et l’administrateur SharePoint de votre entreprise. Pour configurer la solution, vous devez également être administrateur du compte Adobe Sign et avoir accès à votre clé d’API de compte Adobe Sign. La configuration requise ci-dessous englobe les composants client et serveur requis pour installer et exécuter Adobe Sign pour SharePoint avec succès.

• Microsoft SharePoint hébergé
• Internet Explorer 11 ou version ultérieure

Installation d’Adobe Sign WSP sur une collection de sites

Téléchargement et activation du package .wsp

1. Obtenez le package .wsp le plus récent auprès de votre gestionnaire de réussite (installations existantes uniquement).

• Remarque : Workflow a été rendue obsolète et n’est plus disponible pour les nouvelles installations. Reportez-vous plutôt aux instructions de Microsoft Flow.

2. Accédez à Collection de sites > Paramètres du site > Galeries du concepteur Web > Solutions.

Remarque : _catalogs/solutions/Forms/AllItems.aspx

3. Téléchargez le fichier .wsp.

4. Activez la fonctionnalité de site manuellement :

• Accédez à Paramètres du site > Actions du site > Gérer les fonctionnalités du site.
• Cliquez sur le bouton Activer en regard de l’option Actions des flux de travail Adobe eSign.
• Cliquez sur le bouton Activer en regard de l’option Liste de configuration des actions des flux de travail Adobe eSign.

Remplissage de la liste eSignConfig

Le remplissage de la liste eSignConfig nécessite la génération et la saisie de plusieurs champs uniques. 

Il est recommandé d’ouvrir Notepad ou un autre éditeur de texte afin de pouvoir enregistrer les clés générées, puis les entrer toutes en même temps.

Vous devez :

• créer la clé d’intégration eSignIntegrationKey (dans l’application Adobe Sign) ;
• obtenir la valeur spTenantID dans SharePoint ;
• générer les clés spClientID et spClientSecret dans SharePoint ;
• octroyer les autorisations du nouveau principal de service dans SharePoint ;
• insérer l’URL du connecteur eSign.

Étape 1 : Création de la clé d’intégration eSignIntegrationKey

Création d’une clé d’intégration dans Adobe Sign :

1. Connectez-vous en tant qu’utilisateur administrateur de votre compte Adobe Sign.

2. Accédez à Compte > API Adobe Sign > Informations sur l’API.

3. Cliquez sur le lien Clé d’intégration au milieu de la page.

L’interface Créer une clé d’intégration se charge :

1. Fournissez un nom de clé explicite (par ex. SharePoint).

2. Les éléments de la clé d’intégration suivants doivent être activés :

• agreement_read
• agreement_write
• agreement_send
• library_read

3. Une fois la clé configurée, cliquez sur Enregistrer.

La page Jetons d’accès apparaît et indique les clés associées à votre compte.

4. Cliquez sur la définition de clé créée pour SharePoint.

• Le lien Clé d’intégration s’affiche en haut de la définition.

5. Cliquez sur le lien Clé d’intégration.

La clé d’intégration s’affiche :

6. Copiez cette clé et enregistrez-la pour l’ajouter à la liste eSignConfig.

7. Cliquez sur OK.

• Vous en avez maintenant terminé avec l’application Adobe Sign et pouvez vous déconnecter.

Étape 2 : Obtention de la valeur spTenantID

Pour obtenir la valeur spTenantID, procédez comme suit :

1.        Accédez à Paramètres du site > Utilisateurs et autorisations > Autorisations d’application du site.

2.       Dans la section Identificateur d’application, copiez la partie située après @.

• Par ex. : i:0i.t|ms.sp.ext|d559ac84-d8e6-4515-9229-89w01@870fe83b-ye9d-96d3-n1d0-9et51ar2e792e

3. Enregistrez cette valeur à insérer dans la liste eSignConfig.

Étape 3 : Génération des clés spClientID et spClientSecret

Pour générer les clés spClientID et spClientSecret, procédez comme suit :

1. Dans l’URL de votre site SharePoint, collez la chaîne suivante après sharepoint.com/sites/{votre_site} : _layouts/15/appregnew.aspx.

• Une nouvelle page s’ouvre pour vous permettre de générer les deux clés.

2. Cliquez sur les boutons Générer pour ID client et Clé secrète client.

3. Copiez les deux clés et enregistrez-les pour les ajouter à la liste eSignConfig.

4. Insérez les valeurs littérales suivantes dans les champs restants :

• Titre : Adobe Sign
• Domaine de l’application : spintegration.echosign.com/sharepoint
• URL de redirection : https://spintegration.echosign.com/sharepoint

5. Cliquez sur Créer.

• Cette opération crée un nouveau principal du service dans Azure AD.
• Vous pouvez réutiliser le même principal pour les différentes collections de sites.

Étape 4 : Octroi des autorisations du nouveau principal de service

Pour octroyer les autorisations du nouveau principal de service au site, procédez comme suit :

1. Dans l’URL de votre site SharePoint, collez la chaîne suivante après sharepoint.com/sites/{votre_site} : _layouts/15/appinv.aspx.

• Cette opération doit être effectuée sur chaque site où les flux de travail doivent s’exécuter.

Les champs doivent contenir les informations relatives à l’application de l’étape précédente :

• ID d’application : ID client que vous venez de générer
• Titre : Adobe Sign
• Domaine de l’application : spintegration.echosign.com/sharepoint
• URL de redirection : https://spintegration.echosign.com/sharepoint

2. Copiez le code ci-dessous et collez-le dans le champ Code XML de la demande d’autorisation :.

3. Cliquez sur Créer.

4. Cliquez sur Faire confiance lors du rechargement de la page.

Les autorisations obtenues sont répertoriées dans Paramètres du site > Autorisations d’application du site.

Étape 5 : Insertion de l’URL eSignConnectorURL

L’URL eSignConnectorURL est la valeur littérale suivante : https://spintegration.echosign.com/sharepoint.

Configuration de la liste eSignConfig

1. Dans la section Contenu du site du site où la fonctionnalité Liste de configuration des actions des flux de travail Adobe eSign a été activée, recherchez et cliquez sur la liste eSignConfig.

2. Cliquez sur Nouvel élément pour ouvrir un nouveau formulaire de configuration.

3. Renseignez les valeurs suivantes :

• Titre : Config
• spClientID : insérez la valeur ID Client de l’étape 3.
• spClientSecret : insérez la valeur de la clé secrète client de l’étape 3.
• spTenantID : insérez la valeur TenantID de l’étape 2.
• eSignIntegrationKey : insérez la clé d’intégration Adobe Sign de l’étape 1.
• eSignConnectorURL : saisissez https://spintegration.echosign.com/sharepoint.
• debugStatements : saisissez « Non ».

4. Cliquez sur Enregistrer.

Considérations relatives à la sécurité pour la lecture de la liste eSignConfig à partir de l’action de flux de travail

Il est recommandé de limiter l’accès à la liste eSignConfig aux administrateurs des collections de sites.

Si le flux de travail est lancé par l’utilisateur qui a accès à la liste eSignConfig, il s’exécute sans problème. Cependant, si l’utilisateur n’a pas accès à la liste, les actions du flux de travail doivent être encapsulées dans l’étape de l’application.

1. Sur le site où le flux de travail est publié, effectuez les opérations suivantes :

• Accédez à Paramètres du site > Fonctionnalités du site.
• Activez la fonctionnalité Les flux de travail peuvent utiliser les autorisations d’applications.

2. Obtenez l’identifiant du principal de service du flux de travail.

• Accédez à Paramètres du site > Autorisations d’application du site.

Par ex. : Flux de travail i:0i.t|ms.sp.ext|d55e6c84-d8e6-4515-9229-896we4554601@870f107b-dc9d-47d3-9ad0-9d851rr2e762e

3. Indiquez les autorisations du principal de service du flux de travail dans _layouts/15/appinv.aspx de la même façon que ce que nous avons fait avec l’application réelle.

4. Approuvez le principal de service du flux de travail.

L’étape d’application devrait maintenant être disponible dans SharePoint Designer (redémarrage requis) :

Copie téléchargeable au format PDF