Automatiser l’installation d’une application modèle avec Azure

Automatisez l’installation d’une application modèle pour simplifier le processus de déploiement de Power BI pour vos clients. Les applications modèles fournissent des rapports prédéfinis qui se connectent aux données client, mais la configuration manuelle peut être difficile pour les utilisateurs qui ne connaissent pas les détails de connexion.

Ce tutoriel montre aux fournisseurs de services de données comment automatiser la configuration des paramètres de paramètre d’application modèle à l’aide d’Azure Functions. Lorsque les clients cliquent sur un lien préconfiguré, l’automatisation recueille les informations nécessaires, définit des paramètres et les redirige pour installer l’application, nécessitant uniquement l’authentification pour terminer la configuration.

Lorsque le client se connecte à votre portail, il sélectionne un lien spécial que vous avez préparé. Ce lien :

• Lance l’automatisation, qui collecte les informations dont elle a besoin.
• Préconfigure les paramètres de l’application modèle.
• Redirige le client vers son compte Power BI où il peut installer l’application.

Tout ce qu’ils doivent faire est de sélectionner Installer et s’authentifier sur leur source de données, et ils sont bons à aller !

L’expérience client est illustrée ici.

Dans ce tutoriel, vous allez utiliser un exemple d’installation automatisée d’Azure Functions que nous avons créé pour préconfigurer et installer votre application modèle. Cet exemple a été délibérément gardé simple à des fins de démonstration. Il encapsule la configuration d’une fonction Azure pour utiliser les API Power BI pour installer une application modèle et la configurer automatiquement pour vos utilisateurs.

Pour plus d’informations sur le flux d’automatisation général et les API utilisées par l’application, consultez Automatiser la configuration d’une installation d’application modèle.

Notre application simple utilise une fonction Azure. Pour plus d’informations sur Azure Functions, consultez la documentation Azure Functions.

Flux de base

Le flux de base suivant répertorie ce que fait l’application lorsque le client le lance en sélectionnant le lien dans votre portail.

1. L’utilisateur se connecte au portail du fournisseur de logiciels indépendants et sélectionne le lien fourni. Cette action lance le flux. Le portail de l’éditeur de logiciels indépendants prépare à ce stade une configuration personnalisée pour l’utilisateur.
2. L’ISV acquiert un jeton d’application uniquement basé sur un principal de service (jeton d’application uniquement) inscrit dans le locataire de l’ISV.
3. À l’aide des API REST Power BI, l’éditeur de logiciels indépendants crée un ticket d’installation, qui contient la configuration de paramètre spécifique à l’utilisateur telle qu’elle est préparée par l’éditeur de logiciels indépendants.
4. L’éditeur de logiciels indépendants redirige l’utilisateur vers Power BI à l’aide d’une POST méthode de redirection, qui contient le ticket d’installation.
5. L’utilisateur est redirigé vers son compte Power BI avec le ticket d’installation et est invité à installer l’application modèle. Lorsque l’utilisateur sélectionne Installer, l’application modèle est installée pour eux.

Prerequisites

