View a markdown version of this page

Registrazione della connessione per un AWS Client VPN endpoint - AWS Client VPN

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Registrazione della connessione per un AWS Client VPN endpoint

La registrazione delle connessioni è una funzionalità di AWS Client VPN che consente di catturare registri di connessione per il tuo endpoint Client VPN.

Un registro delle connessioni contiene voci del registro di connessione che raccolgono informazioni sugli eventi di connessione, ad esempio quando un client (utente finale) si connette, tenta di connettersi o si disconnette dall'endpoint Client VPN. Puoi utilizzare queste informazioni per eseguire analisi forensi, analizzare come l'endpoint Client VPN viene utilizzato o eseguire il debug dei problemi di connessione.

La registrazione delle connessioni è disponibile in tutte le regioni in cui AWS Client VPN è disponibile. I log delle connessioni vengono pubblicati in un CloudWatch Registra il gruppo di log nel tuo account.

Nota

I tentativi di autenticazione reciproca falliti non vengono registrati.

Voci di log del registro di connessione

Una voce del registro delle connessioni è una JSON-formatted blob di coppie chiave-valore. Di seguito è riportato un esempio di voce di log del registro delle connessioni.

{ "connection-log-type": "connection-attempt", "connection-attempt-status": "successful", "connection-reset-status": "NA", "connection-attempt-failure-reason": "NA", "connection-id": "cvpn-connection-abc123abc123abc12", "client-vpn-endpoint-id": "cvpn-endpoint-aaa111bbb222ccc33", "transport-protocol": "udp", "connection-start-time": "2020-03-26 20:37:15", "connection-last-update-time": "2020-03-26 20:37:15", "client-ip": "10.0.1.2", "common-name": "client1", "device-type": "mac", "aws-client-version": "6.2.1", "device-ip": "98.247.202.82", "port": "50096", "ingress-bytes": "0", "egress-bytes": "0", "ingress-packets": "0", "egress-packets": "0", "connection-end-time": "NA", "username": "joe" }

Una voce di log del registro connessioni contiene le seguenti chiavi:

  • connection-log-type: il tipo di voce di log delle connessioni (connection-attempt o connection-reset).

  • connection-attempt-status: lo stato della richiesta di connessione (successful, failed, waiting-for-assertion o NA).

  • connection-reset-status: lo stato di un evento di reimpostazione della connessione (NA o assertion-received).

  • connection-attempt-failure-reason: il motivo dell'errore di connessione, se applicabile. Quando la politica di autorizzazione nega una connessione, il valore è authorization-policy-deny.

  • connection-id: l'ID della connessione.

  • client-vpn-endpoint-id: l'ID dell'endpoint Client VPN a cui è stata effettuata la connessione.

  • transport-protocol: il protocollo di trasporto utilizzato per la connessione.

  • connection-start-time: l' ora di inizio della connessione.

  • connection-last-update-time: l' ora dell'ultimo aggiornamento della connessione. Questo valore viene periodicamente aggiornato nei registri.

  • client-ip: l'indirizzo IP del client, allocato dall'intervallo CIDR IPv4 del client per l'endpoint Client VPN.

  • common-name: il nome comune del certificato utilizzato per l'autenticazione basata su certificati.

  • device-type: il tipo di dispositivo utilizzato per la connessione dall'utente finale.

  • aws-client-version — Il AWS versione client, se applicabile.

  • device-ip: l'indirizzo IP pubblico del dispositivo.

  • port: il numero di porta per la connessione.

  • ingress-bytes: il numero di byte in ingresso (in ingresso) per la connessione. Questo valore viene periodicamente aggiornato nei registri.

  • egress-bytes: il numero di byte in uscita (in uscita) per la connessione. Questo valore viene periodicamente aggiornato nei registri.

  • ingress-packetsil numero di pacchetti in ingresso (inbound) per la connessione. Questo valore viene periodicamente aggiornato nei registri.

  • egress-packets: il numero di pacchetti in uscita (outbound) per la connessione. Questo valore viene periodicamente aggiornato nei registri.

  • connection-end-time: l'ora di fine della connessione. Il valore è NA se la connessione è ancora in corso o se il tentativo di connessione non è riuscito.

  • posture-compliance-statuses — Gli stati di conformità restituiti da gestore di connessione al client per autorizzazione di connessione personalizzata, se applicabile.

  • authorization-policy-evaluation — Il risultato della valutazione della politica di autorizzazione, se una politica di autorizzazione è configurata. Questo valore contiene i seguenti sottocampi:

    • result — La decisione di autorizzazione (permit, deny, o error). Un error Un risultato può verificarsi quando una policy Cedar fa riferimento a un attributo che è assente dal contesto della connessione, tra le altre ragioni. Ad esempio, il client non fornisce un token del dispositivo e la policy fa riferimento al contesto di quel provider. Un errore può verificarsi anche quando la policy fa riferimento a un attributo SAML o AD che non è presente per l'utente. Quando la modalità shadow è disabled, Client VPN nega la connessione.

    • evaluation-type — Il tipo di valutazione (connection-attempt o periodic). UN connection-attempt la valutazione avviene quando il client si connette. A periodic la valutazione avviene durante una rivalutazione di una sessione attiva.

    • shadow-mode — Una stringa che indica l'impostazione della modalità ombra (enabled o disabled). Quando enabled, Client VPN valuta la politica senza applicare la decisione. Quando disabled, Client VPN applica deny e error decisioni.

    • reason — Motivo della decisione di autorizzazione. Questo campo è presente solo per deny e error risultati. L'attuale valore emesso è policy-deny.

    • device-token-status — Un oggetto che contiene lo stato del token del dispositivo per ogni device trust provider. Ogni voce del provider contiene un status sottocampo (validated o failed). Se lo stato è failed, la voce include anche un reason sottocampo che descrive l'errore.

    • context — Il contesto completo di valutazione della politica di autorizzazione. Questo sottocampo è incluso solo quando IncludeAuthorizationPolicyContext è abilitato.

  • username - Il nome utente viene registrato quando viene utilizzata l'autenticazione basata sull'utente (AD o SAML) per l'endpoint.

  • connection-duration-seconds - La durata in secondi di una connessione. Uguale alla differenza tra “ora di avvio della connessione” e “ora di fine della connessione”.

