Como integrar com Slack

Você pode integrar sua instância ServiceNow com a aplicação Slack para rastrear suas assinaturas de software e recuperar licenças não utilizadas.

A integração ServiceNow Slack oferece suporte ao plano Enterprise Grid Slack. Este plano permite que você conecte vários espaços em sua organização. Para configurar esta integração, você deve ter acesso de proprietário da organização na sua conta da organização Slack. Consulte Funções no Slack para obter mais informações sobre esse acesso.

Criar uma aplicação Enterprise Grid Slack

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

Antes de Iniciar

Função necessária: proprietário da organização

Procedimento

1. Em um navegador da Web, abra o Slack.
2. Entre usando suas credenciais Slack.
3. Vá para a plataforma Slack.
4. No cabeçalho da página da plataforma Slack, clique em Seus aplicativos.
5. Na página Seus apps, clique em Criar um app.
   A caixa de diálogo Criar uma aplicação Slack é aberta.
6. Na caixa de diálogo, insira um nome de aplicação no campo Nome da aplicação.
7. Na lista Development Slack Workspace, selecione o espaço ao qual você deseja que a aplicação pertença.
8. Clique em 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 funcionalidade e clique em 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 o URL do provedor OAuth para o qual você deseja redirecionar os usuários após a autenticação.
       1. Clique em Adicionar novo 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. Clique em Adicionar.
       4. Clique em Salvar URLs.
    2. Na seção Escopos de token do usuário, adicione o escopo do OAuth do 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 OAuth, consulte Escopos de permissão OAuth.

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

          Esse 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 seu aplicativo.
    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 a aplicação não contém informações codificadas, como tokens OAuth.
    4. Após a verificação, marque a caixa de seleção Revisei e removi todas as informações codificadas.
    5. Verifique se você concluiu todas as outras seções.
    6. Clique em Ativar distribuição pública.

Criar uma aplicação do 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: proprietário da organização

Procedimento

1. Em um navegador da Web, abra o Slack.
2. Entre usando suas credenciais Slack.
3. Vá para a plataforma Slack.
4. No cabeçalho da página da plataforma Slack, clique em Seus aplicativos.
5. Na página Seus apps, clique em Criar um app.
   A caixa de diálogo Criar uma aplicação Slack é aberta.
6. Na caixa de diálogo, insira um nome de aplicação no campo Nome da aplicação.
7. Na lista Development Slack Workspace, selecione o espaço ao qual você deseja que a aplicação pertença.
8. Clique em 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 funcionalidade e clique em 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 o URL do provedor OAuth para o qual você deseja redirecionar os usuários após a autenticação.
       1. Clique em Adicionar novo 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. Clique em Adicionar.
       4. Clique em Salvar URLs.
    2. Na seção Escopos de token do usuário, adicione o escopo do OAuth do 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 OAuth, consulte Escopos de permissão OAuth.

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

          Esse 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, clique em Instalar app no espaço.
13. Clique em 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 conexão Slack Enterprise

