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

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 5 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 ServiceNow Storeetapas de instalação, consulte Instale uma aplicação da ServiceNow Store .

    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 Central do SGC em Espaço do CMDB. Para configurar o. Central do SGC aplicação, consulte Configuração da Central do SGC e para obter mais informações sobre como interagir com um playbook, consulte Interaja com o 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 primeira configuração. Consulte Execute 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. Apigee X E criar um certificado Java KeyStore (JKS) para criptografar os certificados de segurança obtidos de um Apigee X aplicação.
        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 Conector do Service Graph da API para Apigee X - Instruções de configuração [KBB0010364] artigo no Now Support Base de conhecimento.

          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 seu ServiceNow instância.

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

        3. Selecione Li as instruções de configuração caixa de seleção para confirmar que você configurou o. Apigee X ambiente de acordo com as instruções.
        4. Selecione Continuar.
      2. Crie um certificado X.509 para associar o certificado Java KeyStore (JKS) para Apigee X aplicação com o conetor.
        Nota:
        Você pode ignorar esta etapa se estiver reutilizando um certificado criado anteriormente.
        1. Em Pré-requisitos fase do playbook, selecione Criar certificado X.509 atividade.
        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-509 Certificado .
          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. Procure e selecione o arquivo P12 para o certificado JKS que você criou no etapa anterior .
        5. Na caixa de diálogo Carregar um arquivo, selecione Upload .
        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 ao ServiceNow conta de serviço usada para autenticação com Apigee X conforme observado em etapa anterior .
        Certificado X.509 Nome do certificado X.509 conforme observado em etapa anterior .
        Senha de armazenamento de chaves Senha associada ao armazenamento de chaves conforme observado em 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 do Apigee
        ID da organização Organização em Apigee X sistema ao qual os projetos pertencem.
        ID do projeto Identificador do projeto em Apigee X ambiente 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.
        Incluir ambientes Apigee X ambientes a serem incluídos na conexão.

        Para vários ambientes, separe-os com vírgulas. Somente proxies de API nos ambientes listados em Include environmentsas propriedades são importadas.

        Se você deixar este campo em branco, as fontes de dados no conector importarão proxies da API 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 por uma duração especificada.
        Expanda Tipos de método HTTP Tipos de método a serem considerados para rotas que permitem todos os métodos HTTP ( OBTER , PUBLICAR , COLOCAR , PATCH , EXCLUIR , OPÇÕES , CABEÇA , CONECTE , RASTREAMENTO ).

        Para vários métodos, separe-os com vírgulas. Todos os métodos listados são considerados para manipulação de rotas.
        Configuração do 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 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. Em Configurar programação de importação caixa de diálogo, no Nome , insira Organização programação de importação.
      4. 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.

      5. Selecione Save (Salvar).
      6. Para Configurar programação de importação atividade, selecione Continuar .
    10. Em Configuração fase do playbook, selecione Confirme a criação da conexão atividade 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.