Como configurar o Conector do Service Graph para Jamf

  • Versão de lançamento: Washingtondc
  • Atualizado 1 de fev. de 2024
  • 8 min. de leitura

    • Configure as credenciais de autenticação e trabalhos programados 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 Visibility IT Operations Management (ITOM) ou na aplicação Discovery ITOM. Conforme definido na seção "Tipos de recursos de TI gerenciados" em Visão geral da unidade de assinatura da ServiceNow para sua assinatura, para recursos de TI gerenciados que são criados ou modificados no CMDB por este Conector do Service Graph, mas que ainda não são gerenciados pela Visibilidade do ITOM ou Descoberta do ITOM, esses recursos aumentarão o consumo da Unidade de assinatura dessa aplicação. Analise o consumo atual da unidade de assinatura no ITOM Visibility ou no ITOM Discovery para garantir a capacidade disponível.

    Dependências e requisitos:

    Função necessária: administrador

    Procedimento

    1. Navegar até Tudo > Service Graph Connectors > Jamf > Configuração.
    2. Na página de Introdução, selecione Introdução.
    3. Configurar a conexão.
      1. Na página do Service Graph Connector for Jamf, na seção Configurar as propriedades, selecione a tarefa Configurar o comprimento parcial máximo do JSON de transformação.
      2. Na próxima página, na seção Configurar tamanho parcial máximo do JSON de transformação, selecione Configurar e faça o seguinte:
        1. Altere o escopo para Global.
        2. Para criar uma nova propriedade do sistema, selecione Novo.
        3. No campo Nome, insira com.glide.transform.json.max-partial-length.
        4. Defina o campo Valor com 65536.
          Nota:
          O campo Valor é necessário para que a transformação funcione.
        5. Clique em Marcar como concluído.
      3. 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 deve ter privilégios de leitura para a categoria Aplicativos para dispositivos móveis em Jamf.
        1. Na seção Filtrar aplicações pessoais, selecione Configurar.
        2. Selecione o nome da propriedade.
        3. No campo Valor, atualize o valor de false para true.
        4. Clique em Marcar como concluído.
      4. Habilite a propriedade Jamf proApi.
        1. Na seção Habilitar propriedade Jamf proAPI, clique em Configurar.
        2. Marque a caixa de seleção Usar Jamf Pro API e Jamf Pro 10.35 ou superior conforme necessário.
          Nota:
          Se você estiver usando o Jamf Pro 10.35 ou superior, deverá marcar a caixa de seleção Jamf Pro 10.35 para evitar a geração de erros.
        3. Clique em Atualizar.
          Nota:
          Ao configurar a conexão HTTP do Jamf, verifique se o campo Caminho Base está vazio para que você possa configurar a URL do endpoint para a propriedade Jamf proAPI.
        4. Clique em Marcar como Concluído.
      5. Configurar Jamf credenciais de autenticação.
        1. Na seção Configurar credenciais de autenticação do Jamf, clique em 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 está habilitado.
          Nota:
          O usuário deve 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 este perfil de autenticação básica está habilitado.
        3. Clique em Atualizar, se necessário, depois em Marcar como Concluído.
      6. Configurar a conexão HTTP do Jamf.
        1. Na seção Configurar conexão HTTP do Jamf, clique em Configurar.
        2. No formulário, preencha os campos.
          Tabela 2. Formulário de conexão HTTP
          Campo Descrição
          Nome Nome da conexão.
          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.
          Host Valor de host de destino usado pela conexão. A URL de conexão preencherá o nome do host automaticamente.
          Nota:
          Atualize o campo Host com uma URL de base do Jamf ou um endereço IP. Por exemplo, demojamfhost.com ou 127.0.0.1.
          Credencial Valor de credencial usado por esta conexão.
          Alias de conexão Valor de conexão usado para se referir à conexão.
          Construtor de URL Construtor de URL usado para criar a URL da 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.
          Autenticação mútua Opção de definir a conexão com autenticação mútua.
          Protocolo Protocolo subjacente usado pela conexão.
          Nota:
          Atualize o campo Protocolo se não estiver usando https.
          Ativo Opção para ativar a conexão HTTP.
          Domínio Domínio que contém a conexão.
          Substituir porta padrão Porta de valor de destino usada pela conexão.
          Caminho base Caminho base para conexão HTTP(s).
          Nota:
          Não é necessário atualizar esse campo. Esse campo é definido automaticamente como /JSSResource. Se você estiver atualizando o Conector do Service Graph para Jamf e quiser usar a propriedade Jamf proAPI, será necessário limpar este campo.
        3. Clique em Atualizar, se necessário, depois em Marcar como Concluído.
      7. Teste a conexão.
        1. Na seção Testar a conexão, clique em Configurar.
        2. Revise os campos do formulário.
          Tabela 3. Formulário de fontes de dados
          Campo Descrição
          Nome Nome exclusivo desta fonte de dados.
          Rótulo da tabela de conjunto de importação Rótulo da tabela de conjunto de importação que esta fonte de dados produzirá.
          Nome da tabela de conjunto de importação Nome da tabela que será criada para esta fonte de dados.
          Tipo Tipo de armazenamento de dados dos dados a serem importados.
          Dados em uma única coluna Opção para definir os dados em uma só coluna.
          Aplicação Aplicação que contém este registro.
          Carregador de Dados Script que carrega dados na tabela de conjuntos de importação.
        3. Testar a conexão clicando no link relacionado Testar carga de 20 registros.

          O teste da 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 configuração.
        4. Clique em Marcar como Concluído.
    4. Adicionar várias instâncias.
      Nota:
      Se você não precisar adicionar várias instâncias, poderá ignorar esta etapa.
      1. Na barra lateral esquerda, selecione o ícone Adicionar Várias Instâncias (Ícone Adicionar várias instâncias).
      2. Na página Service Graph Connector for Jamf, na seção Adicionar Várias Instâncias, selecione a tarefa Atualizar Acesso à Fonte de Dados.
      3. Na próxima página, na seção Atualizar Acesso à Fonte de Dados, selecione Configurar.
      4. Selecione a tabela Fonte de dados [sys_data_source].
      5. Para editar o registro, selecione Global no menu Escopo.
      6. Na guia Acesso à aplicação, marque as caixas de seleção Pode criar, Pode atualizar e Pode excluir.
      7. Salve o registro.
      8. No menu Escopo, selecione Service Graph Connector for Jamf.
      9. Na barra de tarefas de Ajuda, clique em Marcar como concluído.
      10. Repita essas etapas na seção Atualizar acesso à importação de dados Programada com a tabela Importação de dados programada [Scheduled_data_set].
    5. Adicionar outra conexão.
      Nota:
      Altere o escopo para Service Graph Connector for Jamf, caso contrário, você não conseguirá carregar as conexões adicionais.
      1. Na seção Adicionar outra conexão, clique em Configurar.
      2. No Flow Designer, selecione Adicionar conexão.
      3. No formulário, preencha os campos.
        Tabela 4. 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. Clique em Criar Conexão.
      5. Navegue de volta à configuração orientada e clique em Marcar como concluído.
      6. Se necessário, configure o MID Server para a conexão criada.
        1. Na seção Configurar MID Servers, clique em Configurar.
        2. Selecione o nome da conexão criada.
        3. Clique na caixa de seleção Usar MID Server.
        4. Clique em Atualizar.
        5. Ao terminar a tarefa, clique em Marcar como Concluído
      7. Se necessário, habilite a propriedade Jamf proAPI para a conexão criada.
        1. Na seção Habilitar propriedade Jamf proAPI, clique em Configurar.
        2. Para a conexão que você criou, na coluna Usar JAMF Pro API, altere o valor de false para true.
        3. Clique em Marcar como Concluído.
      8. Teste as novas conexões.
        1. Na seção Testar novas conexões, clique em Configurar.
        2. Selecione o nome da conexão que deseja testar.
        3. Para validar a configuração da fonte de dados, clique no botão Testar carga de 20 registros.
          Nota:
          Se o teste da conexão falhar, há um erro de conexão Jamf que você precisa corrigir.
        4. Ao terminar, clique em Marcar como Concluído.
    6. Configurar os trabalhos de importação programados.
      1. Na barra lateral esquerda, selecione o ícone de trabalhos de importação programada (ícone de trabalhos de importação programada).
      2. Na página do Service Graph Connector for Jamf, na seção Configurar trabalhos de importação programada, selecione a tarefa Configurar o trabalho programado.
      3. Na seção da tarefa Configurar o trabalho programado, clique em Configurar.
      4. Selecione o nome do trabalho programado que você deseja ativar.
      5. Revise os campos preenchidos previamente no formulário de Importação de dados programados.
        Nota:
        Por padrão, o trabalho programado SG-Jamf Mobile Devices é definido automaticamente como Ativo e executa o SG-Jamf Computer como pai.
        Tabela 5. Formulário de importação de dados programados
        Campo Descrição
        Nome Nome do trabalho programado.
        Fonte de Dados Registro de fonte de dados que define os dados a serem importados.
        Executar como Opção para executar o trabalho programado com as credenciais do usuário especificado.
        Ativo Opção de ativar o trabalho programado. Selecione esta opção.
        Importação simultânea Função que carrega os dados de vários Import Sets. A função processa e transforma os dados simultaneamente.
        Método de Partição Método de partição referente ao conjunto de importação simultânea.
        Tamanho da Partição Tamanho do conjunto de importação para programação antecipada.
        Executar script de pré-importação Opção para especificar um script a ser executado antes que a importação seja realizada.
        Executar script de pós-importação Opção para especificar um script a ser executado depois que a importação for realizada.
        Aplicação Aplicação que contém este trabalho programado.
        Executar Frequência de execução da importação.
        Condicional Condições sob as quais este trabalho é executado.
      6. Clique em Executar agora e repita essas etapas para as outras importações, se necessário.
      7. Na seção da tarefa Configurar o trabalho programado, clique em Marcar como concluído.