Aruba Networks: Configurando a Integração de Monitoramento de Experiência

Prev Next

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:

  1. Faça login na sua conta HPE Aruba Networking Central.

  2. Navegue até Menu > Gateway API, e selecione a aba REST API.

  3. 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.

  4. No HPE GreenLake, selecione Gerenciar Espaço de Trabalho.

  5. Selecione a categoria Clientes API Pessoais e clique em Criar Cliente API Pessoal.

  6. Digite um apelido de credencial, como Infraestrutura de Redes Cato, e escolha sua instância Central no menu de serviços.

  7. Clique em Criar cliente API pessoal.

  8. Copie e salve o ID do Cliente e o Segredo do Cliente para que possam ser inseridos no CMA.

  9. 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:

  1. 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.com

    • US-2: https://apigw-prod2.central.arubanetworks.com

    • US-East1: https://apigw-us-east-1.central.arubanetworks.com

    • US-West4: https://apigw-uswest4.central.arubanetworks.com

    • US-West5: https://apigw-uswest5.central.arubanetworks.com

    • EU-1: https://eu-apigw.central.arubanetworks.com

    • UE-Central2: https://apigw-eucentral2.central.arubanetworks.com

    • UE-Central3: https://apigw-eucentral3.central.arubanetworks.com

    • Canada-1: https://apigw-ca.central.arubanetworks.com

    • China-1: https://apigw.central.arubanetworks.com.cn

    • APAC-1: https://api-ap.central.arubanetworks.com

    • APAC-EAST1: https://apigw-apaceast.central.arubanetworks.com

    • APAC-SOUTH1: https://apigw-apacsouth.central.arubanetworks.com

    • AUE-NORTH1: https://apigw-uaenorth1.central.arubanetworks.com

    Copie e salve a URL do Classic API Gateway para que possa ser inserida no CMA.

  2. Inicie sessão no Classic Central. Na página Inicial da Conta, sob Configurações Globais, clique em API Gateway.

  3. Abra a aba Meus Aplicativos & Tokens. (Usuários Administradores podem usar a aba Aplicativos & Tokens do Sistema.)

  4. Clique em + Adicionar Aplicativos & Tokens.

  5. 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.

  6. Clique em Gerar. A aplicação é adicionada à tabela, e um token é adicionado à Lista de Tokens.

  7. Na linha da aplicação, copie e salve o ID do Cliente e o Segredo do Cliente para que possam ser inseridos no CMA.

  8. 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.

  9. Construa o Endpoint do Token adicionando /oauth2/token ao URL do Gateway de API Clássico. Para US-2, use https://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:

  1. No menu de navegação, clique em Recursos > Integrações

  2. Clique na aba Integrações Ativas.

  3. Clique em Novo. O painel de Nova Integração é aberto.

  4. Selecione a Aplicação SaaS que deseja adicionar.

  5. No menu suspenso de Capacidade, selecione Gerenciamento de Dispositivos.

  6. Adicione os detalhes criados durante a primeira etapa.

  7. 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:

  1. No menu de navegação, clique em Recursos > Integrações

  2. Clique na aba Integrações Ativas.

  3. Clique em Novo. O painel de Nova Integração é aberto.

  4. Selecione a Aplicação SaaS que deseja adicionar.

  5. Em Capacidade desplegar o menu e selecione Monitoramento de Experiência.

  6. Adicione os detalhes criados durante a primeira etapa.

  7. 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.