Portail de support Workiva

Avec le connecteur Box®, vous pouvez utiliser les commandes pour interagir avec les lecteurs Box, par exemple pour :

• Rechercher et gérer des fichiers
• Créer et supprimer des dossiers
• Récupérer les URL des fichiers et des dossiers

Note: Ce connecteur est construit par Workiva et se connecte à un système tiers. Bien que notre équipe d'assistance puisse vous aider à configurer ce connecteur dans votre espace de travail, nous ne sommes pas en mesure de dépanner ou d'aider à résoudre des problèmes qui proviennent de l'extérieur de la plateforme Workiva.

Conditions préalables

Pour configurer le connecteur, vous aurez besoin de :

• Une application Box personnalisée pour l'intégration du compte de service
• L'identifiant de l'entreprise, l'identifiant et le secret du client et la clé privée de l'application personnalisée

Créer une intégration de compte de service dans Box

Avant de configurer le connecteur Box, créez une application Box personnalisée pour l'intégration du compte de service. Pour configurer la paire de clés publique/privée de l'application, vous aurez besoin de : 

• OpenSSL
• Un éditeur de texte brut, tel que Windows Notepad
• Authentification à deux facteurs (2FA) activée dans la boîte

Étape 1 : Créer une application Box personnalisée

1. Depuis Dev Console in Box, cliquez sur Create New App.
2. Sélectionnez Custom App, et cliquez sur Next.
   
3. Sous Authentication Method, sélectionnez OAuth 2.0 with JWT, et cliquez sur Next.
   
4. Saisissez un nom unique pour identifier l'application, par exemple Workiva Box App, et cliquez sur Create App puis sur View Your App.
   

Étape 2 : Créer la paire de clés RSA de l'application

Pour sécuriser la connexion, le connecteur Box s'authentifie à l'aide de la paire de clés publique/privée Rivest-Shamir-Adleman (RSA) de l'application personnalisée. Pour créer cette paire de clés dans OpenSSL, entrez les commandes suivantes :

openssl genrsa -out private.pem 2048
openssl rsa -in private.pem -outform PEM -pubout -out public.pem

Ces commandes génèrent deux fichiers :

• private.pem, qui contient la clé client utilisée par le connecteur pour s'authentifier auprès de Box
• public.pem, dont l'application personnalisée a besoin pour sa configuration

Étape 3 : Configurer l'application personnalisée

1. Depuis Dev Console in Box, sélectionnez Configuration pour l'application personnalisée.
2. Sous Authentication Method, vérifiez que OAuth 2.0 with JWT est sélectionné.
   
3. Sous Application Access, sélectionnez Enterprise, et cliquez sur Save Changes.
   
4. Dans un éditeur de texte brut, ouvrez le fichier public.pem et copiez tout son contenu, y compris la ligne d'en-tête -----BEGIN PUBLIC KEY-----, la ligne de bas de page -----END PUBLIC KEY-----, et tous les espaces de fin.
5. À partir de Dev Console in Box, sélectionnez Configuration pour l'application personnalisée, et cliquez sur Add a Public Key sous Add and Manage Public Keys.
   
   
6. Collez tout le contenu du fichier public.pem, et cliquez sur Verify and Save.
7. Lorsque vous y êtes invité, saisissez le code 2FA de votre compte Box et cliquez sur Submit.
8. Sous OAuth 2.0 Credentials, copiez l'identifiant client de l'application personnalisée.
   

Étape 4 : Autoriser l'application personnalisée dans Box

1. Depuis Admin Console in Box, cliquez sur Apps.
2. Dans l'onglet Custom Apps, cliquez sur Authorize New App.
3. Collez l'ID client de l'application personnalisée et cliquez sur Next.
4. Sous App Authorization, vérifiez que l'application est autorisée pour tous les utilisateurs et cliquez sur Authorize.

Étape 5 : ajouter l'identifiant du compte de service en tant que collaborateur d'un dossier Box

1. Depuis Dev Console in Box, sélectionnez Configuration pour l'application personnalisée.
2. Copier l'identifiant du compte de service.
3. Accédez au dossier Box qui sera partagé. Sous Partage, recherchez la section Collaborateurs et cliquez sur Inviter des personnes pour ajouter l'identifiant du compte de service.
   

Mise en place du connecteur de la boîte

Note : pour que le connecteur puisse être utilisé dans les chaînes de votre organisation, un admin de sécurité de l’org. doit d’abord l’activer à partir de Configuration.

1. À partir du Générateur de chaînes, cliquez sur Connexions  compare_arrows, puis sur Créer en haut à droite.
2. Sous Connector Connection, sélectionnez Box et le CloudRunner par défaut.
   
3. Sous Informations de base, entrez un nom et une description uniques pour aider à identifier la connexion.
4. Sous Propriétés, entrez les détails de la connexion :
   
   

   Propriété	Détails
   Identifiant du client	Saisissez l'ID client de l'application Box personnalisée à utiliser pour l'intégration du compte de service du connecteur. Note : Depuis Dev Console in Box, l'identifiant du client apparaît sous OAuth 2.0 Credentials dans l'onglet Configuration de l'application personnalisée.
   Secret du client	Saisissez le secret client de l'application personnalisée.  Remarque : Depuis Dev Console in Box, le secret du client apparaît sous OAuth 2.0 Credentials dans l'onglet Configuration de l'application personnalisée.
   Clé du client	Saisissez l'intégralité du contenu du fichier private.pem créé pour l'application personnalisée, y compris la ligne d'en-tête -----BEGIN RSA PRIVATE KEY-----, la ligne de bas de page -----END RSA PRIVATE KEY-----, et les éventuels espaces de fin de ligne.
   ID de l'entreprise	Saisissez l'identifiant d'entreprise de l'application personnalisée. Remarque : Depuis Dev Console in Box, l'identifiant de l'entreprise apparaît sous App Info dans l'onglet General de l'application personnalisée.

   Note : toutes les informations d’identification sensibles sont automatiquement chiffrées et stockées avec un chiffrement Advanced Encryption Standard (AES)-256.

5. Sélectionnez les environnements qui utiliseront la connexion et cliquez sur Enregistrer.
6. Pour tester la connexion, crée et exécute une chaîne avec la commande du connecteur Get Folder Info , et vérifie qu'elle renvoie un résultat valide.

Dépannage

Si la connexion à Box échoue :

• Assurez-vous que l'application personnalisée est autorisée dans Box.
• Vérifier l'ID client de l'application personnalisée et le secret saisi pour le connecteur. Depuis Dev Console in Box, l'identifiant et le secret du client apparaissent sous OAuth 2.0 Credentials dans l'onglet Configuration de l'application personnalisée. Pour réinitialiser les informations d'identification, cliquez sur Reset. 
• Assurez-vous que les contenus et des fichiers public.pem et private.pem de l'application personnalisée sont entrés dans les configurations de l'application et du connecteur, respectivement. Inclure la ligne d'en-tête, la ligne de pied de page et les éventuels espaces de fin. Si nécessaire, créez une nouvelle paire de clés publiques/privées dans OpenSSL, et entrez leur contenu dans les configurations de l'application et du connecteur.
• Vérifier l'identifiant d'entreprise de l'application personnalisée saisi pour le connecteur. Depuis Dev Console in Box, l'identifiant de l'entreprise apparaît sous App Info dans l'onglet General de l'application personnalisée.
• Vérifiez que le dossier partagé possède l'identifiant du compte de service ajouté en tant que collaborateur.