Action Center : Installation d'Azure PaaS

Le script d'installation d'Azure permet d'installer l'Action Center sur un ou plusieurs nœuds.

Important: Toutes les étapes des procédures d’installation énumérées ci-dessous sont obligatoires.

Avant de commencer

Assurez-vous que les outils suivants sont installés sur votre machine :

• PowerShell Web Deploy Snapin
• Module PowerShell AzureAZ version 7.0 ou supérieure.

Installation sur un nœud unique

Création du service d’application Azure pour Action Center

1. Accédez à votre portail Azure et recherchez les Services d’applications (App Services).
2. Créez un nouveau service d’application et nommez-le en conséquence, par exemple UiPathActionCenter.
   Remarque : dans le menu déroulant Pile d'exécution (Runtime stack), sélectionnez .NET Core 3.1.
3. Ouvrez l’application Web précédemment créée et naviguez vers Configuration > Paramètres généraux (General settings) à partir du menu situé à gauche, puis réglez le champ Plate-forme (Platform) sur 64 Bits.

Création du Principal du service Azure pour l'Action Center

1. Sur le portail Azure, recherchez les Inscriptions d’applications ( App registrations ) et créez-en une nouvelle, nommée en conséquence.

   Important : vous devez attribuer le rôle de contributeur à l'enregistrement de l'application. Voyez ici comment procéder.

2. Sur la page Vue d’ensemble (Overview) de votre application, copiez l’iD d’application (client) (Application (client) ID) et enregistrez-la pour une utilisation ultérieure. Il s’agit de votre identifiant principal pour le service Azure.

   
   

   

   
   

3. Sur la page Clients et clés secrètes (Clients & secrets) de l’inscription d’application précédemment créée, générez une nouvelle clé secrète de client. Copiez sa valeur (Value) et enregistrez-la pour une utilisation ultérieure. Il s’agit de votre mot de passe principal pour le service Azure.

   
   

   

   
   
   Remarque: En option, demandez à votre sympathique équipe DevOps de vous fournir un ID et un mot de passe de principal de service Azure qui peuvent accéder à App Service et au groupe de ressources associé.

Installation d’Action Center sur Azure

1. Téléchargez l'archive UiPathActionCenter.zip sur votre machine locale. Celle-ci contient tous les scripts d’installation nécessaires.
   Remarque: UiPath fournit l'archive UiPathActionCenter.zip sur demande. Contactez-nous pour plus de détails.
2. Extrayez le contenu du fichier .zip dans un dossier de votre machine.
3. Exécutez le script Publish-ActionCenter-Azure.ps1 dans PowerShell, en utilisant ces paramètres d'installation.

   Consultez cet exemple de script.

4. Profitez d'Action Center sur votre portail Azure.

Installation à plusieurs nœuds

L'installation multi-nœuds est similaire à l' installation à nœud unique, avec une étape supplémentaire entre les étapes 6 et 7 de la procédure de nœud unique.

Par conséquent, après l’étape 6, vous devez effectuer les actions suivantes :

• Ouvrez le service d’application nouvellement créé.
• Rendez-vous dans l’onglet Mise à l'échelle (Plan du service d'applications) (Scale out (App Service plan)) situé dans le menu de gauche.
• Sélectionnez l'option Évolutivité vers un nombre spécifique d'instances (Scale to a specific instance count).
• Indiquez le nombre d’instances (Instance count) souhaité.

Passez ensuite à l’étape 7 de la procédure de nœud unique.

Important :

Après la migration ou la mise à niveau vers Orchestrator 2022.4 PaaS, accédez à la configuration d'Azure App Service et assurez-vous que les clés suivantes sont présentes dans la liste et que leur valeur est définie sur true :

• IdentityServer.OAuth.Enabled
• IdentityServer.S2SIntegration.Enabled

Paramètres du script d’installation Powershell

Remarque :

Si vous souhaitez utiliser un domaine personnalisé pour votre service d’application Action Center, veuillez d’abord définir le domaine personnalisé, puis utiliser ce nom de domaine dans les paramètres du script.

Par exemple, si votre domaine personnalisé est https://actioncenter.xyz.com, utilisez la même valeur pour le paramètre de script actionCenterUrl.

