Zelfstudie: Regelengine configureren

In deze zelfstudie leert u hoe u een configuratie van de regelengine en uw eerste regel in de Azure Portal en CLI kunt maken.

In deze zelfstudie leert u het volgende:

Vereisten

• Voordat u de stappen in deze zelfstudie kunt voltooien, moet u een Front Door maken. Raadpleeg Snelstartgids: Een Front Door maken voor meer informatie.

Regelengine configureren in de Azure-portal

1. Ga in de resource van de front door naar Instellingen en selecteer Configuratie van regelengine. Klik op Toevoegen, geef een naam op voor de configuratie en begin met het maken van uw eerste configuratie van de regelengine.

   

2. Klik op Regel toevoegen om uw eerste regel te maken. Klik vervolgens op Voorwaarde toevoegen of Actie toevoegen om de regel te definiëren.

   Notitie

   • Als u een voorwaarde of actie wilt verwijderen uit een regel, gebruikt u het pictogram Prullenbak rechts van de voorwaarde of actie die u wilt verwijderen.
   • Als u een regel wilt maken die van toepassing is op alle binnenkomend verkeer, geeft u geen voorwaarden op.
   • Als u wilt stoppen met het evalueren van regels zodra aan de eerste voorwaarde is voldaan, selecteert u Stoppen met evalueren van resterende regels. Als deze optie is ingeschakeld en aan alle voorwaarden van een bepaalde regel wordt voldaan, worden de resterende regels in de configuratie niet uitgevoerd.

   

3. Bepaal de prioriteit van de regels binnen uw configuratie met behulp van de knoppen Omhoog, Omlaag en Bovenaan. De prioriteit werkt in oplopende volgorde, wat betekent dat de regel die het eerst wordt vermeld, de belangrijkste regel is.

   Tip

   Als u wilt controleren wanneer de wijzigingen worden doorgegeven aan Azure Front Door, kunt u een aangepaste antwoordheader maken in de regel met behulp van het onderstaande voorbeeld. U kunt een antwoordheader toevoegen _X-<RuleName>-Version_ en de waarde wijzigen telkens wanneer de regel wordt bijgewerkt.

   Nadat de wijzigingen zijn bijgewerkt, kunt u naar de URL gaan om te bevestigen dat de regelversie wordt aangeroepen: Schermopname van de uitvoer

4. Als u een of meer regels hebt gemaakt, selecteert u Opslaan. De configuratie van de regelengine wordt nu gemaakt.

5. Wanneer u een of meer configuraties hebt gemaakt, koppelt u een configuratie van de regelengine aan een routeregel. Hoewel één configuratie kan worden toegepast op verschillende routeregels, mag een routeregel slechts één configuratie van de regelengine bevatten. Als u de koppeling wilt maken, gaat u naar de ontwerpfunctie van Front Door > Routeregels. Selecteer de routeregel waaraan u de configuratie van de regelengine wilt toevoegen, ga naar Routedetails > Configuratie van regelengine en selecteer de configuratie die u wilt koppelen.

   

Regelengine configureren in de Azure CLI

1. Installeer Azure CLI als u dat nog niet hebt gedaan. Voeg de extensie 'front-door' toe: -az extension add --name front-door. Meld u vervolgens aan en schakel over naar uw abonnement met az account set --subscription <naam_of_id>.

2. Begin met het maken van een regelengine. In dit voorbeeld maakt u één regel met één actie op basis van de header en één match-voorwaarde.

   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. Geef alle regels weer.

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

4. Voeg een actie toe voor het overschrijven van een doorstuurroute.

   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. Geef alle acties in een regel weer.

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

6. Koppel een configuratie van de regelengine aan een routeregel.

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

7. Koppel de regelengine los.

   az network front-door routing-rule update -g {rg} -f {front_door} -n {routing_rule_name} --remove rulesEngine # case sensitive word ‘rulesEngine’
   

Voor meer informatie vindt u hier een volledige lijst met opdrachten voor de AFD-regelengine.

Resources opschonen

In de voorgaande stappen hebt u de configuratie van de regelengine geconfigureerd en gekoppeld aan uw routeringsregels. Als u de configuratie van de regelengine die aan uw Front door is gekoppeld niet meer wilt, kunt u de configuratie verwijderen door de volgende stappen uit te voeren:

1. Koppel alle routeringsregels uit de configuratie van de regelengine los door te klikken op de drie stippen naast de naam van de regelengine.

   

2. Schakel alle routeringsregels uit waaraan deze regelengine-configuratie is gekoppeld en klik op Opslaan.

   

3. U kunt nu de configuratie van de regelengine verwijderen van uw Front Door.

   

Volgende stappen

In deze zelfstudie heeft u het volgende geleerd:

• Een regelengine-configuratie verwijderen
• Koppel de configuratie aan uw Front Door-routeringsregels.

Ga naar de volgende zelfstudie om te leren hoe u beveiligingskopteksten kunt toevoegen met de regelengine.