Verfügbare Schlüssel für IAM Verfügbare Schlüssel für den AWS OIDC Verbund Verfügbare Schlüssel für den SAML basierten AWS STS Verbund Dienstübergreifende SAML AWS STS Verbundkontextschlüssel Verfügbare Schlüssel für AWS STS

IAMund AWS STS Bedingungskontexttasten

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. Auf diese Weise haben Sie eine detaillierte Kontrolle darüber, wann Ihre JSON Richtlinienaussagen mit einer eingehenden Anfrage übereinstimmen oder nicht. Informationen zur Verwendung des Condition Elements in einer JSON Richtlinie finden Sie unterIAM-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 (AWS STS) (mit einem sts: Präfix) definiert und bereitgestellt werden. Verschiedene andere AWS Dienste stellen ebenfalls 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 den AWS OIDC Verbund
Verfügbare Schlüssel für den SAML basierten AWS STS Verbund
Dienstübergreifende SAML 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:

Ich bin: AssociatedResourceArn

Funktioniert mit ARNOperatoren.

Gibt ARN die Ressource an, der diese Rolle im Zieldienst 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önnten beispielsweise eine Rolle an Amazon EC2 Auto Scaling übergeben, die sie auf einer EC2 Amazon-Instance verwenden. In diesem Fall würde die Bedingung mit der ARN der EC2 Amazon-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.

Wichtig