Paramètre	Description
orchestratorUrl	Obligatoire. L'URL de l'instance Orchestrator.
identityServerUrl	Obligatoire. URL de l’instance Serveur d’identité.
actionCenterUrl	Obligatoire. L'URL de l'instance Action Center.
identityInstallationAccessToken	Obligatoire (Mandatory). Le jeton d’accès tiré du portail de gestion des identités. Voir Paramètres d'authentification de l'hôte pour plus de détails.
azureSubscriptionId	Obligatoire. L'ID d'abonnement Azure pour l'application App Service qui héberge Action Center. Remarque: Vous le trouverez sur la page Aperçu (Overview) du service d'application sur votre portail Azure.
azureAccountTenantId	Obligatoire. ID de locataire Azure. Remarque: Vous le trouverez sur la page Aperçu (Overview) de l'enregistrement d'application sur votre portail Azure.
azureAccountApplicationId	Obligatoire. L'identifiant principal du service Azure. Remarque: il s'agit de celui que vous avez copié et enregistré à l’étape 5 de la procédure d’installation des nœuds simples.
azureAccountPassword	Obligatoire. Le mot de passe principal du service Azure. Remarque: C'est celui que vous avez copié et enregistré à l'étape 6 de la procédure d ' Installation sur un nœud unique .
package	Obligatoire (Mandatory). Indiquez le chemin complet ou le chemin relatif de l'archive UiPath.ActionCenter.Web.zip. Remarque: Retrouvez-le dans les archives UiPath.Actioncenter.zip.
resourceGroupName	Obligatoire. Nom du groupe de ressources Azure qui contient le service d'application Action Center.
appServiceName	Obligatoire. Nom du service d'application Azure de l'Action Center.
stopApplicationBeforePublish	Facultatif. S’il est actif, il arrête l’application avant le déploiement et la démarre une fois le déploiement terminé.
unattended	Facultatif. S'il est actif, le déploiement se poursuit sans confirmation de l'utilisateur.

Exemple de script PowerShell

.\Publish-ActionCenter-Azure.ps1 `
    -orchestratorUrl "https://<OrchestratorServiceURL>" `
    -identityServerUrl "https://<IdentityServerURL>/identity" `
    -actionCenterUrl "https://<ActionCenterServiceURL>" `
    -identityInstallationAccessToken "abcdefgh ... MAxJeysh6IQFSabcd" `
    -azureSubscriptionId "d12f123e-12ac-1da1-1234-ed1234d5cf4b" `
    -azureAccountTenantId "d1234d2a-b123-1d12-1234-902c51f12345" `
    -azureAccountApplicationId "12345678-67e1-123d-1234-1c6cd123b123" `
    -azureAccountPassword "O.T5pX4bX89I3~Wi.clbM_u0-R5Aa-sRl~" `
    -package "E:\)\)Work\)\)UiPathActionCenter\)\)UiPath.ActionCenter.Web.zip" `
    -stopApplicationBeforePublish `
    -resourceGroupName "<ResourceGroupName" `
    -appServiceName "<ActionCenterServiceName>" `
    -unattended

Requêtes de compartiments de stockage

Les fonctionnalités de l'Action Center qui utilisent les compartiments de stockage à l’intérieur d’Orchestrator, telles que les images et le rendu PDF sur les actions de formulaire (Form actions), la classification des documents (Document Classification) et les actions de validation de documents (Document Validation) nécessitent la configuration suivante dans Orchestrator :

Accepter les requêtes d'Action Center sur Orchestrator :

• Ouvrez l’application Web Orchestrator dans votre portail Azure.
• Accédez à Configuration et sélectionnez Paramètres d’application (Application Settings).

• Ajoutez un Nouveau paramètre d’application (New application setting) et entrez-y ce qui suit :

  • Nom - AcceptedRootUrls
  • Valeur : https://localhost:6234,https://<ActionCenterServiceURL>
    Important: Assurez-vous que la valeur saisie dans le champ Valeur ne possède pas d’espaces vides.
    Remarque: Remplacez <ActionCenterServiceURL> par l’URL correspondante de votre service Action Center.

    

Pour autoriser OPTIONS dans le fichier web.config de l’application Web Orchestrator :

• Ouvrez l’application Web Orchestrator dans votre portail Azure.
• Accédez à Application de l'éditeur de service (Vue d'ensemble) (App Service Editor (Preview)).
• Modifiez le fichier web.config :
  • Accédez à la section <requestFiltering> <verbs>.
  • Ajoutez <add verb="OPTIONS" allowed="true" /> à la fin de la section.
    Remarque: La mise à niveau Orchestrator réinitialise le fichier web.config, de sorte que vous devez autoriser à nouveau le verbe OPTIONS.

    Concernant les fournisseurs de stockage tiers, retrouvez plus de détails sur la configuration CORS/CSP.

Désinstallation

Pour supprimer Action Center de votre Portail Azure, supprimez les ressources Azure suivantes :

• Service d’application Action Center
• Inscription d’application Action Center