Gestion des actifs dans Orchestrator

Créez et gérez des ressources dans Orchestrator, y compris des informations d'identification, des valeurs de texte et d'autres ressources partagées à utiliser pour l'automatisation.

Création d'actifs

1. On the Assets page, select Add asset, then select Create a new asset. The Add Asset page is displayed.
2. Dans le champ Nom de l'actif (Asset name), entrez un nom pour l'actif.
3. In the Description field, enter what the asset is used for.
4. Dans la liste Type (Type), sélectionnez le type d'actif à créer.
   • For credential or secret assets, from the Credential Store list, select where the asset is stored.
   • For Object (define properties) assets, in the Schema section, select Add property to define the properties of the object.
5. To let external apps and integrations read the asset value through the Orchestrator API, turn on Expose value to API. Automations can always read the asset.
6. In the Global value & overrides section, enter the global value in the Global row. All accounts without an override receive this value.
   • To enter the value in a side panel, select Edit global value, enter the value, then select Done.
   • To create the asset without a global value, turn off the toggle in the Global row. In this case, you must add at least one override.
7. To add a value for a specific account or account-machine pair, select Add override. The New override panel is displayed.
   1. Under Applies to, select In current folder to pick a user assigned to the folder, or In identity directory to pick a user from the identity directory.
   2. From the Account list, select the account.
   3. From the Machine list, keep Any machine, or select a specific machine.
   4. Enter the value, then select Done.
8. Select Create asset.

The asset is created and displayed on the Assets page.

Remarque :

• Une fois qu’un actif est créé, vous ne pouvez pas en modifier le type.
• Si vous créez des ressources d'informations d'identification ou de secret à valeur globale avec le même nom Orchestrator et le même nom externe dans plusieurs dossiers Orchestrator, ces ressources pointent vers un même objet dans le magasin d'informations d'identification. Par conséquent, toute modification que vous apportez à la ressource contenue dans l'un des dossiers Orchestrator affecte les ressources portant un nom identique dans les autres dossiers Orchestrator. Pour éviter toute modification accidentelle des ressources d'informations d'identification ou de secret portant le même nom dans les dossiers Orchestrator, nommez la ressource de chaque dossier avec un nom différent. Cela garantit que les ressources pointent vers des objets différents dans le magasin d'informations d'identification.