Wenn die iam:AssociatedResourceArn Bedingung in einer Richtlinie verwendet wird, um die PassRoleAktion einzuschränken, gelten besondere Überlegungen, wenn die Richtlinie den Zugriff für die AddRoleToInstanceProfileAktion definieren soll. In diesem Fall können Sie in der Instanz keine Regions- oder EC2 Instanz-ID angebenARN. Der ARN-Wert muss arn:aws:ec2:*:CallerAccountId:instance/* lauten. Die Verwendung eines anderen ARN Werts kann zu unerwarteten Bewertungsergebnissen 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. Sie können beispielsweise zulassen, dass ein IAM Benutzer oder eine Rolle eine beliebige Rolle an den EC2 Amazon-Service weitergibt, der mit Instances in der verwendet werden kann AWS-Konto. Der IAM Benutzer oder die Rolle darf keine Rollen an andere Dienste weitergeben.


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

Anmerkung

AWS Dienste, die iam: unterstützen, 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 -Zertifizierung

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 FIDOAlliance Metadata Service abgerufen (MDS). Wenn sich der Zertifizierungsstatus oder die Stufe Ihres FIDO Sicherheitsschlüssels ändert, wird er nicht aktualisiert, es sei denn, das Gerät wird nicht registriert 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 rufen die FIDO Level-1-Plus-Zertifizierung für Ihr Gerät ab.


{
      "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 -140-2-Zertifizierung FIPS

Funktioniert mit Zeichenfolgenoperatoren.

Überprüft die Validierungszertifizierungsstufe FIPS -140-2 für MFA das Gerät zum Zeitpunkt der Registrierung eines Sicherheitsschlüssels. FIDO Die Gerätezertifizierung wird vom FIDOAlliance Metadata Service abgerufen (). MDS Wenn sich der Zertifizierungsstatus oder die Stufe Ihres FIDO Sicherheitsschlüssels ändert, wird er nicht aktualisiert, es sei denn, das Gerät wird nicht registriert 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 rufen die FIPS -140-2 Level 2-Zertifizierung für Ihr Gerät ab.


{
      "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: - -140-3-Zertifizierung FIDO FIPS

Funktioniert mit Zeichenfolgenoperatoren.

Überprüft die Validierungszertifizierungsstufe FIPS -140-3 für MFA das Gerät zum Zeitpunkt der Registrierung eines Sicherheitsschlüssels. FIDO Die Gerätezertifizierung wird vom FIDOAlliance Metadata Service abgerufen (). MDS Wenn sich der Zertifizierungsstatus oder die Stufe Ihres FIDO Sicherheitsschlüssels ändert, wird er nicht aktualisiert, es sei denn, das Gerät wird nicht registriert 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 rufen die FIPS -140-3 Level 3-Zertifizierung für Ihr Gerät ab.


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

Überprüft den aktuellen Status der MFA Geräteaktivierung.

Mögliche Werte von Create oder Activate.

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


{
      "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 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 oben genannten Richtlinie versucht, eine Servicerolle für Amazon zu erstellenEC2, schlägt der Vorgang fehl. Der Fehler tritt auf, weil der Benutzer nicht berechtigt ist, die Rolle an Amazon weiterzugebenEC2.

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 ARNOperatoren.

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

Ich bin: Richtlinie ARN

Funktioniert mit Operatoren. ARN

Überprüft den Amazon-Ressourcennamen (ARN) einer verwalteten Richtlinie in Anfragen, die eine verwaltete Richtlinie betreffen. Weitere Informationen finden Sie unter Steuern des Zugriffs auf Richtlinien.

Ich bin:/ResourceTagkey-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

IAMund AWS STS unterstützt 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 die Richtlinie italicized placeholder text im Beispiel 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 den AWS 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 an einen IAM OpenID Connect (OIDC) -Identitätsanbieter in Ihrem Konto zu geben. AWS Beispiele für solche Anbieter sind GitHub Amazon Cognito, Login with Amazon und Google. Es können Identitäts- und Zugriffs-Tokens 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 Verbundbenutzern 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 anhand 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 AWS Diensten zugreifen dürfen. 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 Weitere Informationen zu Schlüsseln für GitHub und Google finden Sie auf der Registerkarte Standard.

Default

In der Standardeinstellung werden die OIDC Standardansprüche und ihre Zuordnung zu den AWS STS Bedingungskontexten in aufgeführt 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 JWTIdP-Anspruch. Verwenden Sie diese Zuordnung, wenn Ihr IdP nicht in den Registerkartenoptionen 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-Anspruch JWT	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
email	email	Nein
oaud	aud	Nein
sub	sub	Ja

Weitere Hinweise zur Verwendung von OIDC Bedingungskontextschlüsseln mit finden Sie GitHub unterKonfigurieren 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:

audfür den Google-Client OAuth 2.0 IDs Ihrer Anwendung, wenn das azp Feld 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 Hybrid-Apps der Fall sein, bei denen eine Webanwendung und eine Android-App eine unterschiedliche OAuth 2.0-Google-Client-ID haben, aber dasselbe APIs Google-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 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 sich um einen der OAuth 2.0-Clients IDs Ihrer Anwendung handeln.

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 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 JWTIdP-Anspruch.

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-Anspruch JWT	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 Kennung (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.


{
   "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 „Mit Amazon Maps anmelden“ OIDC behauptet, 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 JWTIdP-Anspruch.

AWS STS Bedingungsschlüssel	IdP-Anspruch JWT	In 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 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 erklärt, wie Facebook OIDC Ansprüche zuordnet, um Kontext-Keys 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 JWTIdP-Anspruch.

AWS STS Bedingungsschlüssel	IdP-Anspruch JWT	In 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 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 zur Föderation OIDC

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

Wenn Sie mit einem SAMLbasierten Verbund arbeiten, der AWS Security Token Service (AWS STS) verwendet, können Sie zusätzliche Bedingungsschlüssel in die Richtlinie aufnehmen.

SAMLRichtlinien für Rollenvertrauensstellungen

Sie können in der Vertrauensrichtlinie einer Rolle die folgenden Schlüssel verwenden, um festzustellen, ob der Aufrufer die Rolle übernehmen darf. Mit Ausnahme saml:doc von werden alle Werte aus der SAML Behauptung 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.

Ein EndpunktURL, an dem SAML Behauptungen präsentiert 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 istaccount-ID/provider-friendly-name, zum Beispiel123456789012/SAMLProviderName. Der Account-ID-Wert bezieht sich auf das Konto, dem der Anbieter gehört. SAML

saml:edupersonaffiliation[]

Funktioniert mit Zeichenfolgenoperatoren.