Conexão da Box

Criar um aplicativo customizado na Box

Antes de criar uma conexão com a Box, você cria um aplicativo customizado no Box Developer Console. É possível criar um app para acesso no nível do aplicativo que os usuários podem usar para compartilhar arquivos ou você pode criar um app para acesso corporativo a todas as contas de usuário. Com o acesso corporativo, os usuários não precisam compartilhar arquivos e pastas com o aplicativo.

1. Acesse o Box Developer Console e siga o assistente para criar um Aplicativo customizado. Para o Método de Autenticação, selecione OAuth 2.0 with JWT (Server Authentication).
2. Faça as seleções a seguir na página Configuração. Caso contrário, mantenha as configurações padrão.
   1. Selecione uma de duas opções para Nível de Acesso ao Aplicativo:
      • Mantenha a seleção padrão Acesso apenas ao app para permitir o acesso onde os usuários compartilham arquivos.
        
      • Selecione App + acesso corporativo para criar um aplicativo com acesso corporativo a todas as contas de usuário.
        
   2. Em Incluir e gerenciar chaves públicas, clique em Gerar um par de chaves públicas/privadas. Essa seleção requer que a autenticação de dois fatores seja ativada na conta da Box, mas você pode desativá-la depois. O par de chaves gerado produz um arquivo de configuração (*_config.json) para você fazer download. Você precisará das informações neste arquivo para criar a conexão em seu projeto
3. Se você selecionou um App + Acesso corporativo, em Recursos avançados, selecione ambas as caixas de seleção:
   • Faça chamadas de API usando o cabeçalho como usuário
   • Gerar tokens de acesso de usuário
4. Envie o ID do cliente do app para o administrador corporativo do Box para obter autorização: acesse seu aplicativo no Box Developer Console e selecione o link Geral na barra lateral esquerda em seu aplicativo. Role até a seção Autorização de app.

Crie a conexão do Box

Insira os valores do arquivo de configuração transferido por download para estas configurações:

• ID do cliente
• Segredo do cliente
• ID da Empresa
• Chave privada (substitua cada \n por uma nova linha)
• Senha da chave privada (O valor passphrase no arquivo de configuração)
• Chave pública (O valor publicKeyID no arquivo de configuração)

Aplicativo corporativo

Se você configurou um aplicativo de acesso corporativo, insira o nome de usuário da conta de usuário do Box no campo Nome do usuário.

Aplicativo no nível do aplicativo

Os usuários devem compartilhar explicitamente seus arquivos com o endereço de e-mail do aplicativo para que o aplicativo acesse os arquivos.

1. Faça uma chamada REST para a conexão para descobrir o endereço de e-mail do aplicativo. Por exemplo:

   curl -X PUT "https://api.dataplatform.cloud.ibm.com/v2/connections/{connection_id}/actions/get_user_info?project_id={project_id}" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json"
   

   Retorna:

   {
    "login_name": "AutomationUser_123467_aBcDEFg12h@boxdevedition.com"
   }
   

2. Compartilhe os arquivos e pastas no Box que você deseja acessar a partir do watsonx.ai Studio com o nome de login que foi retornado pela chamada REST.

Descriptografia de uma chave privada

Para descriptografar uma chave privada usando sua senha associada, execute o seguinte comando. Esse processo usa o comando ' openssl pkcs8 para gerar uma versão não criptografada da chave privada.

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

Os parâmetros usados são:

private_key.pem

A chave privada criptografada que foi gerada e fornecida a você pela Box.

pass.txt

Esse arquivo contém a senha associada à chave privada que foi gerada e fornecida a você pela Box.

private_key_unencrypted.pem

Esse é o arquivo de saída que conterá a chave privada não criptografada após a execução do comando.