Présentation

Ce module explore les connecteurs personnalisés et explique comment les configurer et les utiliser avec Microsoft Power Apps, Microsoft Power Automate et Microsoft Azure Logic Apps.

Dans ce module, vous allez :

• découvrir le rôle des connecteurs personnalisés ;

• créer un connecteur et l’utiliser dans un flux Power Automate.

Les connecteurs permettent aux créateurs d’applications et de flux de se connecter plus facilement à d’autres applications, données et appareils dans le cloud des manières suivantes :

• La connexion se fait d’une manière cohérente et reproductible qui est détectable par les créateurs.

• Les connecteurs ont des actions qui permettent aux créateurs de contrôler lorsqu’une opération est effectuée.

• Les connecteurs peuvent avoir des déclencheurs qui permettent à l’automatisation de démarrer lorsque l’événement de déclenchement se produit.

Un connecteur est un proxy ou un wrapper autour d’une API qui permet à Power Automate, Power Apps et Logic Apps de communiquer avec le service sous-jacent. De nombreux connecteurs sont prédéfinis et disponibles pour être utilisés sans que vous ayez à définir quoi que ce soit. Ces définitions de connecteur intégré incluent des services de Microsoft et d’autres. Lorsque le service ou l’API que vous souhaitez utiliser ne possède pas de connecteur prédéfini, vous pouvez créer votre propre connecteur personnalisé. Si un connecteur prédéfini n’expose pas tous les déclencheurs et actions dont vous avez besoin à partir de l’API, vous pouvez créer un connecteur personnalisé en plus de celui qui est disponible pour gérer ces exigences supplémentaires. Une fois le connecteur personnalisé défini, il devient utilisable lorsque vous créez des applications et des flux dans cet environnement, comme les connecteurs intégrés.

Identifier ou créer l’API

Votre première tâche est de vérifier la référence du connecteur afin de déterminer si un connecteur approprié existe déjà pour l’API/le service. Si un connecteur approprié n’existe pas déjà, vous pouvez créer votre propre connecteur personnalisé. Vous pouvez définir le connecteur personnalisé pour décrire toute API REST publique (disponible sur Internet) ou privée (uniquement sur votre réseau interne). Les API privées nécessitent la passerelle de données locale pour accéder aux ressources internes.

Si une API compatible n’existe pas encore, les développeurs peuvent en créer une à l’aide de toute technologie de choix capable d’héberger une API REST, y compris Microsoft Azure Functions et Azure App Service. Vous pouvez aussi utiliser la Gestion des API Azure pour augmenter la gestion et la gouvernance des API.

Décrire l’API

Pour que Power Apps et Power Automate puissent découvrir les déclencheurs et les actions disponibles à partir de l’API, vous devez les identifier lorsque vous créez votre connecteur personnalisé. Vous pouvez accomplir cette tâche en modifiant manuellement la définition du connecteur dans le Maker Portal ou en important une définition dans un format pris en charge. Ce processus comprend l’identification des exigences d’authentification de l’API.

Utiliser le connecteur

Une fois qu’ils ont été créés dans un environnement, les connecteurs personnalisés peuvent être utilisés de la même manière que les connecteurs intégrés. Ces connecteurs peuvent également être utilisés dans un environnement autre que celui que vous avez utilisé pour le créer. La définition du connecteur doit être exportée depuis l’environnement dans lequel elle a été créée, puis importée dans tout environnement qui en a besoin. Vous pouvez également partager le connecteur avec d’autres personnes pour leur permettre de l’utiliser comme d’autres ressources partagées.

Certifier et partager le connecteur en tant qu’open source

Comme les connecteurs personnalisés ne sont disponibles que dans les environnements où leur définition existe, ils ne sont pas accessibles aux autres clients de Microsoft. En partageant une définition de connecteur personnalisé en tant qu’open source, vous la rendez disponible sur GitHub afin que d’autres clients puissent l’importer dans leurs environnements. En certifiant votre connecteur, vous pouvez rendre le connecteur personnalisé que vous avez créé disponible en tant que connecteur prédéfini dans tous les environnements client. La certification d’un connecteur nécessite que vous soyez propriétaire de l’API ou que vous disposiez d’une autorisation explicite pour publier un connecteur à partir du propriétaire de l’API.

Pour en savoir plus, consultez Processus de certification.

Cette étape du processus est facultative et requise uniquement si vous souhaitez partager votre connecteur et le faire répertorier comme certifié. Les connecteurs internes n’ont pas besoin de terminer ce processus de certification.

