Partager via

Fonctions définies par l’utilisateur dans le registre confidentiel Azure (préversion)

Le registre confidentiel Azure fournit des fonctions définies par l’utilisateur (UDF) pour exécuter une logique personnalisée à l’intérieur du registre. Cette fonctionnalité vous permet d’étendre les fonctionnalités du registre en écrivant du code personnalisé qui peut être exécuté dans un environnement confidentiel et interagir avec les données du registre.

Les nouvelles fonctionnalités de programmation permettent aux utilisateurs de créer des fonctions définies par l’utilisateur simples et des fonctions définies par l’utilisateur avancées pour effectuer diverses opérations avec différents niveaux de personnalisation. Une fois définies, les fonctions définies par les utilisateurs peuvent être appelées par les clients du registre confidentiel d’Azure pour s’exécuter directement à l’intérieur du moteur de registre.

Important

Les fonctions définies par l’utilisateur sont actuellement en préversion. Vous pouvez demander l’accès à cette préversion via ce formulaire d’inscription. Consultez les conditions d’utilisation supplémentaires pour les préversions Microsoft Azure pour les conditions légales qui s’appliquent aux fonctionnalités Azure qui sont en version bêta, en préversion ou qui ne sont pas encore publiées dans la disponibilité générale.

Fonctions définies par l’utilisateur simples et avancées

Le registre confidentiel Azure offre deux types de fonctionnalités UDF :

  • Fonctions définies par l’utilisateur simples : Les fonctions simples définies par l’utilisateur sont des fonctions personnalisées qui peuvent être définies et exécutées dans le registre. Ils vous permettent d’effectuer des opérations simples à l’aide de l’API JavaScript et peuvent être intégrés à l’API d’écriture de registre existante. Découvrez-en davantage sur les simples fonctions définies par l’utilisateur ici.

  • Fonctions définies par l’utilisateur (UDF) avancées : les UDF sont des points de terminaison personnalisés qui peuvent être définis et exposés sur une application de registre. Ces points de terminaison peuvent être utilisés pour exposer des API plus sophistiquées avec des paramètres personnalisables, des formats de données et des mécanismes d’authentification. Apprenez-en davantage sur les UDF avancées ici.

Voici une comparaison des principales fonctionnalités et capacités des fonctions définies par l’utilisateur simples et avancées :

Capacité UDF simples UDF avancées
Exécuter une logique métier personnalisée Oui Oui
Personnalisation des arguments/paramètres d’exécution Oui Oui
Exposer de nouvelles API/ points de terminaison Non Oui
Exécuter des fonctions individuelles Oui Non
Exécuter des hooks avant / après une opération d’écriture d’entrée de registre Oui Non
Création et mise à jour du code personnalisé Oui (mise à jour/suppression granulaire de chaque fonction) Oui (mise à jour de bundle d’application unique pour tous les points de terminaison)
Options de runtime JavaScript personnalisées Oui (par chaque exécution) Oui (globalement)
Exécution sur les nœuds de sauvegarde Non Oui
Prise en charge de plusieurs formats de données pour l’entrée et la sortie Non Oui
Authentification et autorisation personnalisées Non Oui
Scénarios cibles Exécution d’une logique personnalisée et d’intégration simples avec l’API de registre Cas d’usage avancés nécessitant des API personnalisées et un contrôle sur les paramètres JavaScript avancés

Basculer entre les UDF simples et avancées

Les UDF simples et avancées sont des fonctionnalités mutuellement exclusives. Vous ne pouvez pas créer ou exécuter des fonctions définies par l’utilisateur simples si des fonctions définies par l’utilisateur avancées sont définies, et inversement. Il est possible de basculer entre les deux fonctionnalités en procédant comme suit.

Important

Le basculement entre les fonctions définies par l’utilisateur simple et avancées est une opération destructrice. Toutes les fonctions définies par l’utilisateur simples ou avancées existantes sont supprimées lors du basculement vers l’autre fonctionnalité. Veillez à sauvegarder les données importantes avant de continuer.

Passer de fonctions définies par l’utilisateur simples à avancées

Pour passer de fonctions définies par l’utilisateur simples à avancées, vous devez supprimer toutes les UDF existantes :

  1. Répertoriez toutes les UDF stockées dans le registre à l’aide de l’API GET /app/userDefinedFunctions.

  2. Supprimez chaque fonction UDF, une par une, à l’aide de l’API DELETE /app/userDefinedFunctions/{functionId} .

Des UDF avancées aux UDF simples

Pour passer des UDF avancées à des UDF simples, vous devez définir les fonctions avancées avec des modules et des définitions de points de terminaison vides.

  1. Créez un bundle d’applications avec la structure suivante :

    {
    "metadata": {
        "endpoints": {}
    }, 
   "modules": []
}

  2. Déployez le bundle d’applications avec le corps de la requête défini à l’étape 1 à l’aide de l’API PUT /app/userDefinedEndpoints .

Étapes suivantes

Pour commencer avec les fonctionnalités des UDF dans le registre confidentiel Azure, reportez-vous aux articles suivants :

Contenu connexe

  • Last updated on