

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
<a name="connection-log-entries"></a>

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-packets`il 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](connection-authorization.md) per [autorizzazione di connessione personalizzata](connection-authorization.md#connection-authorization-posture-assessment), 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](cvpn-working-with-connection-logs.md).

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](#connection-log-options).

## Motivi di errore relativi allo stato del token del dispositivo
<a name="device-token-status-failure-reasons"></a>

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
<a name="connection-log-options"></a>

È 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
<a name="connection-log-examples-device-posture"></a>

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"
}
```