Como integrar com PagerDuty

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

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

    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.
    Tabela 1. Permissões mínimas do usuário
    Processo Função do usuário necessária na aplicação PagerDuty Escopos de autenticação
    Baixar assinaturas
    • Criar app OAuth: gerente
    • Geração de token: Observer
    • OAuth com escopo: users:read
    • OAuth de usuário clássico: leitura
    Extrair atividade do usuário
    • Criar app OAuth: gerente
    • Geração de token: Observer
    • OAuth com escopo: oncalls:read
    • OAuth de usuário clássico: leitura
    Recuperar assinatura Criar app OAuth e geração de token: administrador global
    • OAuth com escopo: users:write
    • OAuth de usuário clássico: leitura/gravação

    Criar uma aplicação PagerDuty

    Crie uma aplicação PagerDuty para integrar com sua instância ServiceNow.

    Antes de Iniciar

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

    Procedimento

    1. Em um navegador da Web, abra o PagerDuty.
    2. Faça login na sua conta PagerDuty.
    3. Acesse o modo de desenvolvedor.
      • Se você estiver conectado com uma conta de desenvolvedor, poderá acessar o Modo de desenvolvedor automaticamente.
      • Se você estiver conectado com uma conta de cliente, deverá acessar o Modo de desenvolvedor manualmente.
      1. No cabeçalho da página, selecione o ícone de menu ( Ícone de menu).
      2. Selecione Modo de desenvolvedor.
        Você será redirecionado para a página Meus apps no Modo de desenvolvedor.
    4. Na página Meus apps, selecione Criar novo app.
    5. No formulário Criar um app, preencha os campos.
      Tabela 2. Formulário Criar um app
      Campo Descrição
      Nome da app Nome da aplicação PagerDuty. Por exemplo, ServiceNow Integration.
      Descrição Resumida Breve descrição da aplicação.
      Categoria Categoria da aplicação. Selecione Gestão de API na lista Categoria.
      Gostaríamos de ajudar você a publicar um app público para todos os usuários PagerDuty. Você pretende publicar o app para todos PagerDuty usuários e o ecossistema de apps? Opção que permite tornar sua aplicação pública, publicando-a para todos os usuários PagerDuty. Este campo é opcional.
    6. Selecione Salvar.
      PagerDuty registra sua aplicação e retorna você para a página Meus apps.
    7. Opcional: Defina as configurações adicionais da aplicação.
      1. Na página Meus apps, selecione sua aplicação PagerDuty.
        A página de configuração da aplicação é aberta.
      2. No campo URL do site da aplicação, insira a URL do site por meio do qual os usuários podem saber mais sobre sua aplicação.
      3. No campo URL do ícone, insira a URL de um arquivo de imagem hospedado que você deseja usar como o ícone da aplicação.
        Os ícones devem ter 50 px por 50 px.
      4. Selecione Salvar.

    Adicionar a funcionalidade OAuth 2.0 à sua aplicação PagerDuty

    Depois de criar uma aplicação PagerDuty, adicione a funcionalidade OAuth 2.0 para autorizar sua aplicação a administrar PagerDuty e acessar dados específicos do usuário no login do usuário.

    Antes de Iniciar

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

    Procedimento

    1. Na página Meus apps da sua conta PagerDuty, selecione sua aplicação PagerDuty.
      A página de configuração da aplicação é aberta.
    2. Na seção Funcionalidade, localize OAuth 2 e selecione Adicionar.
      A página OAuth 2 é aberta.
    3. Na seção Adicionar funcionalidade OAuth 2, insira a URL do provedor OAuth para o qual os usuários são redirecionados após a autenticação no campo URL de redirecionamento.
      Insira https://<instance-name>/oauth_redirect.do, em que <instance-name> é o nome da sua instância ServiceNow.
    4. Selecione Salvar.
    5. Na seção Tokens, copie os valores nos campos ID do cliente e Segredo do cliente.
      Salve-os em um local seguro para uso posterior.
    6. Na seção Escopos, selecione OAuth com escopo ou OAuth de usuário clássico.
      Para obter mais informações sobre os escopos de permissão, consulte a tabela Permissões mínimas do usuário.

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

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

    Antes de Iniciar

    Para criar um perfil de integração PagerDuty, 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 [ PagerDuty 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 PagerDuty.
      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 PagerDuty na lista suspensa.
      4. Selecione Continuar.
    2. No formulário, preencha os campos.
      Tabela 3. Formulário Perfil de integração
      Campo Descrição
      Nome de exibição Nome do perfil de integração. Por exemplo, Integração de PagerDuty.
      Conexão e Credencial Alias de conexão e credencial para o spoke PagerDuty.

      Este campo é definido automaticamente como sn_pagerduty_spoke.PagerDuty.
      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 PagerDuty Assinatura.
    3. Na guia Subfluxo de assinatura de download, verifique se o campo Subfluxo está definido como PagerDuty Subfluxo de assinaturasde download .
    4. Na guia Calcular subfluxo de atividade, verifique se o campo Subfluxo está definido como PagerDuty 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 PagerDutyRecuperar 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 PagerDuty Baixar assinaturas, PagerDuty Atualizar atividade do usuário e PagerDuty Recuperar assinatura para recuperar dados do usuário da aplicação PagerDuty.
    7. Abra o registro de aliases de conexão e credencial selecionando o ícone de visualização (ícone de visualização) ao lado do campo Conexão e credencial e selecionando Abrir registro na visualização do registro.
    8. No formulário Aliases de conexão e credencial, selecione o link relacionado Criar nova conexão e credencial.
    9. Na caixa de diálogo, preencha os campos.
      Tabela 4. Caixa de diálogo Criar conexão e credencial
      Campo Descrição
      Nome O nome da conexão. Por exemplo, Conexão PagerDuty.
      ID do cliente OAuth ID de cliente atribuído à sua aplicação PagerDuty.
      Segredo do cliente OAuth Segredo do cliente atribuído à sua aplicação PagerDuty.
      URL de redirecionamento do OAuth URL do provedor OAuth para o qual os usuários são redirecionados após a autenticação. Insira https://<instance-name>/oauth_redirect.do, em que <instance-name> é o nome da sua instância ServiceNow.
    10. 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.
      Você será redirecionado para a página PagerDuty Contas.
    11. Selecione a mesma conta PagerDuty que você usou para criar sua aplicação PagerDuty.
    12. Quando você for solicitado a Autorizar <pagerduty-app-name> para usar sua conta, selecione Autorizar.
      Sua instância ServiceNow cria um token OAuth para PagerDuty e retorna automaticamente para o formulário de perfil de integração.
    13. Selecione Publicar.

    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.