Skip to content

Commit bbac81f

Browse files
committed
docs(security): correct Entra setup and metrics
1 parent 8350767 commit bbac81f

2 files changed

Lines changed: 12 additions & 8 deletions

File tree

docs/site/src/content/docs/host/authenticated-silo-connections.md

Lines changed: 8 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -115,14 +115,16 @@ Create the identity boundary in this order:
115115
`api://<resource-application-id>/contoso-prod-westus`.
116116
3. Define application roles `Orleans.Silo.Connect` and
117117
`Orleans.Client.Connect`, with applications as allowed member types.
118-
4. Create or select one workload identity for each independently deployable
118+
4. Configure `idtyp` as an optional access-token claim so that application
119+
tokens include `idtyp: "app"`.
120+
5. Create or select one workload identity for each independently deployable
119121
silo and client workload. Don't share a client secret or exported
120122
certificate across the fleet.
121-
5. Assign only the matching application role. A client identity doesn't need
123+
6. Assign only the matching application role. A client identity doesn't need
122124
the silo role.
123-
6. Put each application ID in the matching caller allowlist. Role assignment
125+
7. Put each application ID in the matching caller allowlist. Role assignment
124126
and allowlisting are separate checks; require both.
125-
7. Configure a managed identity, workload identity federation, or another
127+
8. Configure a managed identity, workload identity federation, or another
126128
non-interactive credential. Grant no Microsoft Graph permission merely to
127129
establish an Orleans connection.
128130

@@ -336,9 +338,9 @@ Alert on rates and latency for these instruments:
336338

337339
| Instrument | Operational use |
338340
|---|---|
339-
| `orleans.connections.authentication.attempts` | Count outcomes by fixed result category. |
341+
| `orleans.connections.authentication.attempts` | Count outcomes by fixed result category; `result=overload` identifies authentication capacity exhaustion after both the concurrency and pending-queue limits are reached. |
340342
| `orleans.connections.authentication.duration` | Detect token-provider, metadata, validation, or network latency. |
341-
| `orleans.connections.authentication.active` | Detect handshake concurrency saturation. |
343+
| `orleans.connections.authentication.active` | Track established authenticated connections by connection type and direction. |
342344
| `orleans.connections.authentication.protocol_fallbacks` | Identify peers which haven't negotiated authentication in `Audit`. |
343345

344346
Keep dimensions bounded to direction, mode, protocol version, and fixed result

samples/AuthenticatedSiloConnections/README.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -20,9 +20,11 @@ default ports, then start another with
2020
deployment environment, for example `contoso-prod-westus`.
2121
3. Define the application roles `Orleans.Silo.Connect` and
2222
`Orleans.Client.Connect`, and allow applications as members.
23-
4. Assign only the matching role to each authorized silo or client workload
23+
4. Configure `idtyp` as an optional access-token claim so that application
24+
tokens include `idtyp: "app"`.
25+
5. Assign only the matching role to each authorized silo or client workload
2426
identity.
25-
5. Configure a federated identity credential for each workload and place its
27+
6. Configure a federated identity credential for each workload and place its
2628
application ID in the matching silo or external-client allowlist.
2729

2830
The exact audience, tenant, application-token classification, caller

0 commit comments

Comments
 (0)