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

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

Antes de Iniciar

Importante:

A menos que haja problemas, use Central do SGCexibição, pois o método de configuração assistida será descontinuado. Se uma conexão for configurada usando a configuração assistida, a conexão pode não aparecer no Central do SGCexibição.

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 de front-end do Apigee X do SGA possa recuperar arquivos do Apigee Xe 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  e, em seguida, selecione  Atualizar .
      4. Selecione Conector do Service Graph de APIs para Apigee Xescopo da aplicação no seletor de aplicações.
      5. Defina o. Atualizar acesso ao anexo tarefa a ser concluída selecionando Marcar como concluído e, em seguida, selecione Continuar .
   3. Configure o. Apigee XE crie um certificado Java Keystore (JKS) para criptografar os certificados de segurança obtidos de um Apigee Xaplicação.
      1. Selecione Instruções de configuração do Apigee X. tarefa.
      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.

         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. Defina o. Instruções de configuração do Apigee X. tarefa a ser concluída selecionando Marcar como concluído e, em seguida, selecione Continuar .
   4. Crie um certificado X.509 para associar o certificado Java Keystore (JKS) para o. Apigee Xaplicaçã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, Certificado SGA-ApigeeX-509 .
         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" ().
      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 do Apigee X do SGA .
      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 do Apigee X do SGA é 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 ServiceNowconta de serviço usada para autenticação com Apigee Xconforme 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 de token OAuth for concluído com sucesso, retorne à página de configuração assistida e defina o. Configure a conexão tarefa a ser concluída selecionando Marcar como concluído e, em seguida, 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
         Period de coleta (dias)	Duração em dias para coletar dados de uso da API.
         Dados de uso de coleta	Habilite a coleta de dados de uso para recuperar dados de uso da API ao longo de uma duração especificada.
         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.
         ID da Organização	Organização em Apigee Xsistema ao qual o projeto pertence.
         Tamanho da Página	Número de registros por página. O padrão é 100 , o mínimo é 2 .
         PartitionSize	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.
         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.

         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 o. Adicione propriedades de configuração tarefa a ser concluída selecionando Marcar como concluído e, em seguida, 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. Para editar o registro, selecione o escopo da aplicação Global no seletor de aplicações.
      3. No campo Executar Script, insira o código a seguir:

         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");

      4. Selecione Executar script.
      5. Selecione o escopo da aplicação Conector do Service Graph de APIs para Apigee X no seletor de aplicações.
      6. Defina o. Limpe o cache das tabelas Fonte de dados e Importações de dados agendadas tarefa a ser concluída selecionando Marcar como concluído .
   5. Para criar um certificado X.509 para o novo Apigee Xinstância, repita a etapa 4.de marque o. Crie o 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 o. Adicione propriedades de configuração tarefa a ser concluída selecionando Marcar como concluído e, em seguida, 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 SGA Apigee X. 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.