Skip to content

Conversation

@ronaldbosma
Copy link

@ronaldbosma ronaldbosma commented Nov 7, 2025

Update send-request and send-one-way-request policy documentation with option to use authentication-managed-identity policy for authentication in API Management.

A sample is already included here on the authentication-managed-identity policy page, and I've verified that it works for both policies.

The `authentication-managed-identity` policy can be used with the `send-request` policy.
A sample is already included [here](https://learn.microsoft.com/en-us/azure/api-management/authentication-managed-identity-policy#use-managed-identity-in-send-request-policy) on the `authentication-managed-identity` policy page
@prmerger-automator
Copy link
Contributor

@ronaldbosma : Thanks for your contribution! The author(s) and reviewer(s) have been notified to review your proposed change.

@learn-build-service-prod
Copy link
Contributor

Learn Build status updates of commit 4c7f11d:

⚠️ Validation status: warnings

File Status Preview URL Details
articles/api-management/send-request-policy.md ⚠️Warning Details

articles/api-management/send-request-policy.md

  • Line 55, Column 37: [Warning: hard-coded-locale - See documentation] Link 'https://learn.microsoft.com/en-us/azure/api-management/authentication-managed-identity-policy' contains locale code 'en-us'. For localizability, remove 'en-us' from links to most Microsoft sites.
  • Line 55, Column 37: [Suggestion: docs-link-absolute - See documentation] Absolute link 'https://learn.microsoft.com/en-us/azure/api-management/authentication-managed-identity-policy' will be broken in isolated environments. Replace with a relative link.

For more details, please refer to the build report.

Note: Your PR may contain errors or warnings or suggestions unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.

@ronaldbosma ronaldbosma changed the title Add managed identity authentication option to API Management send-request policy Add managed identity authentication option to API Management send-request and send-one-way-request policies Nov 7, 2025
@learn-build-service-prod
Copy link
Contributor

Learn Build status updates of commit f18ca1c:

⚠️ Validation status: warnings

File Status Preview URL Details
articles/api-management/send-one-way-request-policy.md ⚠️Warning Details
articles/api-management/send-request-policy.md ⚠️Warning Details

articles/api-management/send-one-way-request-policy.md

  • Line 52, Column 37: [Warning: hard-coded-locale - See documentation] Link 'https://learn.microsoft.com/en-us/azure/api-management/authentication-managed-identity-policy' contains locale code 'en-us'. For localizability, remove 'en-us' from links to most Microsoft sites.
  • Line 52, Column 37: [Suggestion: docs-link-absolute - See documentation] Absolute link 'https://learn.microsoft.com/en-us/azure/api-management/authentication-managed-identity-policy' will be broken in isolated environments. Replace with a relative link.

articles/api-management/send-request-policy.md

  • Line 55, Column 37: [Warning: hard-coded-locale - See documentation] Link 'https://learn.microsoft.com/en-us/azure/api-management/authentication-managed-identity-policy' contains locale code 'en-us'. For localizability, remove 'en-us' from links to most Microsoft sites.
  • Line 55, Column 37: [Suggestion: docs-link-absolute - See documentation] Absolute link 'https://learn.microsoft.com/en-us/azure/api-management/authentication-managed-identity-policy' will be broken in isolated environments. Replace with a relative link.

For more details, please refer to the build report.

Note: Your PR may contain errors or warnings or suggestions unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.

@learn-build-service-prod
Copy link
Contributor

Learn Build status updates of commit 978dccf:

✅ Validation status: passed

File Status Preview URL Details
articles/api-management/send-one-way-request-policy.md ✅Succeeded
articles/api-management/send-request-policy.md ✅Succeeded

For more details, please refer to the build report.

@v-dirichards v-dirichards requested a review from Copilot November 7, 2025 16:17
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull Request Overview

This PR adds documentation for using managed identity authentication within the send-request and send-one-way-request policies in Azure API Management. The changes enable users to authenticate backend requests using Azure managed identities as an alternative to certificate-based authentication.

Key changes:

  • Added authentication-managed-identity element to both policy syntax examples
  • Updated policy element tables to document the new authentication option

Reviewed Changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 2 comments.

File Description
articles/api-management/send-request-policy.md Added managed identity authentication option to send-request policy documentation
articles/api-management/send-one-way-request-policy.md Added managed identity authentication option to send-one-way-request policy documentation

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@v-dirichards
Copy link
Contributor

@dlepow

Can you review the proposed changes?

Important: When the changes are ready for publication, adding a #sign-off comment is the best way to signal that the PR is ready for the review team to merge.

#label:"aq-pr-triaged"
@MicrosoftDocs/public-repo-pr-review-team

@prmerger-automator prmerger-automator bot added the aq-pr-triaged tracking label for the PR review team label Nov 7, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants