Configuração do Box

Pré-lançamento privado:a criação e o uso de um repositório de dados usando a ingestão de dados estão em pré-lançamento privado. Você precisa estar na lista de permissões para usar o repositório de dados de ingestão de dados. Para ser adicionado à lista de permissões, entre em contato com a equipe de contas ou a equipe de vendas.

Pré-lançamento público:os recursos de pesquisa e ações federadas estão no pré-lançamento público. Esse recurso está sujeito aos "Termos dos produtos e recursos em pré-GA" na seção Termos gerais de serviço dos Termos específicos de serviço. Os recursos pré-GA estão disponíveis "no estado em que se encontram" e podem ter suporte limitado. Para mais detalhes, consulte as descrições da fase de lançamento.

Esta página descreve como configurar uma configuração de terceiros antes de criar o repositório de dados do Box.

Criar um app do Box

1. Faça login no Box Developer Console com sua conta de administrador.
2. Clique em Create platform app.
3. Selecione App type como Custom app.
4. Insira o App name.

5. Defina as seguintes propriedades:

   • Finalidade:integração.
   • Categorias:IA.
   • Sistema externo: Google Cloud Gemini Enterprise.

6. Selecione método de autenticação como Server Auth - JWT.

7. Clique em Criar app.

Configurar o app do Box

1. No Box Developer Console, selecione o app da plataforma na página My Platform Apps.

   

   Página "My Platform Apps" no Box Developer Console.

2. Na guia Configuration, faça o seguinte:

   1. Na seção nível de acesso do app, selecione Acesso do app + Enterprise.

      Observação: o App + Enterprise access é necessário para buscar arquivos, comentários e tarefas de contas de usuários individuais. Além disso, esse nível de acesso é necessário para a funcionalidade de sincronização incremental. O fluxo de eventos corporativos depende desse nível para identificar e recuperar arquivos, comentários e tarefas novos e modificados de maneira eficiente.

      

      Configurar o app do Box.

   2. Na seção Application scopes, selecione os escopos com base no modo de conexão na tabela a seguir:

      Modo de conexão	Scope	Finalidade
      Pesquisa federada	Read all files and folders stored in Box	Necessário para buscar comentários e tarefas e visualizar arquivos para pesquisa.
      Pesquisa e ações federadas	Write all files and folders stored in Box	Necessário para copiar, fazer upload e download de arquivos, além de buscar comentários e tarefas e visualizar arquivos para pesquisa.
      Ingestão de dados	Read all files and folders stored in Box	Necessário para a ingestão de dados.
      	Manage users	Necessário para buscar a lista de usuários, permitindo a recuperação de arquivos, comentários e tarefas de contas de usuários individuais para ingestão. A conta de serviço do administrador não tem acesso inerente a todos os arquivos de propriedade do usuário. O cabeçalho "as-user" permite que o sistema faça solicitações de API como o usuário específico para acessar os dados dele.
      	Manage enterprise properties	Necessário para a funcionalidade de sincronização incremental, já que facilita o uso do fluxo de eventos Enterprise para acompanhar as mudanças na ingestão.
      	Manage groups	Necessário para buscar a lista de grupos e os membros deles. Isso é fundamental para o controle de acesso durante a ingestão.

      Observação: se você pretende usar o repositório de dados apenas para pesquisa e não para realizar ações que modifiquem o conteúdo no Box, limite o escopo a Read all files and folders stored in Box. O escopo Write all files and folders stored in Box é necessário para Supported Actions que envolvem a atualização de conteúdo no Box.

3. Na seção Add and manage public keys, clique em Generate a public/private keypair.

   • A chave pública é enviada automaticamente para o console com um ID, usado ao criar uma conexão.
   • É possível fazer o download de um arquivo de configuração com a chave privada e a senha. Mantenha esse arquivo para uso posterior.
   • Opcionalmente, para gerar sua própria chave, consulte o guia de configuração de par de chaves do Box.

4. Clique em Salvar alterações.

Autorizar o app do Box

Para autorizar o app do Box no console do desenvolvedor, faça o seguinte:

1. No Box Developer Console, selecione o app da plataforma e acesse a guia Authorization.
2. Clique em Review and submit.

3. Na caixa de diálogo Review app authorization submission, clique em Submit.

   Se a solicitação de autorização for enviada, a seguinte mensagem de confirmação será mostrada:

   

   A solicitação de autorização foi enviada.

Para autorizar o app do Box no gerenciador de apps da plataforma de administração do Box, faça o seguinte:

1. Faça login no gerenciador de apps da plataforma de administração do Box com sua conta de administrador.
2. Escolha o app da plataforma que você configurou.
3. Clique nos três pontos (...) na linha correspondente.
4. Selecione Authorize app na lista suspensa.
5. Na caixa de diálogo Authorize app, clique em Authorize para concluir o processo de autorização.

Obter informações de autenticação do Box

Para obter as informações de autenticação do Box, faça o seguinte:

1. No Box Developer Console, selecione o app da plataforma na página My Platform Apps.

• ID corporativo: obtenha-o na guia General settings.

  

  Obter o ID corporativo.

• ID do cliente e chave secreta do cliente: obtenha-os na guia Configuration em OAuth 2.0 credentials.

  

  Obter a configuração do cliente.

• Chave privada, ID da chave e senha: esses parâmetros foram gerados e baixados para um arquivo local na guia Configuration em Add and manage public keys ao configurar o app.

  

  Adicionar e gerenciar chaves públicas.