Configurar Conector do Service Graph de APIs para Apigee X usando a configuração assistida

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 11 min. de leitura

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

    Antes de Iniciar

    Importante:
    A menos que haja problemas de configuração, use Central do SGC exibir no Espaço do CMDB para configurar a conexão do conector, pois o método de configuração assistida está sendo descontinuado.
    Dependências e requisitos:
    • A aplicação da Store Componentes comuns de integração para CMDB, que é instalado automaticamente. Veja Componentes comuns de integração para CMDB.
    • O app da Store para os Modelos de classe de IC do CMDB, que é instalado automaticamente. Consulte Modelos de classe de IC do CMDB.
    • O plug-in de licença da Descoberta do ITOM (com.snc.itom.discovery.license). Você deve ativar este plug-in.
    • Plug-in de licenciamento do ITOM (com.snc.itom.license). Consulte Request Discovery.

    Função necessária: administrador

    Procedimento

    1. Use o seletor de aplicações para verificar se o escopo da aplicação está definido para a aplicação Conector do Service Graph de APIs para Apigee X.
      Para obter mais informações, consulte Seletor de aplicações.
    2. Navegar até Tudo > Conectores do Service Graph > Apigee X > Configuração.
    3. Em Conector do Service Graph de APIs para Apigee X, selecione Continuar .
    4. Configure as credenciais de autenticação a fim de enviar solicitações para a aplicação do Apigee X.
      1. Na seção Configurar conexão e credenciais da página Conector do Service Graph de APIs para Apigee X, selecione Iniciar.
      2. Conceda a permissão de atualização do anexo para que a fonte de dados de back-end da API possa recuperar arquivos da Apigee X e anexe-os aos registros.
        1. Selecione Atualizar acesso ao anexo tarefa.
        2. Selecione o escopo da aplicação Global no seletor de aplicações.
        3. Na lista relacionada Acesso à aplicação da subpágina Anexo, selecione  Pode atualizar  caixa de seleção e selecione  Atualização .
        4. Selecione Conector do Service Graph de APIs para Apigee Xescopo da aplicação no seletor de aplicações.
        5. Defina Atualizar acesso ao anexo tarefa a ser concluída selecionando Marcar como concluído caixa de seleção e selecione Continuar .
      3. 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. Selecione Instruções de configuração do Apigee X. tarefa.
        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.

          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. Defina Instruções de configuração do Apigee X. tarefa a ser concluída selecionando Marcar como concluído caixa de seleção e selecione Continuar .
      4. Crie um certificado X.509 para associar o certificado Java KeyStore (JKS) para Apigee X aplicação com o conetor.
        1. Selecione a tarefa Criar certificado X.509.
        2. Selecione Novo.
        3. 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 .
          Notificar no vencimento Usuários a serem notificados quando o certificado expirar. Se nenhum usuário for selecionado, o usuário conectado será adicionado por padrão, juntamente com os dois últimos usuários conectados com a função de administrador.
          Avisar em dias antes de expirar Número de dias para enviar uma notificação antes que o certificado expire.
          Ativo Opção para ativar o certificado.
          Tipo Contêiner de certificado que é definido automaticamente como Armazenamento de Java Keystore. Deixe o valor do campo definido como Java Keystore.
          Expira em dias Número de dias até o certificado expirar.
          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.
        4. Selecione o ícone "Gerenciar anexos" (Ícone Gerenciar anexos).
        5. Selecione Escolher arquivo para procurar e carregar o arquivo keystore.p12 no certificado JKS que você criou na etapa 4.c.
        6. Feche a caixa de diálogo.
        7. Selecione o link relacionado Validar armazenamentos/certificados.
        8. Se a validação for bem-sucedida, selecione Atualizar para retornar à página de configuração assistida.
        9. Defina a tarefa Criar certificado X.509 como concluída marcando a caixa de seleção Marcar como concluída e, em seguida, selecione Continuar.
      5. Configure a conexão.
        1. Use o seletor de aplicações para verificar se o escopo da aplicação está definido para a aplicação Conector do Service Graph de APIs para Apigee X.
        2. Selecione Configure a Conexão tarefa.
        3. Selecione Clique aqui Para abrir a página Conexões em uma guia separada do navegador.
        4. PESQUISE e selecione Editar para Conexão SGA Apigee X. .
        5. Na seção Informações de conexão da janela "Editar conexão", preencha os campos.
          Tabela 2. Informação de conexão
          Campo Descrição
          Nome da conexão Nome para identificar o registro de conexão Apigee X.

          Conexão SGA Apigee X. é o nome do alias de credencial padrão. Você pode adicionar várias instâncias Apigee X. No entanto, tente não modificar o nome da conexão padrão.
        6. Na seção Informações de credencial da janela "Editar conexão", preencha os campos.
          Tabela 3. Informações de credencial
          Campo Descrição
          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 Antes de começar seção.
          Certificado X.509 Certificado X.509 criado na etapa 4.d.
          Senha de Armazenamento de Chaves Senha associada ao armazenamento de chaves conforme observado em Antes de começar seção.
        7. Selecione Editar e obter token OAuth.
        8. Selecione Atualizar.
        9. Quando o fluxo do token OAuth for concluído com sucesso, retorne à página de configuração assistida e defina Configure a Conexão tarefa a ser concluída selecionando Marcar como concluído caixa de seleção e selecione Continuar .
      6. Configure as propriedades do conector para acessar recursos.
        1. Selecione a tarefa Adicionar propriedades de configuração.
        2. Na lista relacionada Propriedades de conexão do Service Graph, insira os valores das propriedades.
          Tabela 4. Propriedades de conexão do Service Graph
          Propriedade Descrição
          Coletar dados de uso Habilite a coleta de dados de uso para recuperar dados de uso da API ao longo de uma duração especificada.
          CollectionPeriod (em dias) Duração em dias para coletar dados de uso da API.
          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.
          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 tipos de método, separe-os com vírgulas. Todos os tipos de método listados são considerados para manipulação de rotas.

          Se você deixar este campo em branco, todos os tipos de método HTTP serão considerados por padrão.
          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.
          ID da organização Organização em Apigee X sistema ao qual o projeto pertence.
          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.
          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.
          Dica:
          Para inserir um valor de propriedade, clique duas vezes (ou use o atalho de teclado) para inserir um valor na célula Valor da propriedade.
        3. Defina Adicione propriedades de configuração tarefa a ser concluída selecionando Marcar como concluído caixa de seleção e selecione Continuar .
      7. Teste a conexão.
        1. Selecione a tarefa Testar conexão.
        2. Teste a conexão selecionando o link relacionado Testar conexão.

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

        3. Quando o campo Status estiver definido como Êxito, selecione Atualizar.

          Se algum dos testes apresentar algum erro, siga as sugestões de correção.

        4. Defina a tarefa Testar conexão como concluída marcando a caixa de seleção Marcar como concluída e, em seguida, selecione Continuar.
    5. Opcional: Faça a integração a várias instâncias do Apigee X.
      1. Na seção Adicionar várias instâncias da página do Conector do Service Graph de APIs para Apigee X, selecione Iniciar.
      2. Habilite a criação de fontes de dados para a nova conexão do Apigee X.
        1. Verifique se você tem permissões de edição para a tabela Fonte de dados [sys_data_source].
        2. Selecione a tarefa Atualizar acesso à fonte de dados.
        3. Para editar o registro, selecione o escopo da aplicação Global no seletor de aplicação.
        4. Na lista relacionada "Acesso à aplicação" do formulário "Fonte de dados" que é aberta em uma nova guia, marque as caixas de seleção Pode criar, Pode atualizar e Pode excluir.
        5. Selecione Atualizar.
        6. Selecione o escopo da aplicação Conector do Service Graph de APIs para Apigee X no seletor de aplicações.
        7. Defina a tarefa Atualizar acesso à fonte de dados como concluída marcando a caixa de seleção Marcar como concluída e, em seguida, selecione Continuar.
      3. Habilite a criação de um trabalho de importação agendada para a nova conexão do Apigee X.
        1. Verifique se você tem permissões de edição para a tabela "Importação Agendada de Dados" [scheduled_import_set].
        2. Selecione a tarefa Atualizar acesso à importação de dados agendada.
        3. Para editar o registro, selecione o escopo da aplicação Global no seletor de aplicação.
        4. Na lista relacionada "Acesso à aplicação" do formulário "Importação agendada de dados", marque as caixas de seleção Pode criar, Pode atualizar e Pode excluir.
        5. Selecione Atualizar.
        6. Selecione o escopo da aplicação Conector do Service Graph de APIs para Apigee X no seletor de aplicações.
        7. Defina a tarefa Atualizar importação de dados agendada como concluída marcando a caixa de seleção Marcar como concluída e, em seguida, selecione Continuar.
      4. Limpe o cache nas tabelas "Fonte de Dados" [sys_data_source] e "Importações Agendadas de Dados" [scheduled_import_set].
        1. Selecione a tarefa Limpar cache das tabelas "Fontes de dados" e "Importações agendadas de dados".
        2. Em Executar script caixa de texto da página de script em segundo plano, insira o seguinte script:
          GlideTableManager.invalidateTable("sys_data_source");
