3. Configurer Orchestrator

La configuration d'Orchestrator suppose l'ajout de certains champs dans le fichier UiPath.Orchestrator.dll.config d'Orchestrator (ou Web.config pour Orchestrator 20.4). Avant de commencer, sauvegardez votre fichier UiPath.Orchestrator.dll.config existant (par exemple en faisant une copie dans un chemin d'accès différent).

Nous proposons ci-dessous deux options pour mettre à jour cette configuration :

• Configuration automatisée. Un script PowerShell.
• Configuration manuelle - Des instructions étape par étape comportant des explications ; elle doit être utilisée dans des cas très spécifiques (tels que des règles de gouvernance n'autorisant pas les modifications automatisées de la configuration d'Orchestrator). La configuration manuelle est sujette aux erreurs et peut entraîner des problèmes d'installation en aval.
  Remarque : veuillez noter que si vous mettez à jour le DNS ou les certificats pour Orchestrator ou Identity Server, AI Center cessera de fonctionner. Vous devrez reconfigurer les certificats Orchestrator, puis redéployer AI Fabric pour y remédier.

Configuration automatisée

Attention : cette approche doit constituer l'approche privilégiée. La configuration manuelle doit uniquement être utilisée dans des cas très particuliers.

• Ouvrez PowerShell en tant qu'administrateur. * Téléchargez le fichier [ici] (https://raw.githubusercontent.com/UiPath/ai-customer-scripts/master/orchestrator/orchestratorAutomationAIF20-10.ps1). Cela peut être effectué avec la commande suivante :

  wget https://raw.githubusercontent.com/UiPath/ai-customer-scripts/master/orchestrator/orchestratorAutomationAIF20-10.ps1 -outfile "orchestratorAutomationAIF20-10.ps1"

• Vous pouvez vous familiariser avec les options du script en entrant :

  get-help .\)\)orchestratorAutomationAIF20-10.ps1 -full

Pour la plupart des installations d'Orchestrator, les valeurs par défaut des options non obligatoires fonctionneront. Dans ces cas, exécutez :

.\)\)orchestratorAutomationAIF20-10.ps1 -aifip "<aif-linux-machine-domain-name-or-ip>" -orcname "<Orchestrator-Domain-Name Lower>"

Où vous remplacez <AIF Machine Domain Name or IP> par l'adresse IP de la machine Linux sur laquelle AI Fabric sera installé (ou le nom de domaine complet si AI Fabric sera installé avec un certificat) et <Orchestrator Domain Name Lower Case> par le nom de domaine d'Orchestrator. La casse doit correspondre exactement au certificat Orchestrator utilisé pour installer Orchestrator.

Si vous utilisez un port non standard pour AI Fabric (par exemple, si vous avez un proxy ou un équilibreur de charge dans le cas d'une configuration HA), vous pouvez ajouter le paramètre facultatif relatif au port. (aifport "31390")

Attention : le domaine Orchestrator saisi doit correspondre exactement au nom du domaine présent dans le certificat. Cela inclut la sensibilité à la casse. Veillez à ce que les caractères majuscules et minuscules correspondent.

Si vous disposez d'un chemin non standard vers la configuration Orchestrator UiPath.Orchestrator.dll.config (Web.config), vous pouvez spécifier explicitement le chemin donnant accès au fichier :

.\)\)orchestratorAutomationAIF20-10.ps1 -aifip "<aif-linux-machine-domain-name-or-ip>" -orcname "<Orchestrator-Domain-Name Lower>" -config "<Path to UiPath.Orchestrator.dll.config file>"

Modification de la configuration du contrôle d'intégrité

Remarque : dans la section ci-dessous, le fichier de configuration concevra Web.config si vous utilisez Orchestrator 20.4 et UiPath.Orchestrator.dll.config pour les versions plus récentes.

Votre fichier de configuration sera modifié après application du script ci-dessous. Voici à quoi ressemblent l'application d'un fichier diff sur votre fichier de configuration précédent et le fichier de configuration modifié :

Comparez les valeurs d'empreinte numérique du certificat (utilisé pour installer Orchestrator) aux valeurs du fichier de configuration modifié. Ces valeurs doivent être les mêmes :

De même, comparez le certificat codé en base 64 au champ IDP.SigningCertificate dans le fichier de configuration modifié. Ceux-ci doivent être les mêmes :

Configuration manuelle

