⚠ This page is served via a proxy. Original site: https://github.com
This service does not collect credentials or authentication data.
Skip to content

Conversation

@rnandwal-f5
Copy link
Contributor

@rnandwal-f5 rnandwal-f5 commented Jan 16, 2026

Summary

Updates documentation to reflect that system-assigned managed identity (systemMI) is now required for Geneva logging and monitoring in NGINXaaS for Azure.

Changes

Deployment Guides

  • Portal: Added note that systemMI is automatically created
  • CLI: Added --identity type="SystemAssigned" requirement to all examples
  • Terraform: Added systemMI requirement callout
  • ARM/Bicep/SDK: Added systemMI requirement notes

Key Points

  • Portal: SystemMI created automatically
  • CLI/Terraform/ARM/SDK: Must set identity.type="SystemAssigned"
  • SystemMI cannot be removed once created
  • Backward Compatibility: Legacy deployments without systemMI continue to work without requiring changes

Note: Existing deployments are not affected by this change.

Checklist

Before sharing this pull request, I completed the following checklist:

Footnotes

  1. Potentially sensitive information includes personally identify information (PII), authentication credentials, and live URLs. Refer to the style guide for guidance about placeholder content.

…deployment documentation

System-assigned MI now required for new deployments

Updates all deployment documentation to reflect systemMI requirement:
- Portal: Automatically creates systemMI
- CLI/Terraform/ARM/SDK: Must set identity.type="SystemAssigned"
- SystemMI cannot be removed once created
- Legacy deployments continue to work

Updated deployment guides, client tools docs, managed identity docs,
monitoring prerequisites, and SSL/TLS prerequisites with requirement
notes and backward compatibility information.
@rnandwal-f5 rnandwal-f5 requested a review from arpith-f5 January 16, 2026 10:20
@rnandwal-f5 rnandwal-f5 requested review from a team as code owners January 16, 2026 10:20
@github-actions github-actions bot added documentation Improvements or additions to documentation product/nginxaas-azure Issues related to NGINX as a Service for Azure labels Jan 16, 2026
- A user or system assigned identity associated with your NGINXaaS deployment. Ensure that your Managed Identity (MI) has read access to secrets stored in AKV:
- A user or system assigned identity associated with your NGINXaaS deployment.

{{< call-out "note" >}}**System-Assigned Managed Identity**: All NGINXaaS deployments automatically include a system-assigned managed identity. When creating deployments via Azure CLI, Terraform, ARM templates, or SDK, ensure you explicitly configure the system-assigned identity as shown in the respective deployment guides.{{< /call-out >}}
Copy link
Contributor

Choose a reason for hiding this comment

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

All NGINXaaS deployments automatically include a system-assigned managed identity.
Is this accurate? I thought only those deployments created through the portal include a system MI.

Copy link
Contributor

@amudukutore amudukutore left a comment

Choose a reason for hiding this comment

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

Looking through the changes here, the call out to add a system assigned MI is repeated across multiple sections which seems a bit excessive. Can we only add it in the section on enabling logs and metrics?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation product/nginxaas-azure Issues related to NGINX as a Service for Azure

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants