Partager un connecteur personnalisé
Maintenant que vous avez créé un connecteur personnalisé pour l’API Printer Framer, vous souhaitez rendre le connecteur disponible pour tous les utilisateurs de votre organisation. De cette façon, ils peuvent appeler cette API à partir de leurs propres workflows Azure Logic Apps. Vous savez également qu’une grande partie de vos clients utilisent Azure Logic Apps. Si vous pouvez publier votre nouveau connecteur pour eux, ils pourront appeler votre API facilement.
Partager un connecteur avec votre organisation
Si vous avez créé et utilisé un connecteur personnalisé dans un workflow d’application logique, ce connecteur est, par défaut, disponible pour les autres utilisateurs d’Azure Logic Apps dans votre organisation. Ils peuvent ajouter le connecteur aux workflows dans les régions d’application logique s’ils répondent aux critères suivants :
- Ils partagent le même locataire Microsoft Entra avec vous.
- Ils partagent le même abonnement Azure avec vous.
Azure Logic Apps partage automatiquement des connecteurs personnalisés, que d’autres utilisateurs peuvent voir lorsqu’ils sélectionnent des connecteurs pour leurs flux de travail. En revanche, vous voulez peut-être les informer du nouveau connecteur, de son objectif et de la manière de l’utiliser, etc.
Partager un connecteur avec la communauté
Si des utilisateurs externes peuvent appeler votre API, envisagez de publier votre connecteur personnalisé dans la communauté Azure. La publication rend la création de workflows avec Azure Logic Apps et l’accès à vos données via l’API beaucoup plus facile. La mise à disposition de votre connecteur personnalisé permet également de promouvoir votre API et d’encourager l’adoption de votre communauté.
L’API Print Framer est un bon exemple. Toute personne disposant d’un abonnement et pouvant écrire du code qui effectue des appels d’API REST peut accéder à votre API. En revanche, si vous publiez votre connecteur personnalisé, les personnes qui utilisent Azure Logic Apps peuvent appeler votre API à partir de leurs workflows sans écrire de code. Certaines personnes peuvent ne pas avoir connaissance de votre API. Par conséquent, s’ils trouvent votre connecteur via la galerie de connecteurs Azure Logic Apps, ils peuvent décider d’essayer l’API et même d’acheter un abonnement.
Pour publier votre connecteur dans la galerie de connecteurs Azure Logic Apps, vous devez l’envoyer à Microsoft à des fins de certification. Si le connecteur répond aux critères de certification, Microsoft le publie et tous les utilisateurs d’Azure Logic Apps peuvent le voir et l’utiliser.
Critères de certification
Microsoft valide uniquement les connecteurs qui répondent aux critères suivants :
| Fonctionnalité | Obligatoire ou recommandé | Description |
|---|---|---|
| Propriété du SaaS (Software-as-a-Service) | Obligatoire | Votre organisation doit être propriétaire de l’API à laquelle le connecteur fournit l’accès. |
| Authentification | Obligatoire | Votre API doit prendre en charge OAuth2, une clé API ou l’authentification de base. |
| Assistance technique | Obligatoire | Vous devez proposer un contrat de support technique aux utilisateurs afin que les clients puissent demander de l’aide en cas de problèmes techniques. |
| Disponibilité | Recommandé | Garantissez une durée de fonctionnement d’au moins 99,9 % dans votre contrat de niveau de service (SLA). |
Liste de contrôle avant d’envoyer un connecteur
Testez entièrement votre connecteur avant de le soumettre à certification. Assurez-vous qu’aucun bogue ni autre problème n’existe. La liste suivante décrit les problèmes courants à vérifier et à résoudre :
- Erreurs dans la définition OpenAPI : éliminez tout code JSON non valide dans le fichier de définition d’API. Vérifiez que la définition de l’API est conforme au schéma OpenAPI.
- Informations complètes dans la définition : vérifiez que chaque opération, paramètre d’entrée et attribut de réponse dans la spécification OpenAPI que vous soumettez inclut un résumé, une description et des informations de visibilité.
Soumettre un connecteur à la certification
Le processus de certification prend environ deux semaines, mais cette durée dépend de la manière dont votre connecteur répond aux critères précédents. Le processus s’exécute d’une manière similaire aux étapes suivantes :
Nomination : accédez au formulaire de nomination pour soumettre votre connecteur. Microsoft vous envoie un accord de partenariat.
Révision : une fois que les accords sont signés, un employé de Microsoft évalue le connecteur. Vous devrez peut-être fournir l’ID du connecteur, la définition OpenAPI, un fichier d’icône, un compte de test, une adresse e-mail de support et d’autres informations.
Publier : Microsoft met en scène et publie le connecteur avec la balise « Préversion ».
Prise en charge et mises à jour : une fois que Microsoft publie le connecteur et que les utilisateurs commencent à l’utiliser, surveillez les forums de produits associés pour savoir si les clients rencontrent des problèmes. Si vous avez besoin de soumettre une nouvelle version, utilisez le même formulaire de nomination. Au bout d’un certain temps de publication du connecteur, vous pouvez demander à votre contact de nomination de supprimer la balise « Préversion ».
Pour plus d’informations, consultez Submit your connector for Microsoft certification (Envoyer votre connecteur pour la certification Microsoft).