Configurar o spoke do Box

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 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

    • Solicite a assinatura do Integration Hub.
    • Ativar o plug-in 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 uma conexão para um 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é Todos > 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. Configure uma conexão.
      1. Adicione ou edite uma conexão.

        • Para configurar uma conexão existente, selecione Configurar ou Editar.

        • Para criar e configurar uma nova conexão, selecione Adicionar conexão.

        Nota:
        Para oferecer suporte a várias conexões por meio de um spoke, consulte Suporte a várias conexões.
      2. Preencha o formulário de configuração.

        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 OAuth

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

        Segredo do cliente 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

        O URL neste formato:<instance-name> .com/oauth.do.
      3. Confirme sua configuração.
        • Para uma conexão existente, selecione Editar e obter token OAuth.
        • Para uma nova conexão, selecione Configurar e obter token OAuth.
        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é Todos > 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.