Como integrar com Slack

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 11 min. de leitura

    • A integração da aplicação Gestão de ativos de software com a aplicação Slack permite que você rastreie suas assinaturas de software e recupere licenças não utilizadas.

    A integração ServiceNow Slack é compatível com o plano Slack Enterprise Grid. Este plano permite que você conecte vários espaços em sua organização.

    Importante:
    Minimize os riscos de segurança e proteja as informações concedendo acesso somente ao usuário ou às permissões de API necessárias.
    Processo Função do usuário necessária na aplicação Slack Escopos de autenticação
    Baixar assinaturas Proprietário da organização administrador
    Extrair atividade do usuário Proprietário da organização administrador
    Recuperar assinatura Proprietário da organização administrador

    Criar uma aplicação Slack Enterprise Grid

    Crie uma aplicação Slack Enterprise Grid para gerenciar e conectar vários espaços em sua organização.

    Antes de Iniciar

    Função necessária: consulte a tabela Permissões mínimas do usuário.

    Procedimento

    1. Em um navegador da Web, abra o Slack.
    2. Entre usando suas Slack credenciais.
    3. Acesse a plataforma Slack.
    4. No cabeçalho da página da plataforma Slack, selecione Seus apps.
    5. Na página Seus apps, selecione Criar um app.
      A caixa de diálogo Criar um aplicativo Slack é aberta.
    6. Na caixa de diálogo, insira um nome de aplicação no campo Nome da aplicação.
    7. Na lista Espaço de desenvolvimento do Slack, selecione o espaço ao qual você deseja que a aplicação pertença.
    8. Selecione Criar app.
      A plataforma Slack cria a aplicação e redireciona você para a página de informações básicas. Use esta página para exibir e definir as configurações da aplicação.
    9. Na página Informações básicas, expanda a seção Credenciais do app e copie os valores nos campos ID do cliente e Segredo do cliente.
      Salve-os em um local seguro para uso posterior.
    10. Expanda a seção Adicionar recursos e funcionalidades e selecione Permissões.
    11. Na página OAuth e Permissões, configure as permissões que permitem as interações entre a aplicação e a Slack API.
      1. Na seção Redirecionar URLs, adicione a URL do provedor OAuth para o qual você deseja redirecionar os usuários após a autenticação.
        1. Selecione Adicionar nova URL de redirecionamento.
        2. Quando solicitado, insira https://<instance-name>/oauth_redirect.do, em que <instance-name> é o nome da sua instância ServiceNow.
        3. Selecione Adicionar.
        4. Selecione Salvar URLs.
      2. Na seção Escopos de token do usuário, adicione o escopo do OAuth de administrador à aplicação.

        Os escopos do OAuth limitam o nível de acesso que a aplicação tem aos usuários, canais e espaços. Para obter mais informações sobre Slack escopos do OAuth, consulte Escopos de permissão do OAuth.

        1. Selecione Adicionar um escopo OAuth.
        2. Quando solicitado, selecione administrador na lista Escopo do OAuth.

          Este escopo do OAuth permite que a aplicação administre seu espaço.

          Nota:
          O campo Descrição do escopo do OAuth é preenchido automaticamente.
    12. Ative sua aplicação.
      1. No painel de navegação esquerdo, navegue até Configurações > Gerenciar distribuição.
      2. Em Compartilhar seu app com outros espaços, expanda a seção Remover informações codificadas.
      3. Verifique se sua aplicação não contém informações codificadas, como tokens OAuth.
      4. Após a verificação, marque a caixa de seleção Analisei e removi todas as informações codificadas.
      5. Verifique se você concluiu todas as outras seções.
      6. Selecione Ativar Distribuição pública.

    Criar uma aplicação de espaço Slack

    Crie uma aplicação Slack em cada espaço em que você deseja rastrear a atividade do usuário.

    Antes de Iniciar

    Função necessária: consulte a tabela Permissões mínimas do usuário.

    Procedimento

    1. Em um navegador da Web, abra o Slack.
    2. Entre usando suas Slack credenciais.
    3. Acesse a plataforma Slack.
    4. No cabeçalho da página da plataforma Slack, selecione Seus apps.
    5. Na página Seus apps, selecione Criar um app.
      A caixa de diálogo Criar um aplicativo Slack é aberta.
    6. Na caixa de diálogo, insira um nome de aplicação no campo Nome da aplicação.
    7. Na lista Espaço de desenvolvimento do Slack, selecione o espaço ao qual você deseja que a aplicação pertença.
    8. Selecione Criar app.
      A plataforma Slack cria a aplicação e redireciona você para a página de informações básicas. Use esta página para exibir e definir as configurações da aplicação.
    9. Na página Informações básicas, expanda a seção Credenciais do app e copie os valores nos campos ID do cliente e Segredo do cliente.
      Salve-os em um local seguro para uso posterior.
    10. Expanda a seção Adicionar recursos e funcionalidades e selecione Permissões.
    11. Na página OAuth e Permissões, configure as permissões que permitem interações entre a aplicação e a Slack API.
      1. Na seção Redirecionar URLs, adicione a URL do provedor OAuth para o qual você deseja redirecionar os usuários após a autenticação.
        1. Selecione Adicionar nova URL de redirecionamento.
        2. Quando solicitado, insira https://<instance-name>/oauth_redirect.do, em que <instance-name> é o nome da sua instância ServiceNow.
        3. Selecione Adicionar.
        4. Selecione Salvar URLs.
      2. Na seção Escopos de token do usuário, adicione o escopo do OAuth de administrador à aplicação.

        Os escopos do OAuth limitam o nível de acesso que a aplicação tem aos usuários, canais e espaços. Para obter mais informações sobre Slack escopos do OAuth, consulte Escopos de permissão do OAuth.

        1. Selecione Adicionar um escopo OAuth.
        2. Quando solicitado, selecione administrador na lista Escopo do OAuth.

          Este escopo do OAuth permite que a aplicação administre seu espaço.

          Nota:
          O campo Descrição do escopo do OAuth é preenchido automaticamente.
    12. Na seção Tokens OAuth e URLs de Redirecionamento da página OAuth e Permissões, selecione Instalar app no espaço.
    13. Selecionar Permitir.
      Slack cria a aplicação para o espaço especificado.
    14. Repita as etapas 4 a 13 para cada espaço no qual você deseja criar uma aplicação.

    Criar uma Slack conexão empresarial

    Crie uma conexão entre a aplicação Slack Enterprise Grid e sua instância ServiceNow. Esta conexão permite que sua instância recupere dados do usuário da sua aplicação.

    Antes de Iniciar

    Função necessária: sam_integrator ou administrador

    Procedimento

    1. Em sua instância ServiceNow, navegue até Automação de Processo > Flow Designer.
      O Workflow Studio é iniciado em uma nova guia.
    2. Selecione a guia Conexões.
    3. Selecione Exibir detalhes para sua conexão Slack Enterprise.
    4. Na lista de conexões disponíveis, localize Slack Enterprise e selecione Configurar.
    5. Na caixa de diálogo Configurar conexão, preencha ou verifique os campos a seguir.
      Tabela 1. Caixa de diálogo Configurar conexão
      Campo Valor
      Nome da conexão Nome da conexão Slack Enterprise. Este campo é preenchido automaticamente.
      Nome Nome das suas Slack credenciais empresariais. Este campo é preenchido automaticamente.
      ID do cliente OAuth ID de cliente atribuído à sua aplicação Slack Enterprise Grid. Insira o mesmo ID de cliente que você copiou em Criar uma aplicação Slack Enterprise Grid.
      Segredo do cliente OAuth Segredo do cliente atribuído à sua aplicação Slack Enterprise Grid. Insira o mesmo segredo do cliente que você copiou em Criar uma aplicação Slack Enterprise Grid.
      URL de redirecionamento do OAuth Redirecione a URL da sua aplicação Slack Enterprise Grid. Este campo é preenchido automaticamente.
    6. Selecione Configurar e obter token do OAuth.
      Nota:
      Para a função necessária para executar esta etapa, consulte a tabela Permissões mínimas do usuário.
    7. Na caixa de diálogo Autorizar app, verifique se o espaço do Enterprise Grid está disponível na lista superior direita.
    8. Se o espaço Enterprise Grid estiver disponível, selecione o espaço Enterprise Grid.
    9. Se o espaço do Enterprise Grid não estiver disponível,
      1. Selecione Adicionar outro espaço.
      2. Insira a URL do espaço do Enterprise Grid.
      3. Selecione Continuar.
        Você será redirecionado para a caixa de diálogo Autorizar app.
      4. Selecionar Permitir.
        O token de acesso do OAuth se torna disponível para autorizar a conexão do Enterprise.

    Criar uma conexão de espaço Slack

    Crie uma conexão entre seus espaços Slack e sua instância ServiceNow. Esta conexão permite que sua instância recupere dados do usuário de seus espaços.

    Antes de Iniciar

    Função necessária: sam_integrator ou administrador

    Por Que e Quando Desempenhar Esta Tarefa

    Crie uma conexão separada para cada um dos seus espaços Slack.

    Procedimento

    1. Em sua instância ServiceNow, navegue até Automação de Processo > Flow Designer.
      O Workflow Studio é iniciado em uma nova guia.
    2. Selecione a guia Conexões.
    3. Selecione Adicionar conexão para sua conexão Slack Enterprise.
    4. Na caixa de diálogo Criar conexão, preencha ou verifique os campos a seguir.
      Tabela 2. Caixa de diálogo Criar conexão
      Campo Valor
      Nome da conexão Nome da conexão do espaço Slack. Por exemplo, Slack-Workspace-1.
      Nome Nome das suas credenciais do espaço Slack. Por exemplo, Slack-Workspace-1.
      ID do cliente OAuth ID de cliente atribuído à aplicação do espaço Slack. Insira o mesmo ID de cliente que você copiou em Criar uma aplicação de espaço Slack.
      Segredo do cliente OAuth Segredo do cliente que você atribuiu à aplicação do espaço Slack. Insira o mesmo segredo do cliente que você copiou em Criar uma aplicação de espaço Slack.
      URL de redirecionamento do OAuth Redirecione a URL da aplicação do espaço Slack. Este campo é preenchido automaticamente.
    5. Selecione Criar e obter um Token do OAuth.
      Nota:
      Para a função necessária para executar esta etapa, consulte a tabela Permissões mínimas do usuário.
    6. Na caixa de diálogo Autorizar app, selecione Permitir.
      O token de acesso OAuth se torna disponível para autorizar a conexão do espaço Slack.
    7. Repita as etapas 3 a 6 para cada espaço ao qual você deseja se conectar.
    8. Retorne à instância ServiceNow para associar as conexões do espaço Slack à instância.
      1. Navegar até Slack > Tokens do espaço do Slack.
      2. Selecione Novo.
      3. No formulário Tokens de espaço Slack, preencha os campos a seguir.
        Tabela 3. Slack Formulário Tokens do espaço
        Campo Valor
        Alias de conexão Nome da conexão do espaço Slack. Insira o mesmo nome de conexão que você inseriu na etapa 4.
        Nome do espaço O nome do espaço ao qual sua aplicação Slack pertence.
        Slack Aplicação Nome da aplicação do espaço Slack. Insira o mesmo nome da aplicação que você inseriu em Criar uma aplicação de espaço Slack.
      4. Selecione Enviar.
      5. Repita as etapas de a até d para cada conexão de espaço que você deseja associar à sua instância.

    Criação do perfil de Integração Slack

    Crie um perfil de integração Slack para rastrear assinaturas de software e otimizar o licenciamento de suas aplicações Slack.

    Antes de Iniciar

    Para criar um perfil de integração Slack, solicite o plug-in Gestão de ativos de software - Gestão de licenças de SaaS (com.sn_sam_saas_int) na ServiceNow Store.

    ServiceNow Função necessária: sam_integrator ou administrador

    Por Que e Quando Desempenhar Esta Tarefa

    Se você estiver usando Espaço para ativos de software, a opção para criar o perfil de integração [ Slack em IU principal estará inativa.

    Procedimento

    1. Navegue até o perfil de integração.
      InterfaceAção
      IU principal
      1. Navegar até Todos > Ativo de Software > Licença de SaaS > Perfis de Integração Direta.
      2. Selecione Novo.
      3. Selecione Perfil de integração do Slack Enterprise.
      Espaço de ativo do software
      1. Navegar até Operações de licença > Assinaturas de Usuário > Perfis de integração direta.
      2. Selecione Novo.
      3. Selecione Slack Enterprise na lista suspensa.
      4. Selecione Continuar.
    2. No formulário, preencha os campos.
      Tabela 4. Formulário Perfil de integração
      Campo Valor
      Nome de exibição Nome do perfil de integração. Por exemplo, Slack Integração.
      Conexão e Credencial Alias de credencial e conexão para Slack. Este campo é preenchido automaticamente.
      Status Status do perfil de integração.
      • Se você não publicou o perfil de integração, este campo será definido automaticamente como Rascunho.
      • Se você já publicou o perfil de integração, este campo será definido automaticamente como Publicado.
      Tipo de Perfil Tipo de perfil de integração. Este campo é definido automaticamente como Slack Assinatura Enterprise.
    3. Na guia Subfluxo de assinatura de download, verifique se o campo Subfluxo está definido como Slack Subfluxo de assinaturasde download .
    4. Na guia Calcular subfluxo de atividade, verifique se o campo Subfluxo está definido como Slack Atualizar subfluxo de atividade do usuário.
      Você também pode selecionar a data e a hora em que deseja analisar a atividade do usuário no campo Analisar atividade do usuário de. Por padrão, você pode analisar a atividade do usuário até 60 dias antes da data atual e exibir eventos realizados por usuários individuais a partir do momento em que cria este perfil.
      Nota:
      Gestão de ativos de software extrai os eventos a partir do momento em que você começa a analisar a atividade do usuário, independentemente da data de criação do perfil.
      Você pode modificar este valor no campo Limite de última atividade das regras de recuperação de software. Para obter mais informações, consulte Revisar uma regra de recuperação de software.
    5. Na guia Recuperar subfluxo de assinatura, verifique se o campo Subfluxo está definido como Slack Recuperar subfluxo de assinatura.
    6. Selecione Salvar.
      Sua instância ServiceNow cria um perfil de integração de rascunho. O perfil de integração usa os subfluxos Slack Baixar assinaturas, Slack Atualizar atividade do usuário e Slack Recuperar assinatura para recuperar dados do usuário da aplicação Slack.
    7. Depois que o formulário for recarregado, selecione Publicar.
      A caixa de diálogo Confirmação de publicação é aberta.
    8. Na caixa de diálogo, selecione OK.
      Nota:
      Para otimizar a memória e evitar problemas de desempenho no fluxo Slack, você pode desativar o nível de relatório do mecanismo de fluxo navegando até Propriedades do sistema > Todas as Propriedades e selecionando a propriedade do sistema com.snc.process_flow.reporting.level. Na página Propriedade do sistema, defina o Valor como DESLIGADO e selecione Atualizar.

    O que Fazer Depois

    Depois que a integração se conecta, sua instância ServiceNow cria automaticamente modelos de software, regras de recuperação e assinaturas de usuário que são atualizadas diariamente.

    Revise todas as regras de recuperação geradas automaticamente para recuperar assinaturas de usuário. Para obter mais informações, consulte Revisar uma regra de recuperação de software.

    Crie direitos de software para os modelos de software gerados automaticamente para rastrear o software usado em relação ao software de propriedade.
    A reconciliação também é executada em suas assinaturas como um trabalho agendado ou sob demanda. Você pode exibir os resultados da reconciliação no Workbench de licenças (Gestão de ativos de software aplicação clássica) ou na exibição de uso de licença (Software Asset Workspace). Use esses resultados para determinar sua posição de conformidade de licença e corrigir qualquer não conformidade.