Verfügbare Schlüssel für IAM Verfügbare Schlüssel für AWS-OIDC-Verbund Verfügbare Schlüssel für SAML-basierten AWS STS-Verbund Serviceübergreifende SAML-basierte AWS STS-Verbundkontextschlüssel Verfügbare Schlüssel für AWS STS

IAM- und AWS STS-Bedingungskontextschlüssel

Sie können das Condition-Element in einer JSON-Richtlinie verwenden, um den Wert von Schlüsseln zu testen, die im Anforderungskontext aller AWS-Anforderungen enthalten sind. Diese Schlüssel enthalten Informationen zu der Anforderung selbst oder zu den Ressourcen, die die Anforderung referenziert. Sie können die Schlüssel auf bestimmte Werte überprüfen, bevor Sie die angeforderte Aktion zulassen. So können Sie genau steuern, wann Ihre JSON-Richtlinienanweisungen mit einer eingehenden Anforderung übereinstimmen. Weitere Informationen zur Verwendung des Elements Condition in JSON-Richtlinien finden Sie unter IAM-JSON-Richtlinienelemente: Condition.

Dieses Thema beschreibt die vom IAM-Service definierten und bereitgestellten Schlüssel (mit einem Präfix iam:) und den Service AWS Security Token Service (AWS STS) (mit einem sts:-Präfix). Es gibt noch andere AWS-Services, die servicespezifische Schlüssel bereitstellen, die für die von diesem Service bereitgestellten Aktionen und Ressourcen relevant sind. Weitere Informationen finden Sie unter Aktionen, Ressourcen und Bedingungsschlüssel für AWS-Services. Weitere Informationen zu den unterstützten Bedingungsschlüsseln können Sie meist der Dokumentation des jeweiligen Service entnehmen. Weitere Informationen zu Schlüsseln, die Sie in Richtlinien für Amazon-S3-Ressourcen verwenden können, finden Sie beispielsweise unter Amazon-S3-Richtlinienschlüssel im Benutzerhandbuch für Amazon Simple Storage Service.

Themen

Verfügbare Schlüssel für IAM
Verfügbare Schlüssel für AWS-OIDC-Verbund
Verfügbare Schlüssel für SAML-basierten AWS STS-Verbund
Serviceübergreifende SAML-basierte AWS STS-Verbundkontextschlüssel
Verfügbare Schlüssel für AWS STS

Verfügbare Schlüssel für IAM

Sie können die folgenden Bedingungsschlüssel in Richtlinien verwenden, die zur Zugriffssteuerung auf IAM-Ressourcen genutzt werden:

iam:AssociatedResourceArn

Funktioniert mit ARN-Operatoren.

Gibt den ARN der Ressource an, der diese Rolle beim Zielservice zugeordnet wird. Die Ressource gehört normalerweise zu dem Service, an den der Auftraggeber die Rolle übergibt. Manchmal kann die Ressource zu einem dritten Service gehören. Sie können beispielsweise eine Rolle an Amazon EC2 Auto Scaling übergeben, die sie auf einer Amazon EC2-Instance verwenden. In diesem Fall würde die Bedingung mit dem ARN der Amazon EC2-Instance übereinstimmen.

Dieser Bedingungsschlüssel gilt nur für die Aktion PassRole in einer Richtlinie. Er kann nicht verwendet werden, um eine andere Aktion zu beschränken.

Wichtig