• Configuration de votre tenant Microsoft Entra personnel. Pour obtenir des instructions sur la configuration d’une instance, consultez Créer une instance Microsoft Entra.
• Un principal de service (jeton uniquement pour l'application) enregistré dans l'entité précédente.
• Application de modèle paramétrable prête pour l’installation. L’application modèle doit être créée dans le même locataire dans lequel vous inscrivez votre application dans Microsoft Entra ID. Pour plus d’informations, consultez Conseils pour créer des applications modèles ou créer une application modèle dans Power BI.
• Pour pouvoir tester votre flux de travail Automation, ajoutez le principal de service à l’espace de travail de l’application modèle en tant qu’administrateur.
• Une licence Power BI Pro. Si vous n’êtes pas inscrit à Power BI Pro, inscrivez-vous à un essai gratuit avant de commencer.

Configurer votre environnement de développement d'automatisation

Avant de continuer à configurer votre application, suivez les instructions de démarrage rapide : Créez une application Azure Functions avec Azure App Configuration pour développer une fonction Azure avec une configuration d’application Azure. Créez votre configuration d’application comme décrit dans l’article.

Inscrire une application dans Microsoft Entra ID

Créez un principal de service comme décrit dans Incorporer du contenu Power BI avec un principal de service et un secret d’application.

Veillez à inscrire l’application en tant qu’application web côté serveur. Vous inscrivez une application web côté serveur pour créer un secret d’application.

Enregistrez l’ID d’application (ClientID) et la clé secrète d’application (ClientSecret) pour les étapes ultérieures.

Ajoutez le principal de service à l’espace de travail de l’application modèle en tant qu’administrateur afin de pouvoir tester le flux de travail d'automatisation.

Préparation de l’application modèle

Une fois que vous avez créé votre application modèle et qu’elle est prête pour l’installation, enregistrez les informations suivantes pour les étapes suivantes :

• ID d’application, clé de package et ID de propriétaire lorsqu’ils apparaissent dans l’URL d’installation à la fin du processus Définir les propriétés du processus d’application modèle lors de la création de l’application.

  Vous pouvez également obtenir le même lien en sélectionnant Obtenir le lien dans le volet Gestion des versions de l’application modèle.

• Noms de paramètres tels qu’ils sont définis dans le modèle sémantique de l’application modèle. Les noms de paramètres sont des chaînes sensibles à la casse. Ils peuvent également être récupérés à partir de l’onglet Paramètres du paramètre lorsque vous définissez les propriétés de l’application modèle ou à partir des paramètres de modèle sémantique dans Power BI.

Installer et configurer votre application modèle

Dans cette section, vous allez utiliser un exemple d’installation automatisée d’Azure Functions que nous avons créé pour préconfigurer et installer votre application modèle. Cet exemple a été délibérément gardé simple à des fins de démonstration. Il vous permet d’utiliser une fonction Azure et Azure App Configuration pour déployer et utiliser facilement l’API d’installation automatisée pour vos applications modèles.

Télécharger Visual Studio

Téléchargez Visual Studio (version 2017 ou ultérieure). Veillez à télécharger le dernier package NuGet.

Télécharger l’exemple d’installation automatisée d’Azure Functions

Téléchargez l’exemple d’installation automatisée d’Azure Functions à partir de GitHub pour commencer.

Configurer votre configuration d’application Azure

Pour exécuter cet exemple, vous devez configurer votre configuration d’application Azure avec les valeurs et les clés décrites ici. Les clés sont l’ID d’application, le secret de l’application et les valeurs appId, packageKey et ownerId de votre application modèle. Pour plus d’informations sur l’obtention de ces valeurs, consultez les sections suivantes.

Les clés sont également définies dans le fichier Constants.cs .

Le fichier Constants.cs est affiché ici.

Obtenir les propriétés de l’application modèle

Renseignez toutes les propriétés pertinentes de l’application modèle, car elles sont définies lors de la création de l’application. Ces propriétés sont les valeurs appId, packageKey et ownerId de l’application modèle.

Pour obtenir les valeurs précédentes, procédez comme suit :

1. Connectez-vous à Power BI.

2. Accédez à l’espace de travail d’origine de l’application.

3. Ouvrez le volet Gestion des versions .

   

4. Sélectionnez la version de l’application et obtenez son lien d’installation.

   

5. Copiez le lien dans le presse-papiers.

   

6. Cette URL d’installation contient les trois paramètres d’URL dont vous avez besoin. Utilisez les valeurs appId, packageKey et ownerId de l’application. Un exemple d’URL sera similaire à ce qui est illustré ici.

   https://app.powerbi.com/Redirect?action=InstallApp&appId=66667...9cccc0000&packageKey=b2df4b...dLpHIUnum2pr6k&ownerId=aaaa...22222&buildVersion=5
   

Obtenir l’ID d’application

Renseignez les informations applicationId avec l’ID d’application d’Azure. La valeur applicationId est utilisée par l’application pour s’identifier aux utilisateurs à partir desquels vous demandez des autorisations.

Pour obtenir l’ID d’application, procédez comme suit :

1. Connectez-vous au portail Azure.

2. Dans le menu du portail, sélectionnez Tous les services.

3. Dans la page Tous les services, dans la section Identité , sélectionnez >Inscriptions d’applications.

4. Sélectionnez l’application qui a besoin de l’ID d’application.

   

5. Il existe un ID d’application répertorié en tant que GUID. Utilisez cet ID d’application comme valeur applicationId pour l’application.

   

Obtenir le secret de l’application

Renseignez les informations ApplicationSecret de la section Clés de votre section Inscriptions d’applications dans Azure. Cet attribut fonctionne lorsque vous utilisez le principal de service.

Pour obtenir le secret d’application, procédez comme suit :

1. Connectez-vous au portail Azure.

2. Dans le menu du portail, sélectionnez Tous les services.

3. Dans la page Tous les services, dans la section Identité , sélectionnez >Inscriptions d’applications.

   

4. Sélectionnez Certificats et secrets sous Gérer.

5. Sélectionnez Nouveau secret client.

6. Entrez un nom dans la zone Description , puis sélectionnez une durée. Sélectionnez Ensuite Ajouter pour obtenir la valeur de votre application, que vous verrez sous le titre Valeur de la clé secrète client.

Tester votre fonction localement

Suivez les étapes décrites dans Exécuter la fonction localement pour exécuter votre fonction.

Configurez votre portail pour émettre une POST demande à l’URL de la fonction. par exemple POST http://localhost:7071/api/install. Le corps de la requête doit être un objet JSON qui décrit les paires clé-valeur. Les clés sont des noms de paramètres définis dans Power BI Desktop. Les valeurs sont les valeurs souhaitées à définir pour chaque paramètre de l’application modèle.

Le flux souhaité doit être :

1. Le portail prépare la demande, par utilisateur ou session.
2. La POST /api/install demande est émise à votre fonction Azure. Le corps de la requête se compose de paires clé-valeur. La clé est le nom du paramètre. La valeur est la valeur souhaitée à définir.
3. Si tout est configuré correctement, le navigateur doit automatiquement rediriger vers le compte Power BI du client et afficher le flux d’installation automatisé.
4. Lors de l’installation, les valeurs des paramètres sont définies comme configurées aux étapes 1 et 2.

Publier votre projet sur Azure

Pour publier votre projet sur Azure, suivez les instructions de la documentation Azure Functions. Vous pouvez ensuite intégrer des API d’installation automatisées d’application modèle dans votre produit et commencer à le tester dans des environnements de production.

Contenu connexe

• Automatiser la configuration d’une installation d’une application modèle
• Créer une application modèle dans Power BI
• Conseils pour la création d’applications modèles
• Incorporer du contenu Power BI avec un principal de service et un secret d’application