Configurar o spoke do Box

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 3 min. de leitura

    • Integre sua instância 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 em sua conta do Box. Quando você configura o spoke do Box, esse fluxo é automatizado.

    Antes de Iniciar

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

    Criar 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 de caixa:
    • Conta do Box
    • Credenciais de administrador do Box
    • Função necessária: administrador

    Por Que e Quando Desempenhar Esta Tarefa

    Conclua essas etapas na sua conta do Box. Consulte a documentação do Portal do desenvolvedor do Box 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.
      Destaca o botão Criar novo app
    3. Selecione App personalizado.
      Realça a opção de aplicação personalizada
    4. Preencha o formulário.

      Campo

      Valor

      Nome da app

      App Box

      Descrição (opcional)

      Deixe este campo em branco

      Finalidade

      Selecionarportal 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 sua instância ServiceNow.

    9. Na seção Escopos da aplicação, habilite as permissões de escopo que 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 empresariais

      Ações de compartilhamento de documentos, gestão de grupos e gestão de usuários

      Gerenciar webhooks

      Configuração de webhooks V2
    10. Selecione Salvar mudanças.

    Configurar 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 sua instância ServiceNow, navegue até Tudo > Automação de Processo > Workflow Studio.
    2. Clique na guia Integrações.
    3. Em Conexões, alterne e habilite as Conexões de saída.
    4. Localize o alias de Box 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.

        Exibir detalhes da conexão do Box.

      • Para gerenciar mais de um registro de conexão do spoke do Box, 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.

      Configure a conexão do Box.

    5. No formulário, preencha estes valores.

      Campo

      Valor

      Nome da Conexão

      Caixa.

      URL de conexão

      O URL da instância neste formato:<provider-domain-name>.net.

      Nome da Credencial

      Credenciais de upload de caixa.

      Nome do OAuth

      Caixa OAuth.

      ID do cliente do OAuth

      O ID do cliente da aplicação. Para obter mais informações, consulte Criação de uma aplicação OAuth.

      Segredo do cliente do OAuth

      O segredo do cliente da aplicação. Para obter mais informações, consulte Criação de uma aplicação OAuth.

      URL de redirecionamento do OAuth

      A URL neste formato: https://<ServiceNow-instance-name> .service-now.com/oauth_redirect.do . Substituir<ServiceNow-instance-name> com o nome da sua instância ServiceNow .

      Configure a conexão do Box.

    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.

    Gerar novamente o token OAuth da caixa

    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 sua instância ServiceNow, navegue até Tudo > Automação de Processo > Flow Designer.
    2. Selecione a guia Conexões.
    3. Pesquise o alias de conexão do Box.
    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.