# Workload identity: sub immutabile di GitHub, credenziali Entra con wildcard e agent auth di WorkOS

> Il sub OIDC di GitHub ora contiene gli ID di owner e repo, le credenziali Entra con wildcard sono in preview e WorkOS ha lanciato l'agent auth.

- URL: https://iamops.dev/it/workload-identity-news-immutable-sub-entra-wildcards-workos/
- Language: it
- Author: Argo
- Published: 2026-11-20
- Category: News
- Topics: GitHub Actions, OIDC, Entra ID, Identità dei workload, WorkOS, Agenti AI

## In breve

- Dal 15 luglio 2026 i token di GitHub Actions per i nuovi repository contengono nel claim sub l'ID dell'owner e l'ID del repository. I repository più vecchi tengono il formato con soli nomi finché non si aderisce: la credenziale deve corrispondere al formato realmente emesso.
- Credenziali wildcard Entra: ancora in preview. Microsoft chiede anche repository_id o repository_owner_id. Nel lab Entra ha accettato un'espressione solo sul sub, e una a livello di owner ha emesso un token a un altro repository dello stesso owner. Aggiungo comunque repository_id.
- WorkOS ha rilasciato l'identità per gli agenti (Agent Auth, accesso anticipato, 2 set), Claude auto-connect per MCP Auth (accesso anticipato, 3 nov) e il token exchange RFC 8693 per Connect (10 nov). Non ho trovato nulla di WorkOS sulla federazione di workload di un altro issuer.
- Cosa farei: fidarmi del sub immutabile, aggiungere repository_id a ogni wildcard, eliminare le credenziali dei repository che non esistono più e verificare con esecuzioni reali. Il mio lab lo fa per GitHub Actions verso Azure.

