Skip to content

Add Service Principal support documentation for CoE Starter Kit#10709

Merged
mohamrizwa merged 2 commits intomainfrom
copilot/coec-toolkit-service-principle
Jan 20, 2026
Merged

Add Service Principal support documentation for CoE Starter Kit#10709
mohamrizwa merged 2 commits intomainfrom
copilot/coec-toolkit-service-principle

Conversation

Copy link
Copy Markdown
Contributor

Copilot AI commented Jan 14, 2026

Users frequently ask whether the CoE Starter Kit can be installed and managed using Service Principals instead of Service Accounts. The answer varies by component, but this wasn't documented.

Changes

  • New documentation: docs/ServicePrincipalSupport.md

    • Component-by-component Service Principal support matrix
    • Service Principal vs Service Account comparison
    • Migration procedures for ALM Accelerator (supported) and Core Components (not supported)
    • Security best practices and FAQ
  • Documentation index: docs/README.md

  • Main README update: Links to Service Principal documentation

Key Technical Details

Platform Limitation: Cloud flows require user context and cannot be owned by Service Principals. This affects Core, Governance, Nurture, and Audit components.

ALM Accelerator: Fully supports Service Principal via Azure AD application registration with System Administrator privileges:

# Grant required Power App Management permissions
New-PowerAppManagementApp -ApplicationId <app-id>

Recommendation:

  • Core Components → Continue using Service Account (required)
  • ALM Accelerator → Migrate to Service Principal (recommended)
Original prompt

This section details on the original issue you should resolve

<issue_title>[CoE Starter Kit - QUESTION] Can the COE Toolkit be Managed by Service Principle?</issue_title>
<issue_description>### Does this question already exist in our backlog?

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

What is your question?

Hi team, with regards to the COE Toolkit, I want to ask the below:

  • Can COE Toolkit be installed using Service Principle?
  • Can the COE Toolkit be managed or updated using Service Principle?

Currently we have the COE Toolkit installed and managed using Service Account and we want to migrate toe Service Principle. What is the best approach?

What solution are you experiencing the issue with?

None

What solution version are you using?

No response

What app or flow are you having the issue with?

No response

What method are you using to get inventory and telemetry?

None</issue_description>

<agent_instructions>Please explain the approach for this</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.


✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

Co-authored-by: mohamrizwa <220306360+mohamrizwa@users.noreply.github.com>
Copilot AI changed the title [WIP] Add question about COE Toolkit management with Service Principle Add Service Principal support documentation for CoE Starter Kit Jan 14, 2026
Copilot AI requested a review from mohamrizwa January 14, 2026 09:38
Copy link
Copy Markdown
Collaborator

@muditagarwal2308 muditagarwal2308 left a comment

Choose a reason for hiding this comment

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

Approved

@mohamrizwa mohamrizwa removed their request for review January 20, 2026 10:20
@mohamrizwa mohamrizwa marked this pull request as ready for review January 20, 2026 10:21
@mohamrizwa mohamrizwa merged commit b5059db into main Jan 20, 2026
6 checks passed
@mohamrizwa mohamrizwa deleted the copilot/coec-toolkit-service-principle branch January 20, 2026 10:22
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[CoE Starter Kit - QUESTION] Can the COE Toolkit be Managed by Service Principle?

3 participants