Autenticação do Box

A UiPath é compatível com os seguintes tipos de autenticação para o Box. Para obter mais informações, consulte a documentação de autenticação do Box.

Tipo de Autenticação	Description	Melhor para
Código de autorização do OAuth 2.0	O usuário faz login por meio do Box e concede acesso à API.	Acesso de usuário individual (automação assistida ou pessoal).
Credenciais do cliente OAuth 2.0	Autenticação de serviço a serviço não interativa.	Acesso de serviço a serviço dentro do espaço de trabalho do usuário.
Traga seu próprio aplicativo OAuth 2.0	Usa seu próprio aplicativo OAuth com URL de retorno de chamada da UiPath.	Clientes que gerenciam seu próprio app Box e chaves.
Token de acesso pessoal (PAT)	Usa uma chave privada Box JWT e um ID empresarial/de usuário.	Integrações de servidor a servidor de nível empresarial que exigem acesso apenas ao aplicativo ou em toda a empresa sem interação do usuário.

Detalhes dos tipos de autenticação

Código de autorização do OAuth 2.0

Campo	Description
Escopo	Selecione os escopos configurados em seu aplicativo Box.

Credenciais do cliente OAuth 2.0

Campo	Description
Chave de API OAuth	ID do cliente Box.
Segredo da API OAuth	Segredo do cliente Box.
Tipo de Assunto	"Enterprise" ou "User"
ID empresarial / ID do usuário	ID empresarial do Box ou ID de usuário do Box.
Escopo	Deve corresponder aos escopos configurados no Box.

Traga seu próprio aplicativo OAuth 2.0

Campo	Description
Chave de API OAuth	ID do cliente Box.
Segredo da API OAuth	Segredo do cliente Box.
Escopo	Escopos Box predefinidos ou personalizados.

Importante:

Configure esse URI de redirecionamento em seu aplicativo Box: https://{baseURL}/provisioning_/callback (por exemplo, https://cloud.uipath.com/provisioning_/callback).

Token de acesso pessoal (PAT)

Campo	Description
Chave de API OAuth	ID do cliente Box do Console do desenvolvedor Box.
Segredo da API OAuth	Segredo do cliente Box no Console do desenvolvedor Box.
Escopo	Escopos selecionados no Box e necessários para automação.
Público do JWT	Exemplo: https://api.box.com/oauth2/token
Chave codificada JWT Base64	Sua chave privada codificada em Base64 do aplicativo Box da configuração do aplicativo JWT.
Emissor do JWT	O ID do cliente do aplicativo Box, usado como a declaração JWT iss .
Subtipo do JWT	Deve ser empresa ou usuário baseado no destino de representação desejado.
Assunto do JWT	O ID corporativo (se subtipo = enterprise) ou o ID de usuário (se subtipo = usuário).

Criação de um aplicativo Box

Antes de conectar a UiPath ao Box, você deve criar um aplicativo no Console do Desenvolvedor do Box. Para obter mais informações, consulte a Documentação do desenvolvedor do Box.

1. Abrir Console do Desenvolvedor
2. Selecione Criar novo aplicativo
3. Escolha uma das seguintes opções, dependendo do tipo de autenticação pretendido:
   • OAuth 2.0 (Autenticação do usuário) → usado para Código de autorização e BYO OAuth
   • OAuth 2.0 com Credenciais do cliente → usado para fluxos de Credenciais do cliente
   • OAuth 2.0 com JWT → usado para PAT no UiPath IS

Após criar o aplicativo Box, colete:

• ID do Cliente
• Segredo do Cliente
• Escopos de aplicativos
• Chave privada (apenas aplicativos JWT)
• ID da Empresa/Usuário

Importante:

Para Traga seu próprio aplicativo OAuth 2.0, adicione o URL de retorno de chamada da UiPath ao seu aplicativo Box: https://{baseURL}/provisioning_/callback (por exemplo, https://cloud.uipath.com/provisioning_/callback).

Compreensão dos escopos do Box

O Box exige uma seleção de permissão explícita, conhecida como "Escopos". A tabela a seguir lista os escopos predefinidos comuns para aplicativos Box.

Escopo	Description
Somente_leitura_raiz	Acesso somente leitura a todo o conteúdo que o usuário/conta pode acessar.
root_readwrite	Acesso total de leitura/gravação a arquivos e pastas.
Gerenciar_grupos	Gerencia grupos do Box.
gerenciar_Enterprise_properties	Gerenciar metadados e propriedades do Enterprise.
gerenciar_retenção_dados	Configure políticas de retenção e isenções legais.
sign_requests.readwrite	Criar e gerenciar solicitações de Box Sign.
gerenciar_app_users	Gerenciar usuários do aplicativo.
gerenciar_gerenciar_usuários	Gerenciar usuários gerenciados pelo Enterprise.

Seu Console do desenvolvedor do Box deve refletir os mesmos escopos que você seleciona ao criar a conexão. Para obter mais detalhes sobre escopos, consulte a documentação Escopos in Box.

Como preparar a chave privada do Box

Etapa 1 — Baixe a chave privada

Baixe o arquivo JSON do aplicativo Box que contém acrypt_private_key e a senha.

Etapa 2 — Descriptografar usando senha

Se a chave estiver criptografada, descriptografe-a:

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

Isso produz o seguinte:

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

Etapa 3 — Remover cabeçalhos/rodapés do PEM

Exclua essas duas linhas totalmente:

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

Etapa 4 — Remover todas as novas linhas e espaços em branco

Torne a chave uma única linha contínua, sem espaços, sem quebras de linha.

Exemplo de resultado: MIIG/wIBADANBgkqhkiG9w0BAQEFAASCBK...

Etapa 5 — Codificação em Base64 da chave limpa

Codifique a chave de linha única:

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

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

Cole a saída de Base64 resultante em: Chave Codificada JWT Base64. Para obter mais informações, consulte a documentação de autenticação do Box.