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 primeira configuração. Consulte Execute tarefas de configuração iniciais ao criar uma conexão em Central do SGC.
    6. Conclua os pré-requisitos de configuração do ambiente Apigee X.
      1. Configure o. Apigee XE crie um certificado Java Keystore (JKS) para criptografar os certificados de segurança obtidos de um Apigee Xaplicaçã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 Conetor de gráfico de serviço de API para Apigee X - Instruções de configuração [KBB0010364] artigo no Now SupportBase 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 ServiceNowinstância.

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

        3. Selecione Li as instruções de configuração para confirmar que você configurou o. Apigee Xambiente de acordo com as instruções.
        4. Selecione Continuar.
      2. Crie um certificado X.509 para associar o certificado Java Keystore (JKS) para o. Apigee Xaplicação com o conetor.
        Nota:
        Você pode ignorar esta etapa se estiver reutilizando um certificado criado anteriormente.
        1. Em Pré-requisitos do playbook, selecione Crie o 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, Certificado SGA-ApigeeX-509 .
          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 ServiceNowconta de serviço usada para autenticação com Apigee Xconforme 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 Xsistema ao qual os projetos pertencem.
        ID do projeto Identificador do projeto em Apigee Xambiente 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.
        Exclua 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 por 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 XAPIs 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. Expanda a importação de dados agendada primária na lista Agendamentos de importação para selecionar SGA Apigee X. Organização programação de importação.
      4. Em Configure a programação de importação , selecione 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 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.