Configuração do Box

Visualização particular:o repositório de dados de ingestão de dados está em visualização particular. 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 sua equipe de contas ou com a equipe de vendas.

Acesso antecipado:os recursos de pesquisa e ações federadas estão em Acesso antecipado. Esse recurso está sujeito aos "Termos das ofertas 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 informações, consulte as descrições da fase de lançamento.

Nesta página, descrevemos 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 Criar app de plataforma.
3. Selecione Tipo de app como App personalizado.
4. Insira o Nome do app.

5. Defina as seguintes propriedades:

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

6. Selecione Método de autenticação como Autenticação do servidor - JWT.

7. Clique em Criar app.

Configurar o app Box

1. No Box Developer Console, selecione o app da plataforma na página Meus apps da plataforma.

   

   Página "Meus apps da plataforma" no Box Developer Console.

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

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

      Observação: o acesso a apps e empresas é 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 corporativo depende desse nível para identificar e recuperar arquivos, comentários e tarefas novos e modificados com eficiência.

      

      Configure o app Box.

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

      Modo de conexão	Scope	Purpose
      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 os arquivos, buscar comentários e tarefas e visualizar arquivos para pesquisa.
      Ingestão de dados	Read all files and folders stored in Box	Obrigatório para 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 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 corporativo para rastrear mudanças na ingestão.
      	Manage groups	Obrigatório para buscar a lista de grupos e participantes. 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 Ler todos os arquivos e pastas armazenados no Box. O escopo Gravar todos os arquivos e pastas armazenados no Box é necessário para ações que envolvem a atualização de conteúdo no Box.

3. Na seção Adicionar e gerenciar chaves públicas, clique em Gerar um par de chaves pública/privada.

   • A chave pública é enviada automaticamente ao 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. Guarde esse arquivo para uso posterior.
   • Se quiser gerar sua própria chave, consulte o guia de configuração do par de chaves do Box.

4. Clique em Salvar alterações.

Autorizar o app Box

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

1. No Console do desenvolvedor do Box, selecione o app da plataforma e acesse a guia Autorização.
2. Clique em Revisar e enviar.

3. Na caixa de diálogo Revisar envio de autorização do app, clique em Enviar.

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

   

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

Para autorizar o app Box no gerenciador de apps da plataforma de administrador 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 de plataforma que você configurou.
3. Clique nos três pontos (...) na linha correspondente.
4. Selecione Autorizar app na lista suspensa.
5. Na caixa de diálogo Autorizar app, clique em Autorizar para concluir o processo.

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

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

1. No Console do desenvolvedor do Box, selecione o app da plataforma na página Meus apps da plataforma.

• ID da empresa: obtenha na guia Configurações gerais.

  

  Obtenha o ID corporativo.

• ID do cliente e chave secreta do cliente: obtenha essas informações na guia Configuração em Credenciais do OAuth 2.0.

  

  Consiga a configuração do cliente.

• Chave privada, ID da chave e Senha longa: esses parâmetros foram gerados e baixados para um arquivo local na guia Configuração em Adicionar e gerenciar chaves públicas ao configurar o app.

  

  Adicione e gerencie chaves públicas.