Configuração de Conector do Service Graph para Jamf usando Central do SGC

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 5 min. de leitura

    • Use o playbook disponível com a aplicação Central do SGC para configurar o Conector do Service Graph para Jamf para extrair Jamf dados do CMDB.

    Antes de Iniciar

    Instale Conector do Service Graph para Jamf versão 2.13.0 ou posterior do ServiceNow Store. Para ver as etapas de instalação do ServiceNow Store, consulte Como instalar um aplicativo da loja da ServiceNow.
    Ao usar credenciais do cliente para autenticação, obtenha as credenciais do OAuth com o administrador do Jamf. Anote os seguintes detalhes:
    • ID da aplicação (cliente)
    • Segredo do cliente

    Se estiver usando a autenticação de credenciais do cliente no Jamf Pro, você precisará usar as funções de API e a funcionalidade de clientes. Para obter mais detalhes, consulte a seção Funções e clientes de API na documentação Jamf. Ao criar um novo cliente de API no ambiente Jamf, o campo Tempo de vida do token de acesso no formulário para criar um cliente permite definir por quanto tempo o token permanece válido. O padrão é 60 segundos, mas devido a Now Platform, limitações, o valor deve ser definido como mais de 60 segundos. Definir a vida útil do token como 3600 segundos (1 hora) ajuda a evitar possíveis problemas.

    Função necessária: cmdb_inst_admin ou admin

    Por Que e Quando Desempenhar Esta Tarefa

    O Playbook Experience para conectores de integração é ativado com o Central do SGC em Espaço do CMDB. Para obter mais informações sobre como interagir com um playbook, consulte Interagir com playbook.

    Procedimento

    1. Navegar até Espaços > Espaço do CMDB.
    2. No Espaço do CMDB, selecione Central do SGC.
    3. Na página "Visão geral", selecione Criar conexão.
      Dica:
      Outra opção é selecionar Criar conexão na página "Todas as conexões".
    4. Na janela "Criar conexão", selecione o tipo de conector Jamf e selecione Criar conexão.
    5. Conclua os pré-requisitos iniciais ao configurar uma conexão pela primeira vez usando um conector.
      Nota:
      Esta etapa é necessária somente durante a configuração inicial. Consulte Executar tarefas de configuração inicial ao criar uma conexão no Central do SGC.
    6. Determine o tipo de autenticação para a conexão Jamf.
      1. Na fase Configuração do playbook, selecione a atividade Selecionar modelo de alias.
        Se necessário, expanda a fase Configuração para selecionar uma atividade.
      2. Selecione um modelo de alias para a conexão.
        • Conexão OAuth do SG-Jamf: selecione ao usar o OAuth ou credenciais do cliente para autenticação.
        • Conexão básica do SG-Jamf: selecione ao usar a autenticação básica ou o token do portador.
      3. Selecione Continuar.
    7. Insira os detalhes da conexão e teste a conexão da API para importar dados.
      1. Na fase Configuração do playbook, selecione a atividade Configurar e testar conexão.
      2. No formulário, preencha os campos.
        • Quando o modelo de conexão OAuth do SG-Jamf estiver selecionado, preencha os detalhes conforme mostrado na tabela a seguir.
          Tabela 1. Informações de conexão do OAuth
          Campo Descrição
          Nome da conexão Nome para identificar o registro de conexão Jamf.
          URL de conexão URL base para se conectar à API Jamf.
          Nota:
          Este campo é definido automaticamente como o URL para se conectar à aplicação. Deixe o valor do campo como está.
          ID do cliente do OAuth ID da aplicação (cliente) da sua aplicação cliente Jamf, conforme observado na seção Antes de começar.
          Nota:
          Verifique se o cliente Jamf tem privilégios de leitura para as categorias Computadores e Dispositivos móveis em Jamf.
          Segredo do cliente do OAuth Segredo do cliente da sua aplicação cliente do Jamf, conforme observado na seção Antes de começar.
          Usar MID Server Opção para usar o MID Server.
          Nota:
          O uso de um MID Server é opcional.
          Seleção de MID Nome do MID Server usado pelo conector.

          Esse campo é exibido apenas quando a caixa de seleção Usar MID Server é marcada.
        • Quando o modelo Conexão básica do SG-Jamf estiver selecionado, preencha os detalhes conforme mostrado na tabela a seguir.
          Tabela 2. Informações básicas de conexão
          Campo Descrição
          Nome da conexão Nome para identificar o registro de conexão Jamf.
          Host de conexão Valor de host de destino usado pela conexão.
          Nota:
          Atualize o campo Host com a URL de base ou o endereço IP do Jamf. Por exemplo, demojamfhost.com ou 127.0.0.1.
          Nome de usuário Nome de usuário usado para autenticar a solicitação HTTP ou HTTPS quando este perfil de autenticação Básica estiver habilitado.
          Nota:
          Verifique se o usuário Jamf tem privilégios de leitura para as categorias Computadores e Dispositivos móveis em Jamf.
          Senha Senha usada para autenticar a solicitação HTTP ou HTTPS quando esse perfil de autenticação Básica estiver habilitado.
          Usar MID Server Opção para usar o MID Server.
          Nota:
          O uso de um MID Server é opcional.
          Seleção de MID Nome do MID Server usado pelo conector.

          Esse campo é exibido apenas quando a caixa de seleção Usar MID Server é marcada.
      3. Selecione Criar e testar conexão.
      4. Depois de concluir o teste de conexão, selecione Continuar.
    8. Opcional: Defina as propriedades de configuração da conexão para acessar Jamf recursos.
      Nota:
      Para ignorar essa etapa, selecione Continuar na atividade Definir propriedades de configuração. Se você ignorar esta etapa, os valores padrão das propriedades serão considerados.
      1. Na etapa Configuração do playbook, selecione a atividade Definir propriedades de configuração.
      2. Defina os campos das propriedades de configuração conforme descrito na tabela a seguir.
        Tabela 3. Propriedades de configuração
        Campo Descrição
        Importar somente registros de aplicações gerenciadas Opção para limitar a importação somente a registros de aplicações gerenciadas.
        Nota:
        Se a caixa de seleção Importar somente registros de aplicações gerenciadas estiver desmarcada, o comportamento padrão será importar todos os registros de aplicações.
        Usar API JAMF Pro Opção para habilitar o uso da API Jamf Pro para consultar registros de computador.
        Nota:
        Quando a caixa de seleção Usar JAMF Pro API está marcada, o conector usa a Jamf Pro API, que oferece paginação de dados de resposta e desempenho aprimorado em relação à Jamf Classic API.
      3. Selecione Continuar.
    9. Configure o cronograma de importação para importar dados em intervalos regulares.
      1. Na fase Configuração do playbook, selecione a atividade Configurar cronograma de importação.
      2. Selecione Configurar cronograma de importação.
      3. Marque a caixa de seleção Ativo e preencha os detalhes do cronograma e horário de execução.

        Para mais informações, consulte Schedule a data import.

      4. Selecione Save (Salvar).
      5. Repita as etapas de 9.b a 9.d para cada trabalho exibido na página.
      6. Selecione Continuar.
    10. Na etapa Configuração do playbook, selecione a atividade Confirmar criação de conexão para verificar se a conexão foi criada.

    O que Fazer Depois

    Selecione Exibir todas as conexões para analisar os detalhes da conexão. A conexão configurada é exibida na lista de Conexões instaladas.