Configure o spoke do Box

Integre seu ServiceNow E as APIs do Box para automatizar as ações do spoke do Box. Por exemplo, você pode configurar um fluxo que remove um arquivo na sua conta do Box. Quando você configura o spoke do Box, este fluxo é automatizado.

Antes de Iniciar

• Solicitar uma assinatura de IntegrationHub.
• Ative o. Spoke do Box.
• Acesso ao console do desenvolvedor do Box.
• Função necessária: administrador

Crie uma aplicação OAuth

Crie uma aplicação OAuth personalizada de sua conta do Box para habilitar a autenticação OAuth 2.0 com o spoke do Box.

Antes de Iniciar

Requisitos do Box:

• Conta do Box
• Credenciais de administrador do Box
• Função necessária: administrador

Por Que e Quando Desempenhar Esta Tarefa

Conclua estas etapas na sua conta do Box. Consulte Portal do desenvolvedor do Box documentação para obter instruções sobre como criar e configurar aplicações personalizadas.

Procedimento

1. Faça login no Console do desenvolvedor do Box .
2. Selecione Criar novo app .
   
3. Selecione Aplicativo personalizado .
   
4. Preencha o formulário.

   Campo	Valor
   Nome da aplicação	Aplicativo Box
   Descrição (opcional)	Deixe este campo em branco
   Finalidade	Selecione Portal personalizado

5. Selecione Avançar.
   O modal Criar um app personalizado é exibido.
6. Selecione Autenticação de usuário (OAuth 2,0) .
7. Para confirmar, selecione Criar app .
   Você está nas definições de configuração da sua aplicação.
8. Na seção Credenciais do OAuth 2,0, copie o ID do cliente e o segredo do cliente.

   Você precisa dessas informações para registrar a aplicação como um provedor OAuth de terceiros em seu ServiceNow instância.

9. Na seção Escopos da aplicação, habilite as permissões de escopo às quais você deseja oferecer suporte.

   Escopos de aplicação	Necessário para...
   Ler e gravar todos os arquivos e pastas armazenados no Box	Ações de gestão de documentos, compartilhamento de documentos e gestão de pastas
   Gerenciar usuários	Ações de gestão de usuários
   Gerenciar grupos	Ações de gestão de grupo
   Gerenciar propriedades da empresa	Compartilhamento de documentos, gestão de grupos e ações de gestão de usuários
   Gerenciar webhooks	Configurar webhooks V2

10. Selecione Salvar mudanças .

Configure um registro de conexão para o spoke do Box

Adicione e configure uma conexão do Box para autenticar ServiceNow Solicitações em um spoke do Box.

Antes de Iniciar

Função necessária: administrador

Procedimento

1. Em seu ServiceNow instância, navegue até Tudo > Automação de Processo > Workflow Studio.
2. Clique na guia Integrações.
3. Em Conexões , alterne e habilite Saída conexões.
4. Localize o alias para Caixa e clique em Exibir detalhes .
   • Para configurar a conexão padrão e o registro de alias de credencial que é enviado junto com o spoke do Box, clique em Exibir detalhes .

     

   • Para gerenciar mais de um registro de conexão do Box Spoke, você deve criar um novo registro de alias secundário clicando em Adicionar conexão . Para obter mais informações sobre como usar várias conexões, consulte Suporte a várias conexões.

   Se você estiver configurando o spoke pela primeira vez, clique em Configurar. Caso contrário, clique em Editar.

   

5. No formulário, preencha estes valores.

   Campo	Valor
   Nome da Conexão	Caixa .
   URL de conexão	A URL da instância neste formato: <provider-domain-name>.net .
   Nome da Credencial	Credenciais de carregamento do Box .
   Nome do OAuth	Caixa OAuth .
   ID do cliente do OAuth	O ID do cliente da aplicação. Para obter mais informações, consulte Crie uma aplicação OAuth .
   Segredo do cliente do OAuth	O segredo do cliente da aplicação. Para obter mais informações, consulte Crie uma aplicação OAuth .
   URL de redirecionamento do OAuth	O URL neste formato: https://<ServiceNow-instance-name>.service-now.com/oauth_redirect.do . Substituir <ServiceNow-instance-name> com seu ServiceNow nome da instância.

   

6. Clique em Configurar conexão .

Resultado

A conexão do spoke está configurada e pronta para ser usada.

Nota:

Os tokens OAuth expiram após 30 dias. Um administrador pode gerar novamente o token OAuth do spoke a cada 30 dias.

Token OAuth do Box novamente

Gere novamente o token OAuth do Box quando ele expirar. O token OAuth do spoke do Box expira a cada trinta dias.

Antes de Iniciar

Função necessária: administrador

Procedimento

1. Em seu ServiceNow instância, navegue até Tudo > Automação de Processo > Flow Designer.
2. Selecione Conexões guia.
3. PESQUISE Caixa alias de conexão.
4. Selecione Exibir detalhes.
5. Selecione Obter token OAuth para a conexão.

Resultado

O spoke do Box recebe um novo token de acesso OAuth. Expira em 30 dias.

Integre a instância da ServiceNow com o tipo de concessão do portador JWT

Configure um provedor OAuth com o tipo de concessão de portador JWT para integrar seu ServiceNow Instância com Box.

Antes de Iniciar

Função necessária: administrador

Procedimento

1. Execute as etapas no final da caixa
   1. Inscreva-se no Conta de desenvolvedor do Box .
   2. Em Console do desenvolvedor , selecione Aplicativo personalizado .
   3. Confirme se o método de autenticação é OAuth 2,0 com JWT (Autenticação do servidor).
   4. Insira um nome exclusivo para o app e crie o app.
   5. Exiba o app .
   6. Em Credenciais do OAuth 2,0, copie o ID do cliente e o segredo do cliente.
   7. Crie um novo armazenamento de chaves e exporte uma chave pública dele para o BOX.
   8. Anote o ID da empresa nas Configurações da aplicação.
   9. Navegar até Meus apps > <App Name> > Geral > Enviar para autorização.
   10. Selecione o nome da sua conta na parte superior do Console do administrador.
   11. Em sua conta, crie uma pasta e carregue um arquivo de texto.
2. Execute as etapas em ServiceNow fim da instância
   1. Navegar até Definição do Sistema > Certificados > Novo(a) > Tipo > Storepass.
   2. Anexe o certificado do armazenamento de chaves.
   3. Para configurar uma chave de assinatura JWT navegando até OAuth de Sistema > Chaves de JWT > Novo(a).
   4. Para criar uma entrada de registro da aplicação OAuth navegando até OAuth de Sistema > Registro de aplicações > Novo(a) > Conectar-se a um provedor OAuth de terceiros > Tipo de concessão padrão ( portador JWT).
   5. No perfil de entidade OAuth (oauth_entity_profile), associe o "provedor jwt" criado.
   6. Crie uma mensagem REST.
   7. Na Mensagem REST, selecione Obter token OAuth para obter o token de acesso.
   8. Vá para o método "GET padrão" e clique em "Testar".
   9. No final do The BOX, compartilhe a pasta e o arquivo.