Verfügbare Schlüssel für IAM Verfügbare Schlüssel für AWS den OIDC-Verbund Verfügbare Schlüssel für SAML-basierten AWS STS -Verbund Dienstübergreifende SAML-basierte Verbundkontextschlüssel AWS STS 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 Anfragen 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.

In diesem Thema werden die Schlüssel beschrieben, die vom IAM-Dienst (mit einem iam: Präfix) und dem Dienst () AWS Security Token Service (mit einem sts: Präfix AWS STS) definiert und bereitgestellt werden. Verschiedene andere AWS Dienste stellen auch dienstspezifische Schlüssel bereit, die für die von diesem Dienst definierten Aktionen und Ressourcen relevant sind. Weitere Informationen finden Sie unter Aktionen, Ressourcen und Bedingungsschlüssel für AWS Dienste. 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 den OIDC-Verbund
Verfügbare Schlüssel für SAML-basierten AWS STS -Verbund
Dienstübergreifende SAML-basierte Verbundkontextschlüssel AWS STS
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:

Ich bin: 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 PassRoleAktion in einer Richtlinie. Er kann nicht verwendet werden, um eine andere Aktion zu beschränken.

Verwenden Sie diesen Bedingungsschlüssel in einer Richtlinie, um einer Entität das Übergeben einer Rolle zu ermöglichen, jedoch nur, wenn diese Rolle der angegebenen Ressource zugeordnet ist. Sie können Platzhalter (*) verwenden, um Vorgänge zu ermöglichen, die für einen bestimmten Ressourcentyp ausgeführt werden, ohne die Regions- oder Ressourcen-ID einzuschränken. Beispielsweise können Sie einem IAM-Benutzerus-east-1 oder einer entsprechenden Rolle erlauben, eine beliebige Rolle an den Amazon EC2-Service zu übergeben, die mit Instances in der Region oder us-west-1 verwendet werden soll. Der IAM-Benutzer oder die IAM-Rolle wäre nicht berechtigt, Rollen an andere Services zu übergeben. Darüber hinaus ermöglicht Amazon EC2 nicht, die Rolle mit Instances in anderen Regionen zu verwenden.


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

Anmerkung

AWS Dienste, die iam: unterstützen PassedToService auch diesen Bedingungsschlüssel.

Ich bin: AWSServiceName

Funktioniert mit Zeichenfolgenoperatoren.

Gibt den AWS Dienst an, dem diese Rolle zugewiesen ist.

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


{
   "Version": "2012-10-17",
   "Statement": [{
       "Effect": "Allow",
       "Action": "iam:CreateServiceLinkedRole",
       "Resource": "*",
       "Condition": {
         "StringLike": {
           "iam:AWSServiceName": "access-analyzer.amazonaws.com"
         }
       }
     }]
 }

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.


{
      "Version": "2012-10-17",
      "Statement": [{
            "Effect": "Allow",
            "Action": "iam:EnableMFADevice",
            "Resource": "*",
            "Condition": {
                "StringEquals": {
                    "iam:RegisterSecurityKey" : "Create"
                }
            }
        },
        {
            "Effect": "Allow",
            "Action": "iam:EnableMFADevice",
            "Resource": "*",
            "Condition": {
                "StringEquals": {
                    "iam:RegisterSecurityKey" : "Activate",
                    "iam:FIDO-certification": "L1plus"
                }
            }
        }
    ]
                  
 }

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.


{
      "Version": "2012-10-17",
      "Statement": [{
            "Effect": "Allow",
            "Action": "iam:EnableMFADevice",
            "Resource": "*",
            "Condition": {
                "StringEquals": {
                    "iam:RegisterSecurityKey" : "Create"
                }
            }
        },
        {
            "Effect": "Allow",
            "Action": "iam:EnableMFADevice",
            "Resource": "*",
            "Condition": {
                "StringEquals": {
                    "iam:RegisterSecurityKey" : "Activate",
                    "iam:FIDO-FIPS-140-2-certification": "L2"
                }
            }
        }
    ]
                  
 }

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.


{
      "Version": "2012-10-17",
      "Statement": [{
            "Effect": "Allow",
            "Action": "iam:EnableMFADevice",
            "Resource": "*",
            "Condition": {
                "StringEquals": {
                    "iam:RegisterSecurityKey" : "Create"
                }
            }
        },
        {
            "Effect": "Allow",
            "Action": "iam:EnableMFADevice",
            "Resource": "*",
            "Condition": {
                "StringEquals": {
                    "iam:RegisterSecurityKey" : "Activate",
                    "iam:FIDO-FIPS-140-3-certification": "L3"
                }
            }
        }
    ]
                  
 }

