Ressourcenzugriff auf bestimmte Domains beschränken

Zur Verbesserung der allgemeinen Sicherheit verweigert IAP standardmäßig den Zugriff auf Anfragen, die keine übereinstimmende Server Name Indication (SNI) haben. IAP prüft auch die SNI des Load-Balancer-Zertifikats. Dadurch kann IAP die URL-Weiterleitung zu schädlichen Domains einschränken. Die Funktion für zulässige IAP-Domains bietet eine zusätzliche Sicherheitsebene für Ihre IAP-geschützten Ressourcen. Als Ressourceninhaber oder IAP-Administrator können Sie den Zugriff auf IAP-geschützte Ressourcen auf bestimmte Domains beschränken, indem Sie die Funktion für zulässige Domains konfigurieren.

Sie können zulässige IAP-Domains auch in den folgenden Szenarien konfigurieren:

  • Ihr Browser oder ein Zwischenproxy erzwingt das Connection Pooling: In diesem Szenario erhalten Sie die HTTP-Antwort 429 und den Fehlercode 51. Zur Behebung des Problems kann ein IAP-Administrator die Liste der zulässigen Domains aktualisieren und Ihren Hostnamen hinzufügen.

  • Der angegebene Hostname stimmt nicht mit dem SSL-Zertifikat auf dem Server überein: In diesem Fall erhalten Sie den Fehlercode 52. Zur Behebung des Problems kann ein IAP-Administrator die Liste der zulässigen Domains aktualisieren und Ihren Hostnamen hinzufügen.

Zulässige Domains konfigurieren

Sie können die Einstellungen für zulässige Domains mit gcloud oder der API konfigurieren. Verwenden Sie die folgenden Felder, um zulässige Domains zu konfigurieren:

  • enable: Boolesch. Aktiviert oder deaktiviert die Funktion „Zulässige Domains“.

  • Domains: String. Die Liste der zulässigen Domains. Die Domains können Platzhalterpräfixe wie *.example.com. enthalten. Domainnamen dürfen keinen Platzhalter direkt in einem öffentlichen Suffix oder in einer Top-Level-Domain enthalten. Beispiel: *.com, *.co.in.

Weitere Informationen finden Sie unter IapSettings.

So konfigurieren Sie zulässige IAP-Domains:

Console

  1. Rufen Sie die Seite „IAP“ auf.
    Zum Identity-Aware Proxy

  2. Wählen Sie ein Projekt und dann die Ressource aus, für die Sie die Funktion für zulässige Domains aktivieren möchten.

  3. Öffnen Sie die Einstellungen für die Ressource. Wählen Sie unter Zulässige Domains die Option Zulässige Domains aktivieren aus.

  4. Geben Sie die Liste der zulässigen Domains an und klicken Sie auf Speichern.

gcloud

Im Folgenden finden Sie einige Beispielbefehle zum Angeben zulässiger Domains.

Weitere Informationen finden Sie unter gcloud iap settings set.

Führen Sie dazu diesen Befehl aus:

gcloud iap settings set SETTING_FILE --folder=FOLDER --organization=ORGANIZATION --project=PROJECT --resource-type=RESOURCE_TYPE --service=SERVICE --version=VERSION

Wo SETTING_FILE Folgendes ist:

accessSettings:
  allowed_domains_settings:
    enable: true
    domains: ["*.example.com", "*.example.net"]

Ersetzen Sie Folgendes:

  • FOLDER: Die Ordner-ID.

  • ORGANIZATION: Die Organisations-ID.

  • PROJECT: die Projekt-ID

  • RESOURCE_TYPE: Der IAP-Ressourcentyp. Muss app-engine, iap_web, compute, organization, folder, backend-services, forwarding-rule oder cloud-run sein.

  • SERVICE: Der Dienstname. Dies ist optional, wenn resource-type compute oder app-engine ist.

  • VERSION: Der Versionsname. Dies ist nicht zutreffend für compute und ist optional, wenn resource-type den Wert app-engine hat.

Sie müssen mindestens eines der folgenden Flags angeben, um den Bereich für die Einstellungen zu definieren:

  • --organization=ORGANIZATION

  • --folder=FOLDER

  • --project=PROJECT

API

So konfigurieren Sie zulässige Domains: Weitere Informationen zur Verwendung der API zum Konfigurieren zulässiger Domains finden Sie unter IapSettings.

  1. Führen Sie den folgenden Befehl aus, um eine iap_settings.json-Datei vorzubereiten. Aktualisieren Sie die Werte nach Bedarf.

    {
 "access_settings": {
     "allowed_domains_settings": {
         "enable": true,
         "domains": [
             "*.example.com",
             "*.example.net"
         ]
     }
 }
}

  2. Rufen Sie den Ressourcennamen mit dem Befehl gcloud iap settings get ab. Kopieren Sie das Feld „name“ aus der Ausgabe. Sie benötigen den Namen im nächsten Schritt.

    gcloud iap settings get --organization=ORGANIZATION --folder=FOLDER --project=PROJECT --resource-type=RESOURCE_TYPE --service=SERVICE --version=VERSION

  3. Ersetzen Sie RESOURCE_NAME im folgenden Befehl durch den Namen aus dem vorherigen Schritt. Die IapSettings wird aktualisiert.

    curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d @iap_settings.json \
"https://iap.googleapis.com/v1/RESOURCE_NAME:iapSettings?updateMask=iapSettings.accessSettings.allowedDomainsSettings.enable,iapSettings.accessSettings.allowedDomainsSettings.domains"

Fehlerbehebung

Zugriffsproblem bei zulässigen Domains
Wenn Sie den Fehlercode 53 erhalten, bitten Sie einen IAP-Administrator, Ihren Hostnamen der Liste der zulässigen Domains hinzuzufügen.