Este documento descreve as etapas para configurar e solucionar problemas da Smart License no Secure Web Appliance (SWA).
A Cisco recomenda que você tenha conhecimento destes tópicos:
A Cisco recomenda que você:
Este documento não se restringe a versões de software e hardware específicas.
As informações neste documento foram criadas a partir de dispositivos em um ambiente de laboratório específico. Todos os dispositivos utilizados neste documento foram iniciados com uma configuração (padrão) inicial. Se a rede estiver ativa, certifique-se de que você entenda o impacto potencial de qualquer comando.
O Smart Licensing permite:
Para registrar o SWA com o Smart Licensing, o proprietário do dispositivo deve ter uma Smart Account:
Os links para recursos fornecidos pela Cisco incluem vídeos, guias e explicações relacionadas ao Smart Licensing:
O satélite Cisco Smart Software Manager é um componente do Cisco Smart Licensing. O satélite CSSM trabalha em conjunto com o CSSM para gerenciar licenças de produtos, fornecer visibilidade e relatórios quase em tempo real das licenças da Cisco em uso.
Por motivos de segurança, se você não quiser gerenciar a base instalada com o Smart Software Manager que reside em Cisco.com, poderá optar por instalar o satélite do Smart Software Manager localmente.
Para obter mais informações sobre o satélite do Gerenciador Inteligente de Software, consulte Cisco Smart Software Manager - Cisco.
Tipos de licença:
Status de autorização da licença: O status de uma determinada licença no equipamento.
O status de um recurso específico é exibido com um destes valores:
Note: Uma chave Perpetual indica que não há período de expiração para esse recurso. Uma chave Inativa indica que o recurso tem um Contrato de Licença de Usuário Final (EULA) que deve ser aceito ou que o recurso deve ser configurado e habilitado. Depois de concluído, o recurso passa para Ativo e o temporizador de expiração começa.
Você pode conectar o SWA ao Smart License por meio da interface gráfica do usuário (GUI) e da interface de linha de comando (CLI).
Caution: A habilitação do recurso Smart License no ESA/SMA/SWA é permanente e não permite a opção de reverter um dispositivo de volta para o modo de licença Classic.
Na CLI para Licença Clássica foram usados quatro comandos. Portanto, nas compilações de Smart License Mandate (15.1 e mais recentes) esses comandos são removidos.
Revise a lista dos comandos CLI removidos:
Na GUI para Licença clássica, duas páginas são mencionadas na guia Administração do sistema. Nas versões Smart License Mandate, essas páginas são removidas.
Lista de páginas de GUI removidas:
Reset Configuration in SWA executa a redefinição de fábrica onde a configuração inteira é eliminada e o SWA reverte para seu estado de fábrica. Com a licença Smart, a compilação tem o mesmo comportamento, que é mantido.
Recarregar é um comando oculto da CLI que apaga os dados de configuração e remove as teclas de recursos. Se o SWA foi registrado com a Licença Clássica e um recarregamento foi executado, carregue a licença novamente.
Se o SWA foi configurado com Smart License, após o recarregamento, o registro da Smart License será cancelado e desabilitado junto com uma redefinição de fábrica no comportamento atual do SWA.
Nas versões de criação de mandato SWA, a Smart License nunca reverte para o estado disable, portanto, o comando reload elimina todas as configurações. A Licença inteligente permanece no estado registrado, portanto, solicite todas as licenças novamente.
Comunicação de Rede ou Proxy para smartreceiver.cisco.com na porta TCP 443. Para testar a conectividade de SWA, use estas etapas:
1. Faça login na CLI.
2. Digite telnet e pressione Enter.
3. Escolha a interface na qual você espera que o SWA se conecte ao Smart License Server.
4. Digite smartreceiver.cisco.com.
5. Na seção da porta, insira 443 e pressione Enter.
Note: Se você configurou o satélite do Gerenciador Inteligente de Software, adicione o endereço do Localizador Uniforme de Recursos (URL) ou do Protocolo Internet (IP) associado a esse servidor na Etapa 4.
Este é um exemplo de conexão bem-sucedida:
> telnet
Please select which interface you want to telnet from.
1. Auto
2. Management (10.48.48.184/24: management.swa1.cisco.com)
3. P1 (192.168.13.184/24: p1.swa1.cisco.com)
4. P2 (192.168.133.184/24: p2.swa1.cisco.com)
[1]> 4
Enter the remote hostname or IP address.
[]> smartreceiver.cisco.com
Enter the remote port.
[23]> 443
Trying 10.112.59.81...
Connected to smartreceiver.cisco.com.
Escape character is '^]'.
Este é um exemplo de uma conexão com falha:
SWA_CLI> telnet
Please select which interface you want to telnet from.
1. Auto
2. Management (10.48.48.184/24: management.swa1.cisco.com)
3. P1 (192.168.13.184/24: p1.swa1.cisco.com)
4. P2 (192.168.133.184/24: p2.swa1.cisco.com)
[1]> 2
Enter the remote hostname or IP address.
[]> smartreceiver.cisco.com
Enter the remote port.
[23]> 443
Trying 10.112.59.81...
telnet: connect to address 10.112.59.81: Operation timed out
Trying 2a04:e4c7:fffe::f...
bind: Invalid argument
Note: Para sair do telnet, se Ctrl + C não funcionar, mantenha pressionada a tecla Control e pressione ], digite q e pressione Enter.
1. Faça login na GUI e navegue até System Administration.
2. Escolha Smart Software Licensing.
Imagem - Escolha o Smart Software Licensing
3. Escolha Ativar Smart Software Licensing.
Imagem - Escolha Ativar Smart Software Licensing
4. Leia as instruções cuidadosamente e clique em OK.
Imagem - Leia as instruções atentamente
Caution: Não é possível reverter de Licença inteligente para Licença clássica, depois de habilitar o recurso Licença inteligente em seu equipamento.
5. Confirme as alterações.
6. Aguarde um momento e atualize a página Smart Licensing.
7. Selecione Smart License Registration e clique em Confirmar.
Imagem - escolha Registro de Licença Inteligente
8. (Opcional): Se você tiver o satélite do Gerenciador Inteligente de Software na rede, adicione o URL ou o endereço IP do servidor em Configurações de Transporte.
9. Se você tiver uma tabela de roteamento separada e não tiver acesso ao Receptor Inteligente na interface de Gerenciamento; escolha Data na seção Test Interface.
Por padrão, a tabela Roteamento de gerenciamento está selecionada.
Imagem - escolha a tabela de roteamento
10. Escolha Registrar para navegar até a Página de Registro.
11. Faça login no portal do Gerenciador Inteligente de Software (Cisco Software Central) ou no satélite do Gerenciador Inteligente de Software.
12. Navegue até a guia Inventário e, se você ainda não tiver um token, gere um novo token. Ou clique na seta azul para exibir o token.
Imagem - Navegue até Inventário
13. (Opcional): Para criar um token de registro, escolha Novo token e preencha os campos obrigatórios.
14. Cole o token do portal Smart License em seu SWA e escolha Register.
Imagem - Cole o token de registro
15. (Opcional): Se o dispositivo já tiver sido registrado, você poderá registrá-lo novamente se marcar a caixa de seleção.
16. Após alguns minutos, você poderá verificar o status do registro.
Imagem - Dispositivo registrado
Você pode verificar a integração através da GUI, CLI ou Smart License Portal.
1. Faça login na GUI e navegue até System Administration.
2. Escolha Smart Software Licensing.
3. Verifique estes itens:
Imagem - Verificar Smart License na GUI
4. No menu Administração do Sistema, escolha Licenças.
5. Verifique se as licenças desejadas estão Em Conformidade.
Imagem - Status da licença
Siga estas etapas para verificar o status da Smart License na CLI:
1. Inicie a sessão na CLI.
2. Digite license_smart.
3. Selecione STATUS.
4. Verifique estes itens:
Smart Licensing is : Enabled
License Reservation is: Disabled
Evaluation Period: Not In Use
Evaluation Period Remaining: 89 days 22 hours 40 minutes
Registration Status: Registered ( 04 Sep 2023 20:38 ) Registration Expires on: ( 03 Sep 2024 21:03 )
Smart Account: XXXXXXXXXXXX18.cisco.com
Virtual Account: XXXXXXXXX
Last Registration Renewal Attempt Status: SUCCEEDED on 04 Sep 2023 21:07
License Authorization Status: Authorized ( 04 Sep 2023 20:38 ) Authorization Expires on: ( 03 Dec 2023 20:03 )
Last Authorization Renewal Attempt Status: SUCCEEDED on 04 Sep 2023 21:07
Product Instance Name: wsa125to15.amojarra.calo
Transport Settings: Direct (https://smartreceiver.cisco.com/licservice/license)
Device Led Conversion Status: Started
5. No assistente license_smart, insira SUMMARY.
[]> SUMMARY
Feature Name License Authorization Status
----------------------------------------------------------------------------------------------------
Secure Web Appliance Cisco Web Usage Controls In Compliance
Secure Web Appliance Anti-Virus Webroot In Compliance
Secure Web Appliance L4 Traffic Monitor In Compliance
Secure Web Appliance Cisco AnyConnect SM for AnyConnect In Compliance
Secure Web Appliance Secure Endpoint Reputation In Compliance
Secure Web Appliance Anti-Virus Sophos In Compliance
Secure Web Appliance Web Reputation Filters In Compliance
Secure Web Appliance Secure Endpoint In Compliance
Secure Web Appliance Anti-Virus McAfee Not requested
Secure Web Appliance Web Proxy and DVS Engine In Compliance
Secure Web Appliance HTTPs Decryption In Compliance
6. Verifique se as licenças desejadas estão Em Conformidade.
1. Faça login no Smart Software Licensing Portal: Cisco Software Central.
2. Selecione a guia Inventário.
3. Escolha Instâncias de Produto.
4. Verifique se o dispositivo está listado e clique no nome do dispositivo.
Imagem - Verifique o status do dispositivo no Smart License Portal
5. Observe as Chaves de recurso e o status do dispositivo na guia Geral.
Imagem - Verifique as chaves de recurso no portal Smart License
Para visualizar sua VLAN a partir da CLI, execute o comando smartaccountinfo. Você pode exibir algumas informações adicionais, como Domínio da Virtual Account ou ID e Instâncias de produto.
> smartaccountinfo
Smart Account details
---------------------
Product Instance ID : 609XXXXXXXX-fXXXXXXXXX55
Smart Account Domain : XXXXXXXXXXXXXXXXXXX18.cisco.com
Smart Account ID : 111111
Smart Account Name : XXXXXXXXXXXXXXXXXXX18.cisco.com
VLN : VLNWSA1111111
Virtual Account Domain : WSA_XXXXX
Virtual Account ID : 111111
Todos os registros relacionados à Smart License são coletados nos registros da Smartlicense. Esse log é habilitado por padrão.
Siga estas etapas para configurar o log da Smart License:
1. Faça login na GUI.
2. No menu System Administration, selecione Log Subscriptions.
3. Selecione Smartlicense Logs.
4. Clique no nome do log para editar a configuração.
Tip: Se desejar enviar os logs para o servidor do coletor de logs, é aconselhável criar novas Inscrições de log e encaminhá-los para ter uma cópia dos logs localmente no SWA
Esses são erros comuns e as etapas para resolver o problema.
Este é um exemplo de logs smart_license com uma resposta bem-sucedida:
Mon Sep 4 20:39:32 2023 Info: The product is registered successfully with Smart Software Manager.
Imagem - Falha no registro
Se Registration Failed for retornado, verifique os logs smart_license do CLI usando estas etapas:
1. Faça login na CLI.
2. Informe grep.
3. Localize o número associado aos logs de smartlicensee insira o número.
4. Pressione Enter até ver os logs.
Se você vir "Communication send error" (Erro de envio de comunicação), verifique a conectividade entre o SWA e o Smart License Server na porta TCP 443.
Mon Sep 4 19:57:09 2023 Warning: The registration of the product with Smart Software Manager failed. The response from Smart Software Manager is: Communication send error.
Tip: Se você configurou o satélite do Gerenciador Inteligente de Software, verifique a conectividade com o número de porta configurado.
Para verificar a conectividade, use as etapas fornecidas na seção Requisitos de comunicação deste artigo.
Também em alertas de exibição, você pode ver a mesma mensagem de erro:
04 Sep 2023 20:19:29 +0200 The registration of the product with Smart Software Manager failed. The response from Smart Software Manager is: Communication send error.
Se o token tiver expirado ou atingido seu valor máximo de uso definido, o Token de log de avisos inválido será retornado.
Você pode verificar o erro no comando displayalerts ou nos logs de smartlicense.
Este é um exemplo de erro de displayalerts na CLI:
04 Sep 2023 20:26:55 +0200 The registration of the product with Smart Software Manager failed. The response from Smart Software Manager is: Token is not valid
Este é um exemplo de uma linha de log dos logs smartlicense da CLI:
Mon Sep 4 20:26:55 2023 Warning: The registration of the product with Smart Software Manager failed. The response from Smart Software Manager is: Token is not valid
Para verificar a validade do token, faça login no portal Smart License, navegue até o inventário, verifique o status de expiração e o número de uso.
Imagem - Token Expirador
Se você receber uma autorização de falha na renovação devido a um erro de envio de comunicação, isso pode ser devido a um problema de conectividade. Verifique se a tabela de roteamento correta está selecionada e teste a conectividade entre SWA e smartreceiver.cisco.com porta TCP 443 ou seu servidor satélite do Gerenciador Inteligente de Software.
Para verificar a conectividade, use as etapas fornecidas na seção Requisitos de comunicação deste artigo.
Você pode verificar o erro com o comando displayalerts ou nos logs de smartlicense
Este é um exemplo de erro de displayalerts na CLI:
04 Sep 2023 22:23:43 +0200 Failed to renew authorization of the product with Smart Software Manager due to Communication send error..
Este é um exemplo de linha de log dos logs smartlicense da CLI:
Mon Sep 4 22:22:58 2023 Warning: Failed to renew authorization of the product with Smart Software Manager due to Communication send error..
Se o motivo para renovar a autorização for o certificado REVOGADO, verifique se o dispositivo foi removido do Smart License Portal. Verifique a seção Verificar o status do dispositivo no Smart License Portal neste artigo.
Verifique o erro executando o comando displayalerts ou nos logs de smartlicense.
Este é um exemplo de erro do displayalerts na CLI:
04 Sep 2023 22:39:10 +0200 Failed to renew authorization of the product with Smart Software Manager due to Could not return the certificate for the given sn (111111111) since it is REVOKED..
Este é um exemplo de linha de log dos logs smartlicense da CLI:
Mon Sep 4 22:39:10 2023 Warning: Failed to renew authorization of the product with Smart Software Manager due to Could not return the certificate for the given sn (1111111) since it is REVOKED..
Para resolver esse problema, registre o dispositivo novamente.
Para dispositivos físicos, não há VLANs; o número de licença virtual é usado principalmente em dispositivos virtuais. Se você estiver usando um SWA virtual e não houver VLAN na saída de smartaccountinfo na CLI, tente carregar o arquivo de licença XML novamente com o comando loadlicense na CLI.
Caution: O comando loadlicense remove toda a chave de recurso existente (inclui chaves de avaliação) e o arquivo de licença do sistema antes de instalar o novo arquivo de licença e chaves.
Se você receber esta mensagem de erro, ela se deve ao bug da Cisco ID: CSCwe3665 para SWA ou ID de bug da Cisco: CSCvo2855 para ESA. Entre em contato com o TAC para implementar uma solução.
"Smart license agent service is unavailable. Please visit this page after some time. If you continue to see the same message, please contact Cisco Sales representative."
Se a autorização da Smart License falhar com este erro:
Tue Apr 22 09:46:27 2023 Warning: Failed to renew authorization of the product with Smart Software Manager due to Failed to verify signature..
[Primeiro teste] Este erro pode ser devido ao bug da Cisco ID: CSCvx04164.
A condição para esse bug é que o Nome da Virtual Account no portal Smart Licensing contenha caracteres que não sejam do idioma inglês, e a solução alternativa para esse problema é:
Renomeie a Virtual Account e remova os caracteres que não estão em inglês:
1. Vá para software.cisco.com.
2. Navegue até Administração > Gerenciar Smart Account > Virtual Accounts.
3. Clique na Virtual Account em questão.
4. Defina um novo nome e remova os caracteres que não estão em inglês.
Note: Os usuários devem ter direitos administrativos para renomear a Virtual Account.
[Segundo teste] Se o nome da Virtual Account estiver correto, verifique se o dispositivo está listado no inventário do portal Smart License.
Use as etapas fornecidas na seção Verificar o status do dispositivo no Smart License Portal neste artigo.
[Terceiro teste] Se o dispositivo estiver listado no inventário do Smart License Portal, reinicie o serviço SWA Smart License a partir da CLI:
1. Faça login na CLI.
2. Execute o comando de diagnóstico.
3. Escolha SERVIÇOS.
4. Escolha SMART_LICENSE.
5. Escolha REINICIAR.
SWA_CLI> diagnostic
Choose the operation you want to perform:
- NET - Network Diagnostic Utility.
- PROXY - Proxy Debugging Utility.
- REPORTING - Reporting Utilities.
- SERVICES - Service Utilities.
[]> SERVICES
Choose one of the following services:
- AMP - Secure Endpoint
- AVC - AVC
- ADC - ADC
- DCA - DCA
- WBRS - WBRS
- EXTFEED - ExtFeed
- L4TM - L4TM
- ANTIVIRUS - Anti-Virus xiServices
- AUTHENTICATION - Authentication Services
- MANAGEMENT - Appliance Management Services
- REPORTING - Reporting Associated services
- MISCSERVICES - Miscellaneous Service
- OCSP - OSCP
- UPDATER - UPDATER
- SICAP - SICAP
- SNMP - SNMP
- SNTP - SNTP
- VMSERVICE - VM Services
- WEBUI - Web GUI
- SMART_LICENSE - Smart Licensing Agent
- WCCP - WCCP
[]> SMART_LICENSE
Choose the operation you want to perform:
- RESTART - Restart the service
- STATUS - View status of the service
[]> RESTART
smart_agent is restarting.
[Quarto teste] Gere um novo token no portal do Smart License Manager e registre o dispositivo novamente.
Esses erros podem ser vistos em um ESA ou SMA após a atualização do dispositivo (que a Smart License foi habilitada antes da atualização) para a versão 14.1 ou 14.0.
Note: Esse erro é visto em dispositivos x195 ou x395.
Este é um exemplo da mensagem gerada pelo equipamento:
08 Apr 2023 10:19:36 -0500 Initialization of smart agent service failed. Reason : Port 65501 is not available for smart agent service to run. Please try changing port for smart agent service through `license_smart setagentport` cli command or free the port from other service.
E nos logs smart_license você pode ver:
Mon Apr 8 09:02:36 2021 Warning: Smart License: Failed to change the hostname to esa.local for the product.
Este erro é devido à ID de bug da Cisco: CSCvz74874 para ESA e ID de bug da Cisco: CSCvx68947 para SMA. Você deve entrar em contato com o Suporte da Cisco para resolver esse problema.
Esse erro está relacionado principalmente a dispositivos virtuais que estão configurados com mais recursos do que o esperado. Este é um exemplo do log:
Thu Jun 23 16:16:07 2022 Critical: Initialization of smart agent service failed. Reason : Port 65501 is not available for smart agent service to run. Please try changing port for smart agent service through `license_smart setagentport` cli command or free the port from other service.
any attempts to swap ports using the defined command will fail.
Para corrigir esse problema, verifique a saída do comando version na CLI e certifique-se de que o número de CPUs e a memória alocada esteja definido como esperado. Se houver mais núcleos para o dispositivo do que o permitido, corrija a alocação.
Se o dispositivo tiver sido removido do Smart License Manager Portal, as versões mais antigas retornarão este erro:
Thu Nov 15 13:50:20 2022 Warning: Failed to renew authorization of the product with Smart Software Manager due to Invalid response from licensing cloud..
Para corrigir esse problema, registre novamente o dispositivo e consulte a ID de bug da Cisco: CSCvr09743.
Se você receber esse erro de seu equipamento e não puder recuperar as atualizações, consulte Field Notice: FN - 72502 para obter informações adicionais.
21 Aug 2023 14:03:04 +0200 Unable to connect to the Cisco Aggregator Server.
Details: No valid SSL certificate was sent
Os arquivos de certificado VLN tradicionais incluem um certificado criado pelo Talos Keymaster para acesso a atualizações e upgrades. A antiga Autoridade de Certificação Keymaster (CA) expirou em 13 de janeiro de 2023.
Os ficheiros de certificados VLN com certificados emitidos antes de 15 de dezembro de 2021, com validade superior a 12 meses, devem ser renovados e aplicados antes de 13 de janeiro de 2023.
Para resolver esse problema, entre em contato com o suporte de licença da Cisco e solicite um novo arquivo VLN.
Se você vir alguns registros de que um ou alguns de seus recursos foram movidos para Fora de conformidade, verifique:
1. Você tem uma Licença Válida.
2. O dispositivo tem conectividade com o servidor Smart License (consulte a seção Requisitos de comunicação neste artigo).
3. Verifique os logs da Smart License para obter mais informações sobre o problema.
4. Entre em contato com o Suporte da Cisco para obter assistência.
Este é um log de exemplo:
Mon Sep 4 20:41:09 2023 Warning: Secure Web Appliance HTTPs Decryption license has been moved to Out of Compliance successfully.
Mon Sep 4 20:41:10 2023 Warning: The Secure Web Appliance HTTPs Decryption is in Out of Compliance (OOC) state. You have 29 days remaining in your grace period.
Se você receber o erro crítico como "O agente inteligente está no estado Autorização expirada", revise as próximas linhas para encontrar os motivos para esse estado.
Este é um exemplo do erro:
Fri Aug 18 15:51:11 2023 Critical: Web Security Appliance Cisco Web Usage Controls feature will stop working as Smart Agent is in Authorization Expired state. This can happen if there is no communication between the appliance and the Cisco Smart Software Manager (CSSM) for more than 90 days.
Verifique a conectividade e certifique-se de que seu dispositivo esteja registrado no portal Smart License.
| Revisão | Data de publicação | Comentários |
|---|---|---|
2.0 |
26-Oct-2026
|
Ortografia, gramática, espaçamento e linhas horizontais inseridas atualizadas em seções separadas para facilitar a leitura, texto alternativo, URLs e alertas fixos do CCW. |
1.0 |
08-Sep-2023
|
Versão inicial |