View a markdown version of this page

Crea un endpoint VPC per AWS STS Discovery OIDC - AWS Identity and Access Management

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Crea un endpoint VPC per AWS STS Discovery OIDC

Servizio di token di sicurezza AWS (AWS STS) Il rilevamento OIDC è costituito da una coppia di endpoint pubblici che forniscono i metadati e le chiavi di verifica necessarie alle parti interessate per convalidare i JSON Web Token (JWT) emessi dalla federazione delle identità in uscita. Federando AWS Identità verso servizi esterni

Quando abiliti la federazione delle identità in uscita, pubblica un URL dell'emittente specifico dell'account. AWS STS Questo URL ospita due endpoint di rilevamento OpenID Connect (OIDC). I relying party recuperano questi endpoint per ottenere i metadati e le chiavi pubbliche di cui hanno bisogno per verificare i JWT che emettono: GetWebIdentityToken

  • {issuer_url}/.well-known/openid-configuration— Il documento di scoperta dell'OIDC

  • {issuer_url}/.well-known/jwks.json— Il JSON Web Key Set (JWKS) che contiene le chiavi di verifica della firma del token

Per impostazione predefinita, per raggiungere questi endpoint dal tuo VPC sono necessari un gateway Internet, un dispositivo NAT, una connessione VPN o una connessione. Per mantenere invece questo traffico sulla AWS rete, create un endpoint VPC di interfaccia per l'endpoint di rilevamento STS OIDC.

Nota

L'endpoint di rilevamento STS OIDC serve solo i due endpoint sopra elencati. Non serve ad alcuna operazione API. AWS STS Per chiamare GetWebIdentityToken o eseguire qualsiasi altra AWS STS operazione in privato, utilizza il servizio com.amazonaws.region.sts endpoint. AssumeRole Consulta Crea un endpoint VPC per AWS STS.

Scelta del servizio endpoint giusto

La federazione delle identità in uscita utilizza due percorsi di rete distinti. La maggior parte dei carichi di lavoro che emettono e verificano token richiedono entrambi i servizi endpoint.

Operazione Servizio endpoint Autenticazione
Crea un JWT () sts:GetWebIdentityToken com.amazonaws.region.sts AWS SIG v4
Leggi /.well-known/openid-configuration com.amazonaws.region.sts-oidc Nessuno (non autenticato)
Leggi /.well-known/jwks.json com.amazonaws.region.sts-oidc Nessuno (non autenticato)

Non è necessario l'endpoint di rilevamento STS OIDC se l'unica parte che verifica i token è un servizio esterno. AWS Tale servizio recupera l'URL dell'emittente sulla rete Internet pubblica e il relativo traffico non entra nel tuo VPC.

Considerazioni

Considerate quanto segue prima di creare un endpoint VPC di interfaccia per il rilevamento STS OIDC.

  • Le policy degli endpoint VPC non sono supportate. Entrambe le API di rilevamento servono dati disponibili al pubblico e l'endpoint di rilevamento STS OIDC non applica le policy degli endpoint VPC. Utilizza i gruppi di sicurezza e il posizionamento delle sottoreti per controllare quali risorse possono raggiungere l'endpoint.

  • Sono serviti solo due percorsi. L'endpoint accetta GET richieste HTTPS per /.well-known/openid-configuration e /.well-known/jwks.json solo. Tutti gli altri percorsi e metodi restituiscono un errore.

Creazione di un endpoint VPC di interfaccia per il rilevamento STS OIDC

Puoi creare un endpoint VPC per l'endpoint di rilevamento STS OIDC utilizzando la console Amazon Virtual Private Cloud o il. AWS Command Line Interface Per ulteriori informazioni, consulta Accedere a un AWS servizio utilizzando un endpoint VPC di interfaccia nella Amazon VPC User Guide.

Crea un endpoint VPC per il rilevamento STS OIDC utilizzando il seguente nome di servizio:

  • com.amazonaws.region.sts-oidc

Se abiliti il DNS privato per l'endpoint, puoi inviare richieste sts-oidc.region.amazonaws.com e queste verranno risolte alle interfacce di rete dell'endpoint all'interno del tuo VPC.

Invio di richieste tramite l'endpoint

Quando un relying party nel tuo VPC deve verificare un JWT, recupera il documento di scoperta OIDC e i JWKS dall'URL dell'emittente. Il nome host dell'emittente (ad esempio,uuid.tokens.sts.global.api.aws) utilizza un dominio diverso da quello dell'endpoint (), quindi per impostazione predefinita non si risolve nell'endpoint sts-oidc.region.amazonaws.com VPC.

Per indirizzare le richieste per il nome host dell'emittente attraverso l'endpoint, crea una zona ospitata privata di Amazon Route 53 per il nome host dell'emittente e aggiungi un record alias che punti all'endpoint VPC. Dopo aver creato la zona ospitata, le risorse nel VPC risolvono il nome host dell'emittente nelle interfacce di rete dell'endpoint. Le librerie OIDC standard possono quindi recuperare i documenti di rilevamento senza modifiche al codice. Per ulteriori informazioni sulla creazione di una zona ospitata privata, consulta la sezione relativa all'utilizzo di zone ospitate private nella Guida per gli sviluppatori di Amazon Route 53.

Nota

Il servizio endpoint è regionale, ma un singolo endpoint serve le richieste di rilevamento per qualsiasi UUID dell'emittente nella partizione. Crea endpoint nelle regioni in cui vengono eseguiti i verificatori; non ne hai bisogno uno per account dell'emittente.