In diesem Dokument wird beschrieben, wie Sie Cloud de Confiance by S3NS -Ordner als Mitglieder in Dienstperimetern konfigurieren.
Hinweis
Prüfen Sie, ob Sie die erforderlichen Berechtigungen zum Erstellen und Verwalten von Dienstperimetern (
roles/accesscontextmanager.policyAdmin) haben.Ermitteln Sie die IDs der Ordner, die Sie Dienstperimetern hinzufügen möchten.
Ordner zu einem Perimeter hinzufügen
Sie können einen Perimeter so konfigurieren, dass Ordner als geschützte Ressourcen enthalten sind, wenn Sie einen Perimeter erstellen oder aktualisieren.
Console
Klicken Sie im Navigationsmenü der Cloud de Confiance Console auf Sicherheit > VPC Service Controls.
Klicken Sie auf Neuer Perimeter, um einen neuen Perimeter zu erstellen.
Wenn Sie einen vorhandenen Perimeter ändern möchten, wählen Sie ihn aus und klicken Sie auf Bearbeiten.
Wählen Sie Zu schützende Ressourcen aus.
Klicken Sie im Bereich Zu schützende Ressourcen auf Ordner hinzufügen.
Suchen Sie im Dialogfeld Ordner suchen nach den Ordnern, die Sie schützen möchten, und wählen Sie sie aus.
Klicken Sie auf Auswählen. Die hinzugefügten Ordner werden im Bereich Ordner angezeigt.
Klicken Sie auf Weiter.
Klicken Sie auf Erstellen oder Speichern.
Informationen zu anderen Perimeterkonfigurationen finden Sie unter Dienstperimeter erstellen.
gcloud
Führen Sie den folgenden
perimeters create-Befehl aus, um einen Perimeter im erzwungenen Modus zu erstellen und Ordner als geschützte Ressourcen einzuschließen:gcloud access-context-manager perimeters create NAME \ --title=TITLE \ --resources=FOLDER_ID \ --restricted-services=RESTRICTED-SERVICES \ --policy=POLICY_NAME
Verwenden Sie den Befehl
perimeters dry-run create, um einen Perimeter im Probelaufmodus zu erstellen und Ordner als geschützte Ressourcen einzuschließen.Führen Sie den folgenden
perimeters update-Befehl aus, um einen vorhandenen Perimeter im erzwungenen Modus zu aktualisieren und Ordner als geschützte Ressourcen einzuschließen:gcloud access-context-manager perimeters update \ PERIMETER_ID \ --add-resources=FOLDER_ID
Verwenden Sie den Befehl
perimeters dry-run update, um einen vorhandenen Perimeter im Probelaufmodus zu aktualisieren und Ordner als geschützte Ressourcen einzuschließen.
Ersetzen Sie FOLDER_ID durch eine durch Kommas getrennte Liste mit einer oder mehreren Ordner-IDs. Beispiel: folders/12345. Die Argumente --resources und --add-resources unterstützen auch Projekte und VPC-Netzwerke.
Informationen zu anderen Perimeterkonfigurationen finden Sie unter Dienstperimeter erstellen.
Ordner aus einem Perimeter entfernen
Sie können Ordner aus einem vorhandenen Perimeter entfernen.
Console
Klicken Sie im Navigationsmenü der Cloud de Confiance Console auf Sicherheit > VPC Service Controls.
Wenn Sie einen vorhandenen Perimeter ändern möchten, wählen Sie ihn aus und klicken Sie auf Bearbeiten.
Wählen Sie Zu schützende Ressourcen aus.
Wählen Sie im Bereich Zu schützende Ressourcen im Abschnitt Ordner die Ordner aus, die Sie entfernen möchten.
Klicken Sie auf Ausgewählte entfernen.
Klicken Sie auf Weiter.
Klicken Sie auf Speichern.
Weitere Informationen finden Sie unter Dienstperimeter aktualisieren.
gcloud
Führen Sie den folgenden perimeters update-Befehl aus, um Ordner aus einem vorhandenen Perimeter im erzwungenen Modus zu entfernen:
gcloud access-context-manager perimeters update \ PERIMETER_ID \ --remove-resources=FOLDER_ID
Verwenden Sie den Befehl perimeters dry-run update, um Ordner im Probelaufmodus aus einem vorhandenen Perimeter zu entfernen.
Ersetzen Sie FOLDER_ID durch eine durch Kommas getrennte Liste mit einer oder mehreren Ordner-IDs. Beispiel: folders/12345. Das Argument --remove-resources unterstützt auch Projekte und VPC-Netzwerke.
Weitere Informationen finden Sie unter Dienstperimeter aktualisieren.
Konfigurierte Perimeter für eine Ressource suchen
Verwenden Sie die gcloud CLI oder die API-Methode LookupConfiguredServicePerimeter, um zu sehen, welche erzwungenen oder im Probelauf befindlichen Dienstperimeter für ein Projekt oder einen Ordner gelten.
gcloud
Führen Sie den folgenden lookup-configured-perimeter-Befehl aus, um den konfigurierten Perimeter für ein Projekt oder einen Ordner aufzurufen:
gcloud access-context-manager lookup-configured-perimeter \ --resource=RESOURCE
Ersetzen Sie RESOURCE durch den Ressourcennamen im Format projects/PROJECT_NUMBER oder folders/FOLDER_NUMBER.
API
Rufen Sie die Methode LookupConfiguredServicePerimeter auf, um den konfigurierten Perimeter für ein Projekt nachzuschlagen:
GET https://accesscontextmanager.googleapis.com/v1/projects/PROJECT_NUMBER:lookupConfiguredServicePerimeter
Rufen Sie die Methode LookupConfiguredServicePerimeter auf, um den konfigurierten Perimeter für einen Ordner zu ermitteln:
GET https://accesscontextmanager.googleapis.com/v1/folders/FOLDER_NUMBER:lookupConfiguredServicePerimeter
Erforderliche Berechtigungen
Wenn Sie konfigurierte Perimeter für eine Ressource abfragen möchten, benötigen Sie die folgenden IAM-Berechtigungen für die relevanten Zugriffsrichtlinien:
accesscontextmanager.policies.getaccesscontextmanager.servicePerimeters.list
Beispielantwort
{
"servicePerimeter": "accessPolicies/123456/servicePerimeters/my_enforced_perimeter",
"servicePerimeterDryRun": "accessPolicies/123456/servicePerimeters/my_dry_run_perimeter",
"restrictedResource": "folders/789012",
"restrictedResourceDryRun": "projects/345678"
}
In diesem Beispiel übernimmt das Projekt den erzwungenen Perimeter vom übergeordneten Ordner folders/789012. Im Gegensatz dazu wird der Probelaufperimeter direkt im Projekt projects/345678 konfiguriert.
Projekte in einem Perimeter mithilfe von Ordnern verwalten
Sie können ein Projekt indirekt zu einem Perimeter hinzufügen oder daraus entfernen, indem Sie das Projekt in einen Ordner verschieben, den Sie im Perimeter konfiguriert haben, oder aus diesem Ordner entfernen. Weitere Informationen finden Sie unter Projekt in einen Ordner verschieben.
Informationen zum expliziten Hinzufügen oder Entfernen von Projekten aus einem Perimeter finden Sie unter Dienstperimeter aktualisieren.
Fehlerbehebung
Wenn beim Konfigurieren von Ordnermitgliedschaften Probleme oder unerwartetes Verhalten auftreten, gehen Sie so vor:
- Suchen Sie die konfigurierten Perimeter für die Ressource, um zu prüfen, ob die Ressource einen Perimeter von einem übergeordneten Ordner übernimmt.
- In den Audit-Logs finden Sie Details zu Perimeterverstößen. Weitere Informationen finden Sie unter Informationen zur Fehlerbehebung aus Audit-Logs abrufen.
- Prüfen Sie, ob die Weitergabe der Ressourcenhierarchie für Projekte, die zu ordnerbasierten Perimetern migriert wurden, abgeschlossen ist, bevor Sie explizite Projektbindungen entfernen. Die Weitergabe dauert in der Regel einige Minuten, kann aber auch länger dauern.