AWS vpn: Add device posture options to Client VPN endpoint creation
Summary
Documents new optional Device posture configuration when creating a Client VPN endpoint, including enabling device posture, selecting trust providers, and using the DevicePostureOptions API parameter.
Security assessment
The change documents a security feature that authorizes VPN connections based on device health and trust providers, which is security-relevant hardening/authorization guidance, but it does not reference a specific vulnerability, CVE, or incident.
Evidence
+ 10. (Optional) For **Device posture** , turn on **Enable device posture** to authorize connections based on the health of the connecting device. Configure one or more device trust providers and the authorization policy to evaluate. For more information, see [Device posture for AWS Client VPN](./device-posture.html).
Diff
diff --git a/vpn/latest/clientvpn-admin/cvpn-working-endpoint-create.md b/vpn/latest/clientvpn-admin/cvpn-working-endpoint-create.md index 35d4bcb..716ec4a 100644 --- a//vpn/latest/clientvpn-admin/cvpn-working-endpoint-create.md +++ b//vpn/latest/clientvpn-admin/cvpn-working-endpoint-create.md @@ -6,0 +7,2 @@ +Device posture options + @@ -122 +124,3 @@ If the server and client certificates have been issued by the same Certificate A - 10. (Optional) Specify which DNS servers to use for DNS resolution. To use custom DNS servers, for **DNS Server 1 IP address** and **DNS Server 2 IP address** , specify the IPv4 addresses of the DNS servers to use. For IPv6 or dual-stack endpoints, you can also specify **DNS Server IPv6 1** and **DNS Server IPv6 2** addresses. To use VPC DNS server, for either **DNS Server 1 IP address** or **DNS Server 2 IP address** , specify the IP addresses, and add the VPC DNS server IP address. + 10. (Optional) For **Device posture** , turn on **Enable device posture** to authorize connections based on the health of the connecting device. Configure one or more device trust providers and the authorization policy to evaluate. For more information, see [Device posture for AWS Client VPN](./device-posture.html). + + 11. (Optional) Specify which DNS servers to use for DNS resolution. To use custom DNS servers, for **DNS Server 1 IP address** and **DNS Server 2 IP address** , specify the IPv4 addresses of the DNS servers to use. For IPv6 or dual-stack endpoints, you can also specify **DNS Server IPv6 1** and **DNS Server IPv6 2** addresses. To use VPC DNS server, for either **DNS Server 1 IP address** or **DNS Server 2 IP address** , specify the IP addresses, and add the VPC DNS server IP address. @@ -128 +132 @@ Verify that the DNS servers can be reached by clients. - 11. (Optional) By default, the Client VPN endpoint uses the `UDP` transport protocol. To use the `TCP` transport protocol instead, for **Transport Protocol** , select **TCP**. + 12. (Optional) By default, the Client VPN endpoint uses the `UDP` transport protocol. To use the `TCP` transport protocol instead, for **Transport Protocol** , select **TCP**. @@ -134 +138 @@ UDP typically offers better performance than TCP. You cannot change the transpor - 12. (Optional) To have the endpoint be a split-tunnel Client VPN endpoint, turn on **Enable split-tunnel**. By default, split-tunnel on a Client VPN endpoint is disabled. + 13. (Optional) To have the endpoint be a split-tunnel Client VPN endpoint, turn on **Enable split-tunnel**. By default, split-tunnel on a Client VPN endpoint is disabled. @@ -136 +140 @@ UDP typically offers better performance than TCP. You cannot change the transpor - 13. (Optional) For **VPC ID** , choose the VPC to associate with the Client VPN endpoint. For **Security Group IDs** , choose one or more of the VPC's security groups to apply to the Client VPN endpoint. + 14. (Optional) For **VPC ID** , choose the VPC to associate with the Client VPN endpoint. For **Security Group IDs** , choose one or more of the VPC's security groups to apply to the Client VPN endpoint. @@ -138 +142 @@ UDP typically offers better performance than TCP. You cannot change the transpor - 14. (Optional) For **VPN port** , choose the VPN port number. The default is 443. + 15. (Optional) For **VPN port** , choose the VPN port number. The default is 443. @@ -140 +144 @@ UDP typically offers better performance than TCP. You cannot change the transpor - 15. (Optional) To generate a [self-service portal URL](./cvpn-self-service-portal.html) for clients, turn on **Enable self-service portal**. + 16. (Optional) To generate a [self-service portal URL](./cvpn-self-service-portal.html) for clients, turn on **Enable self-service portal**. @@ -142 +146 @@ UDP typically offers better performance than TCP. You cannot change the transpor - 16. (Optional) For **Session timeout hours** , choose the desired maximum VPN session duration time in hours from the available options, or leave set to default of 24 hours. + 17. (Optional) For **Session timeout hours** , choose the desired maximum VPN session duration time in hours from the available options, or leave set to default of 24 hours. @@ -144 +148 @@ UDP typically offers better performance than TCP. You cannot change the transpor - 17. (Optional) For **Disconnect on session timeout** , choose if you want to terminate the session when the maximum session time is reached. Choosing this option requires that users reconnect manually to the endpoint when the session times out; otherwise, Client VPN will automatically try to reconnect. + 18. (Optional) For **Disconnect on session timeout** , choose if you want to terminate the session when the maximum session time is reached. Choosing this option requires that users reconnect manually to the endpoint when the session times out; otherwise, Client VPN will automatically try to reconnect. @@ -146 +150 @@ UDP typically offers better performance than TCP. You cannot change the transpor - 18. (Optional) Specify whether to enable client login banner text. Turn on **Enable client login banner**. For **Client login banner text** , enter the text that will be displayed in a banner on AWS provided clients when a VPN session is established. UTF-8 encoded characters only. Maximum of 1400 characters. + 19. (Optional) Specify whether to enable client login banner text. Turn on **Enable client login banner**. For **Client login banner text** , enter the text that will be displayed in a banner on AWS provided clients when a VPN session is established. UTF-8 encoded characters only. Maximum of 1400 characters. @@ -148 +152 @@ UDP typically offers better performance than TCP. You cannot change the transpor - 19. Choose **Create Client VPN endpoint**. + 20. Choose **Create Client VPN endpoint**. @@ -199,0 +204,19 @@ Example for creating a dual-stack endpoint: +## Device posture options + +To require device health checks on an endpoint, specify the `DevicePostureOptions` parameter when you create or modify the endpoint. This parameter contains the following fields: + + * `Enabled` — Whether device posture is enabled for the endpoint. + + * `TrustProviders` — One or more device trust providers to evaluate. Each trust provider contains the following fields: + + * `TrustProviderType` — The type of device trust provider (for example, CrowdStrike, Jamf, or JumpCloud). + + * `TenantId` — The tenant identifier for the device trust provider. + + * `PublicSigningKeyUrl` — The URL of the public signing key used to verify device posture tokens. + + + + +For more information, see [Device posture for AWS Client VPN](./device-posture.html). +