Authentification Box

Connectez UiPath à Box dans Automation Suite à l'aide d'OAuth 2.0 ou d'autres types d'authentification pris en charge, en configurant l'URI de redirection requis dans votre application Box.

UiPath prend en charge les types d'authentification suivants pour Box. Pour de plus amples informations, consultez la documentation d'authentification Box.

Type d’authentification	Description	Idéal pour
Apportez votre propre application OAuth 2.0	Utilise votre propre application OAuth avec l’URL de rappel d’UiPath.	Les clients qui gèrent leur propre application et clés Box.
Jeton d’accès personnel (PAT)	Utilise une clé privée JWT et un ID d’entreprise/d’utilisateur.	Intégrations serveur-serveur au niveau de l'entreprise, nécessitant un accès uniquement au niveau de l'application ou à l'échelle de l'entreprise, sans interaction de l'utilisateur.

Détails des types d’authentification

Apportez votre propre application OAuth 2.0

Champ	Description
Clé API OAuth	ID de client Box.
Clé secrète d’API OAuth	Clé secrète du client Box.
Portée	Étendues Box prédéfinies ou personnalisées.

Important :

Configurez cet URI de redirection dans votre application Box : https://{yourDomain}/provisioning_/callback.

Jeton d’accès personnel (PAT)

Champ	Description
Clé API OAuth	ID client Box de la console développeur Box.
Clé secrète d’API OAuth	Clé secrète du client Box dans la console développeur Box.
Portée	Étendues sélectionnées dans Box et requises pour l’automatisation.
Audience JWT	Exemple : https://api.box.com/oauth2/token
Clé encodée JWT au format Base64	La clé privée encodée en Base64 de votre application Box provenant de la configuration de l'application JWT.
Émetteur JWT	L' ID client de l'application Box, utilisé comme revendication JWT iss .
Sous-type JWT	Doit être une entreprise ou un utilisateur en fonction de la cible d’emprunt d’identité souhaitée.
Objet JWT	ID d'entreprise (si sous-type = entreprise) ou ID d'utilisateur (si sous-type = utilisateur).

Créer une application Box

Avant de connecter UiPath à Box, vous devez créer une application dans la console de développement Box. Pour de plus amples informations, consultez la documentation des développeurs de Box.

1. Ouvrir la console de développement
2. Sélectionner Créer une nouvelle application
3. Choisissez l’une des options suivantes en fonction du type d’authentification que vous souhaitez utiliser :
   • OAuth 2.0 (Authentification de l’utilisateur) → utilisé pour OAuth BYO
   • OAuth 2.0 avec JWT → utilisé pour le jeton d’accès personnel dans UiPath IS

Après avoir créé l'application Box, collectez :

• ID de client
• Clé secrète du client
• Étendues d'application
• Clé privée (Apps JWT uniquement)
• Entreprise/ID d'utilisateur

Important :

Pour l'application Apporter votre propre OAuth 2.0, ajoutez l'URL de rappel de UiPath à votre application Box : https://{yourDomain}/provisioning_/callback.

Étendues Box Understanding

Box nécessite une sélection d’autorisation explicite connue sous le nom de « étendues ». Le tableau suivant répertorie les étendues prédéfinies courantes des applications Box.

Portée	Description
racine_en lecture seule	Accès en lecture seule à tout le contenu auquel l'utilisateur/le compte peut accéder.
Racine_lecture écriture	Accès complet en lecture/écriture aux fichiers et dossiers.
Gérer_groupes	Gérez les groupes Box.
gérer_propriétés_entreprise	Gérez les métadonnées et les propriétés de l'entreprise.
gérer_conservation_données	Configurez les politiques de rétention et les rétentions légales.
sign_requests.readwrite	Créer et gérer des requêtes de signature Box.
Gérer_utilisateurs_application	Gérer les utilisateurs d'applications.
gérer_utilisateurs_gérés	Gérez les utilisateurs gérés par l'entreprise.

Votre console de développement Box doit refléter les mêmes étendues que celles que vous avez sélectionnées lors de la création de la connexion. Pour plus de détails sur les étendues, veuillez vous référer à la documentation Étendues de Box.

Comment préparer la clé privée Box

Étape 1 : Téléchargez la clé privée

Téléchargez le fichier JSON de l'application Box qui contient la clé chiffrée_privée_clé et la phrase de mot de passe.

Étape 2 : Décrypter à l'aide de la phrase de passe

Si la clé est chiffrée, déchiffrez-la :

openssl pkcs8 -inform PEM -in private_key.pem -out decrypted_key.pem -passin pass:YOUR_PASSPHRASE

Cela produit les éléments suivants :

-----BEGIN PRIVATE KEY-----
...
-----END PRIVATE KEY-----

Étape 3 — Supprimer les en-têtes/ pieds de page du PEM

Supprimez entièrement ces deux lignes :

-----BEGIN PRIVATE KEY-----
-----END PRIVATE KEY-----

Étape 4 : supprimer toutes les nouvelles lignes et tous les espaces

Faites de la clé une seule ligne continue, sans espaces, sans sauts de ligne.

Exemple de résultat : MIIG/wIBADANBgkqhkiG9w0BAQEFAASCBK...

Étape 5 — Encoder en Base64 la clé nettoyée

Encodez la clé d'une ligne unique :

Linux/macOS : echo -n "CLEANED_KEY" | base64

PowerShell : [Convert]::ToBase64String([Text.Encoding]::UTF8.GetBytes("CLEANED_KEY"))

Collez la sortie Base64 obtenue dans : Clé encodée JWT au format Base64. Pour de plus amples informations, consultez la documentation d'authentification Box.

Ajouter la connexion Box

1. Sélectionnez Integration Service dans la barre de gauche.
2. Dans la liste Connecteurs , sélectionnez Box. Vous pouvez également utiliser la barre de recherche pour affiner le connecteur.
3. Sélectionnez Connecter à Box.
4. Vous êtes maintenant dirigé vers la page de connexion.
5. Entrez les identifiants requis.
6. Select Connect.

Autorisations

Les comptes doivent être activés pour accéder ou se connecter à Box. Si ce n’est pas le cas, contactez votre administrateur et demandez l’accès nécessaire.

Avec accès à votre compte Box, UiPath for Box peut effectuer les actions suivantes :

• Lire tous les fichiers et dossiers stockés dans Box
• Lire et écrire tous les fichiers et dossiers stockés dans Box
• Gérer les groupes
• Gérer les propriétés d'Enterprise
• Gérer les politiques de rétention
• Activer les intégrations
• Gérer les requêtes de signature
• Gérer les utilisateurs de l’application
• Gérer les utilisateurs
• Générer des requêtes Box Sign facturables.

Pour de plus amples informations, consultez la documentation d'authentification Box.