URL-Liste zum Erstellen von Richtlinien verwenden

In diesem Leitfaden erfahren Sie, wie Sie mithilfe von URL-Listen URLs definieren, auf die Ihre Nutzer zugreifen können.

Hinweise

  • Schließen Sie die Ersteinrichtungsschritte ab.

  • Prüfen Sie, ob Sie die Google Cloud CLI 406.0.0 oder höher installiert haben:

    gcloud version | head -n1

    Wenn Sie eine frühere Version der gcloud CLI installiert haben, aktualisieren Sie die Version:

    gcloud components update --version=406.0.0

Secure Web Proxy-Instanz mit einer leeren Richtlinie erstellen

Zum Erstellen einer Secure Web Proxy-Instanz erstellen Sie zuerst eine leere Sicherheitsrichtlinie und dann einen Web-Proxy.

Leere Sicherheitsrichtlinie erstellen

Console

  1. Rufen Sie in der Google Cloud Console die Seite Netzwerksicherheit auf.

    Netzwerksicherheit aufrufen

  2. Klicken Sie auf Secure Web Proxy.

  3. Klicken Sie auf den Tab Richtlinien.

  4. Klicken Sie auf Richtlinie erstellen.

  5. Geben Sie einen Namen für die Richtlinie ein, die Sie erstellen möchten, z. B. myswppolicy.

  6. Geben Sie eine Beschreibung der Richtlinie ein, z. B. My new swp policy.

  7. Wählen Sie in der Liste Regionen die Region aus, in der Sie die Richtlinie erstellen möchten.

  8. Klicken Sie auf Erstellen.

Cloud Shell

  1. Erstellen Sie die Datei POLICY_FILE.yaml mit Ihrem bevorzugten Texteditor. Ersetzen Sie POLICY_FILE durch den Dateinamen, den Sie für die Richtliniendatei verwenden möchten.

  2. Fügen Sie der erstellten YAML-Datei Folgendes hinzu:

    name: projects/PROJECT_NAME/locations/REGION/gatewaySecurityPolicies/POLICY_NAME
description: POLICY_DESCRIPTION

    Ersetzen Sie Folgendes:

    • PROJECT_NAME: Name Ihres Projekts
    • REGION: die Region, für die diese Richtlinie gilt
    • POLICY_NAME: der Name der Richtlinie, die Sie erstellen
    • POLICY_DESCRIPTION: die Beschreibung der Richtlinie, die Sie erstellen

  3. Sicherheitsrichtlinie importieren:

    gcloud network-security gateway-security-policies import POLICY_NAME \
    --source=POLICY_FILE.yaml \
    --location=REGION

Web-Proxy erstellen

Console

  1. Rufen Sie in der Google Cloud Console die Seite Netzwerksicherheit auf.

    Netzwerksicherheit aufrufen

  2. Klicken Sie auf Secure Web Proxy.

  3. Klicken Sie auf Web-Proxy einrichten.

  4. Geben Sie einen Namen für den Web-Proxy ein, den Sie erstellen möchten, z. B. myswp.

  5. Geben Sie eine Beschreibung des Web-Proxys ein, z. B. My new swp.

  6. Wählen Sie in der Liste Regionen die Region aus, in der Sie den Web-Proxy erstellen möchten.

  7. Wählen Sie in der Liste Netzwerk das Netzwerk aus, in dem Sie den Web-Proxy erstellen möchten.

  8. Wählen Sie in der Liste Subnetzwerk das Subnetzwerk aus, in dem Sie den Web-Proxy erstellen möchten.

  9. Geben Sie die IP-Adresse des Web-Proxys ein.

  10. Wählen Sie in der Liste Zertifikat das Zertifikat aus, das Sie zum Erstellen des Web-Proxys verwenden möchten.

  11. Wählen Sie in der Liste Richtlinie die Richtlinie aus, die Sie erstellt haben, um den Web-Proxy zu verknüpfen.

  12. Klicken Sie auf Erstellen.

Cloud Shell

  1. Erstellen Sie die Datei GATEWAY_FILE.yaml mit Ihrem bevorzugten Texteditor. Ersetzen Sie GATEWAY_FILE durch den gewünschten Dateinamen für die Web-Proxy-Datei.

  2. Fügen Sie der erstellten YAML-Datei Folgendes hinzu:

    name: projects/PROJECT_NAME/locations/REGION/gateways/GATEWAY_NAME
