Création d'une application personnalisée dans Box

Avant de créer une connexion à Box, créez une application personnalisée dans Box Developer Console. Vous pouvez créer une application pour un accès au niveau de l'application que les utilisateurs peuvent utiliser pour partager des fichiers ; vous pouvez également créer une application pour un accès à l'échelle de l'entreprise à tous les comptes d'utilisateur. Avec l'accès à l'échelle de l'entreprise, les utilisateurs n'ont pas besoin de partager les fichiers et les dossiers avec l'application.

1. Accédez à Box Developer Console et suivez les instructions de l'assistant pour créer une application personnalisée. Pour la méthode d'authentification, sélectionnez OAuth 2.0 with JWT (Server Authentication).
2. Effectuez les sélections suivantes dans la page de configuration. Sinon, conservez les valeurs par défaut.
   1. Sélectionnez l'une des deux options suivantes pour le niveau d'accès à l'application :
      • Conservez la sélection Accès à l'application uniquement par défaut pour autoriser l'accès où les utilisateurs partagent des fichiers.
        
      • Sélectionnez App + Accès aux entreprises pour créer une application disposant d'un accès à l'ensemble de l'entreprise à tous les comptes utilisateur.
        
   2. Sous Ajouter et gérer des clés publiques, cliquez sur Générer un pavé numérique public / privé. Cette sélection exige que l'authentification à deux facteurs soit activée sur le compte Box, mais vous pouvez la désactiver par la suite. La paire de clés générée produit un fichier de configuration (*_config.json) que vous pouvez télécharger. Vous aurez besoin des informations de ce fichier pour créer la connexion dans votre projet.
3. Si vous avez sélectionné App + Accès aux entreprises, sous les fonctions avancées, cochez les deux cases suivantes :
   • Faire des appels API à l'aide de l'en-tête en tant qu'utilisateur
   • Générer des jetons d'accès utilisateur
4. Soumettez l'ID de client de l'application à l'administrateur d'entreprise Box pour autorisation : accédez à votre application dans la console Box développeur et sélectionnez le lien Général dans la barre latérale gauche. Faites défiler vers le bas jusqu'à la section Autorisation d'application.

Décryptage d'une clé privée

Pour déchiffrer une clé privée à l'aide du mot de passe qui lui est associé, exécutez la commande suivante. Ce processus utilise la commande " openssl pkcs8 pour générer une version non chiffrée de la clé privée.

openssl pkcs8 -in private_key.pem -passin file:pass.txt -out private_key_unencrypted.pem

Les paramètres utilisés sont les suivants

private_key.pem

La clé privée cryptée qui a été générée et qui vous a été fournie par Box.

pass.txt

Ce fichier contient le mot de passe associé à la clé privée qui a été générée et qui vous a été fournie par Box.

private_key_unencrypted.pem

Il s'agit du fichier de sortie qui contiendra la clé privée non chiffrée après l'exécution de la commande.

Choisissez la méthode de création d'une connexion basée sur l'emplacement dans la plateforme.

Dans un projet

Cliquez sur Actifs > Nouvel actif > Connexion à une source de données. Voir Ajout d'une connexion à un projet.  

Dans un espace de déploiement

Cliquez sur Importer les actifs > Accès aux données > Connexion. Voir Ajout d'actifs de données à un espace de déploiement.

Dans le catalogue d'actifs de la plateforme

Cliquez sur Nouvelle connexion. Voir Ajout de connexions de plateforme.

Création de la connexion Box

Entrez les valeurs contenues dans le fichier de configuration téléchargé pour ces paramètres :

• ID de client
• Secret du client
• ID d'entreprise
• Clé privée (Remplacez chaque \n par une nouvelle ligne)
• Mot de passe de clé privée (valeur passphrase dans le fichier de configuration)
• Clé publique (valeur publicKeyID dans le fichier de configuration)

Application à l'échelle de l'entreprise

Si vous avez configuré une application d'accès à l'échelle de l'entreprise, entrez le nom d'utilisateur du compte utilisateur Box dans la zone Nom d'utilisateur.

Application au niveau de l'application

Les utilisateurs doivent partager explicitement leurs fichiers avec l'adresse électronique de l'application afin que l'application ait accès aux fichiers.

1. Effectuez un appel REST à la connexion pour obtenir l'adresse électronique de l'application. Par exemple :

   PUT https://api.dataplatform.cloud.ibm.com/v2/connections/{connection_id}/actions/get_user_info?project_id={project_id}

   Corps de demande :

   {}
   

   Retours :

   {
    "login_name": "[email protected]"
   }
   

2. Partagez les fichiers et les dossiers de Box que vous souhaitez rendre accessibles depuis watsonx.ai Studio avec le nom de connexion renvoyé par l'appel REST.

Etape suivante : ajout d'actifs de données à partir de la connexion

• Voir Ajouter des données à partir d'une connexion dans un projet.