1. Ajoutez des clés AI Fabric au fichier de configuration.
   1. Accédez au serveur Windows sur lequel Orchestrator s'exécute et ouvrez le fichier de configuration Orchestrator.
   2. Ajoutez les lignes suivantes dans la section <appSettings></appSettings>, de préférence juste avant la balise appSettings.

      <add key="AiFabric.Licensing" value="true" />
          <add key="AiFabric.MLSkillsCreate" value="false" />
          <add key="AiFabric.MLSkillsCreateOOB" value="false" />
          <add key="AiFabric.PackagesCreate" value="false" />
          <add key="AiFabric.Packages" value="false" />
          <add key="AiFabric.Logs" value="false" />
          <add key="AiFabric.ModuleEnabled" value="true" />
          <add key="AiFabric.FeatureEnabledByDefault" value="true" />
          <add key="AiFabric.ModelStorageUrl" value="https://${AIF-IP}:31443" />
          <add key="AiFabric.MLPackagingInstructionsUrl" value="https://docs.uipath.com/ai-fabric/v2020.7/docs/building-ml-packages" />
           <add key="AiFabric.MLServiceUrl" value="https://${AIF-IP}:31390" />
          <add key="AiFabric.MLSkillUrl" value="https://${AIF-IP}:31390/ai-deployer" />
          <add key="AiFabric.MLPackageUrl" value="https://${AIF-IP}:31390/ai-pkgmanager" />
          <add key="AiFabric.MLLogUrl" value="https://${AIF-IP}:31390/ai-helper" />
          <add key="AiFabric.MLTrainUrl" value="https://${AIF-IP}:31390/ai-trainer" />
          <add key="AiFabric.AccountId" value="host" />
          
          <add key="IDP.Scope" value="["AIFabric","Orchestrator"]" />
          <add key="IDP.CurrentTokenThumbprint" value="<THUMBPRINT>" />
          <add key="IDP.PreviousTokenThumbprint" value="<THUMBPRINT>" />
          <add key="IDP.SigningCertificate" value="<BASE64 SIGNING CERTIFICATE>" />
          <add key="IDP.Authority" value="https://${ORCHESTRATOR_URL}/api/auth/" />
          <add key="IdentityProviderFeature.Enabled" value="true" />
          
          <add key="Auth.OAuth.SharedRobotOAuthClientId" value="03FFA863-3C0C-4EEC-BBE5-094D4FCF4F22" />
          <add key="Auth.OAuth.SharedRobotOAuthAuthority" value="https://${ORCHESTRATOR_URL}/api/auth/" />
          <add key="Auth.OAuth.SharedOrchestratorOAuthClientId" value="a42436d5-4cd6-4d6a-9311-51271d9fc217" />
          <add key="Auth.OAuth.SharedOrchestratorOAuthAuthority" value="https://${ORCHESTRATOR_URL}/api/auth/" />
          <add key="Auth.OAuth.OrchestratorOAuthAudience" value="Orchestrator" />
          <add key="Auth.OAuth.RobotAuthenticationEnabled" value="true" />

   3. Remplacez ${AIF-IP} par l'adresse IP de la machine Linux sur laquelle vous allez installer AI Fabric.
   4. Remplacez ${ORCHESTRATOR_URL} par le nom de domaine Orchestrator.
   5. Remplacez <THUMBPRINT> par l'empreinte numérique du certificat Orchestrator. Plus précisément, au moment de l'installation d'Orchestrator, un certificat auto-signé ou un certificat approprié doit être fourni en entrée pour le programme d'installation MSI, et les valeurs d'empreinte numérique doivent correspondre à ce certificat.
      
      

      

      
      
   6. Remplacez <BASE64 SIGNING CERTIFICATE> par le certificat Orchestrator. Pour ce faire, accédez au certificat Orchestrator (fourni au moment de l'installation d'Orchestrator). Dans le gestionnaire de certificats, cliquez avec le bouton droit sur le certificat et suivez les instructions de l'assistant d'exportation. Assurez-vous de sélectionner base-64 encoded X.509 comme format.
      
      

      

      
      
   7. Ouvrez le fichier dans un éditeur comme Notepad++ et copiez le certificat (entre BEGIN CERTFICATE et END CERTIFICATE). Supprimez les caractères de nouvelle ligne de sorte que vous ayez une longue string comprenant l'intégralité du certificat. Cette longue string est ce qui doit remplacer <BASE64 SIGNING CERTIFICATE>.
2. Ajoutez des applications clicnet au fichier de configuration.

   Séparément de la balise appSettings, ajoutez les lignes suivantes :

   </appSettings>
     <ClientApplications>
       <add displayName="Robot" clientId="03ffa863-3c0c-4eec-bbe5-094d4fcf4f22" jwtExpirationInSeconds="86400"/>
       <add displayName="Orchestrator" clientId="a42436d5-4cd6-4d6a-9311-51271d9fc217" jwtExpirationInSeconds="86400"/>
     </ClientApplications>

3. Ajoutez le fournisseur d'identité au fichier de configuration.
   1. À l'intérieur des <configSections></configSections> balises du fichier de configuration, ajoutez les lignes suivantes :

      <section name="ClientApplications" type="UiPath.Orchestrator.Security.IdentityProvider.Model.ClientApplications, UiPath.Orchestrator.Security.IdentityProvider" />

   2. Exécutez iisreset à partir de l' invite de commande ou de PowerShell