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 sua 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 das soluções 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 Criar app da 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 do 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 Configuração, faça o seguinte:

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

      Observação: o acesso do app + Enterprise é 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 do Enterprise 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 Escopos do aplicativo, selecione os escopos com base no modo de conexão na tabela a seguir:

      Modo de conexão	Escopo	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 do Enterprise para acompanhar as mudanças na ingestão.
      	Manage groups	Necessário para buscar a lista de grupos e os participantes 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 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 compatíveis que envolvem a atualização do 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 para o console com um ID, usado ao criar uma conexão.
   • Você pode 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 do 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 Autorização.
2. Clique em Analisar e enviar.

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

   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 Autorizar app na lista suspensa.
5. Na caixa de diálogo Autorizar app, clique em Autorizar para concluir o processo de autorização.

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

Para receber 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 Meus apps da plataforma.

• ID corporativo: receba-o na guia Configurações gerais.

  

  Obter o ID empresarial.

• ID do cliente e chave secreta do cliente: receba-os na guia Configuração em Credenciais do OAuth 2.0.

  

  Receber a configuração do cliente.

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

  

  Adicionar e gerenciar chaves públicas.