ich bin: 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.


{
      "Version": "2012-10-17",
      "Statement": [{
            "Effect": "Allow",
            "Action": "iam:EnableMFADevice",
            "Resource": "*",
            "Condition": {
                "StringEquals": {
                    "iam:RegisterSecurityKey" : "Create"
                }
            }
        },
        {
            "Effect": "Allow",
            "Action": "iam:EnableMFADevice",
            "Resource": "*",
            "Condition": {
                "StringEquals": {
                    "iam:RegisterSecurityKey" : "Activate",
                    "iam:FIDO-FIPS-140-3-certification": "L1"
                }
            }
        }
    ]
                  
 }

ich bin: OrganizationsPolicyId

Funktioniert mit Zeichenfolgenoperatoren.

Überprüft, ob die Richtlinie mit der angegebenen AWS Organizations ID mit der in der Anfrage 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 Organizations-Richtlinie.

ich bin: 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 PassRoleAktion 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 ServiceAuftraggeber ist der Name eines Services, 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. Beispielsweise könnte ein Benutzer eine Servicerolle erstellen, die CloudWatch darauf vertraut, in seinem Namen Protokolldaten in einen Amazon S3 S3-Bucket zu schreiben. 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. Eine Richtlinie, an die der Benutzer die Rolle übergeben kann CloudWatch, finden Sie unterIAM: Übergeben Sie eine IAM-Rolle an einen bestimmten Dienst AWS.

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.

ich bin: 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:/Schlüsselname ResourceTag

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 globalen Bedingungsschlüssel. aws:ResourceTag

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 Markieren von IAM-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.


{
    "Version": "2012-10-17",
    "Statement": [{
        "Effect": "Allow",
        "Action": "iam:DeleteUser",
        "Resource": "*",
        "Condition": {"StringEquals": {"iam:ResourceTag/status": "terminated"}}
    }]
}

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

Sie können den OIDC-Verbund verwenden, um Benutzern, die über einen OpenID Connect-kompatiblen Identitätsanbieter (IdP) authentifiziert wurden, temporäre Sicherheitsanmeldedaten für einen IAM OpenID Connect (OIDC) -Identitätsanbieter in Ihrem Konto zuzuweisen. AWS Beispiele für solche Anbieter sind GitHub Amazon Cognito, Login with Amazon und Google. Identitätstoken und Zugriffstoken von Ihrem eigenen IdP können ebenso verwendet werden wie Dienstkonto-Token, die Amazon Elastic Kubernetes Service Service-Workloads gewährt wurden.

Sie können AWS OIDC-Bedingungskontextschlüssel verwenden, um Richtlinien zu schreiben, die den Zugriff verbundener Benutzer 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 mithilfe des Namens des OIDC-Anbieters (token.actions.githubusercontent.com), gefolgt von einem Anspruch ():. :aud token.actions.githubusercontent.com:aud

Einige OIDC-Verbundbedingungsschlüssel können in der Rollensitzung verwendet werden, um den Ressourcenzugriff zu autorisieren. Wenn der Wert in der Spalte In Sitzung verfügbar auf Ja steht, können Sie diese Bedingungsschlüssel in Richtlinien verwenden, um zu definieren, auf welche Benutzer in anderen Diensten zugreifen dürfen. AWS Wenn ein Anspruch in einer Sitzung nicht verfügbar ist, kann der OIDC-Bedingungskontextschlüssel nur in einer Rollenvertrauensrichtlinie für die AssumeRoleWithWebIdentityErstauthentifizierung verwendet werden.

Wählen Sie Ihren IdP aus, um zu sehen, wie Ansprüche Ihres IdP dem IAM-Bedingungskontext zugeordnet werden. AWS

Default

In der Standardeinstellung werden die Standard-OIDC-Ansprüche aufgeführt und wie sie den Bedingungskontextschlüsseln zugeordnet AWS STS werden. AWS 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 IdP JWT Claim. Verwenden Sie diese Zuordnung, wenn Ihr IdP nicht in den Tab-Optionen aufgeführt ist.

