Authentification 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
Code d’autorisation OAuth 2.0	L'utilisateur se connecte via Box et accorde l'accès à l'API.	Accès utilisateur individuel (attended ou automatisation personnelle).
Identifiants du client OAuth 2.0	Authentification de service à service non interactive.	Accès de service à service dans l’ espace de travail de l’utilisateur.
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

Code d’autorisation 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	Sélectionnez les étendues configurées dans votre application Box.

Identifiants du client OAuth 2.0

Champ	Description
Clé API OAuth	ID de client Box.
Clé secrète d’API OAuth	Clé secrète du client Box.
Type d'objet	"Enterprise" ou "User"
ID de l’entreprise/ID de l’utilisateur	ID de l'entreprise Box ou ID de l'utilisateur Box.
Portée	Doit correspondre aux étendues configurées dans Box.

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://{baseURL}/provisioning_/callback (par exemple, https://cloud.uipath.com/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 (Authentication de l’utilisateur) → utilisé pour le code d’autorisation et BYO OAuth
   • OAuth 2.0 avec les informations d’identification du client → utilisé pour les flux d’informations d’identification du client
   • 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 UiPath à votre application Box : https://{baseURL}/provisioning_/callback (par exemple, https://cloud.uipath.com/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.