Add troubleshooting documentation for Office 365 Management API Subscription flow authentication errors

[Copilot]

Users encounter Action 'Get_Azure_Secret' failed. Error occurred while reading secret: Value cannot be null. Parameter name: input when the Office 365 Management API Subscription flow runs without properly configured environment variables for authentication.

Changes

• Created troubleshooting documentation hierarchy (docs/troubleshooting/)

  • Quick-fix checklist for 5-minute resolution
  • Comprehensive guide covering Azure AD app registration, environment variable configuration, and cloud-specific endpoints
  • Issue-specific analysis with immediate action steps
  • Maintainer response templates for consistent support

• Documented dual authentication architecture

  • Azure Key Vault secret path (admin_auditlogsclientazuresecret)
  • Text-based fallback path (admin_auditlogsclientsecret)
  • Flow's built-in error handling and fallback mechanism

• Covered configuration for multiple cloud environments

  • Commercial, GCC, and GCC High endpoint configurations
  • Prerequisites (Unified Audit Log, licenses, permissions)
  • Common error scenarios and resolutions

Context

The flow uses RetrieveEnvironmentVariableSecretValue action which fails when the environment variable name parameter is null. This occurs when users deploy the solution without configuring the required authentication environment variables. The documentation enables self-service resolution instead of requiring maintainer intervention for this configuration issue.

Flow architecture supports primary Azure Key Vault authentication with automatic fallback to text-based secrets when Key Vault retrieval fails, but this mechanism only engages if the variable exists.

Files

docs/troubleshooting/
├── README.md                                                    (40 lines)
├── QUICK-FIX-audit-logs-get-azure-secret-error.md              (56 lines)
├── audit-logs-office365-management-api-subscription-flow-errors.md (246 lines)
├── ISSUE-ANALYSIS-office365-management-api-subscription.md     (188 lines)
├── ISSUE-RESPONSE-TEMPLATE-audit-logs-get-azure-secret.md      (90 lines)
└── GITHUB-ISSUE-COMMENT-template.md                            (114 lines)

Total: 734 lines across 6 files

Original prompt

---

This section details on the original issue you should resolve

<issue_title>[CoE Starter Kit - BUG] Admin | Audit Logs | Office 365 Management API Subscription Flow Fails</issue_title>
<issue_description>### Does this bug already exist in our backlog?

• I have checked and confirm this is a new bug.

Describe the issue

The Admin | Audit Logs | Office 365 Management API Subscription Flow Fails on Action 'Get_Azure_Secret' failed. Error occured while reading secret: Value cannot be null. Parameter name: input

Expected Behavior

Flow should complete successfully.

What solution are you experiencing the issue with?

Core

What solution version are you using?

4.50.6

What app or flow are you having the issue with?

Admin | Audit Logs | Office 365 Management API Subscription

What method are you using to get inventory and telemetry?

Cloud flows

Steps To Reproduce

1. In the CoE - Governance environment
2. Turned on the Admin | Audit Logs | Office 365 Management API Subscription flow and it shows failed.

Anything else?

No response</issue_description>

<agent_instructions>Analyze the issue and provide the trouble shooting steps to resolve the issue</agent_instructions>

Comments on the Issue (you are @copilot in this section)

Custom agent used: CoE Custom Agent
Specialized agent for triaging and fixing issues in the CoE Starter Kit. Always consult the official CoE docs and the team’s SharePoint notes first, then mine prior GitHub issues and the CoE Common Responses playbook.

• Fixes [CoE Starter Kit - BUG] Admin | Audit Logs | Office 365 Management API Subscription Flow Fails #10644

---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.