Signature de paquets

La signature de paquets est disponible dans le but de garantir la sécurité et l'intégrité des processus et des bibliothèques publiés dans Studio.

NuGet propose deux méthodes de signature des paquets, soit par un auteur, soit par un référentiel.

Application de l’utilisation de packages signés

Pour appliquer l’utilisation de packages signés, le paramètre signatureValidationMode du fichier Nuget.config doit être défini require. Le fichier se trouve dans %ProgramFiles(x86)%\UiPath\Studio. Vous pouvez le définir de deux façons :

• During installation, by installing from the command line with the option ENFORCE_SIGNED_EXECUTION=1.

  Par exemple, la commande suivante installe Studio, un Robot en tant que service Windows, les packages d'activités locales et applique l'utilisation de paquets signés dans votre environnement UiPath : UiPathStudio.msi ADDLOCAL=DesktopFeature,Studio,Robot,RegisterService,Packages ENFORCE_SIGNED_EXECUTION=1.

• Après l’installation, en modifiant manuellement le fichier Nuget.config.

  Si vous définissez le paramètre après l’installation, les modifications prendront effet après avoir :

  1. Redémarrez le service de robot UiPath.
  2. supprimé tous les packages .NuGet existants dans %ProgramFiles(x86)%\UiPath\Studio\Packages et dans %userprofile%\.nuget\packages.
  3. redémarré Studio/Assistant.

Par défaut, les packages UiPath sont des référentiels et sont signés par l'auteur. Cela signifie que de tels packages peuvent être téléchargés et installés à l’aide de Gérer les packages (Manage Packages) sans devoir effectuer d’autres actions. Pour plus d'informations sur l'ajout des auteurs, des référentiels et/ou des propriétaires approuvés supplémentaires, consultez les autres sections de cette page.

Ajout de sources approuvées

Pour télécharger, installer et exécuter des paquets signés avec un certain certificat, ajoutez celui-ci en tant que source approuvée. Pour ce faire, modifiez le fichier nuget.config dans le dossier d'installation, principalement la section <trustedSigners>.

Ajout d'un auteur approuvé

Pour ajouter un auteur approuvé, vous devez ouvrir le fichier NuGet.config situé à %ProgramFiles(x86)%\UiPath\Studio\NuGet.config. Ensuite, fournissez les certificatefingerprint et hashAlgorithm. Pour obtenir plus d'informations sur l'empreinte digitale du certificat, consultez cette page.

Définissez allowUntrustedRoot sur true ou sur false :

• allowUntrustedRoot = "true" : permet des paquets non signés.
• allowUntrustedRoot = "false" : les paquets doivent être signés par l'auteur.

L'entrée doit être similaire à l'exemple ci-dessous :

<trustedSigners>
<author name="UiPath">
<certificate fingerprint="1234512345123451234512345123123123123123123123123123112312312E5" hashAlgorithm="SHA256" allowUntrustedRoot="true"/>
</author>
</trustedSigners>

Ajout d'un référentiel approuvé

L'ajout d'un référentiel approuvé est assez semblable à l'ajout d'un auteur, à la différence que vous devez ajouter serviceIndex.

Vous trouverez ci-dessous un exemple de référentiel approuvé ajouté au fichier NuGet.config :

<trustedSigners>
<repository name="UiPath Repository" serviceIndex="https://uipath.repository">
<certificate fingerprint="1234512345123451234512345123123123123123123123123123112312312E5" hashAlgorithm="SHA256" allowUntrustedRoot="true" />
</repository>
</trustedSigners>

Ajout de propriétaires approuvés

Un référentiel peut comprendre des paquets signés par plusieurs auteurs. Dans ce cas, la balise <owners> peut être utilisée pour autoriser uniquement l'installation de paquets signés par des auteurs approuvés.

Ajoutez les auteurs approuvés entre les balises <owners>, comme dans l'exemple ci-dessous :

<trustedSigners>
<repository name="UiPath Repository" serviceIndex="https://uipath.repository">
<certificate fingerprint="1234512345123451234512345123123123123123123123123123112312312E5" hashAlgorithm="SHA256" allowUntrustedRoot="true" />
<owners>Author1;Author2</owners>
</repository>
</trustedSigners>

Signature d'un paquet

1. En studio, la signature de packages peut se faire à partir de la fenêtre Publier, l’onglet Signature du certificat, tant pour les processus que pour les bibliothèques.

   

2. Dans l'onglet Signature du certificat, ajoutez le chemin d'accès du certificat sur votre machine locale. Utilisez le bouton pour naviguer vers le chemin d'accès si nécessaire. Seuls les formats de fichier de certificat .pfx et .p12 sont acceptés.

3. Ensuite, entrez le Mot de passe du certificat (Certificate Password) et ajoutez un Horodateur de certificat facultatif (Optional Certificate Timestamper), si nécessaire. Cliquez sur Publier (Publish). Le fichier .nupkg obtenu est signé avec un certificat et un horodateur, si indiqué.

Les horodatages sont un moyen sécurisé de suivre la date et l'heure de signature d'un package. Pour en savoir plus sur l'horodatage dans le contexte de la signature de packages NuGet, consultez ce lien.

Si l'horodateur du certificat n'est pas valide, un message d'erreur contenant le nom du projet est généré dans Studio après avoir cliqué sur le bouton Publier (Publish). Un message d'erreur similaire est également consigné dans le panneau Sortie (Output).

Remarque :

Si la vérification de la signature n'est PAS appliquée, les processus créés à l'aide d'une version de Studio antérieure à v2019.4 restent exécutés, qu'ils soient signés ou non.

Use the Mass Update Command Line tool to sign multiple packages and then publish them to a location.

Remarque :

Une dépendance non signée dans le projet peut empêcher que d’autres dépendances ne soient résolues lors de l’utilisation de la fonction Dépendance de réparation. Supprimez le package non signé du projet pour résoudre les dépendances signées.