REVIEWITDocumentação
ProcedimentoAtualizada · verificada em 13 novembro 2026

Preparar um identificador Box

Tradução automática, ainda não revistaEsta página foi traduzida por um modelo a partir da versão francesa, que faz fé. Ler a versão francesa.

01Em resumo #sec_d80f63df

REVIEWIT coleta uma empresa Box através de uma aplicação Box que você cria na consola de desenvolvimento da Box, em modo Server Authentication (Client Credentials Grant). Você confia a REVIEWIT três valores: o Enterprise ID, o Client ID e o Client Secret desta aplicação. REVIEWIT então obtém o token da conta de serviço da aplicação, válido por uma hora, e apenas lê.

Box não oferece uma área « leitura-only » para administração: as áreas Manage users ou Manage groups também permitem escrita, e a opção as-user permite agir em nome de um utilizador. REVIEWIT faz uso apenas em leitura: cada chamada que tem o direito de fazer está escrita no contrato do recurso, e nada mais é enviado.

021. Criar a aplicação #sec_02ac4128

Na Box Developer Console (app.box.com/developers/console), com uma conta da sua empresa:

  1. Create Platform App › Custom App;
  2. método de autenticação Server Authentication (Client Credentials Grant);
  3. nomeie-a, por exemplo REVIEWIT Collector.

Para ver o Client Secret, a verificação em duas etapas deve estar ativada na conta de desenvolvimento.

032. Configurar a aplicação #sec_9b48a95f

Separador Configuração:

  • App Access Level: App + Enterprise Access. Sem ele, a aplicação não vê nenhum utilizador da empresa, e REVIEWIT recusa a ligação.
  • Application Scopes, a marcar de acordo com os recursos que deseja coletar:
ÁreaO que ela abre para REVIEWIT
Read all files and folders stored in BoxPastas partilhadas, colaborações, ligações partilhadas, hubs
Manage usersUtilizadores geridos, administradores, colaboradores externos, utilizadores de aplicação
Manage groupsGrupos, membros, administradores de grupo
Manage enterprise propertiesDiário de administração (última ligação), domínios autorizados, barreiras de informação, ligações Slack e Teams, hubs da empresa
Manage retention policiesPolíticas de retenção (Box Governance)
Manage legal holdsConservações legais (Box Governance; área sob pedido ao suporte Box)
  • Advanced Features: marque Make API calls using the as-user header. A conta de serviço vê apenas sua própria pasta: o conteúdo dos seus utilizadores é lido em seu nome, em leitura-only.

Uma área que você não marcar não bloqueia a ligação: os recursos que dependem dela permanecem simplesmente não coletáveis, e a etapa Preparar do assistente os nomeia. Um módulo que você não contratou (Box Governance, Box Shield) é lido como « não contratado », nunca « vazio ».

043. Fazer autorizar a aplicação por um administrador #sec_209c1692

Uma aplicação Client Credentials Grant só funciona autorizada na sua empresa:

  1. separador Authorization da aplicação › Review and Submit;
  2. um administrador Box: Admin Console › Platform › Platform Apps, a aplicação submetida › Authorize (ou Add com seu Client ID).

Qualquer modificação das áreas ou do acesso exige uma nova autorização (Platform Apps › … › Reauthorize): enquanto não for feita, Box aplica a configuração antiga.

054. Obter os três valores #sec_6b0a65ee

ValorOnde encontrá-la
Enterprise IDAdmin Console › Account & Billing › Account Information (um número) ; também no separador General Settings da aplicação
Client IDApplication › Configuration › OAuth 2.0 Credentials
Client SecretMesmo local ( Fetch Client Secret )

Em REVIEWIT : Conexões › Nova conexão › Box , introduza os três valores. A verificação :

  1. obtém o token da conta de serviço ;
  2. verifica se essa conta pertence à empresa introduzida ;
  3. verifica se vê os utilizadores da empresa ( App + Enterprise Access ).

Depois, a prova dos direitos constata cada âmbito por uma leitura mínima : Box não permite que uma aplicação liste os seus próprios âmbitos.

065. Se a conexão for recusada #sec_28cc585b

Mensagem da BoxCausaAção
unauthorized_clientA aplicação não está autorizada na empresaSecção 3
invalid_grant / invalid_clientSecret errado ou regenerado, ou Enterprise ID que não é o da autorizaçãoRecopiar o secret, verificar o Enterprise ID
The grant type is unauthorizedA aplicação não está em Client Credentials GrantCriar uma aplicação Server Authentication (Client Credentials Grant)
the app reaches the enterprise but cannot list its usersApp Access Only , ou âmbito Manage users ausenteSecção 2, depois reautorizar (secção 3)
insufficient_scopeUm âmbito faltaAssinalar o âmbito, depois reautorizar

O secret só muda se o regenerar : faça-o a cada saída de uma pessoa que o viu, depois substitua-o em REVIEWIT.

Esc
↑↓ navegar↵ abrirVer todos os resultados →