Bei Verwendung der Bedingung iam:AssociatedResourceArn in einer Richtlinie zum Einschränken der PassRole-Aktion gelten besondere Überlegungen, wenn die Richtlinie den Zugriff für die Aktion AddRoleToInstanceProfile definieren soll. In diesem Fall können Sie in der EC2-Instancr-ARN keine Region oder Instance-ID angeben. Der ARN -Wert muss arn:aws:ec2:*:CallerAccountId:instance/* lauten. Die Verwendung eines anderen ARN-Wertes kann zu unerwarteten Auswertungsergebnissen führen.

Verwenden Sie diesen Bedingungsschlüssel in einer identitätsbasierten Richtlinie, um einer Entität die Übergabe einer Rolle zu gestatten, jedoch nur, wenn diese Rolle der angegebenen Ressource zugeordnet ist. Beispielsweise können Sie einem IAM-Benutzer oder einer IAM-Rolle erlauben, jede Rolle an den Amazon-EC2-Service zu übergeben, um sie mit Instances im AWS-Konto zu verwenden. Der IAM-Benutzer oder die IAM-Rolle wäre nicht berechtigt, Rollen an andere Services zu übergeben.


{
    "Effect": "Allow",
    "Action": "iam:PassRole",
    "Resource": "*",
    "Condition": {
        "StringEquals": {
            "iam:PassedToService": "ec2.amazonaws.com"
        },
        "ArnLike": {
            "iam:AssociatedResourceARN": [
                "arn:aws:ec2:*:111122223333:instance/*"
            ]
        }
    }
}

Anmerkung

AWS-Services, die IAM:PassedToService unterstützen, unterstützen auch diesen Bedingungsschlüssel.

iam:AWSServiceName

Funktioniert mit Zeichenfolgenoperatoren.

Gibt den AWS-Service an, dem diese Rolle zugeordnet ist.

Dieser Bedingungsschlüssel wird von der CreateServiceLinkedRole-API-Operation unterstützt.

Tipp

Informationen darüber, welche Services die Verwendung von serviceverknüpften Rollen unterstützen, finden Sie unter AWS-Services, die mit IAM funktionieren. Suchen Sie nach den Services, für die Ja in der Spalte Serviceverknüpfte Rolle angegeben ist. Wählen Sie über einen Link Ja aus, um die Dokumentation zu einer serviceverknüpften Rolle für diesen Service anzuzeigen.

In diesem Beispiel erlauben Sie einer Entität das Erstellen einer serviceverknüpften Rolle mithilfe der CreateServiceLinkedRole-API-Operation, wenn der Servicename access-analyzer.amazonaws.com lautet.

iam:FIDO-certification

Funktioniert mit Zeichenfolgenoperatoren.

Überprüft die FIDO-Zertifizierungsstufe des MFA-Geräts zum Zeitpunkt der Registrierung eines FIDO-Sicherheitsschlüssels. Die Gerätezertifizierung wird vom FIDO Alliance Metadata Service (MDS) abgerufen. Wenn sich der Zertifizierungsstatus oder die Stufe Ihres FIDO-Sicherheitsschlüssels ändert, wird dieser nicht aktualisiert, es sei denn, das Gerät wird deregistriert und erneut registriert, um die aktualisierten Zertifizierungsinformationen abzurufen.

Mögliche Werte von L1, L1plus, L2, L2plus, L3, L3plus

In diesem Beispiel registrieren Sie einen Sicherheitsschlüssel und erhalten die FIDO Level 1 Plus-Zertifizierung für Ihr Gerät.

iam:FIDO-FIPS-140-2-certification

Funktioniert mit Zeichenfolgenoperatoren.

Überprüft die FIPS-140-2-Validierungszertifizierungsstufe des MFA-Geräts zum Zeitpunkt der Registrierung eines FIDO-Sicherheitsschlüssels. Die Gerätezertifizierung wird vom FIDO Alliance Metadata Service (MDS) abgerufen. Wenn sich der Zertifizierungsstatus oder die Stufe Ihres FIDO-Sicherheitsschlüssels ändert, wird dieser nicht aktualisiert, es sei denn, das Gerät wird deregistriert und erneut registriert, um die aktualisierten Zertifizierungsinformationen abzurufen.

Mögliche Werte von L1, L2, L3, L4

In diesem Beispiel registrieren Sie einen Sicherheitsschlüssel und erhalten die Zertifizierung FIPS-140-2 Level 2 für Ihr Gerät.

iam:FIDO-FIPS-140-3-certification

Funktioniert mit Zeichenfolgenoperatoren.

Überprüft die FIPS-140-3-Validierungszertifizierungsstufe des MFA-Geräts zum Zeitpunkt der Registrierung eines FIDO-Sicherheitsschlüssels. Die Gerätezertifizierung wird vom FIDO Alliance Metadata Service (MDS) abgerufen. Wenn sich der Zertifizierungsstatus oder die Stufe Ihres FIDO-Sicherheitsschlüssels ändert, wird dieser nicht aktualisiert, es sei denn, das Gerät wird deregistriert und erneut registriert, um die aktualisierten Zertifizierungsinformationen abzurufen.

Mögliche Werte von L1, L2, L3, L4

In diesem Beispiel registrieren Sie einen Sicherheitsschlüssel und erhalten die Zertifizierung FIPS-140-3 Level 3 für Ihr Gerät.

iam:OrganizationsPolicyId

Funktioniert mit Zeichenfolgenoperatoren.

Prüft, ob die Richtlinie mit der angegebenen AWS Organizations-ID mit der in der Anforderung verwendeten Richtlinie übereinstimmt. Informationen zum Anzeigen einer IAM-Beispielrichtlinie, die diesen Bedingungsschlüssel verwendet, finden Sie unter IAM: Anzeigen von Informationen zum letzten Zugriff auf einen Service für eine AWS Organizations-Richtlinie.

iam:PassedToService

Funktioniert mit Zeichenfolgenoperatoren.

Gibt den ServiceAuftraggeber des Services an, an den eine Rolle übergeben werden kann. Dieser Bedingungsschlüssel gilt nur für die Aktion PassRole in einer Richtlinie. Er kann nicht verwendet werden, um eine andere Aktion zu beschränken.

Wenn Sie diesen Bedingungsschlüssel in einer Richtlinie verwenden, geben Sie den Service über einen Dienstauftraggeber an. Ein Serviceprinzipal ist der Name eines Service, der im Element Principal einer Richtlinie angegeben werden kann. Standardformat: SERVICE_NAME_URL.amazonaws.com.

Sie können iam:PassedToService verwenden, um die Benutzer einzuschränken, damit sie Rollen nur an bestimmte Services übergeben können. Ein Benutzer kann beispielsweise eine Servicerolle erstellen, die CloudWatch-Protokolldaten in seinem Namen in einen Amazon S3-Bucket schreiben lässt. Der Benutzer muss dann eine Berechtigungsrichtlinie und eine Vertrauensrichtlinie an die neue Servicerolle anfügen. In diesem Fall muss die Vertrauensrichtlinie cloudwatch.amazonaws.com im Element Principal angeben. Um eine Richtlinie anzuzeigen, die es dem Benutzer erlaubt, die Rolle an CloudWatch zu übergeben, siehe IAM: Übergeben einer IAM-Rolle an einen bestimmten AWS-Service.

Mit diesem Bedingungsschlüssel können Sie sicherstellen, dass Benutzer Servicerollen nur für die von Ihnen angegebenen Services erstellen. Wenn beispielsweise ein Benutzer mit der vorherigen Richtlinie versucht, eine Servicerolle für Amazon EC2 zu erstellen, schlägt der Vorgang fehl. Der Fehlschlag tritt auf, weil der Benutzer nicht über die Berechtigung verfügt, die Rolle an Amazon EC2 zu übergeben.

Manchmal übergeben Sie eine Rolle an einen Service, der die Rolle dann an einen anderen Service übergibt. iam:PassedToService enthält nur den endgültigen Dienst, der die Rolle übernimmt, nicht den Zwischendienst, der die Rolle übergibt.

Anmerkung

Einige Services unterstützen diesen Bedingungsschlüssel nicht.

iam:PermissionsBoundary

Funktioniert mit ARN-Operatoren.

Überprüft, ob die angegebene Richtlinie als Berechtigungsgrenze an die IAM-Auftraggeber-Ressource angefügt. Weitere Informationen finden Sie unter Berechtigungsgrenzen für IAM-Entitäten

iam:PolicyARN

Funktioniert mit ARN-Operatoren.

Prüft den Amazon-Ressourcennamen (ARN) einer verwalteten Richtlinie in Anforderungen mit Beteiligung einer verwalteten Richtlinie. Weitere Informationen finden Sie unter Steuern des Zugriffs auf Richtlinien.

iam:RegisterSecurityKey

Funktioniert mit Zeichenfolgenoperatoren.

Prüft den aktuellen Status der MFA-Geräteaktivierung.

Mögliche Werte von Create oder Activate.

In diesem Beispiel registrieren Sie einen Sicherheitsschlüssel und erhalten die Zertifizierung FIPS-140-3 Level 1 für Ihr Gerät.

iam:ResourceTag/key-name

Funktioniert mit Zeichenfolgenoperatoren.

Überprüft, ob das an die Identitätsressource (Benutzer oder Rolle) angefügte Tag mit dem angegebenen Schlüsselnamen und Wert übereinstimmt.

Anmerkung

IAM und AWS STS unterstützen sowohl den iam:ResourceTag-IAM-Bedingungsschlüssel als auch den aws:ResourceTag-globalen Bedingungsschlüssel.

Sie können IAM-Ressourcen benutzerdefinierte Attribute in Form eines Schlüssel-Wert-Paares hinzufügen. Weitere Informationen zum Markieren von IAM-Ressourcen finden Sie unter Tags für AWS Identity and Access Management-Ressourcen. Sie können ResourceTag verwenden, um den Zugriff auf AWS-Ressourcen, einschließlich IAM-Ressourcen, zu steuern. IAM unterstützt jedoch keine Tags für Gruppen. Daher können Sie Tags nicht verwenden, um den Zugriff auf Gruppen zu steuern.

Dieses Beispiel zeigt, wie Sie eine identitätsbasierte Richtlinie erstellen könnten, die das Löschen von Benutzern mit dem status=terminated-Tag erlaubt. Um diese Richtlinie zu verwenden, ersetzen Sie den kursiv gedruckten Platzhaltertext in der Beispielrichtlinie durch Ihre eigenen Informationen. Befolgen Sie dann die Anweisungen unter Erstellen einer Richtlinie oder Bearbeiten einer Richtlinie.

iam:ServiceSpecificCredentialAgeDays

Funktioniert mit nummerischen Operatoren.

Dieser Bedingungsschlüssel schränkt die Erstellung von servicespezifischen Anmeldeinformationen auf der Grundlage ihrer Ablaufeinstellungen ein. Damit können Sie das maximale Alter in Tagen für servicespezifische Anmeldeinformationen festlegen, die erstellt werden können.

Der gültige Bereich für Tage liegt zwischen 1 und 36 600 (mindestens 1 Tag, maximal 36 600 Tage).

Dieser Bedingungsschlüssel wird von der CreateServiceSpecificCredential-API-Operation unterstützt.

In diesem Beispiel erlauben Sie einem Benutzer, servicespezifische Anmeldeinformationen für den Amazon Bedrock-Service nur zu erstellen, wenn diese innerhalb von 90 Tagen ablaufen.

iam:ServiceSpecificCredentialServiceName

Funktioniert mit Zeichenfolgenoperatoren.

Gibt an, welche AWS-Services bei der Verwaltung servicespezifischer Anmeldeinformationen verwendet werden können. Mit diesem Bedingungsschlüssel können Sie einschränken, welche AWS-Services bei der Verwaltung servicespezifischer Anmeldeinformationen zulässig sind.

Dieser Bedingungsschlüssel wird von folgenden API-Operationen unterstützt.

Die folgenden Services werden für servicespezifische Anmeldeinformationen mit ihrer genauen Wertformatierung unterstützt:

bedrock.amazonaws.com
cassandra.amazonaws.com
codecommit.amazonaws.com

In diesem Beispiel ermöglichen Sie einem Benutzer, servicespezifische Anmeldeinformationen mithilfe der CreateServiceSpecificCredential-API-Operation nur für den Amazon-Bedrock-Service zu erstellen.

Verfügbare Schlüssel für AWS-OIDC-Verbund

Sie können den OIDC-Verbund verwenden, um Benutzern, die über einen mit OpenID Connect kompatiblen Identitätsanbieter (IdP) bei einem IAM OpenID Connect (OIDC)-Identitätsanbieter in Ihrem AWS-Konto authentifiziert wurden, temporäre Sicherheits-Anmeldeinformationen zu gewähren. Beispiele für solche Anbieter sind GitHub, Amazon Cognito, Login mit Amazon und Google. Es können Identitäts- und Zugriffstokens von Ihrem eigenen IdP sowie Servicekonto-Tokens verwendet werden, die Service-Workloads von Amazon Elastic Kubernetes gewährt werden.

Sie können AWS-OIDC-Bedingungskontextschlüssel verwenden, um Richtlinien zu schreiben, die den Zugriff von Verbundprinzipalen auf Ressourcen beschränken, die einem bestimmten Anbieter, einer bestimmten App oder einem bestimmten Benutzer zugeordnet sind. Diese Schlüssel werden in der Regel in der Vertrauensrichtlinie für eine Rolle verwendet. Definieren Sie Bedingungsschlüssel mit dem Namen des OIDC-Anbieters (token.actions.githubusercontent.com), gefolgt von einem Antrag (:aud): token.actions.githubusercontent.com:aud.

Einige Bedingungsschlüssel für den OIDC-Verbund können in der Rollensitzung verwendet werden, um den Ressourcenzugriff zu autorisieren. Wenn in der Spalte In Sitzung verfügbar der Wert Ja lautet, können Sie diese Bedingungsschlüssel in Richtlinien verwenden, um zu definieren, worauf Benutzer in anderen AWS-Services zugreifen dürfen. Wenn ein Antrag in der Sitzung nicht verfügbar ist, kann der OIDC-Bedingungskontextschlüssel nur in einer Rollenvertrauensrichtlinie für die anfängliche Authentifizierung mit AssumeRoleWithWebIdentity verwendet werden.

Wählen Sie Ihren IdP aus, um zu sehen, wie Anträge von Ihrem IdP den IAM-Bedingungskontextschlüsseln in AWS zugeordnet werden. Weitere Informationen zu Schlüsseln für GitHub und Google finden Sie auf der Registerkarte Standard.

Default

Standardmäßig werden die standardmäßigen OIDC-Anträge und deren Zuordnung zu Bedingungskontextschlüsseln AWS STS in AWS aufgelistet. Mit diesen Schlüsseln können Sie den Zugriff auf eine Rolle steuern. Vergleichen Sie dazu die AWS STS-Bedingungsschlüssel mit den Werten in der Spalte mit dem IdP-JWT-Antrag. Verwenden Sie diese Zuordnung, wenn Ihr IdP nicht in den Registerkartenoptionen aufgeführt ist.

GitHub-Aktions-Workflows und Google sind einige Beispiele für IDPs, die die Standardimplementierung in ihrem OIDC-JWT-ID-Token verwenden.

AWS STS-Bedingungsschlüssel	IdP-JWT-Antrag	In der Sitzung verfügbar
amr	amr	Ja
aud	azp Wenn für `azp` kein Wert festgelegt ist, wird der `aud`-Bedingungsschlüssel dem `aud`-Antrag zugeordnet.	Ja
E-Mail	E-Mail	Nein
oaud	aud	Nein
sub	sub	Ja

Weitere Informationen zur Verwendung von OIDC-Bedingungskontextschlüsseln mit GitHub finden Sie unter Konfigurieren einer Rolle für den GitHub-OIDC-Identitätsanbieter. Weitere Informationen zu den Google-Feldern aud und azp finden Sie im Google Identity Platform OpenID Connect-Leitfaden.

amr

Funktioniert mit Zeichenfolgenoperatoren. Der Schlüssel enthält mehrere Werte, d. h. Sie überprüfen ihn in einer Richtlinie mithilfe von Bedingungsmengenoperatoren.

Beispiel: token.actions.githubusercontent.com:amr

Die Referenz zu Authentifizierungsmethoden enthält Anmeldeinformationen zum Benutzer. Der Schlüssel kann die folgenden Werte enthalten:

Wenn der Benutzer nicht authentifiziert wurde, enthält der Schlüssel nur unauthenticated.
Wenn der Benutzer authentifiziert wurde, enthält der Schlüssel den Wert authenticated sowie den Namen des Identitätsanbieters, der in dem Aufruf (accounts.google.com) verwendet wurde.

aud

Funktioniert mit Zeichenfolgenoperatoren.

Beispiele:

accounts.google.com:aud
token.actions.githubusercontent.com:aud

Verwenden Sie den aud-Bedingungsschlüssel, um zu überprüfen, ob die Zielgruppe mit der in der Richtlinie angegebenen übereinstimmt. Sie können den aud-Schlüssel mit dem Sub-Schlüssel für denselben Identitätsanbieter verwenden.

Dieser Bedingungsschlüssel wird aus den folgenden Token-Feldern festgelegt:

aud for OAuth 2.0-Google-Client-IDs Ihrer Anwendung, wenn das Feld azp nicht festgelegt ist. Wenn das azp-Feld festgelegt ist, stimmt das aud-Feld mit dem Bedingungsschlüssel accounts.google.com:oaud überein.
azp, wenn das Feld azp festgelegt ist. Dies kann bei hybriden Anwendungen passieren, bei denen eine Webanwendung und eine Android-Anwendung eine unterschiedliche OAuth 2.0 Google-Client-ID haben, aber dasselbe Google-APIs-Projekt verwenden.

Wenn Sie eine Richtlinie mit dem accounts.google.com:aud-Bedingungsschlüssel schreiben, müssen Sie wissen, ob die Anwendung eine Hybridanwendung ist, die das Feld azp festlegt.

azp-Feld nicht festgelegt

Die folgende Beispielrichtlinie funktioniert für nicht-hybride Anwendungen, die das Feld azp nicht festlegen. In diesem Fall stimmt der Wert des Google-ID-Token aud-Felds mit dem accounts.google.com:aud- und dem accounts.google.com:oaud-Bedingungsschlüsselwert überein.

JSON

JSON


{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Principal": {"Federated": "accounts.google.com"},
            "Action": "sts:AssumeRoleWithWebIdentity",
            "Condition": {
                "StringEquals": {
                    "accounts.google.com:aud": "aud-value",
                    "accounts.google.com:oaud": "aud-value",
                    "accounts.google.com:sub": "sub-value"
                }
            }
        }
    ]
}

azp-Feld festgelegt

Die folgende Beispielrichtlinie funktioniert für hybride Anwendungen, die das Feld azp festlegen. In diesem Fall stimmt der Wert des Google-ID-Token aud-Felds nur mit dem Wert des Bedingungsschlüssels accounts.google.com:oaud überein. Der Wert des Feldes azp entspricht dem Wert des accounts.google.com:aud-Bedingungsschlüssels.

JSON

JSON


{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Principal": {"Federated": "accounts.google.com"},
            "Action": "sts:AssumeRoleWithWebIdentity",
            "Condition": {
                "StringEquals": {
                    "accounts.google.com:aud": "azp-value",
                    "accounts.google.com:oaud": "aud-value",
                    "accounts.google.com:sub": "sub-value"
                }
            }
        }
    ]
}

E-Mail

Funktioniert mit Zeichenfolgenoperatoren.

Beispiel: accounts.google.com:email

Dieser Bedingungsschlüssel validiert die E-Mail-Adresse des Benutzers. Der Wert dieses Antrags ist für dieses Konto möglicherweise nicht eindeutig und kann sich im Laufe der Zeit ändern. Daher sollten Sie diesen Wert nicht als primäre Kennung zur Überprüfung Ihres Benutzerdatensatzes verwenden.

oaud

Funktioniert mit Zeichenfolgenoperatoren.

Beispiel: accounts.google.com:oaud

Dieser Schlüssel gibt die andere Zielgruppe (aud) an, für die dieses ID-Token bestimmt ist. Es muss eine der OAuth 2.0-Client-IDs Ihrer Anwendung sein.

sub

Funktioniert mit Zeichenfolgenoperatoren.

Beispiele:

accounts.google.com:sub
token.actions.githubusercontent.com:sub

Verwenden Sie diese Schlüssel, um zu überprüfen, ob der Betreff mit dem übereinstimmt, den Sie in der Richtlinie angeben. Sie können den sub-Schlüssel mit dem aud-Schlüssel für denselben Identitätsanbieter verwenden.

In der folgenden Rollenvertrauensrichtlinie beschränkt der Bedingungsschlüssel sub die Rolle auf die GitHub-Verzweigung mit dem Namen demo.

JSON

JSON


{
  "Version":"2012-10-17",		 	 	 
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "Federated": "arn:aws:iam::111122223333:oidc-provider/token.actions.githubusercontent.com"
      },
      "Action": "sts:AssumeRoleWithWebIdentity",
      "Condition": {
        "StringEquals": {
          "token.actions.githubusercontent.com:aud": "sts.amazonaws.com",
          "token.actions.githubusercontent.com:sub": "repo:org-name/repo-name:ref:refs/heads/demo"
        }
      }
    }
  ]
}

Amazon Cognito

Auf dieser Registerkarte wird erläutert, wie Amazon Cognito OIDC-Anträge den Bedingungskontextschlüsseln AWS STS in AWS zuordnet. Mit diesen Schlüsseln können Sie den Zugriff auf eine Rolle steuern. Vergleichen Sie dazu die AWS STS-Bedingungsschlüssel mit den Werten in der Spalte mit dem IdP-JWT-Antrag.

Für Rollen, die von Amazon Cognito verwendet werden, werden Schlüssel definiert mit cognito-identity.amazonaws.com, gefolgt von der Forderung.

Weitere Informationen zur Zuordnung von Identitätspool-Anträgen finden Sie unter Standardanbieter-Zuordnungen im Amazon-Cognito-Entwicklerhandbuch. Weitere Informationen zur Zuordnung von Benutzerpool-Anträgen finden Sie unter Verwendung des ID-Tokens im Amazon-Cognito-Entwicklerhandbuch.

AWS STS-Bedingungsschlüssel	IdP-JWT-Antrag	In der Sitzung verfügbar
amr	amr	Ja
aud	aud	Ja
oaud	aud	Nein
sub	sub	Ja

amr

Funktioniert mit Zeichenfolgenoperatoren. Der Schlüssel enthält mehrere Werte, d. h. Sie überprüfen ihn in einer Richtlinie mithilfe von Bedingungsmengenoperatoren.

Beispiel – cognito-identity.amazonaws.com:amr

Die Referenz zu Authentifizierungsmethoden enthält Anmeldeinformationen zum Benutzer. Der Schlüssel kann die folgenden Werte enthalten:

Wenn der Benutzer nicht authentifiziert wurde, enthält der Schlüssel nur unauthenticated.
Wenn der Benutzer authentifiziert wurde, enthält der Schlüssel den Wert authenticated sowie den Namen des Identitätsanbieters, der in dem Aufruf (cognito-identity.amazonaws.com) verwendet wurde.

Beispielsweise testet die folgende Bedingung in der Vertrauensrichtlinie für eine Amazon Cognito-Rolle, ob der Benutzer nicht authentifiziert ist.


"Condition": {
  "StringEquals": 
    { "cognito-identity.amazonaws.com:aud": "us-east-2:identity-pool-id" },
  "ForAnyValue:StringLike": 
    { "cognito-identity.amazonaws.com:amr": "unauthenticated" }
}

aud

Funktioniert mit Zeichenfolgenoperatoren.

Beispiel – cognito-identity.amazonaws.com:aud

Der Benutzerpool-App-Client, der Ihren Benutzer authentifiziert hat. Amazon Cognito gibt den gleichen Wert im Zugriffstoken-Anspruch client_id wieder.

oaud

Funktioniert mit Zeichenfolgenoperatoren.

Beispiel – cognito-identity.amazonaws.com:oaud

Der Benutzerpool-App-Client, der Ihren Benutzer authentifiziert hat. Amazon Cognito gibt den gleichen Wert im Zugriffstoken-Anspruch client_id wieder.

sub

Funktioniert mit Zeichenfolgenoperatoren.

Beispiel – cognito-identity.amazonaws.com:sub

Eine eindeutige ID (UUID) oder ein Betreff für den authentifizierten Benutzer. Möglicherweise ist der Benutzername in Ihrem Benutzerpool nicht eindeutig. Der sub-Antrag ist der beste Weg, um einen bestimmten Benutzer zu identifizieren. Sie können den sub-Schlüssel mit dem aud-Schlüssel für denselben Identitätsanbieter verwenden.


"Condition": {
         "StringEquals": {
            "cognito-identity.amazonaws.com:aud": "us-east-1:12345678-abcd-abcd-abcd-123456790ab",
            "cognito-identity.amazonaws.com:sub": [
               "us-east-1:12345678-1234-1234-1234-123456790ab",
               "us-east-1:98765432-1234-1234-1243-123456790ab"
            ]
         }
      }

Login with Amazon

Auf dieser Registerkarte wird erläutert, wie Login mit Amazon-OIDC-Anträge den AWS STS-Bedingungskontextschlüsseln in AWS zuordnet. Mit diesen Schlüsseln können Sie den Zugriff auf eine Rolle steuern. Vergleichen Sie dazu die AWS STS-Bedingungsschlüssel mit den Werten in der Spalte mit dem IdP-JWT-Antrag.

AWS STS-Bedingungsschlüssel	IdP-JWT-Antrag	In der Sitzung verfügbar
app_id	Anwendungs-ID	Ja
sub	Benutzer-ID	Ja
user_id	Benutzer-ID	Ja

app_id

Funktioniert mit Zeichenfolgenoperatoren.

Beispiel – www.amazon.com:app_id

Dieser Schlüssel gibt den Zielgruppenkontext an, der mit dem von anderen Identitätsanbietern verwendeten aud-Feld übereinstimmt.

sub

Funktioniert mit Zeichenfolgenoperatoren.

Beispiel – www.amazon.com:sub

Dieser Schlüssel überprüft, ob die Benutzer-ID mit der in der Richtlinie angegebenen übereinstimmt. Sie können den sub -Schlüssel mit dem aud-Schlüssel für denselben Identitätsanbieter verwenden.

user_id

Funktioniert mit Zeichenfolgenoperatoren.

Beispiel – www.amazon.com:user_id

Dieser Schlüssel gibt den Zielgruppenkontext an, der dem von anderen Identitätsanbietern verwendeten aud-Feld entspricht. Sie können den user_id-Schlüssel mit dem id-Schlüssel für denselben Identitätsanbieter verwenden.

Facebook

Auf dieser Registerkarte wird erläutert, wie Facebook OIDC-Anträge den AWS STS-Bedingungskontextschlüsseln in AWS zuordnet. Mit diesen Schlüsseln können Sie den Zugriff auf eine Rolle steuern. Vergleichen Sie dazu die AWS STS-Bedingungsschlüssel mit den Werten in der Spalte mit dem IdP-JWT-Antrag.

AWS STS-Bedingungsschlüssel	IdP-JWT-Antrag	In der Sitzung verfügbar
app_id	Anwendungs-ID	Ja
id	id	Ja

app_id

Funktioniert mit Zeichenfolgenoperatoren.

Beispiel – graph.facebook.com:app_id

Dieser Schlüssel überprüft, ob der Zielgruppenkontext mit dem von anderen Identitätsanbietern verwendeten aud-Feld übereinstimmt.

id

Funktioniert mit Zeichenfolgenoperatoren.

Beispiel – graph.facebook.com:id

Dieser Schlüssel hat bestätigt, dass die ID der Anwendung (oder Website) mit der in der Richtlinie angegebenen übereinstimmt.

Weitere Informationen zum OIDC-Verbund

Verfügbare Schlüssel für SAML-basierten AWS STS-Verbund

Wenn Sie mit einem SAML-basierten Verbund mit AWS Security Token Service (AWS STS) arbeiten, können Sie in der Richtlinie weitere Bedingungsschlüssel verwenden.

Vertrauensrichtlinien der SAML-Rolle

Sie können in der Vertrauensrichtlinie einer Rolle die folgenden Schlüssel verwenden, um festzustellen, ob der Aufrufer die Rolle übernehmen darf. Abgesehen von saml:doc werden alle Werte aus der SAML-Zusicherung abgeleitet. Alle Elemente in der Liste sind im visuellen Editor der IAM-Konsole verfügbar, wenn Sie eine Richtlinie mit Bedingungen erstellen oder bearbeiten. Elemente, die mit [] gekennzeichnet sind, können einen Wert enthalten, der eine Liste des angegebenen Typs ist.

saml:aud

Funktioniert mit Zeichenfolgenoperatoren.

Eine Endpunkt-URL, für die SAML-Zusicherungen bereitgestellt werden. Der Wert dieses Schlüssels stammt aus dem Feld SAML Recipient der Zusicherung, nicht aus dem Feld Audience.

saml:commonName[]

Funktioniert mit Zeichenfolgenoperatoren.

Dies ist ein commonName-Attribut.

saml:cn[]

Funktioniert mit Zeichenfolgenoperatoren.

Hierbei handelt es sich um ein eduOrg-Attribut.

saml:doc

Funktioniert mit Zeichenfolgenoperatoren.

Dieser Schlüssel steht für den Auftraggeber, der zum Übernehmen der Rolle verwendet wurde. Das Format ist Konto-ID/Anzeigename des Anbieters, z. B. 123456789012/SAMLProviderName. Der Wert Konto-ID bezieht sich auf das Konto, zu dem der SAML-Anbieter gehört.

saml:edupersonaffiliation[]

Funktioniert mit Zeichenfolgenoperatoren.