Crie uma conexão entre a aplicação Enterprise Grid [ Slack 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: administrador

Procedimento

1. Na sua instância ServiceNow, navegue até Automação de Processo > Flow Designer.
   O Flow Designer é iniciado em uma nova guia.
2. Selecione a guia Conexões.
3. Clique em Exibir detalhes da sua conexão Slack Enterprise.
4. Na lista de conexões disponíveis, localize Slack Enterprise e clique em Configurar.
   A caixa de diálogo Configurar conexão é aberta.
5. Na caixa de diálogo, preencha ou verifique os seguintes campos.

   Tabela 1. Caixa de diálogo Configurar conexão

   Campo	Valor
   Nome da conexão	Nome da Slack conexão corporativa. Este campo é preenchido automaticamente.
   Nome	Nome das suas credenciais Slack Enterprise. 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 Enterprise Grid Slack.
   Segredo do cliente OAuth	Segredo do cliente que é atribuído à sua aplicação Slack Enterprise Grid. Insira o mesmo segredo do cliente que você copiou em Criar uma aplicação Enterprise Grid Slack.
   URL de redirecionamento do OAuth	URL de redirecionamento para sua aplicação Slack Enterprise Grid. Este campo é preenchido automaticamente.

6. Selecione Configurar e obter token do OAuth.
7. Na caixa de diálogo Autorizar app, verifique se o espaço 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 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 OAuth se torna disponível para autorizar sua conexão corporativa.

Criar uma conexão do 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: admin

Por Que e Quando Desempenhar Esta Tarefa

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

Procedimento

1. Na sua instância ServiceNow, navegue até Automação de Processo > Flow Designer.
   O Flow Designer é iniciado em uma nova guia.
2. Selecione a guia Conexões.
3. Selecione Adicionar conexão para sua conexão empresarial Slack.
   A caixa de diálogo Criar conexão é aberta.
4. Na caixa de diálogo, preencha ou verifique os seguintes campos.

   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 do 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 do espaço Slack.
   URL de redirecionamento do OAuth	URL de redirecionamento da aplicação do espaço Slack. Este campo é preenchido automaticamente.

5. Selecione Criar e obter um Token de OAuth.
   Importante:

   Esta etapa deve ser executada por um administrador ServiceNow com a função de Proprietário da organização em Slack.
   A caixa de diálogo Autorizar app é aberta.
6. Na caixa de diálogo, 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 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 e, em seguida, selecione Novo.
   2. No formulário Slack Tokens de espaço, preencha os seguintes campos.

      Tabela 3. Slack Formulário de tokens de espaço

      Campo	Valor
      Alias de conexão	Nome da conexão do seu espaço Slack. Insira o mesmo nome de conexão inserido na etapa 4.
      Nome do espaço	O nome do espaço ao qual sua aplicação Slack pertence.
      Slack App	Nome da aplicação do espaço Slack. Insira o mesmo nome de aplicação que você inseriu em Criar uma aplicação do espaço Slack.

   3. Selecione Enviar.
   4. Repita as etapas a a 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 admin

Por Que e Quando Desempenhar Esta Tarefa

Se você estiver usando o Software Asset Workspace, a opção para criar o perfil de integração Slack na IU principal ficará inativa.

Procedimento

1. Navegue até o perfil de integração.

   Interface	Ação
   IU principal	Navegar até Todos > Ativo de Software > Licença de SaaS > Perfis de Integração Direta. Selecione Novo. Selecione Perfil de integração empresarial do Slack.
   Espaço de ativo do software	Navegar até Operações de licença > Assinaturas de Usuário > Perfis de integração direta. Selecione Novo. Selecione Slack Enterprise na lista suspensa. Selecione Continuar.

2. No formulário, preencha os campos.

   Tabela 4. Formulário de perfil de integração

   Campo	Valor
   Nome de exibição	Nome do perfil de integração. Por exemplo, Integração com o Slack.
   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 Assinatura empresarial do Slack.

3. Na guia Baixar subfluxo de assinatura, verifique se o campo Subfluxo está definido como Subfluxo de download de assinaturasdo Slack.
4. Na guia Calcular subfluxo de atividade, verifique se o campo Subfluxo está definido como Atualizar subfluxo de atividade do usuário no Slack.
   Você também pode selecionar a data e a hora a partir das quais deseja analisar a atividade do usuário no campo Analisar a atividade do usuário a partir 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 Último limite de 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 Recuperar subfluxo de assinatura do Slack.
6. Clique em 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, clique em Publicar.
   A caixa de diálogo Confirmação de publicação é aberta.
8. Na caixa de diálogo, clique em 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 Propriedades do sistema, defina o Valor como DESLIGADO e clique em 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 sua propriedade.

• Para obter mais informações sobre como criar direitos de software na aplicação clássica Gestão de ativos de software, consulte Criar direitos no clássico Gestão de ativos de software.
• Para obter mais informações sobre como criar direitos de software no Software Asset Workspace, consulte Criar direitos no espaço.
• Para obter mais informações sobre como criar direitos de software usando o Gestão de ativos de software Playbook, consulte Criar direitos usando o tutorial guiado.

A reconciliação também é executada em suas assinaturas como um trabalho programado ou sob demanda. Você pode exibir os resultados da reconciliação no Workbench de licença (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 para corrigir qualquer não conformidade.

• Para obter mais informações sobre como executar a reconciliação na aplicação clássica Gestão de ativos de software, consulte Executar reconciliação de software.
• Para obter mais informações sobre como executar a reconciliação no Software Asset Workspace, consulte Executar reconciliação de software no espaço de trabalho.