AWS elasticloadbalancing: Document HTTP/2 RST_STREAM error forwarding target group attribute
Summary
Adds documentation for a new target group attribute (routing.http2.rst_stream_error_forwarding.enabled) that forwards HTTP/2/gRPC RST_STREAM error codes to clients instead of returning 502, with console, CLI, and CloudFormation instructions.
Security assessment
This documents a functional routing/error-handling feature for HTTP/2 and gRPC target groups. It changes error propagation behavior but does not address a vulnerability, credential, encryption, or authorization concern.
Evidence
When you enable RST_STREAM error forwarding, the load balancer instead forwards the target's `RST_STREAM` error code to the downstream client for the following error codes: `REFUSED_STREAM`, `CANCEL`, `ENHANCE_YOUR_CALM`, and `INTERNAL_ERROR`.
Diff
diff --git a/elasticloadbalancing/latest/application/edit-target-group-attributes.md b/elasticloadbalancing/latest/application/edit-target-group-attributes.md index 3a9034b..d714a8d 100644 --- a//elasticloadbalancing/latest/application/edit-target-group-attributes.md +++ b//elasticloadbalancing/latest/application/edit-target-group-attributes.md @@ -7 +7 @@ -Deregistration delayRouting algorithmSlow start modeHealth settingsCross-zone load balancingAutomatic Target Weights (ATW)Sticky sessionsWAF HTTP/2 traffic inspection behavior +Deregistration delayRouting algorithmSlow start modeHealth settingsCross-zone load balancingAutomatic Target Weights (ATW)Sticky sessionsWAF HTTP/2 traffic inspection behaviorHTTP/2 RST_STREAM error forwarding @@ -30,0 +31,2 @@ After you create a target group for you Application Load Balancer, you can edit + * HTTP/2 RST_STREAM error forwarding + @@ -963,0 +966,60 @@ Update the [AWS::ElasticLoadBalancingV2::TargetGroup](https://docs.aws.amazon.co +## HTTP/2 RST_STREAM error forwarding + +By default, when an HTTP/2 or gRPC target ends a stream by sending an `RST_STREAM` frame with an error, the load balancer returns an HTTP 502 (Bad Gateway) response to the client. This hides the specific error that the target reported. + +When you enable RST_STREAM error forwarding, the load balancer instead forwards the target's `RST_STREAM` error code to the downstream client for the following error codes: `REFUSED_STREAM`, `CANCEL`, `ENHANCE_YOUR_CALM`, and `INTERNAL_ERROR`. This lets gRPC and HTTP/2 clients observe and react to the exact error that the target returned. This attribute applies only to target groups that use the `HTTP2` or `GRPC` protocol version, and it is disabled by default. + +Console + + +###### To configure HTTP/2 RST_STREAM error forwarding + + 1. Open the Amazon EC2 console at [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/). + + 2. On the navigation pane, under **Load Balancing** , choose **Target Groups**. + + 3. Choose the name of the target group to open its details page. + + 4. On the **Attributes** tab, choose **Edit**. + + 5. For **HTTP/2 RST_STREAM error forwarding** , turn the setting on or off. + + 6. Choose **Save changes**. + + + + +AWS CLI + + +###### To configure HTTP/2 RST_STREAM error forwarding + +Use the [modify-target-group-attributes](https://docs.aws.amazon.com/cli/latest/reference/elbv2/modify-target-group-attributes.html) command with the `routing.http2.rst_stream_error_forwarding.enabled` attribute. + + + aws elbv2 modify-target-group-attributes \ + --target-group-arn target-group-arn \ + --attributes "Key=routing.http2.rst_stream_error_forwarding.enabled,Value=true" + +CloudFormation + + +###### To configure HTTP/2 RST_STREAM error forwarding + +Update the [AWS::ElasticLoadBalancingV2::TargetGroup](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-elasticloadbalancingv2-targetgroup.html) resource to include the `routing.http2.rst_stream_error_forwarding.enabled` attribute. + + + Resources: + myTargetGroup: + Type: 'AWS::ElasticLoadBalancingV2::TargetGroup' + Properties: + Name: my-target-group + Protocol: HTTP + ProtocolVersion: HTTP2 + Port: 80 + TargetType: ip + VpcId: !Ref myVPC + TargetGroupAttributes: + - Key: "routing.http2.rst_stream_error_forwarding.enabled" + Value: "true" +