type: SECURE_WEB_GATEWAY
ports: [GATEWAY_PORT_NUMBERS]
certificateUrls: [CERTIFICATE_URLS]
gatewaySecurityPolicy: projects/PROJECT_NAME/locations/REGION/gatewaySecurityPolicies/POLICY_NAME
network: projects/PROJECT_NAME/global/networks/NETWORK_NAME
subnetwork: projects/PROJECT_NAME/regions/REGION/subnetworks/SUBNET_NAME
addresses: [GATEWAY_IP_ADDRESS]
scope: samplescope

    Ersetzen Sie Folgendes:

    • GATEWAY_NAME: der Name für diese Instanz
    • GATEWAY_PORT_NUMBERS: eine Liste von Portnummern für dieses Gateway, z. B. [80,443]
    • CERTIFICATE_URLS: eine Liste von SSL-Zertifikat-URLs

    • SUBNET_NAME: der Name des Subnetzes, das GATEWAY_IP_ADDRESS enthält

    • GATEWAY_IP_ADDRESS: eine optionale Liste von IP-Adressen für Ihre Secure Web Proxy-Instanzen in den Proxy-Subnetzen, die zuvor in den ersten Einrichtungsschritten erstellt wurden

      Wenn Sie keine IP-Adressen auflisten möchten, lassen Sie das Feld weg, damit der Web-Proxy eine IP-Adresse für Sie auswählt.

  3. Erstellen Sie eine Secure Web Proxy-Instanz:

    gcloud network-services gateways import GATEWAY_NAME \
    --source=GATEWAY_FILE.yaml \
    --location=REGION

Verbindung testen

Testen Sie die Konnektivität mit dem Befehl curl von einer beliebigen VM in Ihrem VPC-Netzwerk (Virtual Private Cloud):

  curl -x https://GATEWAY_IP_ADDRESS:PORT_NUMBER https://www.example.com --proxy-insecure

Ein 403 Forbidden-Fehler wird erwartet.

URL-Liste erstellen

Führen Sie die Aufgaben in den folgenden Abschnitten aus, um eine URL-Liste zu erstellen und eine Regel hinzuzufügen.

URL-Liste erstellen und konfigurieren

Console

  1. Rufen Sie in der Google Cloud Console die Seite Netzwerksicherheit auf.

    Netzwerksicherheit aufrufen

  2. Klicken Sie auf Secure Web Proxy.

  3. Klicken Sie auf den Tab URL-Listen.

  4. Klicken Sie auf URL-Liste erstellen.

  5. Geben Sie einen Namen für die URL-Liste ein, die Sie erstellen möchten, z. B. myurllist.

  6. Geben Sie eine Beschreibung der URL-Liste ein, zum Beispiel My new URL list.

  7. Wählen Sie in der Liste Regionen die Region aus, in der Sie die URL-Liste erstellen möchten.

  8. Klicken Sie auf Listen hochladen, um eine Liste der abzugleichenden Hosts, URLs oder Muster hochzuladen. Weitere Informationen finden Sie in der Syntaxreferenz zu UrlList.

  9. Klicken Sie auf Erstellen.

Cloud Shell

  1. Verwenden Sie einen Texteditor Ihrer Wahl, um die Datei URL_LIST_FILE.yaml. ReplaceURL_LIST_FILE mit dem gewünschten Dateinamen zu erstellen.

      name: projects/PROJECT_ID/locations/REGION/urlLists/URL_LIST_NAME
  values: URL_LIST

    Ersetzen Sie Folgendes:

    • PROJECT_ID: Ihre Projektnummer
    • REGION: die Region, für die diese URL-Liste gilt
    • URL_LIST_NAME: ein Name für die URL-Liste, die Sie erstellen
    • URL_LIST: die Liste der Hosts, URLs oder Muster, die abgeglichen werden sollen

    Weitere Informationen finden Sie in der Syntaxreferenz zu UrlList.

    Hier sehen Sie ein Beispiel für eine URL-Listenregeldatei:

    name: projects/PROJECT_ID/locations/REGION/urlLists/example-org-allowed-list
values:
  - www.example.com
  - about.example.com
  - "*.google.com"
  - "github.com/example-org/*"

    Das Sternchen (*) hat in YAML eine besondere Bedeutung. Daher müssen Sie URLs, die das Zeichen * enthalten, in Anführungszeichen setzen.

  2. Fügen Sie die URL-Liste hinzu, damit von einer Secure Web Proxy-Regel darauf verwiesen werden kann:

    gcloud network-security url-lists import URL_LIST_NAME \
    --location=REGION \
    --project=PROJECT_ID \
    --source=URL_LIST_FILE.yaml

Regel hinzufügen

