Concevoir des API sur AWS

Développer des applications sur AWS

Ricardo Sueiras

Principal Technologist

API Gateway

 

 

• Amazon API Gateway : service managé pour créer des API.
• Concevez, déployez, gérez et sécurisez vos API.

Capacités d'Amazon API Gateway

 

• Implémentez différents types d'API.

Capacités d'Amazon API Gateway

 

• Implémentez différents types d'API.
• Intégrez des services backend.

Capacités d'Amazon API Gateway

 

• Implémentez différents types d'API.
• Intégrez des services backend.
• Sécurisez l'accès aux API.

Capacités d'Amazon API Gateway

 

• Implémentez différents types d'API.
• Intégrez des services backend.
• Sécurisez l'accès aux API.
• Limitez le débit pour protéger les backends.

Capacités d'Amazon API Gateway

 

• Implémentez différents types d'API.
• Intégrez des services backend.
• Sécurisez l'accès aux API.
• Limitez le débit pour protéger les backends.
• Transformez les charges utiles des requêtes et réponses.

Capacités d'Amazon API Gateway

 

• Implémentez différents types d'API.
• Intégrez des services backend.
• Sécurisez l'accès aux API.
• Limitez le débit pour protéger les backends.
• Transformez les charges utiles des requêtes et réponses.
• Publiez des API pour les consommateurs.

Capacités d'Amazon API Gateway

 

• Implémentez différents types d'API.
• Intégrez des services backend.
• Sécurisez l'accès aux API.
• Limitez le débit pour protéger les backends.
• Transformez les charges utiles des requêtes et réponses.
• Publiez des API pour les consommateurs.
• Gérez le cycle de vie : versions, déploiement, alias.

Types d'API

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

 

Points de terminaison d'API Gateway

• Les points de terminaison contrôlent l'accès client à votre API.
• Edge-optimized : CloudFront géré par AWS pour une faible latence mondiale.
• Regional : déployé dans une Région AWS spécifique.
• Private : accessible uniquement via AWS PrivateLink.
• Les endpoints privés restent hors d'internet public.

 

REST APIs

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

 

Cas d'usage des REST APIs

 

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

Prise en charge des REST APIs par API Gateway

 

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

Prise en charge des REST APIs par API Gateway

 

 

• Trois types d'endpoints pris en charge :
  • Edge-optimized
  • Regional
  • Private
• Protection contre les attaques web avec AWS WAF.
• Déploiements canary.
• Observabilité via AWS X-Ray et journaux CloudWatch.

Compromis des REST APIs

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

 

HTTP APIs

• Optimisées pour performances et coûts plutôt que la richesse fonctionnelle :
  • Performances
  • Coûts

 

Cas d'usage des HTTP APIs

• Charges serverless et API sur Lambda.
• Microservices et proxys légers.
• Applications sensibles à la latence.
• API utilisant l'authentification OAuth 2.0 / OIDC.

 

Prise en charge des HTTP APIs par API Gateway

 

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

Compromis des HTTP APIs

 

• Les HTTP APIs ne prennent PAS en charge :

  • Clés d'API
  • Plans d'usage
  • Validation des requêtes
  • Mise en cache des réponses
  • Traces avec AWS X-Ray

  • Transformation VTL des charges utiles

  • Pris en charge uniquement :

    • Endpoints edge ou privés (régional uniquement)

WebSocket APIs

 

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

Cas d'usage des WebSocket APIs

• Applications de chat.
• Notifications en temps réel.
• Tableaux de bord en temps réel.

 

Prise en charge des WebSocket APIs par API Gateway

• Transformations des données de charge utile.
• 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 trouvée

 

Mise en cache d'API

• Mettre en cache les réponses réduit la charge des backends.
• Améliore les performances des API.
• Cas d'usage typiques :
  • Données fréquemment demandées
  • API majoritairement en lecture
  • Réduire les invocations Lambda

 

Mise en cache d'API

 

• Les réponses mises en cache expirent après un TTL configurable.
• Gérez les données périmées en :
  • Configurant l'expiration du cache
  • Vidant le cache

Bonnes pratiques : nommez 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

Bonnes pratiques : versionnez les API

 

• Versionnez les API pour les faire évoluer en sécurité.
• Évitez de casser 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

• Publiez et partagez des REST APIs via un portail web.
• Fournissez une documentation aux consommateurs d'API.
• Principales fonctions :
  • Documentation d'API (fichiers Swagger)
  • Onboarding des consommateurs
  • Téléchargements d'SDK
  • Inscription de clés d'API et abonnements

 

Spécifications OpenAPI

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

 

Passons à la pratique !

Développer des applications sur AWS