Planification d’une fonction externe pour Azure¶

Portail Azure¶

Vous pouvez utiliser le portail Azure pour créer une fonction Azure (en tant que service distant) et une instance de service de gestion des API (en tant que service proxy). Si vous choisissez cette méthode, vous utilisez également le portail Azure pour configurer les paramètres de sécurité.

Les instructions relatives à la création d’une fonction externe à l’aide du portail Azure comprennent un exemple de fonction Azure et des détails sur la création d’une instance de service de gestion de base des API :

• Les utilisateurs novices peuvent utiliser les instructions et l’exemple de la fonction Azure avec peu ou pas de modifications.

• Les utilisateurs expérimentés peuvent utiliser les instructions et l’exemple Azure Function comme point de départ pour créer une fonction Azure personnalisée et une instance de service de gestion des API configurée de manière personnalisée.

Modèle ARM (Azure Resource Manager)¶

Un modèle ARM utilise JSON pour décrire les informations de configuration d’une fonction Azure (en tant que service distant) et d’une instance de service de gestion des API Azure (en tant que service proxy).

Snowflake fournit un exemple de modèle ARM qui comprend les éléments suivants :

• Exemple de fonction Azure.

• La plupart des informations de configuration d’un exemple de service de gestion des API. Vous devez entrer quelques informations supplémentaires si vous souhaitez personnaliser l’exemple de service de gestion des API.

• Code pour créer un compte de stockage nécessaire au service Azure Functions.

• Code pour ajouter une politique validate-JWT (JSON Web Token) à l’instance de gestion des API afin d’accroître la sécurité du service de gestion des API Azure. Cependant, vous devez mettre à jour manuellement la politique validate-JWT avant de l’utiliser.

Les modèles ARM peuvent être utiles tant aux utilisateurs novices qu’aux utilisateurs expérimentés :

• Les utilisateurs novices voudront peut-être commencer par l’exemple de modèle Snowflake, car il réduit le nombre d’étapes nécessaires à la création de la fonction Azure et de l’instance de service de gestion des API.

  Notez que bien que ces instructions basées sur un modèle vous aident à créer rapidement votre première fonction externe, elles sautent des étapes dont la plupart des utilisateurs ont besoin lorsqu’ils créent des fonctions externes personnalisées.

• Les utilisateurs expérimentés peuvent vouloir utiliser les modèles ARM car les modèles peuvent être utilisés pour automatiser le déploiement. Cela peut être utile si vous développez une fonction Azure et un service de gestion des API de manière itérative.

Pour plus d’informations sur la configuration d’Azure Functions à l’aide de modèles ARM, consultez la documentation Microsoft : Déploiement de ressources .

Choisir le plan tarifaire pour votre fonction Azure¶

Dans Microsoft Azure, une fonction Azure (service distant) peut être exécutée sur un hôte Linux ou Windows. Pour l’instant, Azure propose différentes combinaisons de prix et d’options d’authentification pour les hôtes Linux et Windows.

Si vous prévoyez d’exécuter votre fonction Azure sur Linux, vous devez choisir une combinaison valide de plan tarifaire Azure et d’authentification :

• Si vous utilisez le plan tarifaire Premium ou App Service :

  • Créez l’application Azure AD (Active Directory) à partir de l’onglet Authentication/Authorization de l’écran Azure Functions du portail Azure.

  • Utiliser Azure AD pour l’authentification avec le service Azure Functions.

  Des détails et des liens supplémentaires sont fournis plus loin dans les instructions pour la création d’un service distant.

• Si vous utilisez le plan tarifaire de consommation :

  • Créez manuellement l’application Azure AD dans le portail Azure. Des détails supplémentaires sont fournis plus loin dans les instructions pour la création d’un service distant.

  • Définissez une politique validate-JWT pour l’instance de gestion des API. Pour plus de détails, voir Étape 6 : Créez la politique de sécurité Azure pour le service proxy dans le portail.

  • Utilisez les restrictions d’adresse IP pour limiter le service à distance à l’acceptation des connexions uniquement à partir de l’instance de service API Management. Pour plus de détails, voir Restreindre les adresses IP qui acceptent les appels Azure Functions (facultatif).

Créer une feuille de calcul pour le suivi des informations requises¶

Lorsque vous effectuez des tâches pour créer une fonction externe dans le portail Azure, vous devez saisir des valeurs spécifiques (par exemple, le nom du service de gestion des API) à chaque étape du processus. Souvent, les valeurs que vous saisissez sont requises dans les étapes suivantes.

