Concevoir des API sur AWS

Développer des applications sur AWS

Ricardo Sueiras

Principal Technologist

API Gateway

 

 

• Amazon API Gateway : service géré pour créer des API.
• Concevoir, déployer, gérer et sécuriser vos API.

Capacités d'Amazon API Gateway

 

• Mettre en œuvre différents types d'API.

Capacités d'Amazon API Gateway

 

• Mettre en œuvre différents types d'API.
• Intégrer des services dorsaux.

Capacités d'Amazon API Gateway

 

• Mettre en œuvre différents types d'API.
• Intégrer des services dorsaux.
• Sécuriser l'accès aux API.

Capacités d'Amazon API Gateway

 

• Mettre en œuvre différents types d'API.
• Intégrer des services dorsaux.
• Sécuriser l'accès aux API.
• Limiter le débit pour protéger les dorsales.

Capacités d'Amazon API Gateway

 

• Mettre en œuvre différents types d'API.
• Intégrer des services dorsaux.
• Sécuriser l'accès aux API.
• Limiter le débit pour protéger les dorsales.
• Transformer les charges utiles des requêtes et des réponses.

Capacités d'Amazon API Gateway

 

• Mettre en œuvre différents types d'API.
• Intégrer des services dorsaux.
• Sécuriser l'accès aux API.
• Limiter le débit pour protéger les dorsales.
• Transformer les charges utiles des requêtes et des réponses.
• Publier des API pour les consommateurs.

Capacités d'Amazon API Gateway

 

• Mettre en œuvre différents types d'API.
• Intégrer des services dorsaux.
• Sécuriser l'accès aux API.
• Limiter le débit pour protéger les dorsales.
• Transformer les charges utiles des requêtes et des réponses.
• Publier des API pour les consommateurs.
• Gérer le cycle de vie : versions, déploiement, alias.

Types d'API

• API Gateway prend en charge trois types d'API :
  • API REST
  • API HTTP
  • API WebSocket

 

Points de terminaison d'API Gateway

• Les points de terminaison contrôlent l'accès des clients à votre API.
• Optimisé périphérie : CloudFront géré par AWS pour une faible latence mondiale.
• Régional : déployé dans une région AWS précise.
• Privé : accessible uniquement via AWS PrivateLink.
• Les points de terminaison privés restent hors d'internet public.

 

API REST

• Offre API Gateway la plus complète en fonctionnalités.
• Modèle synchrone requête/réponse.

 

Cas d'usage des API REST

 

• API d'entreprise nécessitant une gestion complète du cycle de vie.
• API exigeant des contrôles de sécurité avancés.
• Écosystèmes de développeurs tiers avec clés d'API et plans d'utilisation.
• Intégrations directes aux services AWS sans Lambda.

Prise en charge des API REST d'API Gateway

 

• Validation des requêtes.
• Clés d'API.
• Plans d'utilisation et limitation de débit.
• Mise en cache des réponses avec TTL configurable.
• Transformation requête/réponse via gabarits VTL.
• Authentification IAM (Signature V4).
• Autorisateurs Lambda, bassins d'utilisateurs Cognito.

Prise en charge des API REST d'API Gateway

 

 

• Trois types de points de terminaison pris en charge :
  • Optimisé périphérie
  • Régional
  • Privé
• Protection contre les exploits Web avec AWS WAF.
• Déploiements canaris.
• Observabilité via AWS X-Ray et journaux CloudWatch.

Compromis des API REST

• Plus coûteuses que les API HTTP.
• Légèrement plus de latence.

 

API HTTP

• Optimisées pour la performance et le coût plutôt que l'étendue des fonctions :
  • Performance
  • Coût

 

Cas d'usage des API HTTP

• Charges sans serveur et API soutenues par Lambda.
• Microservices et API mandataires légères.
• Applications sensibles à la latence.
• API utilisant l'authentification OAuth 2.0 / OIDC.

 

Prise en charge des API HTTP d'API Gateway

 

• Intégrations mandataires Lambda et autorisateurs.
• Autorisation JWT/OIDC native (Cognito, Auth0, Okta).
• Configuration CORS intégrée au niveau API.
• Intégrations VPC privées via VPC Link.
• Mappage de paramètres de base pour en-têtes, chaînes de requête et chemins.

Compromis des API HTTP

 

• Les API HTTP NE prennent PAS en charge :

  • Clés d'API
  • Plans d'utilisation
  • Validation des requêtes
  • Mise en cache des réponses
  • Traçage avec AWS X-Ray

  • Transformation de charge utile VTL

  • Prise en charge uniquement :

    • Points de terminaison périphérie ou privés (régional seulement)

API WebSocket

 

• Communication bidirectionnelle entre clients et serveurs.
• Connexion maintenue ouverte, contrairement aux API REST et HTTP.
• Les serveurs peuvent pousser des données aux clients connectés.

Cas d'usage des API WebSocket

• Applications de clavardage.
• Avis en temps réel.
• Tableaux de bord en temps réel.

 

Prise en charge des API WebSocket d'API Gateway

• Transformations des charges utiles.
• Validation des requêtes.
• Routes intégrées spéciales :
  • $connect : le client établit une connexion
  • $disconnect : le client se déconnecte
  • $default : aucune route correspondante

 

Mise en cache d'API

• Mettre en cache les réponses réduit la charge sur la dorsale.
• Améliore la performance des API.
• Cas typiques :
  • Données souvent demandées
  • API majoritairement en lecture
  • Réduction des invocations Lambda

 

Mise en cache d'API

 

• Les réponses mises en cache expirent après un TTL configurable.
• Gérer les données désuètes en :
  • réglant l'expiration du cache
  • vidant le cache

Meilleures pratiques de conception d'API : nommer clairement les ressources

 

• Les chemins doivent représenter des ressources, pas des actions.
• Utilisez des noms, pas des verbes.
• Bon :
  • GET /orders/123
• À éviter :
  • GET /getOrder/123

Meilleures pratiques de conception d'API : versionner les API

 

• Versionner les API pour les faire évoluer en toute sécurité.
• Éviter de briser les clients existants.
• Approches courantes :
  • Version dans l'URI : GET /v1/orders
  • Paramètre de requête : GET /orders?version=1
  • En-tête HTTP : Accept-Version: v1

Portails pour développeurs d'API

• Publier et partager des API REST via un portail Web.
• Fournir de la documentation aux consommateurs d'API.
• Principales fonctions :
  • Documentation d'API (fichiers Swagger)
  • Intégration des consommateurs
  • Téléchargements de SDK
  • Inscription de clés d'API et parcours d'abonnement

 

Spécifications OpenAPI

• OpenAPI (Swagger) : norme pour décrire les API REST.
• API Gateway peut importer et exporter des spécifications OpenAPI.

 

Passons à la pratique !

Développer des applications sur AWS