Per ulteriori informazioni sull'abilitazione della registrazione delle connessioni, consulta AWS Client VPN registri di connessione.

Quando abiliti la registrazione delle connessioni per un endpoint nuovo o esistente, puoi impostare IncludeAuthorizationPolicyContext per includere il contesto completo di valutazione della politica di autorizzazione nelle voci del registro delle connessioni. Per ulteriori informazioni, consulta Opzioni di registrazione delle connessioni.

Motivi di errore relativi allo stato del token del dispositivo

Quando il status di un device-token-status la voce del fornitore è failed, la voce include un reason sottocampo. Il reason il sottocampo può avere uno dei seguenti valori.

  • token-not-provided

  • token-expired

  • signature-invalid

  • token-malformed

  • tenant-mismatch

  • key-resolution-failed

  • network-error

  • internal-error

Opzioni di registrazione delle connessioni

È possibile configurare la seguente opzione per controllare il contenuto dei log di connessione:

  • IncludeAuthorizationPolicyContext — Quando true, le voci del registro delle connessioni includono il contesto completo di valutazione della politica di autorizzazione. Il valore predefinito è false.

Esempi di log di connessione della politica di autorizzazione

Quando viene configurata una politica di autorizzazione, le voci del registro delle connessioni registrano la decisione di autorizzazione. L'esempio seguente mostra una connessione riuscita consentita dalla politica di autorizzazione.

{ "connection-log-type": "connection-attempt", "connection-attempt-status": "successful", "connection-attempt-failure-reason": "NA", "connection-id": "cvpn-connection-01f248f0e3084e4f2", "client-vpn-endpoint-id": "cvpn-endpoint-0f2d58d4869ece501", "transport-protocol": "udp", "connection-start-time": "2026-09-24 22:22:25", "connection-last-update-time": "2026-09-24 22:22:25", "client-ip": "172.1.0.162", "client-ip-v6": "NA", "common-name": "client1.domain.tld", "device-type": "linux", "aws-client-version": "6.2.1", "device-ip": "72.21.198.66", "port": "5567", "ingress-bytes": "0", "egress-bytes": "0", "ingress-packets": "0", "egress-packets": "0", "authorization-policy-evaluation": { "result": "permit", "evaluation-type": "connection-attempt", "shadow-mode": "disabled", "device-token-status": { "crowdstrike": { "status": "validated" } } }, "connection-end-time": "NA", "connection-duration-seconds": "0" }

L'esempio seguente mostra una connessione negata dalla politica di autorizzazione.

{ "connection-log-type": "connection-attempt", "connection-attempt-status": "failed", "connection-attempt-failure-reason": "authorization-policy-deny", "connection-id": "cvpn-connection-0a39f1b3b7082abbb", "client-vpn-endpoint-id": "cvpn-endpoint-0f2d58d4869ece501", "transport-protocol": "udp", "connection-start-time": "NA", "connection-last-update-time": "2026-09-25 17:14:11", "client-ip": "NA", "client-ip-v6": "NA", "common-name": "client1.domain.tld", "device-type": "linux", "aws-client-version": "6.2.1", "device-ip": "72.21.198.66", "port": "28081", "ingress-bytes": "0", "egress-bytes": "0", "ingress-packets": "0", "egress-packets": "0", "authorization-policy-evaluation": { "result": "error", "evaluation-type": "connection-attempt", "shadow-mode": "disabled", "reason": "policy-deny", "device-token-status": { "crowdstrike": { "status": "failed", "reason": "token-malformed" } } }, "connection-end-time": "NA", "connection-duration-seconds": "NA" }

L'esempio seguente mostra una sessione che è stata interrotta quando una rivalutazione periodica della politica di autorizzazione non soddisfaceva più i requisiti.

{ "connection-log-type": "connection-reset", "connection-attempt-status": "NA", "connection-attempt-failure-reason": "NA", "connection-id": "cvpn-connection-01f248f0e3084e4f2", "client-vpn-endpoint-id": "cvpn-endpoint-0f2d58d4869ece501", "transport-protocol": "udp", "connection-start-time": "2026-09-24 22:22:25", "connection-last-update-time": "2026-09-24 22:27:43", "client-ip": "172.1.0.162", "client-ip-v6": "NA", "common-name": "client1.domain.tld", "device-type": "linux", "aws-client-version": "6.2.1", "device-ip": "72.21.198.66", "port": "5567", "ingress-bytes": "21017", "egress-bytes": "16438", "ingress-packets": "330", "egress-packets": "325", "authorization-policy-evaluation": { "result": "deny", "evaluation-type": "periodic", "shadow-mode": "disabled", "reason": "policy-deny", "device-token-status": { "crowdstrike": { "status": "validated" } } }, "connection-end-time": "2026-09-24 22:27:43", "connection-reset-status": "NA", "connection-duration-seconds": "318" }