Pour faciliter l’enregistrement/le suivi de ces informations, nous avons fourni une feuille de calcul avec des champs pour chacune des valeurs requises :

================================================================================
======================= Tracking Worksheet: Azure Portal =======================
================================================================================

****** Step 1: Azure Function (Remote Service) Info ****************************

Azure Function app name: _______________________________________________________
HTTP-Triggered Function name: __________________________________________________
Azure Function AD app registration name: _______________________________________
Azure Function App AD Application ID: __________________________________________

    (The value for the Azure Function App AD Application ID above is the
    "Application (client) ID" of the Azure AD app registration for the
    Azure Function. The value is used to fill in the "azure_ad_application_id"
    field in the CREATE API INTEGRATION command. This value is in the form of a
    UUID (universally unique identifier), which contains hexadecimal digits and
    dashes.)


****** Step 2: Azure API Management Service (Proxy Service) Info ***************

API Management service name: ___________________________________________________
API Management API URL suffix: _________________________________________________


****** Steps 3-5: API Integration & External Function Info *********************

API Integration Name: __________________________________________________________
AZURE_MULTI_TENANT_APP_NAME: ___________________________________________________
AZURE_CONSENT_URL: _____________________________________________________________

External Function Name: ________________________________________________________

Télécharger le modèle¶

Le modèle peut être téléchargé à partir du référentiel Snowflake dans GitHub.

Avant de pouvoir utiliser le modèle, vous devez l’importer dans le portail Azure. Les détails de l’importation du modèle sont inclus plus loin dans la rubrique qui décrit l’utilisation du modèle.

Choisir le plan tarifaire pour votre fonction Azure¶

Dans Microsoft Azure, une fonction Azure (service distant) peut être exécutée sur un hôte Linux ou Windows. Pour l’instant, Azure propose différentes combinaisons de prix et d’options d’authentification pour les hôtes Linux et Windows.

Le modèle ARM fourni par Snowflake utilise par défaut le plan tarifaire et les informations d’authentification suivants :

• Par défaut, la fonction Azure utilise un hôte Windows.

• La valeur par défaut est le niveau de prix « Consommation ».

• Crée une application Azure Functions et configure cette application pour qu’elle nécessite une authentification AD (Active Directory).

• Crée une politique de sécurité pour valider un JWT (JSON Web Token) qui autorise Snowflake à appeler votre fonction Azure.

  Notez qu’il manque un champ à cette politique de sécurité ; les instructions fournies plus loin vous indiquent comment remplir ce champ.

Si vous prévoyez d’exécuter votre instance de gestion des API Azure ou une fonction Azure avec une configuration différente, vous devez mettre à jour le modèle. Pour plus d’informations sur la mise à jour du modèle, consultez la documentation Microsoft :

• Automatisation du déploiement des ressources (pour votre application de fonction dans Azure Functions)

Créer une feuille de calcul pour le suivi des informations requises¶

Lorsque vous effectuez les tâches pour créer une fonction externe en utilisant le modèle ARM fourni par Snowflake, vous devez saisir des valeurs spécifiques (par exemple, le nom de service de gestion des API) à chaque étape du processus. Souvent, les valeurs que vous saisissez sont requises dans les étapes suivantes.

Pour faciliter l’enregistrement/le suivi de ces informations, nous avons fourni une feuille de calcul avec des champs pour chacune des valeurs requises :

================================================================================
======================= Tracking Worksheet: ARM Template =======================
================================================================================

****** Step 1: Azure Function (Remote Service) Info ****************************

HTTP-Triggered Function name: __________________ echo __________________________
Azure Function AD Application ID: ______________________________________________

    (The value for the Azure Function AD Application ID above is the
    "Application (client) ID" of the Azure AD app registration for the
    Azure Function. The value is used to fill in the "azure_ad_application_id"
    field in the CREATE API INTEGRATION command. This value is in the form of a
    UUID (universally unique identifier), which contains hexadecimal digits and
    dashes.)


****** Step 2: Azure API Management Service (Proxy Service) Info ***************

API Management service name: ___________________________________________________
API Management URL: ____________________________________________________________
Azure Function HTTP Trigger URL: _______________________________________________
API Management API URL suffix: _________________________________________________


****** Steps 3-5: API Integration & External Function Info *********************

API Integration Name: __________________________________________________________
AZURE_MULTI_TENANT_APP_NAME: ___________________________________________________
AZURE_CONSENT_URL: _____________________________________________________________

External Function Name: ________________________________________________________