GlideCacheManager.flushTable("sys_data_source");
GlideTableManager.invalidateTable("scheduled_import_set");
GlideCacheManager.flushTable("scheduled_import_set");
GlideTableManager.invalidateTable("sys_db_object");
GlideCacheManager.flushTable("sys_db_object");     
GlideTableManager.invalidateTable("sys_attachment");
GlideCacheManager.flushTable("sys_attachment");
        3. Selecione Executar script para executar o script em segundo plano no global escopo.

          O script pode levar vários minutos para ser executado.

        4. Depois que o script for executado, selecione Fechar .
        5. Selecione o escopo da aplicação Conector do Service Graph de APIs para Apigee X no seletor de aplicações.
        6. Defina Limpar cache das tabelas Fonte de dados e Importações de dados programadas tarefa a ser concluída selecionando Marcar como concluído .
      5. Para criar um certificado X.509 para o novo Apigee X instância, repita a etapa 4.de marque Criar certificado X.509 tarefa a ser concluída selecionando Marcar como concluído .
      6. Adicione outra conexão para a nova instância do Apigee X.
        1. Use o seletor de aplicações para verificar se o escopo da aplicação está definido para a aplicação Conector do Service Graph de APIs para Apigee X.
        2. Selecione a tarefa Adicionar outra conexão e, em seguida, Clicar aqui.
        3. Na página "Conexões" que abre em outra guia do navegador, selecione Adicionar conexão.
        4. Na janela Criar conexão, preencha a conexão, a conta de serviço e os detalhes do armazenamento de chaves, incluindo a senha do armazenamento de chaves.

          Você criou o armazenamento de chaves na etapa 5.e.

        5. Selecione Criar e obter um Token do OAuth.
        6. Feche a página "Conexões" e volte à guia da configuração assistida.
        7. Defina a tarefa Adicionar outra conexão como concluída marcando a caixa de seleção Marcar como concluída e, em seguida, selecione Continuar.
      7. Adicione propriedades para a nova conexão.
        1. Use o seletor de aplicações para verificar se o escopo da aplicação está definido para a aplicação Conector do Service Graph de APIs para Apigee X.
        2. Selecione a tarefa Adicionar propriedades de configuração.
        3. Na coluna Nome, selecione o nome da conexão criada na etapa 5.f.
        4. Na lista relacionada Propriedades de conexão do Service Graph, insira os valores das propriedades.

          Para mais informações sobre propriedades, consulte 4.f.ii.

          Dica:
          Para inserir um valor de propriedade, clique duas vezes (ou use o atalho de teclado) para inserir um valor na célula Valor da propriedade.
        5. Defina Adicione propriedades de configuração tarefa a ser concluída selecionando Marcar como concluído caixa de seleção e selecione Continuar .
      8. Teste a nova conexão.
        1. Selecione a tarefa Testar novas conexões.
        2. Na coluna Nome, selecione o nome da conexão criada na etapa 5.f.
        3. Teste a conexão selecionando o link relacionado Testar conexão.

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

        4. Quando o campo Status estiver definido como Êxito, selecione Atualizar.

          Se algum dos testes apresentar algum erro, siga as sugestões de correção.

        5. Defina a tarefa Testar novas conexões como concluída marcando a caixa de seleção Marcar como concluída e, em seguida, selecione Continuar.
    6. Configure o trabalho agendado para a importação de dados do Apigee X.
      1. Na seção Configurar trabalhos de importação agendada da página Conector do Service Graph de APIs para Apigee X, selecione Iniciar.
      2. Selecione Organização trabalho agendado.
        Para executar uma configuração de várias instâncias, selecione a importação agendada que foi criada com a conexão na etapa 5.f.
      3. No formulário "Importação agendada de dados", verifique os valores dos campos.

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

      4. Marque a caixa de seleção Ativo para ativar o trabalho agendado.
      5. No campo Executar, selecione Periodicamente para especificar a frequência de execução do trabalho.
      6. Selecione Atualizar.
      7. Defina a tarefa Configurar trabalhos de importação agendada como concluída marcando a caixa de seleção Marcar como concluída e, em seguida, selecione Continuar.
    7. Na página Conector do Service Graph de APIs para Apigee X, selecione Concluído para salvar suas mudanças.
    8. Na caixa de diálogo "Concluir configuração", selecione Concluir para concluir a configuração.
    9. Na caixa de mensagem que é exibida, selecione Concluído.