|
Os tipos de arquivos clássicos não estarão mais disponíveis para uso a partir de janeiro de 2021. Você pode fazer a transição de seus arquivos clássicos ou baixar um PDF. Saber mais

Centro de suporte da Workiva

Conector para Box

Conector para Box

  • Última atualização em

Com o conector Box®, você pode usar os comandos para interagir com as unidades Box, como, por exemplo, para:

  • Pesquisar e gerenciar arquivos
  • Criar e excluir pastas
  • Recuperar URLs para arquivos e pastas
Observação: Esse conector foi criado pela Workiva e se conecta a um sistema de terceiros. Embora nossa equipe de suporte possa ajudar a configurar esse conector no seu espaço de trabalho, não podemos solucionar problemas ou ajudar com problemas que se originem fora da plataforma Workiva.

Pré-requisitos

Para configurar o conector, você precisará de:

  • Um aplicativo Box personalizado para a integração da conta de serviço
  • O ID corporativo do aplicativo personalizado, o ID e o segredo do cliente e a chave privada

Criar uma integração de conta de serviço no Box

Antes de você configurar o conector Box, crie um aplicativo Box personalizado para a integração da conta de serviço. Para configurar o par de chaves públicas/privadas do aplicativo, você precisará de: 

  • OpenSSL
  • Um editor de texto simples, como Windows Notepad
  • Autenticação de dois fatores (2FA) ativada no Box

Etapa 1: Crie um aplicativo Box personalizado

  1. Em Dev Console in Box, clique em Create New App.
  2. Selecione Custom App e clique em Next.
    box-app-types.png
  3. Em Authentication Method (Método de autenticação), selecione OAuth 2.0 with JWT e clique em Next (Próximo).
    box-auth-types-jwt.png
  4. Digite um nome exclusivo para ajudar a identificar o aplicativo, como Workiva Box App, e clique em Create App e, em seguida, View Your App.
    box-app-name.png

Etapa 2: criar o par de chaves RSA do aplicativo

Para proteger a conexão, o conector Box se autentica usando o par de chaves públicas/privadas Rivest-Shamir-Adleman (RSA) do aplicativo personalizado. Para criar esse par de chaves em OpenSSL, digite os seguintes comandos:

openssl genrsa -out private.pem 2048
openssl rsa -in private.pem -outform PEM -pubout -out public.pem

Esses comandos geram dois arquivos:

  • private.pem, que contém a chave do cliente que o conector usa para autenticar com o Box
  • public.pem, que o aplicativo personalizado requer para sua configuração

Etapa 3: Configurar o aplicativo personalizado

  1. No console de desenvolvimento na caixa, selecione Configuration para o aplicativo personalizado.
  2. Em Authentication Method, verifique se OAuth 2.0 with JWT está selecionado.
    box-auth.png
  3. Em Application Access, selecione Enterprise e clique em Save Changes.
    box-app-access.png
  4. Em um editor de texto simples, abra o arquivo public.pem e copie todo o seu conteúdo, inclusive a linha de cabeçalho -----BEGIN PUBLIC KEY-----, a linha de rodapé -----END PUBLIC KEY----- e todos os espaços finais.
  5. No Dev Console in Box, selecione Configuration para o aplicativo personalizado e clique em Add a Public Key em Add and Manage Public Keys.
    box-app-add-keys.png
  6. Cole todo o conteúdo do arquivo public.pem e clique em Verify and Save.
  7. Quando solicitado, digite o código 2FA da sua conta Box e clique em Enviar.
  8. Em OAuth 2.0 Credentials, copie o ID do cliente do aplicativo personalizado.
    box-oauth-2-creds.png

Etapa 4: Autorizar o aplicativo personalizado no Box

  1. No Console do administrador na caixa, clique em Apps.
  2. Na guia Custom Apps, clique em Authorize New App.
  3. Cole o ID de cliente do aplicativo personalizado e clique em Next.
  4. Em App Authorization, verifique se o aplicativo está autorizado para Todos os usuários e clique em Authorize.