GitHub Actions, Workflows und Google sind einige Beispiele dafür IdPs , die Standardimplementierung in ihrem OIDC JWT-ID-Token verwenden.

AWS STS Bedingungsschlüssel	IdP JWT-Anspruch	Während der Sitzung verfügbar
amr	amr	Ja
aud	azp Wenn kein Wert für angegeben ist`azp`, wird der `aud` Bedingungsschlüssel dem `aud` Anspruch zugeordnet.	Ja
email	email	Nein
oaud	aud	Nein
sub	sub	Ja

Weitere Hinweise zur Verwendung von OIDC-Bedingungskontextschlüsseln mit GitHub finden Sie unter. Konfiguration 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 über den 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 ist, enthält der Schlüssel den Wert authenticated und den Namen des Anmeldeanbieters, der im Call (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 der Zielgruppe entspricht, die Sie in der Richtlinie angegeben haben. Sie können den AUD-Schlüssel zusammen mit dem Unterschlü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.


{
    "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.


{
    "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 möglicherweise nicht eindeutig auf dieses Konto beschränkt 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 Betreff übereinstimmt, den Sie in der Richtlinie angegeben haben. 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 sub Bedingungsschlüssel die Rolle auf den GitHib angegebenen Zweigdemo.


{
   "Version": "2012-10-17",
   "Statement": [
      "Condition": {
         "StringEquals": {
            "token.actions.githubusercontent.com:aud": "sts.amazonaws.com",
            "token.actions.githubusercontent.com:sub": "repo:octo-org/octo-repo:ref:refs/heads/demo"
         }
      }
   ]
}

Amazon Cognito

Auf dieser Registerkarte wird erklärt, wie Amazon Cognito OIDC-Ansprüche den AWS STS Bedingungskontextschlüsseln zuordnet. AWS 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 IdP JWT Claim.

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-Ansprüchen finden Sie unter Standardanbieterzuordnungen im Amazon Cognito Developer Guide. Weitere Informationen zur Zuordnung von Benutzerpool-Ansprüchen finden Sie unter Verwenden des ID-Tokens im Amazon Cognito Developer Guide.

AWS STS Bedingungsschlüssel	IdP JWT-Anspruch	Während 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 über den 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 ist, enthält der Schlüssel den Wert authenticated und den Namen des Anmeldeanbieters, der im Call (cognito-identity.amazonaws.com) verwendet wurde.

Beispielsweise testet die folgende Bedingung in der Vertrauensrichtlinie für eine Amazon Cognito 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 Unteranspruch 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.


{
   "Version": "2012-10-17",
   "Statement": [
      "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 erklärt, wie Login with Amazon OIDC-Behauptungen zuordnet, um Kontextschlüssel zu AWS STS konditionieren. AWS 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 IdP JWT Claim.

AWS STS Bedingungsschlüssel	IdP JWT-Anspruch	Während der Sitzung verfügbar
app_id	Application 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 dem von anderen Identitätsanbietern verwendeten aud Feld entspricht.

sub

Funktioniert mit Zeichenfolgenoperatoren.

Beispiel — www.amazon.com:sub

Dieser Schlüssel überprüft, ob die Benutzer-ID mit der übereinstimmt, die Sie in der Richtlinie angegeben haben. 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 zusammen mit dem id Schlüssel für denselben Identitätsanbieter verwenden.

Facebook

Auf dieser Registerkarte wird erklärt, wie Facebook OIDC-Behauptungen zuordnet, um Kontexteingaben zu konditionieren AWS STS . AWS 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 IdP JWT Claim.

AWS STS Bedingungsschlüssel	IdP JWT-Anspruch	Während der Sitzung verfügbar
app_id	Application 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 aud Feld übereinstimmt, das von anderen Identitätsanbietern verwendet wird.

id

Funktioniert mit Zeichenfolgenoperatoren.

Beispiel — graph.facebook.com:id

Mit diesem Schlüssel wurde überprüft, ob die Anwendungs- (oder Site-) ID mit der ID übereinstimmt, die Sie in der Richtlinie angegeben haben.

Weitere Informationen zum OIDC-Verbund

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

Wenn Sie mit einem SAML-basierten Verbund mithilfe von AWS Security Token Service (AWS STS) arbeiten, können Sie zusätzliche Bedingungsschlüssel in die Richtlinie aufnehmen.

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 Account-ID/provider-friendly-name, 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.