Integração com Slack

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 13 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
    Download de 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 novo app.
    6. Selecione Do zero.
      A caixa de diálogo Nomear app e escolher espaço é aberta.
    7. Na caixa de diálogo, insira um nome de aplicação no campo Nome da aplicação.
    8. Na lista Espaço de desenvolvimento do Slack, selecione o espaço ao qual você deseja que a aplicação pertença.
    9. 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.
    10. 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.
    11. Expanda a seção Adicionar recursos e funcionalidades e selecione Permissões.
    12. 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.
    13. 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 novo app.
    6. Selecione Do zero.
      A caixa de diálogo Nomear app e escolher espaço é aberta.
    7. Na caixa de diálogo, insira um nome de aplicação no campo Nome da aplicação.
    8. Na lista Espaço de desenvolvimento do Slack, selecione o espaço ao qual você deseja que a aplicação pertença.
    9. 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.
    10. 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.
    11. Expanda a seção Adicionar recursos e funcionalidades e selecione Permissões.
    12. 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.
    13. Na seção Tokens OAuth e URLs de Redirecionamento da página OAuth e Permissões, selecione Instalar app no espaço.
    14. Selecionar Permitir.
      Slack cria a aplicação para o espaço especificado.
    15. 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 do 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 do 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 do 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 do 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 (sn_sam_saas_int) na ServiceNow Store.

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

    Importante:
    Você deve marcar a caixa de seleção Spoke do Slack para esta integração ao instalar recursos opcionais na página Application Manager. Para obter mais informações sobre como escolher as aplicações SaaS necessárias, consulte Solicitação Gestão de licenças de SaaS.

    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é Tudo > 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 diretos.
      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 para exibição Nome do perfil de integração. Por exemplo, Slack Integração.
      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. Revise as funções de usuário necessárias ou as permissões de API especificadas no campo Configuração do fornecedor para cada processo para minimizar os riscos de segurança e otimizar SaaS licenças.
      Nota:
      Para obter mais informações, consulte Tabela de permissões mínimas do usuário.
      1. Na seção Subfluxo de assinatura de download, verifique se o campo Subfluxo está definido como Assinaturas de download do Slack.
        Nota:
        A caixa de seleção Baixar assinaturas está marcada por padrão e você não pode desmarcá-la.
      2. Na seção Calcular subfluxo de atividade, verifique se o campo Subfluxo está definido como Atualizar atividade do usuário no Slack.
        Nota:
        A caixa de seleção Baixar atividade está marcada por padrão. Se você desmarcar, o trabalho agendado de atividade SAM - Refresh <displayname> Activity não será criado.
        No campo Analisar atividade do usuário, você também pode selecionar a data e a hora a partir de quando deseja analisar a atividade do usuário. 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.
      3. Na seção Recuperar subfluxo de assinatura, verifique se o campo Subfluxo está definido como Recuperar assinatura do Slack.
        Nota:
        A caixa de seleção Recuperar assinaturas está marcada por padrão. Se você não quiser recuperar assinaturas, poderá desmarcar esta caixa de seleção. Se você desmarcar, os candidatos a remoção serão criados, mas o subfluxo de assinatura de recuperação não será acionado ou o processo de recuperação não será iniciado.
    4. Selecione Save (Salvar).
      Sua instância ServiceNow cria um perfil de integração de rascunho.

      O campo Conexão e credencial é exibido e definido automaticamente como sn_slack_ah_v2.Slack_Enterprise.

    5. No formulário de perfil de integração, selecione Validar conexão para verificar os detalhes de conexão e credencial desta integração.

      A validação da conexão verifica as APIs Baixar assinaturas e Calcular atividade, mas não as APIs Recuperar assinaturas.

    6. Depois que a conexão for verificada, selecione Publicar.
    7. Na caixa de diálogo, selecione OK.
      Nota:
      Se você desmarcar a caixa de seleção Atividade de download após a publicação do perfil de integração, deverá revalidar as conexões e publicar novamente o perfil de integração, pois ocorrem os seguintes eventos:
      • O campo Status no formulário de perfil de integração muda para Rascunho.
      • O botão Validar conexão aparece no formulário.
      • O trabalho SAM - Refresh <displayname> Activity atual é excluído.
    8. Opcional: Para otimizar a memória e evitar problemas de desempenho no fluxo Workfront, você pode desativar o nível de emissão de relatórios do mecanismo de fluxo.
      1. Navegar até Propriedades do sistema > Todas as Propriedades.
      2. Selecione a propriedade do sistema com.snc.process_flow.reporting.level.
      3. Na página Propriedade do sistema, defina o Valor como DESLIGADO.
      4. 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 software que são atualizadas diariamente.

    Se você quiser configurar vários perfis de integração com conexões exclusivas, crie aliases secundários para gerenciar diferentes configurações e definições para cada perfil de integração. Para obter mais informações, consulte Crie um alias secundário para configurar vários perfis de integração.

    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.