Etapa 5: Adicionar o ID da conta de serviço como colaborador a uma pasta do Box

  1. Em Dev Console in Box, selecione Configuration para o aplicativo personalizado.
  2. Copie o ID da conta de serviço.
  3. Vá para a pasta Box que será compartilhada. Em Sharing (Compartilhamento), procure a seção Collaborators (Colaboradores) e clique em Invite People (Convidar pessoas) para adicionar o ID da conta de serviço.
    Screenshot - 4_19_2024 , 2_07_46 PM.png

Configure o conector Box

Observação: Para tornar o conector disponível para uso nas cadeias de sua organização, um administrador de segurança da organização primeiro o habilita em Configuração.
  1. Em Construtor de cadeia, clique em Conexões compare_arrows e, em seguida, Criar no canto superior direito.
  2. Em Conector Conexão, selecione Box e o CloudRunner padrão.
    box-connector_01.png
  3. Em Informações básicas, digite um nome e uma descrição exclusivos para ajudar a identificar a conexão.
  4. Em Propriedades, digite os detalhes da conexão:
    box-connector_02.png
    Propriedade Detalhes
    ID do cliente Insira o ID do cliente do aplicativo Box personalizado para usar como a integração da conta de serviço do conector.
    Observação: Do console de desenvolvimento na caixa, o ID do cliente aparece em Credenciais OAuth 2.0 na guia Configuration do aplicativo personalizado.
    Segredo do cliente Digite o segredo do cliente do aplicativo personalizado. 
    Observação: No console de desenvolvimento in Box, o segredo do cliente aparece em Credenciais OAuth 2.0 na guia Configuration do aplicativo personalizado.
    Chave do cliente Insira todo o conteúdo do arquivo private.pem criado para o aplicativo personalizado, incluindo a linha de cabeçalho -----BEGIN RSA PRIVATE KEY-----, a linha de rodapé -----END RSA PRIVATE KEY----- e todos os espaços finais.
    ID da empresa Digite o ID corporativo do aplicativo personalizado.
    Observação: No console de desenvolvimento in Box, o ID da empresa aparece em App Info na guia General do aplicativo personalizado.
    Observação: Todas as credenciais confidenciais são automaticamente criptografadas e armazenadas com criptografia Advanced Encryption Standard (AES) 256.
  5. Selecione os ambientes para usar a conexão e clique em Save.
  6. Para testar a conexão, crie e execute uma cadeia com o comando Get Folder Info do conector e verifique se ele retorna uma saída válida.

Solução de problemas

Se a conexão com o Box falhar:

  • Certifique-se de que o aplicativo personalizado esteja autorizado no Box.
  • Verifique a ID do cliente e o segredo do aplicativo personalizado inseridos para o conector. No console de desenvolvimento no Box, a ID do cliente e o segredo aparecem em OAuth 2.0 Credentials na guia Configuration do aplicativo personalizado. Para redefinir as credenciais, clique em Reset. 
  • Certifique-se de que todo o conteúdo de dos arquivos public.pem e private.pem do aplicativo personalizado seja inserido nas configurações do aplicativo e do conector, respectivamente. Inclua a linha do cabeçalho, a linha do rodapé e todos os espaços à direita. Se necessário, crie um novo par de chaves públicas/privadas no OpenSSL e insira seu conteúdo nas configurações do aplicativo e do conector.
  • Verifique o ID corporativo do aplicativo personalizado inserido para o conector. No console de desenvolvimento no Box, o ID da empresa aparece em App Info na guia General do aplicativo personalizado.
  • Verifique se a pasta que está sendo compartilhada tem o ID da conta de serviço adicionado como colaborador.
Com o conector Box®, você pode usar os comandos para interagir com as unidades Box, como, por exemplo, para: Pesquis...