Réutiliser des configurations de stratégie dans vos définitions de stratégie Gestion des API

S’APPLIQUE À : tous les niveaux de Gestion des API

Cet article explique comment créer et utiliser des fragments de stratégie dans vos définitions de stratégie Gestion des API Azure. Les fragments de stratégie sont des extraits de code XML réutilisables gérés de manière centralisée qui contiennent une ou plusieurs configurations de stratégie Gestion des API.

Les fragments de stratégie vous aident à configurer des stratégies de manière cohérente et à gérer les définitions de stratégie sans avoir à répéter ou à retyper du code XML.

Un fragment de stratégie :

• Doit être un XML valide qui contient une ou plusieurs configurations de politiques.
• Peut inclure des expressions de stratégie, si une stratégie référencée les prend en charge.
• Est inséré tel qu’il se trouve dans une définition de stratégie via la stratégie include-fragment.

Limites :

• Un fragment de stratégie ne peut pas inclure d’identificateur de section de stratégie (<inbound>, <outbound>, par exemple) ou l’élément <base/>.
• Actuellement, un fragment de stratégie ne peut pas imbriquer un autre fragment de stratégie.
• La taille maximale d’un fragment de stratégie est de 32 Ko.

Prérequis

Si vous ne disposez pas déjà d’une instance Gestion des API et d’une API back-end, consultez :

• Créer une instance du service Gestion des API Azure
• Importer et publier une API

Bien qu’il ne soit pas nécessaire, vous pouvez configurer une ou plusieurs définitions de stratégie. Vous pouvez copier des éléments de stratégie à partir de ces définitions lorsque vous créez des fragments de stratégie.

Accéder à votre instance Gestion des API

1. Dans le portail Azure, recherchez et sélectionnez Services de gestion des API :

   

2. Sur la page des services de gestion des API, sélectionnez votre instance de gestion des API :

   

Créer un fragment de stratégie

1. Dans le volet gauche de votre instance Gestion des API, sous API, sélectionnez Fragments de stratégie. Dans le volet Fragments de stratégie, sélectionnez + Créer.

2. Dans la fenêtre Créer un fragment de stratégie, entrez un nom et, éventuellement, une description du fragment de stratégie. Le nom doit être unique dans votre instance Gestion des API.

   Exemple de nom : ForwardContext

3. Dans l’éditeur de fragment XML de stratégie, tapez ou collez un ou plusieurs éléments de stratégie XML entre les balises <fragment> et </fragment>.

   

   Par exemple, le fragment suivant contient une configuration de stratégie set-header pour transférer des informations de contexte vers un service back-end. Ce fragment serait inclus dans une section de stratégie entrante. Les expressions de stratégie de cet exemple accèdent à la variable intégrée context.

   <fragment>
       <set-header name="x-request-context-data" exists-action="override">
         <value>@(context.User.Id)</value>
         <value>@(context.Deployment.Region)</value>
       </set-header>
   </fragment>
   

4. Sélectionnez Create (Créer). Le fragment est ajouté à la liste des fragments de stratégie.

Inclure un fragment dans une définition de stratégie

Utilisez la stratégie include-fragment pour insérer un fragment de stratégie dans une définition de stratégie. Pour plus d’informations sur les définitions de stratégie, consultez Définir ou modifier des stratégies.

• Vous pouvez inclure un fragment à n’importe quelle étendue et dans n’importe quelle section de stratégie, tant que la stratégie ou les stratégies sous-jacentes du fragment prennent en charge l’utilisation.
• Vous pouvez inclure plusieurs fragments de stratégie dans une définition de stratégie.

Par exemple, insérez le fragment de stratégie nommé ForwardContext dans la section de stratégie entrante :

<policies>
    <inbound>
        <include-fragment fragment-id="ForwardContext" />
        <base />
    </inbound>
[...]

Gérer les fragments de stratégie

Après avoir créé un fragment de stratégie, vous pouvez afficher et mettre à jour ses propriétés ou le supprimer à tout moment.

Pour afficher les propriétés d’un fragment de stratégie :

1. Dans le volet gauche de votre instance Gestion des API, sous API, sélectionnez Fragments de stratégie. Sélectionnez le nom de votre fragment.
2. Dans la page Vue d’ensemble, passez en revue les Références de documents de stratégie pour afficher les définitions de stratégie qui incluent le fragment.
3. Dans la page Propriétés , sous Paramètres, passez en revue le nom et la description du fragment de stratégie. Vous ne pouvez pas changer ce nom.

Pour modifier un fragment de stratégie :

1. Dans le volet gauche de votre instance Gestion des API, sous API, sélectionnez Fragments de stratégie. Sélectionnez le nom de votre fragment.
2. Sous Paramètres, sélectionnez Éditeur de stratégie.
3. Mettez à jour les instructions dans le fragment, puis sélectionnez Appliquer.

Pour supprimer un fragment de stratégie :

1. Dans le volet gauche de votre instance Gestion des API, sous API, sélectionnez Fragments de stratégie. Sélectionnez le nom de votre fragment.
2. Passez en revue les Références de documents de stratégie pour les définitions de stratégie qui incluent le fragment. Avant de supprimer un fragment, vous devez supprimer les références de fragment de toutes les définitions de stratégie.
3. Une fois toutes les références supprimées, sélectionnez Supprimer.

Contenu connexe

Pour plus d’informations sur l’utilisation des stratégies, consultez :

• Tutoriel : Transformer et protéger votre API
• Référence de politique pour obtenir la liste complète des déclarations et des paramètres de politique
• Expressions de stratégie
• Définir ou modifier des stratégies
• Réutiliser les configurations de stratégie
• Référentiel d’extrait de stratégie
• Dépôt de terrain de jeu de stratégie
• Ensemble de stratégies de gestion des API Azure
• Obtenez de l’aide de Copilot pour créer, expliquer et dépanner des politiques