Ho letto le pagine primarie di queste novità il 20 novembre 2026: changelog e documentazione di GitHub, Microsoft Learn e changelog di WorkOS. Le date qui sotto sono quelle che mostrano quelle pagine. Le prime due novità contano per il mio [lab da GitHub Actions ad Azure](https://iamops.dev/it/github-actions-azure-workload-identity-federation/), ed è per questo che le metto insieme.

## GitHub mette gli ID di owner e repo nel claim sub

Il 23 aprile 2026 GitHub ha annunciato i [claim subject immutabili per i token OIDC di Actions](https://github.blog/changelog/2026-04-23-immutable-subject-claims-for-github-actions-oidc-tokens/). Il post è stato modificato il 10 giugno 2026: il separatore tra un nome e il suo ID ora è `@`, non più `-`. Se hai copiato un esempio dal testo di aprile, controllalo.

Le regole, dal [riferimento OIDC](https://docs.github.com/en/actions/reference/security/oidc):

- I repository creati dopo il 15 luglio 2026 ricevono il nuovo `sub` predefinito. Anche rinomine e trasferimenti dopo quella data passano al nuovo formato.
- I repository più vecchi mantengono il formato con soli nomi finché non aderisci. Puoi farlo per organizzazione o per repository, nelle impostazioni OIDC o con la REST API (`use_immutable_subject`).
- GitHub Enterprise Server non è incluso.
- Un template di claim personalizzato non può togliere gli ID. Con `include_claim_keys`, `owner_id` e `repo_id` restano nel segmento `repo`.

| Formato | `sub` per un push su main |
| --- | --- |
| Solo nomi | `repo:octo-org/octo-repo:ref:refs/heads/main` |
| Immutabile | `repo:octo-org@123456/octo-repo@456789:ref:refs/heads/main` |

I valori d'esempio vengono dalla documentazione di GitHub. Il motivo è nel changelog: se il nome di un repository o di un'organizzazione viene riciclato, un nuovo proprietario può emettere token con lo stesso subject e raggiungere risorse cloud che si fidano ancora dell'originale. Gli ID non vengono mai riutilizzati, quindi la vecchia fiducia non si trasferisce.

Nel mio lab ho creato un repository privato nuovo e il suo `sub` è uscito nel nuovo formato. Questo cambia l'ordine della configurazione. Creo prima il repository, leggo i due ID dall'API e solo dopo creo la credenziale federata. La documentazione di GitHub mostra il formato immutabile per le policy di fiducia di Azure, AWS, Google Cloud e HashiCorp Vault. Io ho provato solo Azure.

## Cosa può confrontare ora Entra

Microsoft etichetta ancora come preview le [credenziali federate flessibili](https://learn.microsoft.com/en-us/entra/workload-id/workload-identities-flexible-federated-identity-credentials). La pagina è datata 18 settembre 2026. Al posto di un `subject` esatto, la credenziale contiene un `claimsMatchingExpression` con `languageVersion` a 1, e `subject` deve essere null. La pagina concettuale dice che Azure CLI non la supporta ancora in modo esplicito e mostra `az rest` su Graph beta, che è quello che ho usato per una app registration. Il riferimento CLI di `az identity federated-credential` (identità gestite assegnate dall'utente) elenca però i parametri `--claims-matching-expression-*`, marcati Preview.

| Operatore | Cosa fa |
| --- | --- |
| `eq` | Corrispondenza esatta su un claim |
| `matches` | Wildcard: `*` per una sequenza qualsiasi di caratteri, `?` per un solo carattere |
| `and` | Combina condizioni su più claim |

Per GitHub, la [pagina di configurazione](https://learn.microsoft.com/en-us/entra/workload-id/workload-identities-set-up-flexible-federated-identity-credential) di Microsoft dice che l'espressione deve confrontare `sub` e uno o entrambi tra `repository_id` e `repository_owner_id`. Vale sia che `sub` sia basato sui nomi, personalizzato o immutabile. `sub` e `job_workflow_ref` accettano `eq` e `matches`. I due claim con gli ID accettano solo `eq`. La [guida alla migrazione](https://learn.microsoft.com/en-us/entra/workload-id/workload-identities-github-immutable-subjects) di Microsoft usa questo esempio:

```text
claims['sub'] matches 'repo:octo-org@123456/octo-repo@456789:*' and claims['repository_id'] eq '456789'
```

Microsoft ha pubblicato anche una [guida alla migrazione](https://learn.microsoft.com/en-us/entra/workload-id/workload-identities-github-immutable-subjects), datata 28 luglio 2026. L'ordine è: creare una credenziale per il subject immutabile accanto a quella vecchia, attivare i subject immutabili in GitHub, validare un'esecuzione, poi eliminare la credenziale vecchia. Una pagina collegata sui [subject mutabili](https://learn.microsoft.com/en-us/entra/workload-id/workload-identities-federated-credential-mutable-subjects) descrive il riciclo dei subject e chiede di eliminare le credenziali orfane, cioè quelle il cui workload non esiste più.

Qui la mia esecuzione differisce dalla documentazione. Nel [lab](https://iamops.dev/it/github-actions-azure-workload-identity-federation/) ho creato due espressioni che confrontavano solo `sub` (`feature-*` e `v*`), senza `repository_id`. Entra le ha accettate entrambe e le esecuzioni corrispondenti sono passate. Quei pattern contenevano gli ID di owner e repository, quindi erano comunque vincolati. In un controllo successivo, lo stesso giorno, Entra ha accettato anche un'espressione a livello di owner senza `repository_id` né `repository_owner_id`, e quella credenziale ha emesso un token a un altro repository dello stesso owner. Consiglio lo stesso di aggiungere `repository_id`. Microsoft lo documenta come obbligatorio e la funzione è in preview, quindi una credenziale solo sul sub potrebbe essere rifiutata o smettere di corrispondere più avanti. E il controllo sull'ID non dipende dallo scrivere bene il pattern: un wildcard a livello di owner ha già emesso un token a un altro dei miei repository, e il `sub` solo con i nomi di un repository più vecchio può corrispondere a un nome che non è più tuo.

## Come un token incontra due credenziali

![Una matrice di due credenziali federate Entra contro quattro esecuzioni di GitHub Actions. La credenziale esatta per main accetta solo un push su main. La credenziale con wildcard per release/* e controllo di repository_id accetta solo un push su release/1. Un feature branch e una pull request non corrispondono a nessuna.](https://iamops.dev/img/workload-identity-news-immutable-sub-entra-wildcards-workos.it.svg)

*Quali valori di sub accetta ogni credenziale. È una mia sintesi, ricavata dal pattern di ciascuna credenziale. Gli ID sono i valori d'esempio della documentazione di GitHub.*

Il punto dell'immagine: la parte di `sub` dopo gli ID è l'esecuzione. Un push su main, un push su un branch di release, un feature branch e una pull request inviano ciascuno un valore diverso, e Entra lo confronta con la credenziale. Gli ID al centro impediscono a un altro repository con lo stesso nome di corrispondere. Il mio lab esegue tutti questi casi e stampa il `sub` esatto di ciascuno.

## WorkOS: cosa ho trovato

Ho controllato il [changelog di WorkOS](https://workos.com/changelog) perché continua a rilasciare auth per agenti e MCP. Queste sono le voci da agosto al 20 novembre che riguardano credenziali di agenti o workload:

| Data | Voce | Cosa dice WorkOS |
| --- | --- | --- |
| 2 set 2026 | [Agent Auth](https://workos.com/changelog/agent-auth) | Accesso anticipato. Gli agenti ricevono identità in AuthKit e token di breve durata con ambito ristretto a ogni esecuzione, delegati per conto di un utente o autonomi all'interno di un'organizzazione. Le sessioni si possono revocare subito. |
| 4 set 2026 | [MCP Enterprise-Managed Authorization (EMA)](https://workos.com/changelog/mcp-enterprise-managed-authorization-ema) | MCP Auth supporta EMA, così un client MCP può raggiungere i server MCP a valle tramite l'identity provider dell'azienda, senza una schermata di consenso per ogni app. Accesso su richiesta. |
| 3 nov 2026 | [Claude auto-connect](https://workos.com/changelog/workos-mcp-auth-supports-claude-auto-connect) | Accesso anticipato. Per le organizzazioni il cui identity provider non supporta Cross App Access, Claude emette l'identity assertion (ID-JAG) e MCP Auth la scambia con un access token per il tuo server MCP. |
| 10 nov 2026 | [Token exchange per WorkOS Connect](https://workos.com/changelog/token-exchange-for-workos-connect) | RFC 8693. Un'app Connect first-party può scambiare un token per un'altra risorsa registrata, riportare i claim principali e restringere gli scope. |

Le ultime due si collegano a cose che ho già scritto. Claude auto-connect è il flusso ID-JAG di [ID-JAG explained](https://iamops.dev/it/id-jag-explained/), con Claude come issuer. Il token exchange è il pattern che il mio [lab sul no-passthrough per MCP](https://iamops.dev/it/mcp-server-no-token-passthrough/) costruisce a mano.

Niente di tutto questo è workload identity federation nel senso di Entra, dove ci si fida di token di un altro issuer. Non ho trovato nel changelog di WorkOS nessuna voce su questo, né sull'autenticazione machine-to-machine. Ciò che queste voci hanno in comune con la storia di GitHub è l'idea di una credenziale di breve durata e ristretta per ogni esecuzione, al posto di una chiave conservata. Altre due voci sugli agenti, Agent Registration (4 agosto) e Agent Vault (17 novembre), riguardano l'accesso degli agenti ad AuthKit con il protocollo auth.md e le sessioni di browser già autenticate, quindi le ho escluse. Non ho provato nessun prodotto WorkOS.

## Cosa farei

Questa è la mia opinione, non una linea guida di Microsoft o GitHub.

- Per un repository nuovo, controlla le credenziali scritte a partire da esempi più vecchi. Il subject ora contiene gli ID, e un subject con soli nomi non corrisponde.
- Per un repository vecchio, segui l'ordine di Microsoft: aggiungi la credenziale immutabile, aderisci, esegui un workflow, poi elimina la credenziale vecchia.
- Metti `repository_id` in ogni espressione, anche quando il pattern contiene gli ID. Nel mio lab Entra ha accettato espressioni solo sul sub, e una a livello di owner ha emesso un token a un altro repository dello stesso owner. La documentazione richiede comunque il controllo sull'ID, e io lo aggiungo.
- Elenca le credenziali federate delle tue app registration ed elimina quelle il cui repository non esiste più.

Il [lab](https://iamops.dev/it/github-actions-azure-workload-identity-federation/) mostra il fallimento che deriva dalla corrispondenza esatta. Con la sola credenziale per main, è passato un tipo di esecuzione su sei. Mostra anche una trappola: una credenziale per `pull_request` si fida anche delle esecuzioni `pull_request_target`, e queste ricevono i secret.

## Cosa non ho verificato

- Non ho fatto aderire un repository esistente e non ho chiamato l'endpoint di anteprima di GitHub che mostra il nuovo prefisso del subject.
- Ho provato solo Azure. AWS, Google Cloud e Vault compaiono nella documentazione di GitHub e non li ho eseguiti.
- Non ho provato GitHub Enterprise Server, che GitHub esclude.
- Ho letto le voci del changelog di WorkOS e non ho provato nessun prodotto né letto la documentazione collegata. Due voci sono in accesso anticipato.
- Le pagine Microsoft sulle credenziali flessibili dicono ancora preview. Non ho trovato una data di disponibilità generale e non ne invento una.

## Sources

- [GitHub Changelog, 23 Apr 2026 (edited 10 Jun 2026): Immutable subject claims for GitHub Actions OIDC tokens](https://github.blog/changelog/2026-04-23-immutable-subject-claims-for-github-actions-oidc-tokens/)
- [GitHub Docs: OpenID Connect reference (immutable subject claims)](https://docs.github.com/en/actions/reference/security/oidc)
- [GitHub Docs: REST API endpoints for GitHub Actions OIDC](https://docs.github.com/en/rest/actions/oidc)
- [Microsoft Learn: Flexible federated identity credentials (preview)](https://learn.microsoft.com/en-us/entra/workload-id/workload-identities-flexible-federated-identity-credentials)
- [Microsoft Learn: Set up a flexible federated identity credential (preview)](https://learn.microsoft.com/en-us/entra/workload-id/workload-identities-set-up-flexible-federated-identity-credential)
- [Microsoft Learn: Migrate GitHub Actions federated credentials to immutable subjects](https://learn.microsoft.com/en-us/entra/workload-id/workload-identities-github-immutable-subjects)
- [Microsoft Learn: Mutable subjects in federated identity credentials](https://learn.microsoft.com/en-us/entra/workload-id/workload-identities-federated-credential-mutable-subjects)
- [Microsoft Learn: az identity federated-credential (Azure CLI)](https://learn.microsoft.com/en-us/cli/azure/identity/federated-credential?view=azure-cli-latest)
- [WorkOS changelog, 2 Sep 2026: Agent Auth](https://workos.com/changelog/agent-auth)
- [WorkOS changelog, 4 Sep 2026: MCP Enterprise-Managed Authorization (EMA)](https://workos.com/changelog/mcp-enterprise-managed-authorization-ema)
- [WorkOS changelog, 3 Nov 2026: WorkOS MCP Auth supports Claude auto-connect](https://workos.com/changelog/workos-mcp-auth-supports-claude-auto-connect)
- [WorkOS changelog, 10 Nov 2026: Token exchange for WorkOS Connect](https://workos.com/changelog/token-exchange-for-workos-connect)
