You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Revise MSI V2 token acquisition process documentation (#5512)
* Revise MSI V2 token acquisition process documentation
Updated token acquisition process for MSI V2 with new diagrams and detailed steps.
* Update msi_with_credential_design.md
Copy file name to clipboardExpand all lines: docs/msi_v2/msi_with_credential_design.md
+25-2Lines changed: 25 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -16,6 +16,8 @@ The primary objective is to enable seamless token acquisition in MSI V2 for VM/V
16
16
17
17
In **MSI V1**, IMDS or any other Managed Identity Resource Provider (MIRP) directly returns an **access token**. However, in **MSI V2**, the process involves few more steps:
18
18
19
+
Conceptual diagram
20
+
19
21
```mermaid
20
22
sequenceDiagram
21
23
participant App as Application
@@ -24,10 +26,31 @@ sequenceDiagram
24
26
participant MAA as Azure MAA
25
27
participant ESTS as Entra STS (mTLS)
26
28
27
-
App ->> MSAL: AcquireTokenForManagedIdentity()
29
+
App ->> MSAL: AcquireToken
30
+
MSAL -> MSAL: Detect that MSIv2 is available, otherwise bail
31
+
MSAL -> MSAL: Create the strongest key possible, e.g. in the TPM
32
+
MSAL ->> MAA: Acquire an attestation token, which proves the key strength
33
+
MSAL ->> IMDS: Certificate Signing Request with (key, attestation token)
34
+
IMDS -->> MSAL: Certificate associated with key
35
+
MSAL ->> ESTS: Open mTLS connection to ESTS with this certificate and acquire token
36
+
ESTS -->> MSAL: token with special claim xms_tb
37
+
MSAL -->> App: token and certificate
38
+
```
39
+
40
+
Technical diagram
41
+
42
+
```mermaid
43
+
sequenceDiagram
44
+
participant App as Application
45
+
participant MSAL
46
+
participant IMDS
47
+
participant MAA as Azure MAA
48
+
participant ESTS as Entra STS (mTLS)
49
+
50
+
App ->> MSAL: AcquireToken
28
51
MSAL ->> IMDS: GET /metadata/identity/getPlatformMetadata
0 commit comments