Partager via


Activer les stratégies CORS pour le connecteur personnalisé de gestion des API

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

Le partage de ressources inter-origines (CORS) est un mécanisme basé sur un en-tête HTTP qui permet à un serveur d’indiquer les origines (domaine, schéma ou port) autres que celles dont un navigateur doit autoriser le chargement des ressources. Les clients peuvent ajouter une stratégie CORS à leurs API web dans Gestion des API Azure, ce qui ajoute la prise en charge du partage de ressources inter-origines à une opération ou une API pour autoriser les appels inter-domaines à partir de clients basés sur un navigateur.

Si vous exportez une API à partir de Gestion des API en tant que connecteur personnalisé dans Power Platform et que vous souhaitez utiliser des clients basés sur un navigateur, notamment Power Apps ou Power Automate pour appeler l’API, vous devez configurer votre API pour activer explicitement les requêtes inter-origines à partir d’applications Power Platform. Cet article vous montre comment configurer les deux paramètres de stratégie nécessaires suivants :

  • Ajouter une stratégie CORS à votre API
  • Ajouter une stratégie à votre connecteur personnalisé qui définit un en-tête Origin sur les requêtes HTTP

Prerequisites

Ajouter une stratégie CORS à l’API dans Gestion des API

Suivez ces étapes pour configurer la stratégie CORS dans Gestion des API.

  1. Connectez-vous au portail Azure et accédez à votre instance Gestion des API.
  2. Dans le menu de gauche, sélectionnez les API et sélectionnez l’API que vous avez exportée en tant que connecteur personnalisé. Si vous le souhaitez, sélectionnez uniquement une opération d’API à laquelle appliquer la stratégie.
  3. Dans la section Stratégies , dans la section Traitement entrant , sélectionnez + Ajouter une stratégie.
    1. Sélectionnez Autoriser le partage de ressources inter-origines (CORS).
    2. Ajoutez l’origine autorisée suivante : https://make.powerapps.com.
    3. Cliquez sur Enregistrer.
  • Pour plus d’informations sur la configuration d’une stratégie, consultez Définir ou modifier des stratégies.
  • Pour plus d’informations sur la stratégie CORS, consultez la référence de la stratégie cors .

Note

Si vous disposez déjà d’une stratégie CORS existante au niveau du service (toutes les API) pour activer la console de test du portail des développeurs, vous pouvez ajouter l’origine https://make.powerapps.com à cette stratégie au lieu de configurer une stratégie distincte pour l’API ou l’opération.

Note

Selon la façon dont le connecteur personnalisé est utilisé dans les applications Power Platform, vous devrez peut-être configurer davantage d’origines dans la stratégie CORS. Si vous rencontrez des problèmes CORS lors de l’exécution d’applications Power Platform, utilisez des outils de développement dans votre navigateur, le suivi dans Gestion des API ou Application Insights pour examiner les problèmes.

Ajoutez une stratégie au connecteur personnalisé pour définir l’en-tête Origin

Ajoutez la règle suivante à votre connecteur personnalisé dans votre environnement Power Platform. La stratégie définit un en-tête Origin pour qu’il corresponde à l’origine CORS que vous avez autorisée dans Gestion des API.

Pour plus d’informations sur la modification des paramètres d’un connecteur personnalisé, consultez Créer un connecteur personnalisé à partir de zéro.

  1. Connectez-vous à Power Apps ou Power Automate.

  2. Dans le volet gauche, sélectionnez Données>Connecteurs personnalisés.

  3. Sélectionnez votre connecteur dans la liste des connecteurs personnalisés.

  4. Pour modifier le connecteur personnalisé, sélectionnez l’icône crayon (Modifier).

  5. Sélectionnez 3. Définition.

  6. Dans Stratégies, sélectionnez + Nouvelle stratégie. Sélectionnez ou entrez les détails de politiques suivants.

    Réglage Valeur
    Nom Nom de votre choix, tel que set-origin-header
    Template Définir l’en-tête HTTP
    Nom de l’en-tête Origine
    Valeur de l’en-tête https://make.powerapps.com (même URL que celle que vous avez configurée dans Gestion des API)
    Action si l’en-tête existe remplacer
    Réexécuter la stratégie sur Requête

    Capture d’écran de la création d’une stratégie dans le connecteur personnalisé Power Platform pour définir un en-tête Origin dans les requêtes HTTP.

  7. Sélectionnez Mettre à jour un connecteur.

  8. Après avoir défini la stratégie, accédez au 5. Page de test pour tester le connecteur personnalisé.