Configurar Conector do Service Graph de APIs para Apigee X usando a configuração assistida
Configure trabalhos de importação agendada para inserir dados Apigee X no seu CMDB.
Antes de Iniciar
- 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
-
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.
- Navegar até Tudo > Conectores do Service Graph > Apigee X > Configuração.
- Na página Conector do Service Graph de APIs para Apigee X, selecione Continuar.
-
Configure as credenciais de autenticação a fim de enviar solicitações para a aplicação do Apigee X.
- Na seção Configurar conexão e credenciais da página Conector do Service Graph de APIs para Apigee X, selecione Iniciar.
-
Conceda a permissão de atualização de anexo para que a fonte de dados de back-end do SGA Apigee X possa recuperar arquivos de Apigee X e anexá-los aos registros.
- Selecione a tarefa Atualizar acesso a anexos.
- Selecione o escopo da aplicação Global no seletor de aplicações.
- Na lista relacionada Acesso à aplicação da subpágina Anexo, marque a caixa de seleção Pode atualizar e selecione Atualizar.
- Selecione o escopo da aplicação Conector do Service Graph de APIs para Apigee X no seletor de aplicações.
- Defina a tarefa Atualizar acesso a anexos como concluída marcando a caixa de seleção Marcar como concluída e, em seguida, selecione Continuar.
-
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.
- Selecione a tarefa Instruções de configuração da Apigee X.
- 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.
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.
- Defina a tarefa Instruções de configuração do Apigee X como concluída marcando a caixa de seleção Marcar como concluída e selecione Continuar.
-
Crie um certificado X.509 para associar o certificado Java KeyStore (JKS) da aplicação Apigee X ao conector.
- Selecione a tarefa Criar certificado X.509.
- Selecione Novo.
- 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.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. - Selecione o ícone "Gerenciar anexos" (
).
- Selecione Escolher arquivo para procurar e carregar o arquivo keystore.p12 no certificado JKS que você criou na etapa 4.c.
- Feche a caixa de diálogo.
- Selecione o link relacionado Validar armazenamentos/certificados.
- Se a validação for bem-sucedida, selecione Atualizar para retornar à página de configuração assistida.
- 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.
-
Configure a conexão.
- 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.
- Selecione a tarefa Configurar a conexão.
- Selecione Clique aqui para abrir a página Conexões em uma guia separada do navegador.
- Pesquise e selecione Editar para SGA Apigee X Connection.
- 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. SGA Apigee X Connectioné 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. - 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 à conta de serviço ServiceNow usada para autenticação com Apigee X, conforme observado na seção Antes de começar. Certificado X.509 Certificado X.509 criado na etapa 4.d. Senha de Armazenamento de Chaves Senha associada ao armazenamento de chaves conforme observado na seção Antes de começar. - Selecione Editar e obter token OAuth.
- Selecione Atualizar.
- Quando o fluxo de token OAuth for concluído com sucesso, retorne à página de configuração assistida e defina a tarefa Configurar a conexão como concluída marcando a caixa de seleção Marcar como concluída e, em seguida, selecione Continuar.
-
Configure as propriedades do conector para acessar recursos.
- Selecione a tarefa Adicionar propriedades de configuração.
- 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 CollectionPeriod (dias) Duração em dias para coletar dados de uso da API. CollectUsageData 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.
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.
ID da organização Organização no sistema Apigee X 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 for deixado em branco, o valor será calculado automaticamente.
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.
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. - Defina a tarefa Adicionar propriedades de configuração como concluída marcando a caixa de seleção Marcar como concluída e, em seguida, selecione Continuar.
-
Teste a conexão.
- Selecione a tarefa Testar conexão.
- 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.
- Quando o campo Status estiver definido como Êxito, selecione Atualizar.
Se algum dos testes apresentar algum erro, siga as sugestões de correção.
- Defina a tarefa Testar conexão como concluída marcando a caixa de seleção Marcar como concluída e, em seguida, selecione Continuar.
- Opcional:
Faça a integração a várias instâncias do Apigee X.
- Na seção Adicionar várias instâncias da página do Conector do Service Graph de APIs para Apigee X, selecione Iniciar.
-
Habilite a criação de fontes de dados para a nova conexão do Apigee X.
- Verifique se você tem permissões de edição para a tabela Fonte de dados [sys_data_source].
- Selecione a tarefa Atualizar acesso à fonte de dados.
- Para editar o registro, selecione o escopo da aplicação Global no seletor de aplicação.
- 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.
- Selecione Atualizar.
- Selecione o escopo da aplicação Conector do Service Graph de APIs para Apigee X no seletor de aplicações.
- 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.
-
Habilite a criação de um trabalho de importação agendada para a nova conexão do Apigee X.
- Verifique se você tem permissões de edição para a tabela "Importação Programada de Dados" [scheduled_import_set].
- Selecione a tarefa Atualizar acesso à importação de dados agendada.
- Para editar o registro, selecione o escopo da aplicação Global no seletor de aplicação.
- 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.
- Selecione Atualizar.
- Selecione o escopo da aplicação Conector do Service Graph de APIs para Apigee X no seletor de aplicações.
- 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.
-
Limpe o cache nas tabelas "Fonte de Dados" [sys_data_source] e "Importações Programadas de Dados" [scheduled_import_set].
- Selecione a tarefa Limpar cache das tabelas "Fontes de dados" e "Importações agendadas de dados".
- Para editar o registro, selecione o escopo da aplicação Global no seletor de aplicações.
- 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"); - Selecione Executar script.
- Selecione o escopo da aplicação Conector do Service Graph de APIs para Apigee X no seletor de aplicações.
- Defina a tarefa Limpar cache das tabelas Fonte de dados e Importações programadas de dados como concluída clicando em Marcar como concluída.
- Para criar um certificado X.509 para a nova instância Apigee X, repita a etapa 4.de marque a tarefa Criar certificado X.509 como concluída clicando em Marcar como concluída.
-
Adicione outra conexão para a nova instância do Apigee X.
- 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.
- Selecione a tarefa Adicionar outra conexão e, em seguida, Clicar aqui.
- Na página "Conexões" que abre em outra guia do navegador, selecione Adicionar conexão.
- 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.
- Selecione Criar e obter um Token do OAuth.
- Feche a página "Conexões" e volte à guia da configuração assistida.
- 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.
-
Adicione propriedades para a nova conexão.
- 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.
- Selecione a tarefa Adicionar propriedades de configuração.
- Na coluna Nome, selecione o nome da conexão criada na etapa 5.f.
- 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. - Defina a tarefa Adicionar propriedades de configuração como concluída marcando a caixa de seleção Marcar como concluída e, em seguida, selecione Continuar.
-
Teste a nova conexão.
- Selecione a tarefa Testar novas conexões.
- Na coluna Nome, selecione o nome da conexão criada na etapa 5.f.
- 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.
- Quando o campo Status estiver definido como Êxito, selecione Atualizar.
Se algum dos testes apresentar algum erro, siga as sugestões de correção.
- 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.
-
Configure o trabalho agendado para a importação de dados do Apigee X.
- Na seção Configurar trabalhos de importação agendada da página Conector do Service Graph de APIs para Apigee X, selecione Iniciar.
-
Selecione o trabalho agendado do SGA Apigee X Organization.
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.
-
No formulário "Importação agendada de dados", verifique os valores dos campos.
Para obter mais informações, consulte Schedule a data import.
- Marque a caixa de seleção Ativo para ativar o trabalho agendado.
- No campo Executar, selecione Periodicamente para especificar a frequência de execução do trabalho.
- Selecione Atualizar.
- 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.
- Na página Conector do Service Graph de APIs para Apigee X, selecione Concluído para salvar suas mudanças.
- Na caixa de diálogo "Concluir configuração", selecione Concluir para concluir a configuração.
- Na caixa de mensagem que é exibida, selecione Concluído.