Visão geral
O Monitoramento de Experiência fornece contexto aprimorado, como perda de pacotes ou idade do túnel, para fornecer as informações necessárias para determinar se os problemas estão relacionados ao seu ISP, o Cato Cloud ou outras fontes.
Uma licença DEM é necessária para exibir Métricas Específicas de Aplicação. Para mais informações sobre a compra de uma licença DEM, por favor entre em contato com seu representante Cato.
Para configurar esta integração, você precisa:
Configurar a integração em suas Redes Aruba
Crie o conector API no Aplicativo de Gerenciamento Cato (CMA)
Configurar a Integração Aruba Networks
Para configurar a integração Aruba Networks, crie credenciais de API para Central ou Classic Central e insira-as na Aplicação de Gerenciamento Cato (CMA).
Requisitos
Uma conta HPE Aruba Networking Central ou Classic Central com acesso aos sites que você deseja monitorar
Para Central: permissão para criar um cliente de API Pessoal no HPE GreenLake para sua instância Central
Para Classic Central: permissão para criar uma aplicação e token no Gateway API Classic Central
Para Central apenas: dispositivos atribuídos a um site, porque as APIs de monitoramento do Central apenas relatam telemetria para dispositivos atribuídos ao site
O token de acesso herda os mesmos direitos e permissões que a sua função de usuário Central. Use uma conta cuja função tenha acesso de leitura aos dados de monitoramento que você deseja coletar.
Passo 1: Configurar a Integração nas Redes Aruba
O conector suporta tanto o Central (Novo Central) quanto o Classic Central. Crie um conector Aruba Networks por conta Central.
Central: Use esta opção para contas Central autônomas ou pontos de acesso executando AOS 10
Classic Central: Use esta opção se você vir a alternância Classic Central ou tiver APs Instantâneos AOS 8 gerenciados no Classic Central
Para configurar o Central Aruba:
Faça login na sua conta HPE Aruba Networking Central.
Navegue até Menu > Gateway API, e selecione a aba REST API.
Clique Copiar ao lado do URL base. Copie e salve a URL base para que ela possa ser inserida no CMA.
A URL base é específica para a região de hospedagem da sua conta. As solicitações são malsucedidas se você usar o URL errado.
No HPE GreenLake, selecione Gerenciar Espaço de Trabalho.
Selecione a categoria Clientes API Pessoais e clique em Criar Cliente API Pessoal.
Digite um apelido de credencial, como
Infraestrutura de Redes Cato, e escolha sua instância Central no menu de serviços.Clique em Criar cliente API pessoal.
Copie e salve o ID do Cliente e o Segredo do Cliente para que possam ser inseridos no CMA.
Confirme que os pontos de acesso que você deseja monitorar estão atribuídos a um site. Dispositivos não atribuídos não retornam dados de monitoramento e não aparecem no Cato.
Para configurar o Aruba Classic Central:
Identifique a URL do Gateway API Clássico para o cluster da sua conta. Classic Central usa diferentes domínios de Gateway API do Central.
US-1:
https://app1-apigw.central.arubanetworks.comUS-2:
https://apigw-prod2.central.arubanetworks.comUS-East1:
https://apigw-us-east-1.central.arubanetworks.comUS-West4:
https://apigw-uswest4.central.arubanetworks.comUS-West5:
https://apigw-uswest5.central.arubanetworks.comEU-1:
https://eu-apigw.central.arubanetworks.comUE-Central2:
https://apigw-eucentral2.central.arubanetworks.comUE-Central3:
https://apigw-eucentral3.central.arubanetworks.comCanada-1:
https://apigw-ca.central.arubanetworks.comChina-1:
https://apigw.central.arubanetworks.com.cnAPAC-1:
https://api-ap.central.arubanetworks.comAPAC-EAST1:
https://apigw-apaceast.central.arubanetworks.comAPAC-SOUTH1:
https://apigw-apacsouth.central.arubanetworks.comAUE-NORTH1:
https://apigw-uaenorth1.central.arubanetworks.com
Copie e salve a URL do Classic API Gateway para que possa ser inserida no CMA.
Inicie sessão no Classic Central. Na página Inicial da Conta, sob Configurações Globais, clique em API Gateway.
Abra a aba Meus Aplicativos & Tokens. (Usuários Administradores podem usar a aba Aplicativos & Tokens do Sistema.)
Clique em + Adicionar Aplicativos & Tokens.
Digite um nome de aplicação, como
Infraestrutura de Rede Cato. Deixe URI de Redirecionamento vazio e selecione Operações de Rede como aplicação.Clique em Gerar. A aplicação é adicionada à tabela, e um token é adicionado à Lista de Tokens.
Na linha da aplicação, copie e salve o ID do Cliente e o Segredo do Cliente para que possam ser inseridos no CMA.
Na Lista de Tokens, clique em Baixar Token para o novo token. Copie e salve o Token de Atualização (
refresh_token) para que possa ser inserido no CMA.Complete a conexão Cato dentro de 15 minutos após gerar o token. Use esta aplicação e token apenas para Cato. Classic Central emite um novo par de tokens quando o token é atualizado. Se outra ferramenta ou script atualizar o mesmo token, a cópia do Cato parará de funcionar.
Construa o Endpoint do Token adicionando
/oauth2/tokenao URL do Gateway de API Clássico. Para US-2, usehttps://apigw-prod2.central.arubanetworks.com/oauth2/token.
Etapa 2: Crie o Conector API na CMA
Depois de configurar uma integração com a aplicação requerida, adicione os detalhes no CMA.
Para Aruba Networks, use a opção de autenticação que corresponde à sua conta:
Autorização de Credenciais de Cliente OAuth2 para Aruba Central: ID do Cliente, Segredo do Cliente e URL do Gateway de API Aruba Central
Autenticação de token de atualização OAuth2 para Aruba Classic Central: ID do Cliente, Segredo do Cliente, Token de Atualização, Endpoint de Token e URL do Gateway de API Aruba Classic Central
Para criar o conector da API no CMA:
No menu de navegação, clique em Recursos > Integrações
Clique na aba Integrações Ativas.
Clique em Novo. O painel de Nova Integração é aberto.
Selecione a Aplicação SaaS que deseja adicionar.
No menu suspenso de Capacidade, selecione Gerenciamento de Dispositivos.
Adicione os detalhes criados durante a primeira etapa.
Clique em Salvar.
O aplicativo está visível na tabela de Aplicativos Integrados com status de Conectado.
Com o Central, o Cato descobre automaticamente todos os sites em sua conta e começa a coletar eventos de cada site. Com o Classic Central, Cato coleta eventos, pontos de acesso e clientes sem fio em toda a conta e renova o token automaticamente.
Se a conexão mostrar token de atualização Aruba Classic Central inválido, o token expirou, foi revogado ou foi atualizado por outra ferramenta. Gere um novo token para a aplicação em API Gateway > Minhas Aplicações & Tokens. Copie e salve o Token de Atualização para que possa ser inserido no CMA. Edite o conector no Cato e cole o novo Token de Atualização.
Passo 2: Criar o Conector de API no CMA
Depois de configurar uma integração com a aplicação requerida, adicione os detalhes no CMA.
Use a opção de autenticação que corresponde à sua conta Aruba:
Autorização de Credenciais de Cliente OAuth2 para Aruba Central: ID do Cliente, Segredo do Cliente e URL do Gateway de API Aruba Central
Autenticação de token de atualização OAuth2 para Aruba Classic Central: ID do Cliente, Segredo do Cliente, Token de Atualização, Endpoint de Token e URL do Gateway de API Aruba Classic Central
Insira um Nome e Descrição opcional para o conector. Complete a conexão Classic Central dentro de 15 minutos após gerar o token.
Para criar o conector da API no CMA:
No menu de navegação, clique em Recursos > Integrações
Clique na aba Integrações Ativas.
Clique em Novo. O painel de Nova Integração é aberto.
Selecione a Aplicação SaaS que deseja adicionar.
Em Capacidade desplegar o menu e selecione Monitoramento de Experiência.
Adicione os detalhes criados durante a primeira etapa.
Clique em Salvar.
O aplicativo está visível na tabela de Aplicativos Integrados com status de Conectado.
Com o Central, a Cato descobre automaticamente todos os sites na sua conta e começa a coletar eventos de cada um. Com o Clássico Central, a Cato coleta eventos, pontos de acesso e clientes wireless em toda a conta e mantém o token renovado automaticamente.
Se a conexão mostrar Aruba Clássico Central refresh token inválido, o token expirou, foi revogado ou foi atualizado por outra ferramenta. Genere um novo token para a aplicação em API Gateway > Meus Apps & Tokens. Copie e salve o Token de Atualização para que ele possa ser inserido no CMA. Em seguida, edite o conector na Cato e insira o novo Token de Atualização.
Limitações de Serviços
Intensidade do sinal é coletada apenas com o Clássico Central. A API de monitoramento de cliente do Central não expõe RSSI/dBm. Com o Clássico Central, a intensidade do sinal mostrada em um evento é o valor atual do cliente quando a Cato o coletou, não o valor no momento do evento.
Saúde do cliente, uso e velocidade de conexão não são coletados com nenhum das opções.
Clientes com fio não são coletados com o Clássico Central. A opção Clássico Central coleta apenas clientes wireless.
Nomes de usuários estão disponíveis apenas em redes 802.1X. Aruba popula o nome de usuário do cliente apenas quando o SSID usa 802.1X/WPA-Enterprise contra um backend RADIUS. Em SSIDs com chave pré-compartilhada, tipicamente convidados, IoT e redes BYOD, não há identidade de usuário para relatar. Eventos de cliente dessas redes não têm atribuição de usuário.
Com o Central, apenas dispositivos atribuídos ao site são relatados. Dispositivos não atribuídos a um site no Central não são visíveis para as APIs do Central. Se seus dispositivos são gerenciados no Clássico Central, use a opção de autenticação Clássico Central em vez disso.
O token Clássico Central deve ser dedicado à Cato. Se outra ferramenta atualizar o mesmo token, ou o token não for usado por 15 dias, a conexão para e você precisa gerar um novo token.
Quotas de API. O Central impõe um limite de taxa compartilhada de 10 chamadas de API por segundo em toda a conta do Central. Classic Central aplica 7 chamadas de API por segundo e uma cota diária de chamadas de API por conta: 5.000 chamadas por dia como base, aumentando com o número de dispositivos assinados, com 30 chamadas por dispositivo Foundation e 90 chamadas por dispositivo Avançado por dia, uma vez que o total exceda 5.000. O conector Classic Central utiliza cerca de 400 chamadas por dia (pelo menos quatro por consulta: atualização de token, pontos de acesso, clientes e eventos), mais em contas grandes porque cada lista é lida em páginas de 1.000. Outras ferramentas que compartilham a conta contam contra a mesma cota.