Champ	Description
Nom de l'actif (Asset name)	Un nom personnalisé de l'actif, pour vous aider à l'identifier facilement. Ne peut pas dépasser 256 caractères.
Saisie de texte	Le type d'actif. The following options are available, grouped as Primitive, Secure, and JSON: Text : ressources qui peuvent stocker des valeurs sous forme de chaînes de caractères. Il s'agit de l'option par défaut. Bool : ressources qui peuvent stocker une valeur True ou False. Si vous sélectionnez cette option, le champ Valeur affiche deux cases d'option ( Vrai , Faux , Faux ). Integer (Entier) : ressources qui peuvent stocker des nombres entiers. Credential (Informations d'identification) : ressources pouvant stocker des informations d'identification. Si vous sélectionnez cette option, le champ Value (Valeur) est remplacé par deux autres champs : Username (Nom d'utilisateur), qui ne peut pas dépasser 512 caractères, et Password (Mot de passe), qui ne peut pas dépasser 25 000 caractères. Secret : les ressources qui peuvent stocker des secrets, tels que les clés API. Saisissez la valeur du secret dans le champ Secret. Le secret ne peut pas dépasser 25 000 caractères. Remarque: vous ne pouvez actuellement utiliser des ressources de type Secret qu'en conjonction avec des agents codés, indiqués sous la forme Agent<programming language> . Aucun type de processus dont le package sous-jacent est créé par Studio ne prend actuellement en charge les ressources de type Secret. JSON : assets that can store structured JSON data. The following JSON types are available: Object (define properties) , Array of strings , Number (Float) , DateTime , Email , URL , Regex , and Any . For Object (define properties) assets, you define the properties of the object in the Schema section.
Expose value to API	Defines whether the asset value can also be read outside automations. Automations can always read the asset. Off: only automations can read the asset value. This is the default option. On: external apps and integrations can also read the asset value through the Orchestrator API.
Magasin d'identifiants	Disponible uniquement lorsque vous ajoutez des informations d'identification ou des ressources de secret. Le magasin d’informations d’identification dans lequel la ressource sera enregistrée, qu’il s’agisse de la base de données Orchestrator native ou de l’un de vos magasins externes créés. Remarque : vous ne pouvez pas récupérer les ressources de type secret à partir d'un magasin d'informations d'identification externe lorsque vous utilisez un proxy déconnecté.
Nom externe	Disponible uniquement lorsque vous ajoutez des informations d'identification ou des ressources de secret à un magasin d'informations d'identification. Le nom de la ressource à utiliser lors de la communication avec le magasin d'informations d'identification.
Global value	The value received by all accounts, except those with an override (defined using the Add override button). Enter it in the Global row of the Global value & overrides section, or select Edit global value to enter it in a side panel. To create the asset without a global value, turn off the toggle in the Global row. When the global value is turned on, you must enter the value that is received by accounts: Pour les ressources Booléen (Bool), deux cases d'option, Vrai (True) et Faux (False), sont affichées. Par défaut, l'option Faux (False) est sélectionnée. Pour les ressources Credential (Informations d'identification), les champs User Name (Nom d'utilisateur) et Password (Mot de passe) sont activés. Vous devez remplir les deux champs. Pour les ressources Secret, vous devez entrer une valeur dans le champ Secret. Pour les ressources de texte, ce champ autorise jusqu'à 1 000 000 caractères.
Add override	Vous permet d'ajouter des valeurs de ressources spécifiques par compte ou par compte-machine. In the New override panel, select whether the account is In current folder or In identity directory, then select the Account and, optionally, the Machine. When the global value is turned off, you must configure at least one override. If a global value is provided, adding overrides is optional. Pour les ressources Booléen (Bool), deux cases d'option, Vrai (True) et Faux (False), sont affichées. Par défaut, l'option Faux (False) est sélectionnée. Pour les ressources Credential (Informations d'identification), les champs User Name (Nom d'utilisateur) et Password (Mot de passe) sont activés. Vous devez remplir les deux champs. Pour les ressources Secret, vous devez entrer une valeur dans le champ Secret. Pour les ressources de texte, ce champ autorise jusqu'à 1 000 000 caractères.

Gestion des liens de ressources

Le partage de ressources entre les dossiers permet de lancer des tâches dans plusieurs dossiers sans devoir concevoir une nouvelle fois vos workflows dans Studio lorsque les processus sous-jacents ont pour cible la même ressource. Lier une ressource à un dossier rend la ressource et tous les objets associés à la ressource, tels que les éléments de ressources, disponibles dans ce dossier.

Important :

Vous ne pouvez partager que des actifs avec des valeurs globales et aucune valeur spécifique par compte. Vous ne pouvez pas partager des ressources avec des valeurs par compte entre les dossiers.

Remarque :

Une ressource liée à plusieurs dossiers est marquée à l'aide de l'icône . Si l'icône n'est pas affichée, le dossier actuel est le seul dossier contenant la ressource. La supprimer ici supprime complètement la ressource d'Orchestrator. Vous avez besoin de l’autorisation Ressource - Créer dans les dossiers auxquels vous souhaitez ajouter la ressource (dossiers cibles) et Ressource - Afficher dans le dossier dans lequel se trouve actuellement la ressource (dossier d’origine). Si la fonction Ressources - Modifier s’affiche dans le dossier cible, vous n’avez pas besoin de Ressources - Modifier dans le dossier d’origine. Une fois qu’une ressource est partagée dans un dossier, les utilisateurs voyant s’afficher la fonction Ressources - Modifier dans le dossier de destination peuvent modifier la ressource, et les modifications s’appliqueront globalement.

Relier plusieurs ressources au dossier actuel

1. Dans le dossier auquel vous souhaitez lier une ressource, sur la page Ressources , sélectionnez Ajouter. Trois boutons s'affichent, vous permettant d'ajouter une ressource, de lier des ressources à partir d'autres dossiers ou de masquer les options.
2. Sélectionnez Lier depuis d'autres dossiers. La fenêtre Lier les ressources (Link Assets) s'affiche et affiche une liste de tous les ressources des dossiers dans lesquels vous disposez des autorisations Consultation (View) pour les ressources.

Figure 1. Lier des ressources d'autres dossiers

3. Dans la section Sélectionner des ressources (Select Assets), sélectionnez une ou plusieurs ressources dans la liste.
4. Sélectionnez continuer (continue). Vous êtes redirigé vers la section Validation du dossier (Folder Validation). Ici, vous pouvez voir les dossiers auxquels les ressources sont déjà liées. S'il y a plusieurs dossiers, leurs noms sont affichés.

Figure 2. Valider le dossier

5. Sélectionnez Supprimer pour la ressource correspondante pour annuler la modification ou Sélectionnez Quitter pour annuler l'opération.
6. Sélectionnez Lier si vous souhaitez établir le lien entre les ressources que vous avez sélectionnées et le dossier actuel. Les ressources s'affichent sur la page Ressources.

Lier une ressource à plusieurs dossiers

1. Accédez à un dossier contenant la ressource à lier.

Sélectionnez Autres actions > Gérer les liens de la ressource souhaitée pour ouvrir la fenêtre Gérer les liens. La fenêtre Gérer les liens de la ressource s'affiche.

Figure 3. Gérer les liens de la ressource

1 - Le volet de gauche affichant tous les dossiers pour lesquels vous avez reçu des autorisations Consultation (View) pour les ressources.

2 - L'état actuel de la ressource affichant le nombre de dossiers dans lesquels elle se trouve ainsi que leurs noms.

3 - Les dossiers dans lesquels la ressource doit être ajoutée selon votre sélection dans le volet de gauche.

4 - Les dossiers dont la ressource sera supprimée.

1. Sélectionnez Update (Mettre à jour). Une fenêtre de confirmation s'affiche.
2. Sélectionnez Annuler si vous souhaitez annuler les modifications ou Continuer pour que les modifications prennent effet. Les opérations sont désormais appliquées à Orchestrator conformément à vos modifications.

Dissociation des ressources des dossiers

La dissociation des ressources des dossiers peut être effectuée d'une manière similaire à l'opération de liaison. Accédez aux zones de gestion des liens présentées dans les procédures ci-dessus et supprimez les connexions entre la ressource et le dossier de votre choix.

Vous pouvez également supprimer une ressource à l'aide de la fonctionnalité Supprimer (Remove). Voir Suppression d'un actif.

Important :

La suppression d'une ressource existant dans plusieurs dossiers ne la supprime que du dossier dans lequel l'opération de suppression a lieu, sans la supprimer des autres dossiers. Afin de supprimer complètement une ressource, vous devez supprimer tous ses liens existants.

Modification des actifs

Pour modifier une ressource, cliquez sur le bouton Autres actions > Modifier , effectuez les modifications nécessaires et cliquez sur Mettre à jour dans la fenêtre Mettre à jour la ressource . Vous pouvez uniquement modifier la valeur et le nom de la ressource. Toutes les modifications sont vérifiées et peuvent être consultées sur la page Audit . Si vous modifiez le nom d'utilisateur ou une ressource d'informations d’identification, vous devez également modifier le mot de passe.

Suppression des valeurs de ressource par utilisateur et par robot

Vous pouvez supprimer les valeurs de ressource définies pour des utilisateurs ou des robots spécifiques directement à partir de l’éditeur de ressources.

1. Ouvrez Ressources.
2. Créez une nouvelle ressource ou modifiez une ressource existante.
3. Dans la section Valeur de la ressource, choisissez la valeur que vous souhaitez supprimer.
4. Sélectionnez Supprimer.
5. Sélectionnez Supprimer dans la boîte de dialogue de confirmation.

Vous pouvez également sélectionner plusieurs entrées et les supprimer simultanément à l’aide de l’option Supprimer dans l’en-tête de la grille.

Ajout de balises aux ressources

Remarque :

Vous avez besoin de l'autorisation Modification (Edit) par rapport aux ressources et Consultation (View) par rapport aux balises pour ajouter des balises existantes aux ressources. Vous avez besoin de l'autorisation Modification (Edit) et Création (Create) par rapport aux balises pour ajouter de nouvelles balises aux ressources.

Remarque :

• Chaque ressource peut avoir jusqu'à un million de paires clé/valeur.
• Les étiquettes et les propriétés clé/valeur sont limitées à 256 caractères.
• Les noms de balise ne peuvent pas contenir ces caractères : <, >, %, &, , ?, /, :.

Vous pouvez appliquer des balises à une ressource lors de sa création ou de la modification d'une ressource existante. Pour ajouter des balises à une ressource lors de sa modification, suivez ces étapes :

1. Sur la page Ressources , sélectionnez Autres actions > Modifier en regard de la ressource souhaitée. La ressource est ouverte pour modification.
2. Dans le champ Étiquettes (Labels), commencez à saisir le nom de l'étiquette. Vous pouvez choisir une étiquette existante ou en créer une.
3. Dans le champ Propriétés (paires clé-valeur) , sélectionnez Add new (Ajouter nouveau).
4. Ajoutez de nouvelles clés et valeurs. Vous pouvez choisir des clés et/ou valeurs existantes, ou vous pouvez en créer.
5. Lorsque vous avez terminé, sélectionnez Mettre à jour. Votre ressource est mise à jour et les balises nouvellement créées, le cas échéant, deviennent disponibles pour d'autres objets.

Suppression de balises des ressources

Pour supprimer des balises d'une ressource, suivez ces étapes :

1. Sur la page Ressources , sélectionnez Autres actions > Modifier en regard de la ressource souhaitée. La ressource est ouverte pour modification.
2. Dans le champ Étiquettes , sélectionnez le X adjacent au nom de l'étiquette pour la supprimer. Le libellé est supprimé.
3. Dans le champ Propriétés (paires clé-valeur) (Properties), sélectionnez le X adjacent aux clés et/ou valeurs pour les supprimer. Les clés et/ou valeurs sont supprimées.
4. Pour supprimer une paire clé/valeur, sélectionnez l'icône Supprimer correspondant à cette entrée. La paire clé/valeur est supprimée.
5. Lorsque vous avez terminé, sélectionnez Mettre à jour. Votre ressource est mise à jour et les balises sont supprimées.

Suppression des actifs

To remove an asset, click More Actions > Remove.

Vous pouvez également sélectionner un ou plusieurs actifs et cliquer sur Supprimer (Remove).