Passer au contenu principal
Depuis le 15 janvier 2025, l’environnement d’exécution d’extensibilité Node 22 est offert en disponibilité générale (GA) dans l’ensemble de nos offres d’extensibilité. Cela comprend Actions, Rules, Hooks, les scripts de base de données et les connexions sociales personnalisées. Nous vous encourageons fortement à passer à Node 22 dès que possible afin de respecter les pratiques exemplaires en matière de sécurité du code.
Le code défini au niveau du module dans vos Actions n’est désormais invoqué qu’une seule fois par instance de votre Action et peut être réutilisé au besoin pour de nombreuses exécutions.

​
Considérations générales

  • Pour connaître les modules offerts dans le nouvel environnement d’exécution, vous pouvez consulter Can I require: Auth0 Extensibility.
  • La directive use npm n’est plus offerte dans Node 22.
  • L’accès en écriture au système de fichiers a été désactivé.

​
Intégrations du Marketplace

​
Intégrations des connexions sociales

Utilisez la Management API pour obtenir la liste complète des connexions sociales touchées par un changement de version de l’environnement d’exécution Node. Plus précisément, toutes les connexions sociales potentiellement touchées, qu’elles aient été créées explicitement comme connexions sociales personnalisées ou ajoutées initialement par l’entremise du Marketplace, ont l’attribut strategy dont la valeur est oauth1 ou oauth2. Vous pouvez ensuite parcourir, par pagination, toutes les connexions sociales personnalisées existantes dans un locataire donné à l’aide du point de terminaison GET all connections. Par exemple, les options de requête suivantes renvoient les noms et les identifiants d’un maximum de 100 connexions sociales personnalisées : 
/api/v2/connections?strategy=oauth1&strategy=oauth2&include_totals=true&fields=name&per_page=100
Le ne permet pas de mettre à jour les scripts des connexions sociales personnalisées ajoutées via Marketplace. Si une modification du script est nécessaire pour assurer la compatibilité avec Node 22, vous devez utiliser la .

​
Tâches de migration

​
Créer de nouvelles Actions personnalisées

Pour créer une nouvelle Action personnalisée avec Node 22 à partir de l’Auth0 Dashboard :
  1. Accédez à Auth0 Dashboard > Actions > Library.
  2. Sélectionnez Create Action > Build from scratch.
  3. Dans le champ Runtime*, sélectionnez Node 22 (Recommended).
  4. Écrivez vos Actions personnalisées en Node 22, testez-les, puis déployez-les lorsque vous êtes prêt.

​
Mettre à niveau des Actions personnalisées existantes

Vous pouvez mettre à niveau individuellement des Actions personnalisées existantes créées avec Node 12, 16 ou 18 vers Node 22, puis revenir à la version précédente en utilisant l’ancien environnement d’exécution. Pour mettre à niveau des Actions vers Node 22, créez et déployez une nouvelle version de l’implémentation existante en y apportant les modifications requises, puis configurez-la pour utiliser Node 22 comme environnement d’exécution.

​
Choisir Node 22 pour les autres produits d’extensibilité

L’environnement d’exécution utilisé pour les autres fonctionnalités d’extensibilité (à l’exclusion d’Actions) est défini globalement dans les paramètres avancés du locataire. La modification de ce paramètre a une incidence sur les fonctionnalités suivantes en même temps :
  • Rules
  • Hooks
  • Scripts de base de données personnalisés
  • Scripts personnalisés de connexion sociale
Pour modifier le paramètre d’environnement d’exécution de l’extensibilité du locataire dans l’Auth0 Dashboard :
  1. Accédez à Dashboard > Settings > Advanced.
  2. Faites défiler jusqu’à la section Extensibility.
  3. Pour Runtime, sélectionnez Node 22.
  4. Pour Legacy Extensibility, sélectionnez la version de l’environnement d’exécution, s’il y a lieu.
Comme il s’agit d’un paramètre global qui touche simultanément plusieurs fonctionnalités d’extensibilité, nous vous recommandons d’effectuer d’abord cette étape dans votre locataire de développement, de terminer les tests de toutes les fonctionnalités d’extensibilité applicables, puis de passer à votre locataire de production seulement lorsque vous ne constatez aucun problème dans l’environnement de développement. Plus précisément, pour les scripts de base de données personnalisés, vous pouvez suivre les étapes expliquées sur cette page afin de vérifier individuellement un script avec une version précise de l’environnement d’exécution avant de modifier la version globale de l’environnement d’exécution.