Como configurar o Conector do Service Graph para Jamf

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

    • Configure as credenciais de autenticação e trabalhos agendados para importar dados do Jamf para o seu CMDB.

    Antes de Iniciar

    Para usar este Conector do Service Graph, você precisa de uma assinatura para uma Unidade de Assinatura baseada na aplicação Visibilidade IT Operations Management (ITOM) ou na aplicação Descoberta ITOM. Conforme definido na seção intitulada "Tipos de recurso de TI gerenciados" em Visão geral da unidade de assinatura da ServiceNow, para sua assinatura, para recursos de TI gerenciados criados ou modificados em CMDB por este Conector do Service Graph, mas que ainda não são gerenciados pela Visibilidade do ITOM ou pela Descoberta do ITOM, esses recursos aumentarão o consumo da Unidade de Assinatura dessa aplicação. Analise o consumo atual da unidade de assinatura na Visibilidade do ITOM ou no ITOM Discovery para garantir a capacidade disponível.

    Dependências e requisitos:

    Função necessária: administrador

    Procedimento

    1. Navegar até Todos > Service Graph Connectors > Jamf > Configuração.
    2. Na página de Introdução, selecione Introdução.
    3. Configure as propriedades.
      1. Na página Conector do Service Graph para Jamf, na seção Configurar as propriedades, selecione a tarefa Configurar o comprimento parcial máximo do JSON de transformação.
      2. Para a tarefa "Configurar tamanho parcial máximo do JSON de transformação", selecione Configurar.
      3. Selecione o escopo da aplicação Global no seletor de aplicações.
      4. Para criar uma nova propriedade do sistema, selecione Novo.
      5. No campo Nome, insira com.glide.transform.json.max-partial-length.
      6. No campo Valor, insira 65536.
        Nota:
        O campo Valor é necessário para que a transformação funcione.
      7. Defina a tarefa Configurar tamanho parcial máximo do JSON de transformação como concluída clicando em Marcar como concluído.
      8. Filtre as aplicações pessoais.
        Nota:
        Por padrão, o SG-Jamf importa todos os registros de aplicação. Para importar somente registros de aplicações gerenciadas, defina o valor da propriedade sn_jamf_integrate.import_managed_apps_only como true. Além disso, o usuário precisa ter privilégios de leitura para a categoria Apps para dispositivos móveis em Jamf.
        1. Para a tarefa "Filtrar aplicações pessoais", selecione Configurar.
        2. Selecione o nome da propriedade.
        3. No campo Valor, atualize o valor de false para true.
        4. Defina a tarefa "Filtrar aplicações pessoais" como concluída clicando em Marcar como concluído.
      9. Ao usar a API Jamf Pro, a versão Jamf Pro 10.35 ou superior, ou ambas, especifica a versão e a API do Jamf Pro.
        1. Para a tarefa "Selecionar versão e API do JAMF Pro", selecione Configurar.
        2. Ao usar a API Jamf Pro em vez da API Classic, na página "Conexões do JAMF", marque a caixa de seleção Usar API JAMF Pro.
        3. Ao usar a versão Jamf Pro 10.35 ou posterior, marque a caixa de seleção Jamf Pro 10.35 ou superior.
          Nota:
          Se você estiver usando as versões Jamf Pro 10.35 ou posteriores, marque a caixa de seleção Jamf Pro 10.35 ou superior para evitar a geração de erros. Com a caixa de seleção Jamf Pro 10.35 ou superior marcada, a autenticação de token do portador é usada para autenticar a API Jamf. Caso contrário, a autenticação básica será usada.
        4. Selecione Atualizar.
        5. Defina a tarefa "Selecionar versão e API do JAMF Pro" como concluída clicando em Marcar como concluído.
      10. Configurar Jamf credenciais de autenticação.
        1. Para a tarefa "Configurar credenciais de autenticação do Jamf", selecione Configurar.
        2. No formulário, preencha os campos.
          Tabela 1. Formulário de credenciais de autenticação básica
          Campo Descrição
          Nome Nome descritivo desta configuração de autenticação.
          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:
          O usuário precisa ter 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.
        3. Selecione Atualizar.
        4. Defina a tarefa "Configurar credenciais de autenticação do Jamf" como concluída clicando em Marcar como concluído.
      11. Configurar a conexão HTTP do Jamf.
        1. Para a tarefa "Configurar conexão HTTP do Jamf", selecione Configurar.
        2. No formulário, preencha os campos.
          Tabela 2. Formulário de conexão HTTP
          Campo Descrição
          Nome Nome da conexão.
          Credencial Valor de credencial usado por esta conexão.
          Alias de conexão Valor de conexão usado para se referir à conexão.
          Ativo Opção para ativar a conexão HTTP.
          Domínio Domínio que contém a conexão.
          Construtor de URL Opção para habilitar o sistema a criar a URL de conexão.
          URL de Conexão URL da conexão. Você pode inserir uma URL manualmente ou usar o construtor de URL para criar a cadeia de conexão.
          Nota:
          Você não poderá modificar o campo URL de conexão se marcar a caixa de seleção do Construtor de URL.
          Autenticação mútua Opção de definir a conexão com autenticação mútua. Esse campo é exibido apenas quando a caixa de seleção Construtor de URL é marcada.
          Protocolo Protocolo subjacente usado pela conexão. Esse campo é exibido apenas quando a caixa de seleção Construtor de URL é marcada.
          Nota:
          Atualize o campo Protocolo se não estiver usando https.
          Usar MID Server Opção para selecionar um MID Server que envia esta conexão HTTP. O uso de um MID Server não é compatível com a autenticação mútua.
          Tempo limite de conexão Número de milissegundos que o sistema espera por uma conexão de host bem-sucedida. Se uma conexão bem-sucedida não ocorrer durante esse tempo, a solicitação de conexão expirará. Deixe este campo em branco para usar o valor de tempo limite de conexão padrão do sistema.
          Host Valor de host de destino usado pela conexão. Esse campo é exibido apenas quando a caixa de seleção Construtor de URL é marcada.
          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.
          Substituir porta padrão Porta de valor de destino usada pela conexão. Esse campo é exibido apenas quando a caixa de seleção Construtor de URL é marcada.
          Caminho base Caminho base da conexão HTTPS. Esse campo é exibido apenas quando a caixa de seleção Construtor de URL é marcada.
          Nota:
          Para usar a API Jamf Pro, o campo Caminho base deve estar vazio. Portanto, desmarque qualquer valor no campo Caminho base.
        3. Selecione Atualizar.
        4. Defina a tarefa "Configurar a conexão HTTP do Jamf" como concluída clicando em Marcar como concluído.
      12. Teste a conexão.
        1. Para a tarefa Testar conexão, selecione Configurar.
        2. Teste a conexão clicando no link relacionado Testar carregamento 20 registros.

          O teste de conexão pode levar alguns minutos. A página é atualizada para mostrar os resultados do teste.

          Nota:
          A conexão será bem-sucedida se o Status HTTP for 200. Se houver algo exibido nos campos Código de Erro e Mensagem de erro, significa que a conexão falhou e será necessário executar a solução de problemas. Não clique em Carregar todos os registros durante essa etapa.
        3. Defina a tarefa Testar conexão como concluída clicando em Marcar como concluído.
    4. Opcional: Adicionar várias instâncias.
      Nota:
      Se você não precisar adicionar várias instâncias, poderá ignorar essa etapa.
      1. Na seção Adicionar várias instâncias da página Conector do Service Graph para Jamf, selecione Iniciar.
      2. Criar fontes de dados para a nova conexão Jamf.
        1. Verifique se você tem permissões de edição para a tabela Fonte de dados [sys_data_source].
        2. Na tarefa Atualizar acesso à fonte de dados, selecione Configurar.
        3. Para editar o registro, selecione o escopo da aplicação Global no seletor de aplicações.
        4. Na lista relacionada de acesso à aplicação no formulário de fonte de dados que abre em uma nova guia, selecione as caixas de seleção Pode criar, Pode atualizar e Pode excluir.
        5. Selecione Atualizar.
        6. Selecione o ícone Voltar (<) para retornar à página de configuração assistida.
        7. No seletor de aplicações, selecione o escopo da aplicação Conector do Service Graph para Jamf.
        8. Defina a tarefa Atualizar acesso à fonte de dados como concluída clicando em Marcar como concluído.
      3. Crie um trabalho de importação agendada para a nova conexão Jamf.
        1. Verifique se você tem permissões de edição para a tabela "Importação agendada de dados" [scheduled_import_set].
        2. Na tarefa Atualizar acesso à importação agendada de dados, selecione Configurar.
        3. Para editar o registro, selecione o escopo da aplicação Global no seletor de aplicações.
        4. Na lista relacionada de Acesso à Aplicação no formulário de Importação Programada de Dados que abre em uma nova guia, selecione as caixas de seleção Pode criar, Pode atualizar e Pode excluir.
        5. Selecione Atualizar.
        6. Selecione o ícone Voltar (<) para retornar à página de configuração assistida.
        7. No seletor de aplicações, selecione o escopo da aplicação Conector do Service Graph para Jamf.
        8. Defina a tarefa Atualizar acesso à importação agendada de dados como concluída clicando em Marcar como concluído.
      4. Adicionar outra conexão.
        Nota:
        No seletor de aplicações, selecione o escopo da aplicação Conector do Service Graph para Jamf.
        1. Na tarefa "Adicionar outra conexão", selecione Configurar.
        2. No Workflow Studio, selecione Adicionar conexão.
        3. No formulário, preencha os campos.
          Tabela 3. Formulário de conexão
          Campo Descrição
          Nome da conexão Nome de exibição da conexão.
          URL de Conexão URL da nova conexão.
          Nome de usuário Credencial de nome de usuário para a nova conexão.
          Senha Credencial de senha de usuário para a nova conexão.
        4. Selecione Criar conexão.
        5. Navegue de volta à configuração assistida e selecione Marcar como concluído.
      5. Opcional: Configurar o MID Server na conexão que você criou.
        1. Na tarefa "Configurar MID Servers", selecione Configurar.
        2. Selecione o nome da conexão criada.
        3. Marque a caixa de seleção Usar MID Server.
        4. Selecione Atualizar.
        5. Defina a tarefa Configurar MID Servers como concluída clicando em Marcar como concluído.
      6. Ao usar a API Jamf Pro, a versão Jamf Pro 10.35 ou superior, ou ambas, especifica a versão e a API do Jamf Pro.
        1. Para a tarefa Selecionar versão e API do JAMF Pro, selecione Configurar.
        2. Na coluna Usar API do JAMF Pro, na conexão criada, modifique o valor de falso para verdadeiro para usar a API Jamf Pro em vez da API Classic.
        3. Atualize o valor da coluna Jamf Pro 10.35 ou superior para verdadeiro ao usar a versão Jamf Pro 10.35 ou superior.
          Nota:
          Com o valor da coluna Jamf Pro 10.35 ou superior definido como verdadeiro, a autenticação de token do portador é usada para autenticar a API do Jamf. Caso contrário, a autenticação básica será usada.
        4. Defina a tarefa Selecionar versão e API do JAMF Pro como concluída clicando em Marcar como concluído.
      7. Teste as novas conexões.
        1. Para a tarefa "Testar novas conexões", selecione Configurar.
        2. Selecione o nome da conexão que deseja testar.
        3. Para validar a configuração da fonte de dados, clique em Testar carga de 20 registros.
          Nota:
          Se qualquer um dos testes tiver um código de erro ou mensagem/sinal de erro, a conexão falhou e será necessário efetuar a solução de problemas.
        4. Defina a tarefa "Testar novas conexões" como concluída clicando em Marcar como concluído.
    5. Configurar os trabalhos de importação agendados.
      1. Na tarefa Configurar trabalhos agendados, seção Configurar trabalhos de importação agendada, selecione Configurar.
      2. Selecione o trabalho agendado que você deseja ativar.
        Nota:
        Por padrão, o trabalho agendado "Dispositivos móveis SG-JAMF" é definido automaticamente como Ativo e executa o trabalho agendado "Computador SG-Jamf" como o trabalho primário.
      3. No formulário "Importação agendada de dados", verifique os valores de campos do trabalho agendado.

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

      4. Selecione Atualizar.
      5. Repita as etapas de 5.b a 5.d para cada trabalho agendado de importação de dados.
      6. Defina a tarefa Configurar os trabalhos agendados como concluída clicando em Marcar como concluído na configuração assistida.