Décrire le connecteur

Pour définir les actions et les déclencheurs d’un connecteur, vous devez le décrire. Un connecteur personnalisé peut être défini en décrivant uniquement les déclencheurs et les actions des API dont vous avez besoin. Par exemple, si une API comporte 100 actions et 10 déclencheurs disponibles, vous pouvez créer un connecteur personnalisé avec une seule action. Vous pouvez également en décrire d’autres plus tard, à mesure que vos besoins évoluent.

Lorsque vous décrivez l’API, vous utilisez au moins l’une des approches suivantes. Si vous choisissez d’importer une définition OpenAPI, vous pouvez toujours manipuler manuellement la définition de votre connecteur dans le portail.

• Créer manuellement dans le portail : lorsque vous utilisez cette approche, vous utilisez la documentation de l’API et des exemples d’entrées et de sorties, puis définissez chaque action et déclencheur. Cette approche convient aux API simples pour lesquelles vous ne pouvez pas importer la définition. Vous pouvez également affiner les définitions après les avoir importées à l’aide de cette approche.

• Importer la définition OpenAPI : OpenAPI est une spécification qui décrit REST, simplifiant les tâches de développement et de consommation d’une API en mappant efficacement toutes les ressources et opérations associées. De nombreux services ou API publient une définition OpenAPI et vous pouvez l’importer pour décrire l’API dans le connecteur personnalisé. L’importation de la version 2.0 est prise en charge, mais la version 3.0 n’est actuellement pas prise en charge. Cette approche est avantageuse si une définition OpenAPI est disponible auprès de l’éditeur de l’API ou, si vous la développez, si vous pouvez en publier une.

• Importer à partir de GitHub : importez des connecteurs depuis le référentiel des connecteurs Power Platform. Il s’agit de la meilleure approche lorsqu’un connecteur est déjà publié dans le référentiel et que vous souhaitez l’importer pour le modifier ou l’utiliser comme connecteur personnalisé.

• Exporter depuis Azure : si votre API est créée en tant qu’Azure App Service, Microsoft Azure Functions, ou est géré par Gestion des API Microsoft Azure, vous pouvez exporter depuis ces services et cela crée automatiquement la définition de connecteur personnalisé initiale.

Utiliser des API authentifiées

L’architecture de connecteur personnalisé prend en charge l’utilisation d’API authentifiées. Lorsque vous définissez le connecteur personnalisé, vous identifiez comment il doit s’authentifier auprès de l’API. Les choix d’authentification prennent en charge l’accès anonyme, protégé par mot de passe, OAuth 2.0 et par clé API.

• Pas d’authentification : ce choix est destiné aux API qui autorisent l’accès anonyme. Il s’agit de la valeur par défaut si vous ne configurez pas un type d’authentification spécifique.

• Authentification de base : ce choix concerne les API qui nécessitent l’envoi d’un utilisateur et d’un mot de passe à chaque demande.

• OAuth 2.0 - OAuth 2.0 est le protocole d’autorisation standard de l’industrie. Cette option peut être configurée pour toute API qui utilise OAuth 2.0. Des configurations prédéfinies sont disponibles afin que vous puissiez sélectionner des services Microsoft tels que Microsoft Entra ID, GitHub et Azure DevOps. Des configurations prédéfinies similaires sont disponibles pour d’autres services tels que Dropbox, Slack, Stripe, etc. Les configurations prédéfinies simplifient ce que vous devez fournir pour configurer le fournisseur d’identité.

• Clé API : une clé API est un jeton fourni par un client lors des appels d’API. L’éditeur d’API fournit généralement la clé. Elle doit être incluse dans chaque requête du connecteur personnalisé.

Les connecteurs personnalisés permettent aux créateurs d’applications et de flux d’utiliser plus facilement les API/services. La plupart du temps, les créateurs peuvent invoquer directement l’API sans connecteur ; cependant, ils doivent savoir comment composer la requête et interpréter les résultats, puis gérer l’authentification. Ce processus doit être terminé chaque fois que l’application ou le flux utilise des connecteurs personnalisés.

De plus, il n’est pas toujours facile pour un créateur de pouvoir disposer de connecteurs personnalisés qui incluent des déclencheurs permettant de démarrer les flux par des événements. Les connecteurs personnalisés vous aident à découvrir plus facilement comment utiliser les actions et leurs résultats lorsque vous créez une application ou un flux qui utilise le connecteur.

L’unité suivante explique comment créer un connecteur personnalisé.