Support Authentication PIM Role Management Policies

[thomas11]

About

This PR adds support for Role Management Policies, part of Privileged Identity Management (PIM) in the Microsoft.Authentication namespace. It's one part of #2455.

Note that this is about the ARM part of PIM; there's also a Microsoft Graph API part which is not covered by this provider.

This resource wasn't automatically included because it supports only GET and PATCH. The policies are singletons that cannot be created or deleted, only modified via PATCH.

Implementation

Role Management Policies essentially consist of a name which is actually a GUID, and a list of ~20 rules.

Using our existing singleton support defaults.GetDefaultResourceState was tricky because

1. there are many policies with many rules, for a total of ~300k lines of JSON for a subscription scope, and there are more scopes, plus
2. I believe the defaults can vary per scope and possibly also per customer.

So instead, I've implemented a custom resource that captures the original state of a policy when it's first "created", i.e., added to Pulumi state. When a rule or the whole policy is removed from Pulumi, we look up the original state and re-apply it.

Testing

The e2e/integration test for this resource is special because using PIM requires a paid Entra ID P2 license. We don't have one yet so the test fails (example). This PR looks green because the test is marked as long-running and doesn't run in PR workflows. Hence the draft status while I organize the license.

[github-actions]

Does the PR have any schema changes?

Looking good! No breaking changes found.

New resources:

• authorization.RoleManagementPolicy

New functions:

• authorization.getRoleManagementPolicy

[codecov]

Codecov Report

Attention: Patch coverage is 36.84211% with 96 lines in your changes are missing coverage. Please review.

Project coverage is 56.45%. Comparing base (d00db35) to head (b13c565).

Files	Patch %	Lines
...ovider/pkg/resources/customresources/custom_pim.go	40.42%	49 Missing and 7 partials ⚠️
provider/pkg/provider/provider.go	32.25%	16 Missing and 5 partials ⚠️
provider/pkg/provider/crud/crud.go	0.00%	8 Missing ⚠️
provider/pkg/openapi/discover.go	0.00%	4 Missing and 1 partial ⚠️
...r/pkg/resources/customresources/custom_keyvault.go	0.00%	0 Missing and 2 partials ⚠️
...r/pkg/resources/customresources/customresources.go	71.42%	1 Missing and 1 partial ⚠️
...es/customresources/custom_keyvault_accesspolicy.go	0.00%	1 Missing ⚠️
...er/pkg/resources/customresources/custom_storage.go	50.00%	1 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##           master    #3130      +/-   ##
==========================================
- Coverage   56.74%   56.45%   -0.30%     
==========================================
  Files          66       67       +1     
  Lines        8053     8175     +122     
==========================================
+ Hits         4570     4615      +45     
- Misses       3049     3113      +64     
- Partials      434      447      +13     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[t0yv0]

Is not existing the only kind of err?

[t0yv0]

Glanced over it but the review effort here is formidable, LMK if you need me as a reviewer, I'm happy to try again. Since there's a lot going on it can be helpful to rebase into step-by-step commits.