Tutorial: Konfigurieren Ihres Regelmoduls

Gilt für: ✔️ Front Door (klassisch)

In diesem Tutorial wird erläutert, wie Sie eine Regelmodulkonfiguration und Ihre erste Regel sowohl im Azure-Portal als auch über die Befehlszeilenschnittstelle erstellen.

In diesem Tutorial lernen Sie Folgendes:

Prerequisites

• Um die Schritte in diesem Tutorial auszuführen, müssen Sie zunächst Azure Front Door (klassisch) erstellen. Weitere Informationen finden Sie unter Erstellen von Azure Front Door (klassisch).

Regelmodul im Azure-Portal konfigurieren

1. Wählen Sie in Ihrer Azure Front Door (klassische) Ressource Rule Engine-Konfiguration unter Settings im linken Menü aus. Wählen Sie +Hinzufügen aus, geben Sie einen Namen für Ihre Konfiguration ein, und beginnen Sie mit der Erstellung Ihrer ersten Regelmodulkonfiguration.

2. Geben Sie einen Namen für Ihre erste Regel ein. Klicken Sie dann auf + Bedingung hinzufügen oder + Aktion hinzufügen, um die Regel zu definieren.

   Note

   • Zum Löschen einer Bedingung oder Aktion aus einer Regel verwenden Sie das Papierkorbsymbol auf der rechten Seite der jeweiligen Bedingung oder Aktion.
   • Wenn Sie eine Regel erstellen möchten, die für alle eingehenden Datenverkehr gilt, geben Sie keine Bedingungen an.
   • Um die Auswertung von Regeln zu stoppen, sobald die erste Übereinstimmungsbedingung erfüllt ist, aktivieren Sie Auswertung der verbleibenden Regeln beenden. Wenn diese Bedingung erfüllt ist, werden die verbleibenden Regeln in der Konfiguration nicht ausgeführt.
   • Bei allen Pfaden in der Konfiguration des Regelmoduls wird die Groß-/Kleinschreibung beachtet.
   • Headernamen sollten RFC 7230entsprechen.

3. Bestimmen Sie die Priorität der Regeln in Ihrer Konfiguration, indem Sie die Schaltflächen "Nach oben", " Nach unten" und "Nach oben verschieben " verwenden. Die Priorität ist in aufsteigender Reihenfolge, was bedeutet, dass die erste aufgelistete Regel die wichtigste Regel ist.

   Tip

   Wenn Sie überprüfen möchten, wann die Änderungen an Azure Front Door (klassisch) weitergegeben werden, können Sie mithilfe des folgenden Beispiels einen benutzerdefinierten Antwortheader in der Regel erstellen. Sie können einen Antwortheader (_X-<RuleName>-Version_) hinzufügen und den Wert bei jeder Aktualisierung der Regel ändern.

   Nach dem Anwenden der Änderungen können Sie die URL aufrufen, um zu bestätigen, welche Regelversion aufgerufen wird:

4. Wenn Sie eine oder mehrere Regeln erstellen, wählen Sie "Speichern" aus. Mit dieser Aktion wird die Konfiguration Ihres Regelwerks erstellt.

5. Nachdem Sie eine Regelmodulkonfiguration erstellt haben, ordnen Sie die Konfiguration einer Routingregel zu. Sie können eine einzelne Konfiguration auf mehrere Routingregeln anwenden, aber eine Routingregel kann nur eine Regelmodulkonfiguration haben. Um die Konfiguration zuzuordnen, wechseln Sie zum Azure Front Door-Designer (klassisch), und wählen Sie eine Route aus. Wählen Sie dann die Regelmodulkonfiguration aus, die der Routingregel zugeordnet werden soll.

   

Konfigurieren der Regel-Engine in Azure CLI

1. Installieren Sie die Azure CLI und fügen Sie die „front-door”-Erweiterung hinzu:

   az extension add --name front-door
   

   Melden Sie sich an, und wechseln Sie zu Ihrem Abonnement:

   az account set --subscription <name_or_Id>
   

2. Erstellen Sie eine Regel-Engine mit einer Regel, einschließlich einer headerbasierten Aktion und einer Übereinstimmungsbedingung:

   az network front-door rules-engine rule create -f {front_door} -g {resource_group} --rules-engine-name {rules_engine} --name {rule1} --priority 1 --action-type RequestHeader --header-action Overwrite --header-name Rewrite --header-value True --match-variable RequestFilenameExtension --operator Contains --match-values jpg png --transforms Lowercase
   

3. Listen Sie alle Regeln auf:

   az network front-door rules-engine rule list -f {front_door} -g {rg} --name {rules_engine}
   

4. Fügen Sie eine Aktion zur Außerkraftsetzung der Weiterleitungsroute hinzu:

   az network front-door rules-engine rule action add -f {front_door} -g {rg} --rules-engine-name {rules_engine} --name {rule1} --action-type ForwardRouteOverride --backend-pool {backend_pool_name} --caching Disabled
   

5. Listen Sie alle Aktionen in einer Regel auf:

   az network front-door rules-engine rule action list -f {front_door} -g {rg} -r {rules_engine} --name {rule1}
   

6. Verknüpfen Sie eine Regelmodulkonfiguration mit einer Routingregel:

   az network front-door routing-rule update -g {rg} -f {front_door} -n {routing_rule_name} --rules-engine {rules_engine}
   

7. Lösen Sie die Verknüpfung der Regel-Engine:

   az network front-door routing-rule update -g {rg} -f {front_door} -n {routing_rule_name} --remove rulesEngine
   

Weitere Informationen finden Sie in der vollständigen Liste der Regelmodulbefehle für Azure Front Door (klassisch).

Bereinigen von Ressourcen

So entfernen Sie die Rules Engine-Konfiguration aus Ihrem Front Door (klassisch):

1. Wählen Sie die drei Punkte neben dem Namen des Regelmoduls aus, und wählen Sie dann " Routingregel zuordnen " aus, um die Zuordnung aller Routingregeln aus der Regelmodulkonfiguration zu trennen:

2. Deaktivieren Sie alle Routingregeln, die dieser Regelmodulkonfiguration zugeordnet sind, und wählen Sie dann "Speichern" aus:

3. Löschen Sie die Regelmodulkonfiguration aus Front Door:

   

Nächste Schritte

In diesem Tutorial haben Sie Folgendes gelernt:

• Erstellen einer Regelengine-Konfiguration
• Zuordnen einer Konfiguration zu einer Routingregel

Wenn Sie erfahren möchten, wie Sie Sicherheitsheader mithilfe des Regelmoduls hinzufügen, fahren Sie mit dem nächsten Lernprogramm fort.