Centro de suporte da Workiva

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.
   
3. Em Authentication Method (Método de autenticação), selecione OAuth 2.0 with JWT e clique em Next (Próximo).
   
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.
   

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.
   
3. Em Application Access, selecione Enterprise e clique em Save Changes.
   
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.
   
   
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.
   

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.
   

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.
   
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:
   
   

   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.