Configuração de Conector do Service Graph de APIs para Apigee X usando Central do SGC

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

    • Configure trabalhos de importação agendada para inserir dados Apigee X no seu CMDB.

    Antes de Iniciar

    Instale a Conector do Service Graph de APIs para Apigee X versão 1.0.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.

    Função necessária: administrador

    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 Apigee X 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. Conclua os pré-requisitos de configuração do ambiente Apigee X.
      1. Configure o ambiente Apigee X e crie um certificado Java KeyStore (JKS) para criptografar os certificados de segurança obtidos de uma aplicação Apigee X.
        1. Na fase de Pré-requisitos do playbook, selecione a atividade Analisar instruções de configuração.
        2. Revise e conclua as instruções de configuração no artigo Conector do Service Graph da API para Apigee X - Instruções de configuração [KBB0010364] na Base de conhecimento Now Support.

          Você deve criar uma conta de serviço, atribuir funções, vincular funções à conta de serviço, habilitar APIs, criar um arquivo P12 e registrá-lo em sua instância ServiceNow.

          Anote a senha do armazenamento de chaves de destino. Você precisa especificar esta senha ao importar o certificado JKS para a aplicação Conector do Service Graph de APIs para Apigee X.

        3. Marque a caixa de seleção Li as instruções de configuração para confirmar que você configurou o ambiente Apigee X de acordo com as instruções.
        4. Selecione Continuar.
      2. Crie um certificado X.509 para associar o certificado Java KeyStore (JKS) da aplicação Apigee X ao conector.
        Nota:
        Você pode ignorar esta etapa se estiver reutilizando um certificado criado anteriormente.
        1. Na fase Pré-requisitos do playbook, selecione a atividade Criar certificado X.509.
        2. No formulário, preencha os campos.
          Tabela 1. Formulário de Certificado X.509
          Campo Descrição
          Nome Nome do certificado X.509. Por exemplo, SGA-ApigeeX-509Certificate.
          Senha do armazenamento de chaves Senha para acessar o certificado JKS conforme anotado na etapa anterior.
          Descrição resumida Descrição do certificado X.509.
        3. Na seção Anexos, selecione Adicionar arquivo.
        4. Pesquise e selecione o arquivo P12 para o certificado JKS que você criou na etapa anterior.
        5. Na caixa de diálogo Carregar um arquivo, selecione Carregar.
        6. Selecione Continuar.
    7. Insira os detalhes da conexão e teste a conexão da API para importar dados do Apigee X.
      1. Na etapa Configuração do playbook, selecione a atividade Criar e testar conexão.
      2. No formulário, preencha os campos.
        Tabela 2. Formulário Configurar e testar conexão
        Campo Descrição
        Nome da conexão Nome para identificar o registro de conexão Apigee X.
        E-mail da conta de serviço Endereço de e-mail associado à conta de serviço ServiceNow usada para autenticação com Apigee X, conforme anotado na etapa anterior.
        Certificado X.509 Nome do certificado X.509 conforme anotado na etapa anterior.
        Senha de Armazenamento de Chaves Senha associada ao armazenamento de chaves conforme anotado na etapa anterior.
      3. Selecione Criar e testar conexão.
      4. Depois de concluir o teste de conexão, selecione Continuar.
    8. Defina as propriedades de configuração da conexão.
      1. Na etapa Configuração do playbook, selecione a atividade Definir propriedades de configuração.
      2. Insira as propriedades.
        Tabela 3. Propriedades de conexão do Service Graph
        Propriedade Descrição
        Identificação da Apigee
        ID da organização Organização no sistema Apigee X ao qual os projetos pertencem.
        ID do projeto Identificador do projeto no ambiente Apigee X ao qual a conexão será vinculada.

        Para vários IDs de projeto, separe-os com vírgulas.
        Configuração de recuperação de dados
        Escopo da Descoberta Escopo da descoberta da aplicação Apigee X. As opções disponíveis são:
        Organização
        Selecione Organização quando a conta de serviço do ServiceNow tiver acesso aos dados na organização Apigee X.
        Projetos
        Selecione Projetos quando a conta de serviço do ServiceNow tiver acesso somente aos dados em projetos do Apigee X.
        Excluir ambientes Apigee X Ambientes que devem ser excluídos da conexão.

        Para vários ambientes, separe-os com vírgulas. Todos os gateways, exceto os listados na propriedade Exclude Environments, são extraídos.

        Se você deixar este campo em branco, as fontes de dados no conector importarão dados de todos os ambientes.
        Período de coleta em dias Duração em dias para coletar dados de uso da API.
        Coletar dados de uso Opção para habilitar a coleta de dados de uso para recuperar dados de uso da API ao longo de uma duração especificada.
        Configuração de desempenho
        Tamanho da página Número de registros por página. O padrão é 100, o mínimo é 2.
        Tamanho da partição Tamanho da partição para Apigee X APIs gerenciadas se o carregamento paralelo estiver habilitado.

        Aceita um valor numérico maior que zero. Se for deixado em branco, o valor será calculado automaticamente.
      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. Expanda a importação de dados programada primária na lista Cronogramas de importação para selecionar a programação de importação da organização X da Apigee SGA.
      4. Na caixa de diálogo Configurar programação de importação, marque a caixa de seleção Ativo e preencha a programação de execução e os detalhes de tempo.

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

      5. Selecione Save (Salvar).
        Como alternativa, selecione Executar agora para executar a programação de importação imediatamente.
      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.