Mask URLs in content

  • Article

APPLIES TO: All API Management tiers

The redirect-content-urls policy rewrites (masks) links in the response body. Use in the outbound section to rewrite response body links to the backend service to make them point to the gateway instead. For example, you might do this to hide URLs of the original backend service when they appear in the response. Use in the inbound section for an opposite effect.

Note

This policy does not change any header values such as Location headers. To change header values, use the set-header policy.

Note

Set a policy's elements and child elements in the order provided in the policy statement. Learn more about how to set or edit API Management policies.

Policy statement

<redirect-content-urls />

Usage

Usage notes

  • This policy can only be used once in a policy section.

Example

<redirect-content-urls />

For example, consider the following image, which shows an API response body that includes the original backend service URLs.

Screenshot showing original outbound response in test console in the portal.

After the redirect-content-urls policy is configured in the outbound section, the response body is rewritten to point to the gateway, in this case, https://apim-hello-world.azure-api.cn.

Screenshot showing replaced URLs in test console in the portal.

Next steps

For more information about working with policies, see: