Creare un'app personalizzata in Box

Prima di creare una connessione a Box, si crea un'app personalizzata in Box Developer Console. È possibile creare un'app per l'accesso a livello applicativo che gli utenti possono utilizzare per condividere file, oppure è possibile creare un'app per l'accesso a livello aziendale a tutti gli account utente. Con l'accesso a livello aziendale, gli utenti non hanno bisogno di condividere file e cartelle con l'applicazione.

1. Passare alla Box Developer Consolee seguire la procedura guidata per creare una App personalizzata. Per il Metodo di autenticazione, selezionare OAuth 2.0 with JWT (Server Authentication).
2. Effettuare le seguenti selezioni nella pagina Configurazione . In caso contrario, mantenere le impostazioni predefinite.
   1. Selezionare una delle due scelte per Livello di accesso App:
      • Conservare la selezione predefinita App Access Only per consentire l'accesso in cui gli utenti condividono i file.
        
      • Selezionare App + Enterprise Access per creare un'app con accesso aziendale a tutti gli account utente.
        
   2. In Aggiungi e Gestisci le chiavi pubbliche, clicca su Generare un Keypair Public / Private. Questa selezione richiede che l'autenticazione a due fattori sia abilitata sul conto Casella, ma è possibile disabilitarla in seguito. La coppia di chiavi generate produce un file di configurazione (*_config.json) per il download. Saranno necessarie le informazioni contenute in questo file per creare la connessione nel progetto.
3. Se è stato selezionato un App + Enterprise Access, in Funzioni avanzate, selezionare entrambe le caselle di spunta:
   • Fare chiamate API utilizzando l'intestazione as - user
   • Genera token di accesso utente
4. Invia l'ID client dell'app all'amministratore di Box enterprise per l'autorizzazione: Vai alla tua applicazione nella Box Developer Console e seleziona il link Generale dalla barra laterale sinistra nella tua applicazione. Scorrere verso il basso nella sezione Autorizzazione app .

Decifrare una chiave privata

Per decifrare una chiave privata utilizzando la password associata, eseguire il seguente comando. Questo processo utilizza il comando " openssl pkcs8 per generare una versione non criptata della chiave privata.

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

I parametri utilizzati sono:

private_key.pem

La chiave privata crittografata generata e fornita da Box.

pass.txt

Questo file contiene la password associata alla chiave privata generata e fornita da Box.

private_key_unencrypted.pem

Questo è il file di output che conterrà la chiave privata non criptata dopo l'esecuzione del comando.

Scegliere il metodo per la creazione di una connessione in base alla posizione in cui ci si trova nella piattaforma

In un progetto

Fare clic su Asset> Nuovo asset> Connetti a una origine dati. Consultare Aggiunta di una connessione a un progetto.

In uno spazio di distribuzione

Fare clic su Importa asset> Accesso dati> Connessione. Consultare Aggiunta di asset di dati a uno spazio di distribuzione.

Nel Platform assets catalog

Fare clic su Nuova connessione. Consultare Aggiunta di connessioni di piattaforma.

Creare la connessione Box

Inserire i valori dal file di configurazione scaricato per queste impostazioni:

• ID client
• Segreto client
• ID azienda
• Chiave privata (Sostituisci ogni \n con una newline)
• Password chiave privata (Il valore passphrase nel file di configurazione)
• chiave pubblica (Il valore publicKeyID nel file di configurazione)

App enterprise - wide

Se è stata configurata un'app di accesso a livello aziendale, inserire l'username dell'account utente di Box nel campo Username .

App di livello applicativo

Gli utenti devono condividere esplicitamente i propri file con l'indirizzo email dell'app in modo che l'app possa accedere ai file.

1. Effettuare una chiamata REST alla connessione per scoprire l'indirizzo email dell'app. Ad esempio:

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

   Corpo richiesta:

   {}
   

   Restituisce:

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

2. Condividere i file e le cartelle di Box che si desidera rendere accessibili da watsonx.ai Studio con il nome di login restituito dalla chiamata REST.

Next step: Aggiungi asset dati dalla connessione

• Consultare Aggiungi dati da una connessione in un progetto.