Edge functions

Exécution de code côté serveur

Les edge functions sont des fonctions JavaScript/TypeScript qui s'exécutent sur le runtime Deno. Elles vous permettent d'implémenter une logique qui ne devrait pas, ou ne peut pas, s'exécuter dans le navigateur. L'IA crée ces fonctions quand vous décrivez des fonctionnalités qui nécessitent un traitement côté serveur, l'intégration d'une API externe ou une sécurité renforcée.

Ce que permettent les edge functions :

  • Traiter des formulaires avec validation et appels d'API externes
  • Intégrer des services : envoi d'e-mails, traitement de paiements, appels à des API d'IA
  • Protéger une logique sensible qui ne doit pas être visible dans le code du navigateur
  • Accéder aux secrets en toute sécurité, sans les exposer aux utilisateurs
  • Effectuer des opérations complexes trop lentes ou trop gourmandes en ressources pour le navigateur

Comment fonctionnent les fonctions

Quand l'IA crée une edge function pour vous, elle :

  1. Écrit le code JavaScript qui réalise la tâche que vous avez décrite
  2. Met en place le contrôle d'accès pour déterminer qui peut appeler la fonction
  3. Configure l'accès aux secrets si la fonction a besoin d'identifiants d'API externes
  4. Teste la fonction pour s'assurer qu'elle fonctionne correctement
  5. Fournit une URL que votre application peut appeler pour exécuter la fonction

Les fonctions s'exécutent dans des environnements isolés et sécurisés. Chaque exécution est journalisée avec sa durée, les éventuelles erreurs et l'utilisateur qui l'a déclenchée. Vous pouvez consulter ces journaux dans Paramètres > Configuration du site > Surveillance > Journaux pour suivre les performances de vos fonctions et diagnostiquer les problèmes.

Contrôle d'accès des fonctions

Comme les tables de base de données, les edge functions ont des politiques de sécurité qui contrôlent qui peut les exécuter. L'IA les met en place selon ce que vous construisez :

Fonctions publiques

N'importe qui peut les appeler, même sans être connecté. Utilisées pour les gestionnaires de webhooks (comme les notifications de paiement Stripe), les API publiques ou les points de contrôle de santé.

Fonctions authentifiées

Seuls les utilisateurs connectés peuvent les appeler. La plupart des fonctions utilisent cette politique : elle convient aux fonctionnalités destinées aux utilisateurs, à l'envoi de formulaires ou à la récupération de données pour votre application.

Accès par groupe

Seuls les utilisateurs de certains groupes (comme « admin ») peuvent appeler la fonction. Idéal pour les opérations d'administration, les outils de modération ou les fonctionnalités propres à une équipe.

Accès par métadonnées

Accès fondé sur des attributs d'utilisateur personnalisés. Par exemple, seuls les utilisateurs avec department = "engineering" peuvent appeler certaines fonctions. Cela permet des schémas de permissions souples et sur mesure.

Ce que les fonctions peuvent faire

Accès à la base de données

Les fonctions peuvent interroger et modifier votre base de données, avec les mêmes règles de sécurité appliquées.

Appels d'API externes

Les fonctions peuvent communiquer avec des services externes en utilisant vos secrets stockés.

Logique complexe

Les fonctions peuvent effectuer des calculs, des transformations de données, des validations ou des workflows en plusieurs étapes.

E-mails et notifications

Envoyez des e-mails transactionnels, des SMS ou des notifications push en réponse aux actions des utilisateurs.

Traitement des paiements

Gérez les flux de paiement, le traitement des webhooks ou la gestion des abonnements avec des services comme Stripe.

Intégration d'IA

Appelez des API d'IA comme OpenAI ou Anthropic pour générer du contenu, analyser des données ou proposer des fonctionnalités intelligentes.

Surveillance et journaux

Chaque exécution de fonction est automatiquement journalisée avec :

  • Le moment de l'appel et son auteur
  • La durée d'exécution
  • Le succès ou les erreurs rencontrées
  • Toute sortie console ou tout message d'erreur
  • La réponse renvoyée

Bonnes pratiques

✅ Décrivez clairement — quand vous demandez à l'IA de créer une fonction, précisez ce qu'elle doit faire et qui doit pouvoir l'appeler.

✅ Surveillez les journaux — consultez les journaux d'exécution pour comprendre les performances et repérer rapidement les erreurs.

✅ Gardez les secrets dans le gestionnaire de secrets — l'IA utilisera les secrets stockés plutôt que de les écrire en dur dans les fonctions.

❌ N'exposez pas d'opérations sensibles — laissez l'IA configurer les contrôles d'accès appropriés. Les fonctions d'administration ne doivent jamais être publiques.


Documentation associée :