In questo documento viene descritta la procedura per configurare Smart License in Secure Web Appliance (SWA) e risolverne i problemi.
Cisco raccomanda la conoscenza dei seguenti argomenti:
Cisco raccomanda:
Il documento può essere consultato per tutte le versioni software o hardware.
Le informazioni discusse in questo documento fanno riferimento a dispositivi usati in uno specifico ambiente di emulazione. Su tutti i dispositivi menzionati nel documento la configurazione è stata ripristinata ai valori predefiniti. Se la rete è operativa, valutare attentamente eventuali conseguenze derivanti dall'uso dei comandi.
Smart Licensing consente di:
Per registrare un dispositivo SWA con una licenza intelligente, il proprietario dell'accessorio deve disporre di uno Smart Account:
I collegamenti alle risorse fornite da Cisco includono video, guide e spiegazioni relative a Smart Licensing:
Il satellite Cisco Smart Software Manager è un componente di Cisco Smart Licensing. CSSM Satellite lavora in abbinamento a CSSM per gestire le licenze dei prodotti, fornire visibilità e report in tempo quasi reale sulle licenze Cisco in uso.
Per motivi di sicurezza, se non si desidera gestire la base installata con Smart Software Manager che risiede su Cisco.com, è possibile scegliere di installare il satellite di Smart Software Manager in locale.
Per ulteriori informazioni su Smart Software Manager Satellite, consultare Cisco Smart Software Manager - Cisco.
Tipi di licenza:
Stato autorizzazione licenza: Stato di una determinata licenza all'interno dell'accessorio.
Lo stato di una feature specifica viene visualizzato con uno dei seguenti valori:
Nota: Una chiave Perpetua indica che non è previsto alcun periodo di scadenza per la funzione. Una chiave inattiva indica che la funzionalità dispone di un contratto di licenza con l'utente finale (EULA) che deve essere accettato oppure che la funzionalità deve essere configurata e abilitata. Al termine, la funzione passa ad Attiva e il timer di scadenza ha inizio.
È possibile connettere SWA a Smart License tramite l'interfaccia utente grafica (GUI) e l'interfaccia della riga di comando (CLI).
Attenzione: L'attivazione della funzione Smart License su ESA/SMA/SWA è permanente e non consente di ripristinare la modalità di licenza classica per un accessorio.
Nella CLI per la licenza classica sono stati utilizzati quattro comandi. Pertanto, nelle build Smart License Mandate (15.1 e successive) tali comandi vengono rimossi.
Esaminare la lista dei comandi CLI rimossi:
Nella GUI per la licenza Classic, due pagine sono menzionate nella scheda Amministrazione del sistema. Nelle build di Mandato Smart License, tali pagine vengono rimosse.
Elenco di pagine GUI rimosse:
Reset Configuration in SWA esegue il reset di fabbrica quando l'intera configurazione viene cancellata e SWA torna allo stato di fabbrica. Con il mandato di Smart License, la build ha lo stesso comportamento, che viene mantenuto.
Reload è un comando nascosto della CLI che cancella i dati di configurazione e rimuove le chiavi di funzionalità. Se SWA è stato registrato con la licenza Classic ed è stato eseguito un ricaricamento, caricare nuovamente la licenza.
Se SWA è stato configurato con Smart License, dopo il ricaricamento, la Smart License viene cancellata e disabilitata insieme a una reimpostazione di fabbrica nel comportamento SWA corrente.
Nelle versioni di creazione del mandato SWA, Smart License non torna mai allo stato disable, quindi il comando reload elimina tutte le configurazioni. La Smart License rimane nello stato registrato, quindi è necessario richiedere nuovamente tutte le licenze.
Comunicazione di rete o proxy a smartreceiver.cisco.com sulla porta TCP 443. Per verificare la connettività da SWA, attenersi alla seguente procedura:
1. Accedere alla CLI.
2. Digitare telnet e premere Invio.
3. Scegliere l'interfaccia che si prevede che SWA si connetta a Smart License Server.
4. Immettere smartreceiver.cisco.com.
5. Nella sezione port, immettere 443 e premere Invio.
Nota: Se è stato configurato il satellite di Smart Software Manager, aggiungere l'URL (Uniform Resource Locator) o l'indirizzo IP (Internet Protocol) associato a tale server nel passaggio 4.
Di seguito viene riportato un esempio di connessione riuscita:
> 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 '^]'.
Questo è un esempio di connessione non riuscita:
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
Nota: Per uscire da telnet, se Ctrl + C non funziona, tenere premuto Ctrl e quindi premere ], digitare q e premere Invio.
1. Accedere alla GUI e selezionare System Administration (Amministrazione sistema).
2. Scegliere Smart Software Licensing.
Immagine - Scegli le licenze per Smart Software
3. Scegliere Abilita gestione licenze Smart Software.
Immagine: scegliere Abilita gestione licenze Smart Software
4. Leggere attentamente le istruzioni e fare clic su OK.
Immagine- Leggere attentamente le istruzioni
Attenzione: Dopo aver attivato la funzione Smart License sull'accessorio, non è possibile eseguire il rollback da Smart License a Classic License.
5. Confermare le modifiche.
6. Attendere qualche istante, quindi aggiornare la pagina Smart Licensing.
7. Selezionare Smart License Registration e fare clic su Confirm.
Immagine: scegliere Smart License Registration
8. (facoltativo): Se nella rete è presente il satellite di Smart Software Manager, aggiungere l'URL o l'indirizzo IP del server in Impostazioni di trasporto.
9. Se si dispone di una tabella di routing separata e non si dispone dell'accesso a Smart Receiver dall'interfaccia di gestione; scegliere Dati dalla sezione Interfaccia test.
Per impostazione predefinita, la tabella Routing di gestione è selezionata.
Immagine - scegliere la tabella di routing
10. Scegliere Registra per passare alla pagina Registrazione.
11. Accedere al portale di Smart Software Manager (Cisco Software Central) o al satellite di Smart Software Manager.
12. Passare alla scheda Magazzino e, se non si dispone ancora di un token, generare un nuovo token. In alternativa, fai clic sulla freccia blu per visualizzare il token.
Immagine - Passa a Magazzino
13. (facoltativo): Per creare un token di registrazione, scegliere Nuovo token e compilare i campi obbligatori.
14. Incollare il token dal portale Smart License al proprio SWA e scegliere Register.
Immagine - Incolla il token di registrazione
15. (facoltativo): Se la periferica è già stata registrata, è possibile registrarla nuovamente selezionando la casella di controllo.
16. Dopo alcuni minuti, è possibile controllare lo stato della registrazione.
Immagine - Accessorio registrato
È possibile verificare l'integrazione dalla GUI, dalla CLI o dal portale Smart License.
1. Accedere alla GUI e selezionare System Administration.
2. Scegliere Smart Software Licensing.
3. Verificare quanto segue:
Immagine - Verifica della licenza Smart nella GUI
4. Dal menu Amministrazione sistema, scegliere Licenze.
5. Verificare che le licenze desiderate siano conformi.
Immagine - Stato licenza
Per verificare lo stato della Smart License dalla CLI, attenersi alla procedura descritta di seguito.
1. Accedere alla CLI.
2. Inserire license_smart.
3. Selezionare STATUS.
4. Verificare quanto segue:
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. Dalla procedura guidata license_smart, immettere 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. Verificare che le licenze desiderate siano conformi.
1. Accedere al portale delle licenze di Smart Software: Cisco Software Central.
2. Selezionare la scheda Magazzino.
3. Scegliere Istanze prodotto.
4. Verificare che il dispositivo sia presente nell'elenco e fare clic sul nome del dispositivo.
Immagine - Verifica dello stato del dispositivo in Smart License Portal
5. Osservare le chiavi di funzionalità e lo stato del dispositivo nella scheda Generale.
Immagine - Verifica dei tasti funzione nel portale Smart License
Per visualizzare la VLAN dalla CLI, eseguire il comando smartaccountinfo. È possibile visualizzare alcune informazioni aggiuntive, ad esempio il dominio account virtuale o l'ID e le istanze del prodotto.
> 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
Tutti i log relativi a Smart License vengono raccolti nei log Smartlicense. Questo registro è attivato per impostazione predefinita.
Per configurare il log delle licenze Smart, attenersi alla procedura seguente:
1. Accedere alla GUI.
2. Dal menu Amministrazione di sistema, selezionare Registra sottoscrizioni.
3. Selezionare Smartlicense Logs.
4. Fare clic sul nome del log per modificare la configurazione.
Suggerimento: Se si desidera eseguire il push dei log nel server di raccolta dei log, si consiglia di creare una nuova sottoscrizione ai log e inoltrare tali log, in modo da avere una copia dei log localmente nell'SWA
Si tratta di errori comuni e dei passaggi per risolvere il problema.
Questo è un esempio di log di smart_license con una risposta corretta:
Mon Sep 4 20:39:32 2023 Info: The product is registered successfully with Smart Software Manager.
Immagine - Registrazione non riuscita
Se viene restituito Registration Failed, controllare i log smart_license dalla CLI attenendosi alla seguente procedura:
1. Accedere alla CLI.
2. Inserire grep.
3. Individuare il numero associato ai log delle licenze intelligenti e immettere il numero.
4. Premere Invio finché non vengono visualizzati i log.
Se viene visualizzato "Errore di invio comunicazione", controllare la connettività tra SWA e Smart License Server sulla 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.
Suggerimento: Se è stato configurato Smart Software Manager Satellite, verificare la connettività al numero di porta configurato.
Per verificare la connettività, eseguire la procedura descritta nella sezione Requisiti di comunicazione di questo articolo.
Anche negli avvisi di visualizzazione è possibile visualizzare lo stesso messaggio di errore:
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 il token è scaduto o ha raggiunto il valore utilizzato massimo definito, viene restituito il token del registro di avviso non valido.
È possibile verificare l'errore dal comando displayalert o dai log delle licenze intelligenti.
Questo è un errore di esempio da displayalert nella 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
Questo è un esempio di una riga di registro dai log delle licenze intelligenti dalla 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
Per verificare la validità del token, accedere al portale Smart License, passare all'inventario, controllare lo stato di scadenza e il numero di utenti.
Immagine - Token Expier
Se si riceve un messaggio che indica che non è stato possibile rinnovare l'autorizzazione a causa di un errore di invio di comunicazione, è possibile che si sia verificato un problema di connettività. Assicurarsi di aver selezionato la tabella di routing corretta e verificare la connettività tra SWA e la porta TCP smartreceiver.cisco.com 443 o il server satellitare Smart Software Manager.
Per verificare la connettività, eseguire la procedura descritta nella sezione Requisiti di comunicazione di questo articolo.
È possibile verificare l'errore con il comando displayalert o dai log delle licenze intelligenti
Questo è un esempio di errore restituito da displayalert nella CLI:
04 Sep 2023 22:23:43 +0200 Failed to renew authorization of the product with Smart Software Manager due to Communication send error..
Questa è una riga di log di esempio dai log delle licenze intelligenti dalla 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 il motivo per cui rinnovare l'autorizzazione è il certificato REVOCATO, verificare se il dispositivo è stato rimosso dal portale Smart License. Controllare la sezione Verifica dello stato del dispositivo nel portale delle licenze Smart in questo articolo.
Verificare l'errore eseguendo il comando displayalert o dai log delle licenze intelligenti.
Questo è un esempio di errore da displayalert nella 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..
Questa è una riga di log di esempio dai log delle licenze intelligenti dalla 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..
Per risolvere il problema, registrare nuovamente il dispositivo.
Per i dispositivi fisici, non vi è alcuna VLAN; il numero di licenza virtuale viene utilizzato solo nelle appliance virtuali. Se si utilizza un SWA virtuale e non è presente alcuna VLAN nell'output di smartaccountinfo nella CLI, provare a caricare di nuovo il file di licenza XML con il comando loadlicense nella CLI.
Attenzione: Il comando loadlicense rimuove tutte le chiavi di funzionalità esistenti (incluse le chiavi di valutazione) e il file di licenza dal sistema prima di installare il nuovo file di licenza e le nuove chiavi.
La visualizzazione di questo messaggio di errore è dovuta all'ID bug Cisco: CSCwe3665 per SWA o ID bug Cisco: CSCvo22855 per ESA. Contattare TAC per implementare una soluzione.
"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 l'autorizzazione Smart License non riesce con questo errore:
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..
[First Test] Questo errore può essere dovuto a un bug di Cisco con ID: CSCvx04164.
La condizione per questo bug è che il nome dell'account virtuale sul portale di Smart Licensing contiene caratteri non inglesi e la soluzione al problema è:
Rinominare l'account virtuale e rimuovere i caratteri non inglesi:
1. Visitare il sito software.cisco.com.
2. Passare a Amministrazione > Gestisci Smart Account > Account virtuali.
3. Fare clic sull'account virtuale in questione.
4. Definire un nuovo nome e rimuovere i caratteri non inglesi.
Nota: Gli utenti devono disporre dei diritti amministrativi per rinominare l'account virtuale.
[Secondo test] Se il nome dell'account virtuale è corretto, verificare che il dispositivo sia elencato nell'inventario del portale delle Smart License.
Attenersi alla procedura descritta nella sezione Verifica dello stato del dispositivo nel portale Smart License di questo articolo.
[Third Test] Se il dispositivo è elencato nell'inventario di Smart License Portal, riavviare il servizio SWA Smart License dalla CLI:
1. Accedere alla CLI.
2. Eseguire il comando di diagnostica.
3. Scegliere SERVIZI.
4. Scegliere SMART_LICENSE.
5. Scegliere RIAVVIA.
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.
[Fourth Test] Generare un nuovo token nel portale di Smart License Manager e registrare nuovamente il dispositivo.
Questi errori possono essere rilevati su un ESA o SMA dopo l'aggiornamento dell'accessorio (su cui la Smart License era stata abilitata prima dell'aggiornamento) alla versione 14.1 o 14.0.
Nota: Questo errore viene visualizzato sui dispositivi x195 o x395.
Di seguito è riportato un esempio del messaggio generato dall'accessorio:
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.
Nei log di smart_license è inoltre possibile visualizzare:
Mon Apr 8 09:02:36 2021 Warning: Smart License: Failed to change the hostname to esa.local for the product.
Questo errore è dovuto all'ID bug Cisco: CSCvz74874 per ESA e ID bug Cisco: CSCvx68947 per SMA. Per risolvere il problema, è necessario contattare il supporto Cisco.
Questo errore è dovuto principalmente ad appliance virtuali configurate con un numero di risorse superiore al previsto. Questo è un esempio del 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.
Per risolvere il problema, controllare l'output del comando version nella CLI e verificare che il numero di CPU e la memoria allocata siano impostati come previsto. Se il numero di core dell'accessorio è maggiore di quello supportato, correggere l'allocazione.
Se il dispositivo è stato rimosso dal portale di Smart License Manager, le versioni precedenti restituiscono questo errore:
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..
Per risolvere il problema, registrare nuovamente l'accessorio e consultare l'ID bug Cisco: CSCvr09743.
Se l'accessorio segnala questo errore e non è possibile recuperare gli aggiornamenti, consultare la Guida in linea: FN - 72502 per ulteriori informazioni.
21 Aug 2023 14:03:04 +0200 Unable to connect to the Cisco Aggregator Server.
Details: No valid SSL certificate was sent
I file dei certificati VLAN tradizionali includono un certificato creato da Talos Keymaster per l'accesso agli aggiornamenti. La vecchia Autorità di certificazione (CA) Keymaster è scaduta il 13 gennaio 2023.
I file di certificato VLAN con certificati rilasciati prima del 15 dicembre 2021, con validità superiore a 12 mesi, devono essere rinnovati e applicati prima del 13 gennaio 2023.
Per risolvere questo problema, contattare il supporto della licenza Cisco e chiedere un nuovo file VLAN.
Se in alcuni registri viene segnalato che una o alcune funzionalità sono state spostate in Non conforme, verificare quanto segue:
1. Si dispone di una licenza valida.
2. L'accessorio è connesso al server Smart License (vedere la sezione Requisiti di comunicazione in questo articolo).
3. Controllare i log delle licenze intelligenti per avere ulteriori informazioni sul problema.
4. Contattare il supporto Cisco per assistenza.
Di seguito è riportato un esempio di log:
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 viene visualizzato l'errore critico "Smart Agent è in stato Autorizzazione scaduta", esaminare le righe successive per individuare i motivi di questo stato.
Ecco un esempio dell'errore:
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.
Verificare la connettività e accertarsi che il dispositivo sia registrato nel portale delle licenze Smart.
| Revisione | Data di pubblicazione | Commenti |
|---|---|---|
2.0 |
26-Oct-2026
|
Controllo ortografico, grammaticale, spaziatura e righe orizzontali inserite aggiornate per separare le sezioni in modo da garantire leggibilità, testo alternativo, URL e avvisi CCW fissi. |
1.0 |
08-Sep-2023
|
Versione iniziale |