ADC

gRPC with rewrite policy

May 2, 2023

Contributed by:

The gRPC with rewrite policy use case explains how NetScaler appliance works in rewriting some information in the gRPC requests or responses. The following diagram shows the components interact.

The following diagram shows how components interact with each other in a gRPC with rewrite policy configuration.

Enable rewrite feature on the appliance.
Configure rewrite action to modify, add, or delete gRPC headers.
Configure rewrite policy for determining the gRPC requests (traffic) on which an action has to be taken.
Bind the rewrite policy to the load balancing virtual server to examine if the traffic matches the policy expression.
By using a rewrite policy, you can perform the following based on gRPC status code.
1. Modify responses from gRPC web server.
2. Modify, add, or delete gRPC headers.
3. Modify the URL of the request to the gRRC server.

Configure gRPC call termination with rewrite policy

To configure gRPC call termination with rewrite policy, you must complete the following steps:

Enable rewrite feature
Add rewrite policy
Bind rewrite policy to load balancing virtual server

Enable rewrite feature

To use the rewrite feature, you must first enable it.

At the command prompt, type:

enable ns rewrite

Add rewrite policy

After you configure a rewrite action, you must next configure a rewrite policy to select the gRPC requests to which the NetScaler appliance must rewrite.

At the command prompt, type:

add rewrite policy <name> <expression> <action> [<undefaction>]-appFlowaction <actionName>

Example:

add rewrite policy grpc-rewr_pol1 "http.res.header(\"grpc-status\").NE(\"0\")" RESET

Bind rewrite policy to load balancing virtual server

To put a policy into effect, you must bind it to the load balancing virtual server with the gRPC service.

At the command prompt, type:

bind rewrite global <policyName> <priority> [<gotoPriorityExpression> [-type <type>] [-invoke (<labelType> <labelName>)]

Example:

bind lb vserver lb-grpc –policyName grpc-rewr_pol1 –priority 100

The official version of this content is in English. Some of the Cloud Software Group documentation content is machine translated for your convenience only. Cloud Software Group has no control over machine-translated content, which may contain errors, inaccuracies or unsuitable language. No warranty of any kind, either expressed or implied, is made as to the accuracy, reliability, suitability, or correctness of any translations made from the English original into any other language, or that your Cloud Software Group product or service conforms to any machine translated content, and any warranty provided under the applicable end user license agreement or terms of service, or any other agreement with Cloud Software Group, that the product or service conforms with any documentation shall not apply to the extent that such documentation has been machine translated. Cloud Software Group will not be held responsible for any damage or issues that may arise from using machine-translated content.

Was this helpful

gRPC with rewrite policy

May 2, 2023

Contributed by:

May 2, 2023

Contributed by:

gRPC with rewrite policy

Configure gRPC call termination with rewrite policy

Enable rewrite feature

Add rewrite policy

Bind rewrite policy to load balancing virtual server

In this article