Les API et les services web
Partie 2 sur 3
4Pourquoi faire travailler des programmes à distance
Avec l’interconnexion des ordinateurs en réseau, et en particulier à travers Internet, il est devenu possible de faire fonctionner des applications sur des machines distantes. L’intérêt peut sembler mince, puisque les applications fonctionnent très bien sur le poste de l’utilisateur. Une application distante répond pourtant à plusieurs besoins :
- les données peuvent n’exister que sur le serveur distant : un catalogue de produits, un classement en temps réel, les horaires d’un réseau de transport, le solde d’un compte bancaire ;
- le serveur distant peut disposer d’une puissance de calcul ou de capacités de stockage dont l’utilisateur ne dispose pas, ce qui est le cas aujourd’hui des modèles d’intelligence artificielle (voir l’IA générative) ;
- l’application distante peut être utilisée simultanément par un grand nombre d’utilisateurs, et sa mise à jour n’intervient qu’à un seul endroit.
Pour toutes ces raisons, une interaction entre des programmes distants est utile. Encore faut-il une manière standard d’appeler une application distante et d’en récupérer les résultats, quel que soit le langage dans lequel chacune est écrite. C’est ce qu’ont apporté les services Web (en anglais web services) : un mécanisme de communication entre applications distantes à travers Internet, indépendant de tout langage de programmation et de toute plateforme d’exécution, qui :
- utilise comme moyen de transport le protocole du Web, HTTP (HyperText Transfer Protocol, voir HTTP et HTTPS). Les communications passent ainsi par un support universel, bien maîtrisé et « généralement non filtré par les pare-feux » ; cet avantage d’alors est aussi un sujet de sécurité, comme on le verra dans le coin cyber ;
- emploie une syntaxe fondée sur une notation standard, XML autrefois, le plus souvent JSON aujourd’hui, pour décrire les appels de fonctions distantes et les données échangées (voir XML et JSON) ;
- organise les mécanismes d’appel et de réponse.
Grâce aux services Web, une application peut être vue comme un ensemble de services métiers, structurés et correctement décrits, qui dialoguent selon un standard international, plutôt que comme un ensemble d’objets et de méthodes entremêlés. Le premier bénéfice de ce découpage est la facilité de maintenance, ainsi que l’interopérabilité, qui permet de remplacer facilement un composant, un service, par un autre, éventuellement développé par un tiers. Le développeur peut aussi se concentrer sur un service, indépendamment du reste de l’application, ce qui réduit la complexité.
Les services Web facilitent les échanges entre les applications d’une même entreprise, mais surtout ils l’ouvrent vers les autres. Les premiers fournisseurs ont été les services en ligne de météo, de cours de la Bourse, de calcul d’itinéraire ou d’annuaire comme les pages jaunes, qui mettaient à la disposition des développeurs des API, payantes ou non, pour intégrer leur service à d’autres applications. Ce mouvement a pris depuis une ampleur considérable : cartes, paiement en ligne, envoi de SMS (les messages texte des téléphones), traduction, reconnaissance d’images, intelligence artificielle, presque tout se vend aujourd’hui sous forme d’API.
5Pour mémoire : les services Web de première génération
5.1Trois couches et deux organismes
Les services Web de première génération, souvent désignés aujourd’hui par le sigle WS-* (« WS-étoile », pour la famille de normes dont le nom commence par WS, Web Services), reposaient sur un modèle en couches, dont les trois couches fondamentales étaient :
- l’invocation, qui décrit la structure des messages échangés par les applications ;
- la découverte, qui permet de rechercher et de localiser un service dans un annuaire, lequel décrit le nom de la société qui le propose, l’objectif de chaque service, et ainsi de suite ;
- la description, qui décrit les interfaces des services : les paramètres des fonctions et les types de données.
Les standards de base (SOAP et WSDL, présentés plus bas) étaient normalisés par le W3C (World Wide Web Consortium, l’organisme qui établit les standards du Web), tandis que l’OASIS (Organization for the Advancement of Structured Information Standards, un consortium d’industriels) était chargée des couches supérieures, plus proches des applications, comme la sécurité des messages avec la norme WS-Security. Pour l’invocation, deux standards fondés sur XML coexistaient : XML-RPC, le plus ancien, et SOAP. Pour la découverte, le standard le plus utilisé était UDDI ; pour la description, WSDL. La figure 2 montre comment ils s’articulaient.
Quel que soit le standard utilisé, le principe de programmation était le même : l’appel d’une méthode distante passait par une bibliothèque cliente, qui transmettait la demande au fournisseur de service en la mettant en forme en XML, de manière transparente pour le programmeur ; côté serveur, une bibliothèque serveur décodait la requête ; le serveur faisait ses traitements, puis répondait par la même bibliothèque ; la bibliothèque cliente décodait enfin la réponse pour que l’application puisse l’utiliser. Le programmeur avait l’illusion d’appeler une fonction locale.
5.2XML-RPC
Le standard XML-RPC (XML Remote Procedure Call, « appel de procédure à distance en XML »), défini en 1998 par Dave Winer, de la société UserLand, avec des ingénieurs de Microsoft, est un protocole fondé sur XML qui permet d’appeler des procédures à distance. Il fonctionne selon un principe procédural : on appelle une fonction par son nom, avec des paramètres, et l’on reçoit un résultat. Il est sans gestion d’états : le serveur ne garde aucun souvenir d’un appel à l’autre. Sa simplicité lui a valu un certain succès ; il a notamment longtemps servi à publier des articles à distance sur les moteurs de blogs.
5.3SOAP
SOAP (Simple Object Access Protocol, « protocole simple d’accès aux objets ») est un protocole défini à l’origine par Microsoft avec UserLand, rejoints ensuite par IBM, puis standardisé par le W3C (version 1.2 en 2003). Il utilise la notation XML pour définir les mécanismes d’échange d’informations entre les clients et les fournisseurs de services Web. Chaque message est une enveloppe, qui contient un en-tête facultatif, pour les informations techniques comme l’authentification, et un corps, qui porte l’appel ou la réponse :
<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope">
<soap:Body>
<m:Prevision xmlns:m="https://meteo.example.org/ws">
<m:ville>Lyon</m:ville>
</m:Prevision>
</soap:Body>
</soap:Envelope>
Le transport des messages SOAP peut être assuré par HTTP, mais aussi par d’autres protocoles comme SMTP, celui du courrier électronique, ou FTP, celui du transfert de fichiers. Il existait des bibliothèques SOAP pour de très nombreux langages : Perl, C, C++, C#, Python, Java, Visual Basic .NET, PHP, Ruby, etc. SOAP accepte de nombreux types de données comme paramètres : entiers, dates, booléens (vrai ou faux), chaînes de caractères, tableaux et structures, tableaux associatifs. Il définit un mécanisme d’exceptions, l’élément Fault, qui permet de signaler les erreurs (voir les exceptions).
On lit parfois que SOAP fonctionne « selon le modèle objet », par opposition à XML-RPC. C’est trompeur : malgré son nom, SOAP n’a rien de spécifiquement orienté objet ; c’est un format d’enveloppe pour des messages, qui peuvent représenter des appels de procédures ou de simples documents. Depuis la version 1.2, le nom SOAP n’est d’ailleurs plus considéré comme un sigle.
5.4WSDL
Le standard WSDL (Web Services Description Language, « langage de description des services Web ») est un langage fondé sur XML qui décrit un service Web : son emplacement et les opérations qu’il propose, avec leurs méthodes, leurs paramètres et leurs valeurs de retour. Un document WSDL est un fichier XML qui utilise notamment les éléments suivants :
types, qui définit les types de données utilisés par le service ;message, qui décrit, en une ou plusieurs parties, les données échangées : les paramètres d’entrée, mais aussi, contrairement à ce qu’on lit parfois, les valeurs de sortie ;portType, qui définit le service, en particulier les opérations qu’il réalise et les messages échangés pour chacune ;binding, qui précise le protocole utilisé et le format des messages ;serviceetport, souvent omis, qui donnent l’adresse réseau à laquelle joindre le service.
La version 2.0 de WSDL, publiée en 2007, a rebaptisé portType en interface et port en endpoint. Les outils de développement savaient générer automatiquement, à partir d’un fichier WSDL, tout le code des bibliothèques cliente et serveur : c’était le principal atout de cette famille de standards.
5.5UDDI
Le standard UDDI (Universal Description, Discovery and Integration, « description, découverte et intégration universelles »), lancé en 2000 par Ariba, IBM et Microsoft puis confié à l’OASIS, décrit une manière standard de publier et d’interroger les services Web proposés sur un réseau, généralement au sein d’un annuaire qui recense les services d’une organisation. L’idée d’un grand annuaire mondial, où les programmes trouveraient seuls leurs partenaires commerciaux, ne s’est jamais concrétisée : l’annuaire public animé par IBM, Microsoft et SAP a fermé en janvier 2006, et avec lui le registre de Microsoft (uddi.microsoft.com). UDDI a survécu quelque temps dans des annuaires internes d’entreprises, puis il est tombé en désuétude.
5.6Ce qu’il en reste
Les services SOAP n’ont pas disparu : ils restent nombreux dans les banques, les assurances, les administrations, les télécommunications et les échanges entre entreprises, où des systèmes construits dans les années 2000 fonctionnent toujours. Mais leur lourdeur, la complexité des normes WS-* et la verbosité de XML les ont fait supplanter, pour presque tous les nouveaux développements, par un style beaucoup plus simple : REST.
6L’architecture orientée services
6.1Le problème des silos
Le système d’information d’une entreprise est généralement constitué d’applications et de données accumulées au fil des années, qui forment son héritage (en anglais legacy). Avec les fusions de groupes et l’évolution des technologies, cet héritage tend à devenir hétérogène et à se spécialiser par métier, par entité ou par service. Il en résulte un fonctionnement en silos : un cloisonnement des différents métiers qui empêche certaines formes de transversalité, et masque aux décideurs une vision globale du système d’information de l’entreprise. Le service commercial et le service de facturation ont chacun leur fichier des clients, qui ne concordent pas.
L’intégration des applications de l’entreprise, ou EAI (de l’anglais Enterprise Application Integration), a été une première réponse : elle consiste à développer des connecteurs spécifiques qui font communiquer entre eux les différents silos. Mais chaque nouvelle application exige de nouveaux connecteurs, et l’ensemble devient vite un enchevêtrement difficile à maintenir.
6.2Le principe
Une architecture orientée services, notée SOA (de l’anglais Service-Oriented Architecture ; on écrit parfois par erreur Services Oriented Architecture), est une architecture logicielle qui s’appuie sur un ensemble de services simples. Son objectif est de décomposer une fonctionnalité en un ensemble de fonctions élémentaires, appelées services, fournies par des composants, et de décrire finement le schéma d’interaction entre ces services. L’idée est de cesser de construire la vie de l’entreprise autour d’applications, pour bâtir une architecture logicielle globale, décomposée en services qui correspondent aux processus métiers de l’entreprise : « vérifier la solvabilité d’un client », « réserver un stock », « émettre une facture ». Lorsqu’une architecture SOA s’appuie sur des services Web, on parlait de WSOA (Web Services Oriented Architecture).
Il n’existe pas à proprement parler de spécification officielle de la SOA, mais on y retrouve des notions communes :
- la notion de service : une fonction encapsulée dans un composant, que l’on interroge par une requête comportant un ou plusieurs paramètres, et qui fournit une ou plusieurs réponses. Idéalement, chaque service est indépendant des autres, ce qui garantit sa réutilisabilité et son interopérabilité ;
- la description du service : les paramètres d’entrée, le format et le type des données retournées. Le principal format de description était WSDL, normalisé par le W3C ;
- la publication (en anglais advertising) et la découverte (discovery) des services : la publication consiste à inscrire dans un registre (en anglais registry ou repository) les services offerts aux utilisateurs, la découverte à rechercher un service parmi ceux qui ont été publiés. Le principal standard était UDDI, normalisé par l’OASIS ;
- l’invocation : la connexion et l’interaction du client avec le service, le plus souvent par SOAP.
6.3Avantages et limites
Une architecture orientée services offre tous les avantages d’une architecture client-serveur, et notamment :
- une modularité qui permet de remplacer facilement un composant, un service, par un autre ;
- une réutilisabilité des composants, par opposition à un système tout-en-un fait sur mesure pour une organisation ;
- de meilleures possibilités d’évolution : il suffit de faire évoluer un service ou d’en ajouter un nouveau ;
- une plus grande tolérance aux pannes, si chaque service est conçu pour fonctionner malgré la défaillance d’un autre ;
- une maintenance facilitée.
En pratique, beaucoup de projets SOA des années 2000 ont déçu. Ils s’appuyaient souvent sur un bus de services (en anglais Enterprise Service Bus, ESB), un logiciel central chargé d’acheminer et de transformer tous les messages, qui devenait à son tour un point de complexité et de fragilité. Les gains de réutilisation promis supposaient une gouvernance rigoureuse, rarement atteinte.
6.4Les microservices
Les idées de la SOA ont été reprises, dans les années 2010, par les microservices : une application est découpée en petits services indépendants, chacun avec sa propre base de données, développé et déployé par une petite équipe, et qui communiquent par des API Web légères plutôt que par un bus central. Popularisés par Amazon, Netflix ou Spotify, et facilités par les conteneurs (voir les conteneurs), ils permettent à des centaines d’équipes de livrer chacune à son rythme. Ils ont aussi leurs pièges : un découpage mal pensé produit un « monolithe distribué », aussi rigide qu’une application unique mais beaucoup plus difficile à surveiller, où une panne se propage d’un service à l’autre. Beaucoup d’équipes reviennent pour cette raison à des applications moins découpées.