Comprendre les Workspaces dans Azure API Management

Introduction

 

Azure API Management (ou APIM) est un service permettant aux utilisateurs de définir, gérer, sécuriser et surveiller des APIs dans une interface unifiée. APIM offre divers fonctionnalités avancées comme la mise en cache, la journalisation, la transformation des données en entrée et sortie, ou encore plus récemment la gestion des Workspaces.
Dans cet article, nous allons comprendre les Workspaces dans APIM. Nous analyserons les différents aspects de cette option et en montrant comment elle peut être bénéfique pour les utilisateurs et les développeurs.

 

Qu’est-ce qu’un Workspace ?

 

L’APIM dispose de Workspaces dédiés comme espaces de travail. Ils permettent à plusieurs membres d’une équipe de collaborer sur des projets spécifiques. Chaque Workspace contient des ressources liées à un projet d’API, il est possible de centraliser plusieurs ressources liés à un projet dans un seul Workspace. Il faut tout de même prendre en compte qu’actuellement, les Workspaces sont encore en version « preview ». Cela signifie qu’ils sont encore en cours de développement, ils peuvent être amenés à évoluer ou complétement disparaître.

 

Pourquoi utiliser les Workspaces ?

 

Il est compliqué pour les développeurs utilisant l’API Management de partager parmi plusieurs équipes, la gestion de plusieurs instances d’APIs. Cela est particulièrement vrai pour les cas spécifiques de séparation des droits ou d’organisation du portail développeur, mais les problématiques peuvent être plus vastes.

Les Workspaces pallies ce problème en apportant un panel de fonctionnalités au sein d’une nouvelle ressource dans l’APIM. Cela permet notamment de gérer plus efficacement les responsabilités au sein de différentes APIs.

 

Les avantages de l’utilisation des Workspaces

 

Les Workspaces dans Azure API Management offrent plusieurs atouts pour faciliter la collaboration et la gestion des projets d’API au sein d’une organisation :

 

• Répartition des responsabilités :
  Ils permettent de séparer les responsabilités entre administrateurs, développeurs ou équipe business. Cette séparation des rôles permet de travailler de manière plus organisée et d’éviter de potentiels conflits. De cette manière les administrateurs gardent un contrôle total et les autres équipes concernées sont décentralisées dans chaque Workspace.

 

• Contrôle d’accès basé sur les rôles (RBAC) :
  Les Workspaces utilisent le RBAC d’Azure Resource Manager pour déterminer qui peut accéder aux différentes ressources d’un projet. Cela garantit que seuls les membres autorisés de chaque équipe puissent accéder aux APIs, aux produits ou aux différentes entités associés. Il faut garder en mémoire que les Workspaces sont en preview, mais voilà un aperçu des menus disponibles.

 

• Personnalisation du Portail Développeur :
  Les Workspaces d’APIM permettent de créer des groupes d’utilisateurs spécifiques à chaque Workspace. Cela renforce la personnalisation et le contrôle des accès du Portail Développeur. Cette fonctionnalité améliore la sécurité, l’expérience utilisateur, et offre une gestion plus précise et centralisée des permissions aux administrateurs d’API.

 

Les axes d’amélioration

 

Les Workspaces étant en preview, il y a plusieurs axes d’améliorations potentiels pour les rendre plus efficaces et faciles à utiliser, en voici quelques-uns :

 

• Le déploiement automatisé :
  Dans le contexte actuel, le déploiement automatisé est limité pour les Workspaces en raison de leur non intégration aux outils de génération d’ARM. Cela complexifie les processus de déploiement, nécessitant parfois des solutions alternatives. Il est donc crucial de rester informé des évolutions futures de l’API Management pour optimiser les pratiques de déploiement.

 

• Consommation des endpoints :
  Pour un utilisateur ou un système souhaitant accéder aux endpoints des APIs exposées sur l’API Management, le fonctionnement reste inchangé.
  
  Sur l’URL ci-dessus, on ne retrouve pas le nom du Workspace, uniquement l’APIM, l’API et l’Operation. Pour l’utilisateur c’est un avantage. Par contre, on ne pourra pas nommer deux APIs de la même manière dans deux Workspaces différent. Cela peut être impactant pour un développeur n’ayant accès qu’à un seul Workspace parmi une multitude de Workspaces présent sur un même API Management.

 

Conclusion

 

Nous avons défini ce que sont les Workspaces dans l’APIM et en avons listé les avantages et les axes d’amélioration. Les Workspaces sont prometteurs mais toujours en preview, il faut rester attentif sur les évolutions que pourrait apporter Microsoft à l’avenir.

Si vous souhaitez plus d’informations liées aux Workspaces ou à l’API Management, voici quelques liens :

• Documentation Microsoft sur les Workspaces : https://learn.microsoft.com/en-us/azure/api-management/workspaces-overview
• Autre article de blog Middleway lié à l’API Management : https://www.middleway.eu/fr/tracer-informations-appel-http-vers-application-insights-depuis-api-management/