Autenticação do Box

Conecte a UiPath ao Box no Automation Suite usando OAuth 2.0 ou outros tipos de autenticação compatíveis, configurando o URI de redirecionamento necessário em seu aplicativo 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
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

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://{yourDomain}/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 BYO OAuth
   • 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://{yourDomain}/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.

Adicionar a conexão ao Box

1. Selecione Integration Service no menu de navegação esquerdo.
2. Na lista Conectores , selecione Box. Você também pode usar a barra de pesquisa para restringir o conector.
3. Selecione Conectar à Box.
4. Você será direcionado agora para a página Conexão.
5. Insira as credenciais necessárias.
6. Select Connect.

Permissões

As contas devem ser habilitadas para acessar ou se conectar ao Box. Se não for o caso, entre em contato com o administrador e solicite o acesso necessário.

Com o acesso à sua conta Box, o UiPath for Box pode fazer o seguinte:

• Ler todos os arquivos e pastas armazenados no Box
• Ler e gravar todos os arquivos e pastas armazenados no Box
• Gerenciar grupos
• Gerenciar propriedades corporativas
• Gerenciar políticas de retenção
• Habilitar integrações
• Gerenciar Solicitações de Assinatura
• Gerenciar usuários do aplicativo
• Gerenciar usuários
• Gere solicitações de Box Sign faturáveis.

Para obter mais informações, consulte a documentação de autenticação do Box.