Console

  1. Rufen Sie in der Google Cloud Console die Seite Netzwerksicherheit auf.

    Netzwerksicherheit aufrufen

  2. Klicken Sie auf Secure Web Proxy.

  3. Wählen Sie in der Projektauswahl Ihre Organisations-ID oder den Ordner aus, der Ihre Richtlinie enthält.

  4. Klicken Sie auf den Namen Ihrer Richtlinie.

  5. Klicken Sie auf Regel hinzufügen.

  6. Füllen Sie die Regelfelder aus:

    1. Name
    2. Beschreibung
    3. Status
    4. Priorität: die numerische Auswertungsreihenfolge der Regel. Die Regeln werden von der höchsten bis zur niedrigsten Priorität ausgewertet, wobei 0 die höchste Priorität ist.
    5. Geben Sie im Abschnitt Action (Aktion) an, ob Verbindungen, die der Regel entsprechen, zugelassen (Allow) oder abgelehnt (Deny) werden.

    6. Geben Sie im Abschnitt Sitzungsübereinstimmung den Namen der URL-Liste ein, die Sie zuvor erstellt haben. Beispiel:

        sessionMatcher: "inUrlList(host(), 'projects/PROJECT_ID/locations/REGION/urlLists/URL_LIST_NAME')"

    7. Wenn Sie die TLS-Prüfung aktivieren möchten, wählen Sie TLS-Prüfung aktivieren aus.

    8. Geben Sie im Abschnitt Anwendungsübereinstimmung die Kriterien für den Abgleich der Anfrage an.

    9. Klicken Sie auf Erstellen.

  7. Klicken Sie auf Regel hinzufügen, um eine weitere Regel hinzuzufügen.

  8. Klicken Sie auf Erstellen, um die Richtlinie zu erstellen.

Cloud Shell

  1. Erstellen Sie die Datei RULE_FILE.yaml mit einem Texteditor. Ersetzen Sie RULE_FILE durch den gewünschten Dateinamen.

    name: projects/PROJECT_ID/locations/REGION/gatewaySecurityPolicies/POLICY_NAME/rules/RULE_NAME
basicProfile: ALLOW
enabled: true
priority: PRIORITY_VALUE
description: RULE_DESCRIPTION
sessionMatcher: SESSION_CEL_EXPRESSION
applicationMatcher: APPLICATION_CEL_EXPRESSION

    Ersetzen Sie Folgendes:

    • PROJECT_ID: Ihre Projektnummer
    • REGION: die Region, für die diese Regel gilt
    • POLICY_NAME: der Name einer vorhandenen GatewaySecurityPolicy, die von Ihrer Secure Web Proxy-Instanz verwendet wird
    • RULE_NAME: ein Name für die GatewaySecurityPolicyRule, die Sie erstellen
    • PRIORITY_VALUE: ein Prioritätswert für diese Regel; niedrigere Zahlen entsprechen höheren Prioritäten
    • RULE_DESCRIPTION: eine Beschreibung der Richtlinie, die Sie erstellen
    • SESSION_CEL_EXPRESSION: ein CEL-Ausdruck (Common Expression Language) für die Sitzung
    • APPLICATION_CEL_EXPRESSION: ein CEL-Ausdruck für die Anwendung

    Hier sehen Sie ein Beispiel für eine Regeldatei:

    name: projects/PROJECT_ID/locations/REGION/urlLists/allow-repos
basicProfile: ALLOW
enabled: true
priority: 100
description: Allow access to our list of known code repos.
sessionMatcher: "inUrlList(host(), 'projects/PROJECT_ID/locations/REGION/urlLists/URL_LIST_NAME')"

  2. Fügen Sie mithilfe der URL-Liste, die Sie zuvor erstellt haben, eine Secure Web-Proxy-Regel hinzu:

        gcloud network-security gateway-security-policies rules import RULE_NAME \
      --location=REGION \
      --project=PROJECT_ID \
      --source=RULE_FILE.yaml \
      --gateway-security-policy=POLICY_NAME

Verbindung testen

Testen Sie die Konnektivität mit dem folgenden curl-Befehl:

curl -x https://SWP_IP_ADDRESS:SWP_PORT_NUMBER HTTP_TEST_ADDRESS
--proxy-insecure

Ersetzen Sie Folgendes:

  • SWP_IP_ADDRESS: die IP-Adresse zu Ihrem Web-Proxy

  • SWP_PORT_NUMBER: die Portnummer für Ihren Web-Proxy, z. B. 443

  • HTTP_TEST_ADDRESS: eine zu testende Adresse wie https://www.example.com, die mit einem Host oder URL-Eintrag in Ihrer URL_LIST übereinstimmt

Die Anfrage sollte eine erfolgreiche Antwort zurückgeben.

Nächste Schritte