Descoberta da edição Apigee Edge Enterprise

A aplicação ServiceNow Descoberta usa o padrão APIGee para encontrar as versões 4.xx da edição Edge Enterprise do Apigee. Descobrir alguns desses recursos requer a atualização do Padrões de descoberta e mapeamento de serviços aplicação do ServiceNow Store.

O padrão APIGee usa um mecanismo de cache interno que coleta dados de cada serviço de API em um arquivo de cache local. O Mapeamento de serviços executa a descoberta de cima para baixo nesses arquivos de cache para encontrar conexões de saída do Apigee Edge.

Solicitar aplicativos na Store

Acesse o site ServiceNow Store para ver todos os aplicativos disponíveis e obter informações sobre como enviar solicitações para a loja. Para obter informações sobre notas de versão cumulativa para todos os aplicativos liberados, consulte as ServiceNow Store notas de versão do histórico de versão.

Pré-requisitos

Usuário do Linux

Forneça ao usuário do sistema operacional (SO) Linux direitos elevados para executar os comandos cat, ls, netstat e stat. Para obter mais informações, consulte Comandos do Mapeamento de serviços que requerem um usuário privilegiado.

Além disso, forneça a este usuário do Linux permissões para executar os seguintes comandos na pasta inicial do usuário do SO:

Comando	Descrição
"date +%s"	Obtém a data atual.
"ls -d $HOME/APIGee_Cache/cache_folder*"	Obtém a última pasta de cache.
"mkdir-p $HOME/APIGee_Cache/cache_folder_" + $today + ";ls -d$HOME/APIGee_Cache/cache_folder_" + $today	Cria o arquivo de cache se o arquivo de cache estiver vazio.
"ls -d $HOME/APIGee_Cache/cache_folder*"	Verifica se o arquivo de cache foi criado.
"echo `expr " + $today + " -" + $current_date+ "`”	Calcula o intervalo entre a hora de criação da pasta e a data atual.
"if [ " + $diff + " -ge" + $week_seconds+ " ]; then echo true; fi”	Verifica se é necessário recriar a pasta.
"ls" + $cache_folder+ "/* | sort | xargsgrep -l " + $entry_point.source_url	Verifica se os arquivos de cache existentes contêm o URL de origem inserido como ponto de entrada para o serviço.
"rm-rf" + $cache_folder+ ";mkdir-p $HOME/APIGee_Cache/cache_folder_" + $today + ";ls -d $HOME/APIGee_Cache/cache_folder_" + $today	Remove arquivos de cache antigos.
“curl -k -X GETurl-H '<ClientID>: <Token>’”	Obtém a resposta da API para o token fornecido.
"ls" + $cache_folder+ "/* | sort | xargsgrep -l " + $entry_point.source_url	Obtém a definição de URL do arquivo de cache.

Credencial do aplicativo

Configure a credencial do aplicativo da seguinte forma:

Tabela 1. Formulário Credenciais do aplicativo

Campo	Descrição
Nome	O nome da credencial, por exemplo, token da Apigee.
Ativo	Caixa de seleção para habilitar esta credencial para descoberta.
Nome de usuário	O nome do usuário desta credencial do aplicativo. É possível usar qualquer usuário para a credencial deste padrão, já que as informações são extraídas de um cache local.
Senha	A senha real do usuário desta credencial do aplicativo.
Tipo de IC	O tipo de IC para o qual esta credencial é usada: APIGee Service [cmdb_ci_appl_apigee_srv]. Nota: ServiceNow Aplicações se referem a dispositivos e aplicações que compõem uma instância de serviço como itens de configuração (ICs).
Aplica-se a	Selecione se deseja aplicar essas credenciais a Todos os MID Servers em sua rede, ou a um ou mais MID Servers específicos. Especifique os MID Servers que devem usar essas credenciais no campo Servidores MID.
Ordem	Insira a ordem (sequência) na qual a plataforma testa esta credencial ao tentar fazer login nos dispositivos. Quanto menor o número, mais alta será a exibição dessa credencial na lista. Estabeleça a ordem de credenciais ao usar um grande número de credenciais ou quando a segurança bloquear usuários após três tentativas de login com falha. Se todas as credenciais tiverem o mesmo número na ordem (ou número nenhum), a instância vai tentar usar as credenciais em uma ordem aleatória.

comando curl

Verifique se o comando curl está instalado no servidor Linux que hospeda o Apigee Edge.

Configurar propriedades do sistema

• Para criar conexões de Apigee Edge de saída de cima para baixo, configure a propriedade do sistema de URLs do Apigee (apigee.urls) usando a seguinte sintaxe:

  01#DVL#https://<url1>.com/dashboard/v1/targetServers/dvl### 02#QA#https://<url2>.com/dashboard/v2/targetServers/qa###

  Onde

  01 é o número do URL.

  DVL é o tipo de ambiente, como desenvolvimento.

  # é o delimitador entre os atributos. Coloque-o exatamente onde está no exemplo acima.

  ### é o delimitador entre URLs.

• Configure a propriedade do sistema ID do cliente da API Apigee (apigee.api.client.id) inserindo o ID do cliente da API Apigee no campo Valor. O padrão usa esta propriedade como cabeçalho para o comando cURL com o token:

  curl -k -X GET " + url + " -H ' apigee.api.client.id: " + token

O padrão preenche essas duas propriedades do sistema usando Adicionar URLs de Apigee e ID de cliente de API de Apigee sa_pre_task_script.

Dados coletados por Descoberta Para Apigee Edge Enterprise Edition

Descoberta preenche os dados no CMDB Ao executar o padrão APIGee.

Tabela 2. Serviço de APIGEE [cmdb_ci_appl_apigee_srv]

Campo	Descrição
Nome [nome]	O nome do servidor que hospeda o Apigee Edge.
Versão [version]	A versão do Apigee Edge.
Diretório de instalação [install_directory]	A pasta que contém todas as bibliotecas e arquivos executáveis do Apigee Edge.
Diretório de configuração [config_directory]	A pasta que contém todos os arquivos de configuração do Apigee Edge.

Relacionamentos entre ICs

O padrão APIGee não cria nenhum relacionamento de IC.

Dados coletados pelo Mapeamento de serviços durante a descoberta de cima para baixo

O padrão APIGee identifica conexões do Apigee Edge com outros ICs com base no URL configurado na seção de conexão do padrão.