Auf dieser Seite wird beschrieben, wie Sie Probleme mit IAM-Zulassungsrichtlinien (Identity and Access Management), Ablehnungsrichtlinien, Principal Access Boundary-Richtlinien und Unified Access Policies (UAPs) beheben.
Policy Troubleshooter verwenden
Wenn Sie Probleme mit dem Zugriff für ein bestimmtes Hauptkonto beheben müssen, verwenden Sie die Richtlinien-Fehlerbehebung für IAM.
Mit Policy Troubleshooter können Sie nachvollziehen, ob ein Hauptkonto auf eine Ressource zugreifen kann. Mit der Angabe eines Hauptkontos, einer Ressource und einer Berechtigung wertet Policy Troubleshooter die Zulassungsrichtlinien, Ablehnungsrichtlinien und Principal Access Boundary-Richtlinien (PAB) aus, die sich auf den Zugriff des Hauptkontos auswirken. Anschließend wird Ihnen mitgeteilt, ob das Hauptkonto basierend auf diesen Richtlinien die angegebene Berechtigung für den Zugriff auf die Ressource verwenden kann. Außerdem werden die relevanten Richtlinien aufgelistet und erläutert, wie sie sich auf den Zugriff des Hauptkontos auswirken.Policy Troubleshooter unterstützt die Fehlerbehebung bei UAPs nicht. Informationen zur Fehlerbehebung bei UAPs finden Sie auf dieser Seite unter Manuelle Fehlerbehebung.
Informationen zur Fehlerbehebung bei Zulassungsrichtlinien, Ablehnungsrichtlinien und Principal Access Boundary-Richtlinien mit Policy Troubleshooter finden Sie unter Fehlerbehebung bei IAM-Berechtigungen.
Zulassungsrichtlinie suchen
Wenn Sie eine bestimmte Rollenbindung in einer Zulassungsrichtlinie suchen müssen, können Sie in der Zulassungsrichtlinie suchen.
Mit Cloud Asset Inventory können Sie in Zulassungsrichtlinien nach Rollenbindungen suchen, die mit den angegebenen Parametern übereinstimmen. Sie können eine Vielzahl von Suchparametern verwenden, darunter:
- Ressourcentyp
- Hauptkonto-Typ
- Rolle
- Projekt
- Ordner
- Organisation
Weitere Informationen finden Sie unter IAM-Zulassungsrichtlinien suchen.
Manuelle Fehlerbehebung
Wenn Sie den Zugriff eines Hauptkontos auf eine Ressource manuell beheben möchten, prüfen Sie alle Richtlinien, die sich auf den Zugriff des Hauptkontos auswirken können.
Erforderliche Rollen
Wenn Sie alle Richtlinien prüfen möchten, die sich auf den Zugriff eines Hauptkontos auswirken, benötigen Sie die Berechtigung zum Aufrufen von Zulassungsrichtlinien, Ablehnungsrichtlinien, UAP-Bindungen und UAPs.
Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Sicherheitsprüfer (roles/iam.securityReviewer) für die Organisation zuzuweisen, die die Ressource enthält, um die Berechtigungen zu erhalten, die Sie zum Aufrufen aller Zulassungs- und Ablehnungsrichtlinien benötigen.
Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für die Organisation zuzuweisen, die die Ressource enthält, um die Berechtigungen zu erhalten, die Sie benötigen, um alle UAP-Bindungen aufzurufen, die sich auf eine Zielressource auswirken:
- Organization Administrator (
roles/resourcemanager.organizationAdmin) -
Bindungen für dienstspezifische Ressourcen auflisten: Eine Rolle mit der Berechtigung
SERVICE.RESOURCE.searchPolicyBindings, wobeiRESOURCEder Ressourcentyp undSERVICEder Dienst ist, zu dem die Ressource gehört.
Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.
Diese vordefinierten Rollen enthalten die Berechtigungen, die zum Aufrufen aller UAP-Bindungen erforderlich sind, die sich auf eine Zielressource auswirken. Maximieren Sie den Abschnitt Erforderliche Berechtigungen, um die notwendigen Berechtigungen anzuzeigen:
Erforderliche Berechtigungen
Die folgenden Berechtigungen sind erforderlich, um alle UAP-Bindungen aufzurufen, die sich auf eine Zielressource auswirken:
-
Bindungen für Organisationen auflisten:
resourcemanager.organizations.searchPolicyBindings -
Bindungen für Ordner auflisten:
resourcemanager.folders.searchPolicyBindings -
Bindungen für Projekte auflisten:
resourcemanager.projects.searchPolicyBindings -
Bindungen für dienstspezifische Ressourcen auflisten:
SERVICE.RESOURCE.searchPolicyBindings
Sie können diese Berechtigungen auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.
Bitten Sie Ihren Administrator, Ihnen Rollen zuzuweisen, mit denen Sie Bindungen für diese Ressource und die übergeordneten Ressourcen dieser Ressource auflisten können, um die Berechtigungen zu erhalten, die Sie zum Aufrufen aller UAP-Bindungen benötigen, die sich auf eine Zielressource auswirken. Diese Rollen müssen die Berechtigung SERVICE.RESOURCE.searchPolicyBindings enthalten, wobei RESOURCE der Zielressourcentyp und SERVICE der Dienst ist, zu dem die Ressource gehört.
Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Access Policy Viewer (roles/iam.accessPolicyViewer) für die Organisation zuzuweisen, die die Ressource enthält, um die Berechtigungen zu erhalten, die Sie zum Aufrufen aller UAPs benötigen.
Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.
Diese vordefinierte Rolle enthält die Berechtigungen, die zum Aufrufen aller UAPs erforderlich sind. Maximieren Sie den Abschnitt Erforderliche Berechtigungen, um die notwendigen Berechtigungen anzuzeigen:
Erforderliche Berechtigungen
Die folgenden Berechtigungen sind erforderlich, um alle UAPs aufzurufen:
-
Bindungen für Organisationen auflisten:
resourcemanager.organizations.searchPolicyBindings -
Bindungen für Ordner auflisten:
resourcemanager.folders.searchPolicyBindings -
Bindungen für Projekte auflisten:
resourcemanager.projects.searchPolicyBindings -
Bindungen für dienstspezifische Ressourcen auflisten:
SERVICE.RESOURCE.searchPolicyBindings
Sie können diese Berechtigungen auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.
Alle Zulassungs- und Ablehnungsrichtlinien ansehen, die für eine Ressource gelten
In Google Cloudwirken sich die folgenden Zulassungs- und Ablehnungsrichtlinien auf den Zugriff auf eine Ressource aus:
- Zulassungsrichtlinie der Ressource
- Ablehnungsrichtlinien der Ressource, falls vorhanden
- Die Zulassungsrichtlinien des übergeordneten Projekts, des Ordners und der Organisation der Ressource, sofern vorhanden
- Ablehnungsrichtlinien des übergeordneten Projekts, des Ordners und der Organisation der Ressource, falls vorhanden
Die Richtlinien zum Zulassen oder Ablehnen von übergeordneten Projekten, Ordnern und Organisationen wirken sich aufgrund der Richtlinienübernahme auf den Zugriff auf eine Ressource aus. Wenn Sie eine Zulassung- oder Ablehnungsrichtlinie an ein Projekt, einen Ordner oder eine Organisation anhängen, gilt diese Richtlinie auch für alle Ressourcen innerhalb dieses Projekts, Ordners oder dieser Organisation.
Wenn eine Ablehnungsrichtlinie für eine Organisation beispielsweise besagt, dass ein Hauptkonto keine bestimmte Berechtigung verwenden kann, kann das Hauptkonto diese Berechtigung nicht für eine Ressource innerhalb der Organisation verwenden. Diese Regel gilt auch dann, wenn die Ordner und Projekte innerhalb dieser Organisation striktere Ablehnungsrichtlinien haben oder Richtlinien zulassen, die dem Hauptkonto die Berechtigung erteilen.
Wenn eine „allow”-Richtlinie für ein Projekt einem Hauptkonto eine bestimmte Berechtigung erteilt, hat das Hauptkonto diese Berechtigung für jede Ressource innerhalb des Projekts, sofern ihm diese Berechtigung nicht verweigert wird.
Die Vereinigung aller dieser Richtlinien wird als entsprechende Richtlinie oder effektive Richtlinie für die Ressource bezeichnet.
In Google Cloudkönnen Sie mit dem Befehl gcloud beta projects
get-ancestors-iam-policy mit dem Flag --include-deny eine Liste aller Zulassungs- und Ablehnungsrichtlinien abrufen, die sich auf den Zugriff auf ein Projekt auswirken. Zusammen bilden diese Richtlinien die geltende Richtlinie für das Projekt. Sie können jede Richtlinie untersuchen, um zu sehen, wie sie sich auf den Zugriff des Hauptkontos auswirkt.
gcloud
Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:
PROJECT_ID: Ihre Projekt-ID in Google Cloud . Projekt-IDs sind alphanumerische Strings, wiemy-project.
Führen Sie den Befehl gcloud beta projects get-ancestors-iam-policy aus:
Linux, macOS oder Cloud Shell
gcloud beta projects get-ancestors-iam-policy PROJECT_ID --include-deny --format=json
Windows (PowerShell)
gcloud beta projects get-ancestors-iam-policy PROJECT_ID --include-deny --format=json
Windows (cmd.exe)
gcloud beta projects get-ancestors-iam-policy PROJECT_ID --include-deny --format=json
Die Antwort enthält die Richtlinien zum Zulassen oder Ablehnen des Projekts, alle Ordner, die Ancestors des Projekts sind und die Organisation. Das folgende Beispiel zeigt Zulassungsrichtlinien für die Organisation 1234567890123 und das Projekt my-project sowie eine Ablehnungsrichtlinie für das Projekt my-project:
[
{
"id": "1234567890123",
"policy": {
"bindings": [
{
"members": [
"group:cloud-admins@example.com"
],
"role": "roles/iam.denyAdmin"
},
{
"members": [
"user:raha@example.com"
],
"role": "roles/iam.serviceAccountAdmin"
}
],
"etag": "BwXW6Eab7TI=",
"version": 1
},
"type": "organization"
},
{
"id": "my-project",
"policy": {
"bindings": [
{
"members": [
"group:cloud-admins@example.com"
],
"role": "roles/owner"
}
],
"etag": "BwXXjOM7L6M=",
"type": "project"
}
},
{
"id": "my-project",
"policy": {
"createTime": "2022-02-14T21:46:35.865279Z",
"displayName": "My deny policy",
"etag": "MTgyMzg2ODcwNTEyMjMxMTM3Mjg=",
"kind": "DenyPolicy",
"name": "policies/cloudresourcemanager.googleapis.com%2Fprojects%2F123456789012/denypolicies/my-deny-policy",
"rules": [
{
"denyRule": {
"deniedPermissions": [
"iam.googleapis.com/serviceAccounts.create"
],
"deniedPrincipals": [
"user:raha@example.com"
]
},
"description": "Prevent service account creation"
}
],
"uid": "c83e3dc3-d8a6-6f51-4018-814e9f200b05",
"updateTime": "2022-02-14T21:46:35.865279Z"
},
"type": "project"
}
]
In diesem Beispiel hat Raha die Rolle „Dienstkonto-Administrator“ (roles/iam.serviceAccountAdmin) für die Organisation, aber das Projekt hat eine Ablehnungsrichtlinie, die Raha daran hindert, die Berechtigung iam.googleapis.com/serviceAccounts.create zu verwenden. Wenn Raha versucht, ein Dienstkonto im Projekt my-project zu erstellen, wird die Anfrage daher abgelehnt.
In einigen Fällen müssen Sie möglicherweise nur die geltende Zulassungsrichtlinie für eine Ressource aufrufen, z. B. wenn Ihre Organisation keine Ablehnungsrichtlinien verwendet. In diesen Fällen können Sie die folgenden Methoden mit den folgenden Methoden aufrufen, um die geltende Zulassungsrichtlinie aufzurufen:
Rufen Sie die IAM-Zulassungsrichtlinie der Ressource in derGoogle Cloud Console auf. In der Google Cloud Console wird automatisch die geltende Richtlinie jeder Ressource angezeigt.
Informationen zum Aufrufen der IAM-Zulassungsrichtlinie einer Ressource in derGoogle Cloud Console finden Sie unter Aktuellen Zugriff ansehen.
Verwenden Sie die Cloud Asset API, um die geltende Zulassungsrichtlinie der Ressource abzurufen. Weitere Informationen finden Sie unter Geltende IAM-Richtlinien aufrufen.
Alle Unified Access Policies ansehen, die für eine Ressource gelten
So rufen Sie alle UAPs auf, die für eine Zielressource gelten:
Console
- Identifizieren Sie alle übergeordneten Ressourcen der Zielressource. Die übergeordneten Ressourcen sind alle Projekte, Ordner und Organisationen, die sich in der Ressourcenhierarchie über der Ressource befinden.
- An die einzelnen übergeordneten Ressourcen gebundene UAP ansehen Wenn das Hauptkonto in der UAP erwähnt wird, kann sich das auf den Zugriff des Hauptkontos auf die Zielressource auswirken.
gcloud
- Identifizieren Sie alle übergeordneten Ressourcen der Zielressource. Die übergeordneten Ressourcen sind alle Projekte, Ordner und Organisationen, die sich in der Ressourcenhierarchie über der Ressource befinden.
- Listen Sie UAP-Bindungen für die Zielressource und jeden Ancestor der Zielressource auf. Notieren Sie sich die Richtlinien-IDs in jeder Bindung.
- Sehen Sie sich die einzelnen UAPs in jeder abgerufenen Bindung an. Wenn das Hauptkonto in der UAP erwähnt wird, kann sich dies auf den Zugriff des Hauptkontos auf die Zielressource auswirken.
REST
- Identifizieren Sie alle übergeordneten Ressourcen der Zielressource. Die übergeordneten Ressourcen sind alle Projekte, Ordner und Organisationen, die sich in der Ressourcenhierarchie über der Ressource befinden.
- Listen Sie UAP-Bindungen für die Zielressource und jeden Ancestor der Zielressource auf. Notieren Sie sich die Richtlinien-IDs in jeder Bindung.
- Sehen Sie sich die einzelnen UAPs in jeder abgerufenen Bindung an. Wenn das Hauptkonto in der UAP erwähnt wird, kann sich dies auf den Zugriff des Hauptkontos auf die Zielressource auswirken.