Configuração do Box

Pré-visualização privada: o arquivo de dados de carregamento de dados está em pré-visualização privada. Tem de estar na lista de autorizações para usar o repositório de dados de carregamento de dados. Para ser adicionado à lista de autorizações, contacte a sua equipa da conta ou a equipa de vendas.

Pré-visualização pública: a pesquisa federada está em pré-visualização pública. Esta funcionalidade está sujeita aos "Termos de ofertas de pré-disponibilidade geral" na secção de Termos de Utilização Gerais dos Termos Específicos do Serviço. As funcionalidades pré-GA estão disponíveis "tal como estão" e podem ter apoio técnico limitado. Para mais informações, consulte as descrições das fases de lançamento.

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

Crie uma app Box

1. Inicie sessão na Box Developer Console com a sua conta de administrador.
2. Clique em Criar app de plataforma.
3. Selecione Tipo de app como App personalizada.
4. Introduza o Nome da 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 de servidor (com JWT).

   

   Selecione Autenticação do servidor (com JWT).

7. Clique em Criar app.

Configure a app Box

1. Na Box Developer Console, escolha a app de plataforma e, de seguida, aceda ao separador Configuração.

2. Na secção Nível de acesso à app, selecione Acesso à app + Enterprise.

   Nota: acesso à app + empresa é necessário para obter ficheiros, comentários e tarefas de contas de utilizadores individuais. Além disso, este nível de acesso é necessário para a funcionalidade de sincronização incremental. O fluxo de eventos empresariais baseia-se neste nível para identificar e obter ficheiros, comentários e tarefas novos e modificados de forma eficiente.

3. Na secção Âmbitos da aplicação, selecione os âmbitos de acordo com o seu requisito na tabela seguinte:

   Modo de ligação	Âmbito	Finalidade
   Pesquisa federada	Read all files and folders stored in Box	Necessário para obter comentários e tarefas, e para pré-visualizar ficheiros para pesquisa.
   Carregamento de dados	Read all files and folders stored in Box	Obrigatório para o carregamento de dados.
   	Manage users	Necessário para obter a lista de utilizadores, o que permite a obtenção de ficheiros, comentários e tarefas de contas de utilizadores individuais para carregamento. A conta de serviço do administrador não tem inerentemente acesso a todos os ficheiros pertencentes aos utilizadores. O cabeçalho as-user permite que o sistema faça pedidos de API como o utilizador específico para aceder aos respetivos dados.
   	Manage enterprise properties	Necessário para a funcionalidade de sincronização incremental, uma vez que facilita a utilização da stream de eventos empresarial para acompanhar as alterações para carregamento.
   	Manage groups	Necessário para obter a lista de grupos e os respetivos membros. Isto é fundamental para o controlo de acesso durante o carregamento.

   

   Configure a app Box.

4. Na secção Adicione e faça a gestão de chaves públicas, clique em Gerar um par de chaves pública/privada.

   • A chave pública é carregada automaticamente para a consola com um ID, usado quando cria uma associação.
   • Pode transferir um ficheiro de configuração com a chave privada e a frase de acesso. Certifique-se de que guarda este ficheiro para utilização posterior.

   • Opcionalmente, para gerar a sua própria chave, consulte o guia de configuração do par de chaves do Box.

     

     Faça a gestão das chaves.

5. Clique em Guardar alterações.

Autorize a app Box

1. Na Box Developer Console, escolha a app de plataforma e, de seguida, aceda ao separador Autorização.
2. Clique em Rever e enviar.

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

   

   Autorize a app Box.

   Se o pedido de autorização for enviado com êxito, é apresentada a seguinte mensagem de confirmação:

   

   O pedido de autorização foi enviado com êxito.

4. Inicie sessão no gestor de apps da plataforma de administração do Box com a sua conta de administrador.

5. Escolha a app de plataforma que configurou.

6. Clique nos três pontos (...) na linha correspondente.

7. Selecione Autorizar app na lista pendente.

8. Na caixa de diálogo Autorizar app, clique em Autorizar para concluir o processo de autorização.

   

   Clique em Autorizar.

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

Tenha as seguintes informações de autenticação do Box prontas:

• ID empresarial: obtenha-o no separador Definições gerais.

  

  Obtenha o ID de empresa.

• ID do cliente e segredo do cliente: obtenha-os no separador Configuração em Credenciais do OAuth 2.0.

  

  Obtenha a configuração do cliente.

• Chave privada, ID da chave e Frase de acesso: estes parâmetros foram gerados e transferidos para um ficheiro local a partir do separador Configuração em Adicione e faça a gestão de chaves públicas durante a configuração da app.

  

  Adicione e faça a gestão de chaves públicas.