Orchestrator でアセットを管理する

オートメーションで使用するアセット (資格情報、テキスト値、その他の共有リソースを含む) を Orchestrator で作成および管理します。

アセットを作成する

1. On the Assets page, select Add asset, then select Create a new asset. The Add Asset page is displayed.
2. [アセット名] フィールドに、アセットの名前を入力します。
3. In the Description field, enter what the asset is used for.
4. Type のリストから、作成するセットの種類を選択します。
   • 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.

注:

• アセットを作成した後は、アセットの種類は変更できません。
• グローバル値の Credential アセットまたは Secret アセットを作成する際に、Orchestrator 名と外部名を複数の Orchestrator フォルダー間で同じにすると、それらのアセットは資格情報ストア内の単一のオブジェクトを指します。したがって、いずれかの Orchestrator フォルダーでアセットを変更すると、他の Orchestrator フォルダーにある同じ名前のアセットすべてに影響します。 Orchestrator の複数のフォルダー間で同一の名前を持つ Credential アセットまたは Secret アセットを誤って変更しないようにするには、これらのアセットにフォルダーごとに異なる外部名を使用します。これにより、アセットは資格情報ストア内の異なるオブジェクトを指すようになります。

フィールド	説明
アセット名	ユーザーが設定する名前で、アセットを識別するために役立ちます。 256 文字までです。
入力	アセットの種類です。 The following options are available, grouped as Primitive, Secure, and JSON: Text - 文字列のみを格納できるアセットです。これは既定のオプションです。 Bool: true または false の値のみを格納できるアセットです。このオプションを選択すると、[値] フィールドに2種類のラジオ ボタン ( [True]、[False] ) が表示されます。 Integer: 整数値のみ格納できるアセットです。 Credential: 認証情報を格納するアセットです。 このオプションを選択すると、[値] フィールドが、[ユーザー名] (最大 512 文字) および [パスワード] (最大 25,000 文字) に置換されます。 Secret: API キーなどのシークレットを格納できるアセットです。 [シークレット] フィールドにシークレット値を入力します。シークレットは 25,000 文字以内にする必要があります。 注: 現在、Secret タイプのアセットは、コード化されたエージェントと組み合わせて使用する必要があります。コード化されたエージェントは、<programming language> Agent () の形式で示されます。 現在のところ、基になるパッケージが Studio で作成されたプロセスは、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.
資格情報ストア	Credential アセットまたは Secret アセットを追加する場合にのみ使用できます。 アセットが保存される資格情報ストアです。ネイティブの Orchestrator データベースの場合と、ユーザーが作成した任意の外部ストアの場合があります。 注: 接続されていないプロキシを使用していると、外部資格情報ストアからは Secret タイプのアセットを取得できません。
外部名	Credential アセットまたは Secret アセットを資格情報ストアに追加する場合にのみ使用できます。 資格情報ストアと通信するときに使用されるアセットの名前です。
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: [Bool] アセットの場合、[True] と [False] の 2 つのラジオ ボタンが表示されます。既定では、[False] が選択されています。 Credential アセットの場合、[ユーザー名] フィールドと [パスワード] フィールドが有効化されます。 これら両方のフィールドに入力する必要があります。 Secret アセットの場合は、[シークレット] フィールドに値を入力する必要があります。 [Text] の場合、このフィールドに入力できる最大文字数は 1,000,000 文字です。
Add override	アカウントごと、またはアカウントとマシンごとに、特定のアセット値を追加できます。 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. [Bool] アセットの場合、[True] と [False] の 2 つのラジオ ボタンが表示されます。既定では、[False] が選択されています。 Credential アセットの場合、[ユーザー名] フィールドと [パスワード] フィールドが有効化されます。 これら両方のフィールドに入力する必要があります。 Secret アセットの場合は、[シークレット] フィールドに値を入力する必要があります。 [Text] の場合、このフィールドに入力できる最大文字数は 1,000,000 文字です。

アセットのリンクを管理する

フォルダー間でアセットを共有すると、基になるプロセスが同じアセットをターゲットにしている場合、Studio でワークフローを再設計しなくても、複数のフォルダーでジョブを開始できます。アセットをフォルダーにリンクすると、そのアセットとアセットに関連するすべてのオブジェクト (アセット アイテムなど) をそのフォルダーで使用できるようになります。

重要:

共有できるアセットは、グローバル値を持ち、アカウントごとの固有の値を持たないアセットのみです。アカウントごとの値を持つアセットをフォルダー間で共有することはできません。

注:

複数のフォルダーにリンクされているアセットは、 アイコンを使用してマークされます。アイコンが存在しない場合は、現在のフォルダーがアセットが存在する唯一のフォルダーです。ここで削除すると、アセットは Orchestrator から完全に削除されます。アセットを追加するフォルダー (ターゲット フォルダー) での Assets - Create 権限と、アセットが現在存在するフォルダー (元のフォルダー) での Assets - View 権限が必要です。ターゲット フォルダーに [アセット] - [編集 ] がある場合、元のフォルダーに [アセット] - [編集 ] は必要ありません。アセットがフォルダーに共有されると、移動先のフォルダーに 「アセット - 編集 」を持つユーザーがアセットを編集でき、変更はグローバルに適用されます。

現在のフォルダーに複数のアセットをリンクする

1. アセットをリンクするフォルダーの [ アセット ] ページで [ 追加] を選択します。3 つのボタンが表示され、アセットを追加したり、他のフォルダーのアセットをリンクしたり、オプションを非表示にしたりできます。
2. [ 他のフォルダーからリンク] を選択します。[ アセットをリンク] ウィンドウに、アセットの表示権限を持つフォルダー内のすべてのアセットのリストが表示されます。

図 1. 他のフォルダーのアセットのリンク

3. [アセットを選択] セクションで、リストから 1 つまたは複数のアセットを選択します。
4. [ 続行] を選択します。[フォルダーの検証] セクションに移動します。ここでは、アセットがすでにリンクされているフォルダーを確認できます。複数のフォルダーがある場合は、それらのフォルダーの名前が表示されます。

図 2. フォルダーの検証

5. 変更を元に戻すには、該当するアセットの [ 削除 ] を選択し、操作を取り消すには [ 終了 ] を選択します。
6. 選択したアセットと現在のフォルダーの間にリンクを作成するには、[リンク] を選択します。アセットが [アセット] ページに表示されます。

複数のフォルダーにアセットをリンクする

1. リンクするアセットが存在するフォルダーに移動します。

目的のアセットで [その他のアクション] > [リンクを管理] を選択して、[リンクを管理] ウィンドウを開きます。アセットのリンクの管理ウィンドウが表示されます。

図 3. アセットのリンクの管理

1 - 左側のペインには、アセットの表示権限が付与されたすべてのフォルダーが表示されます。

2 - アセットの現在のステート。アセットが現在置かれているフォルダーの数とその名前を示します。

3 - 左側のペインで選択した内容に従ってアセットが追加されるフォルダーです。

4 - アセットが削除されるフォルダーです。

1. [ 更新] を選択します。確認のウィンドウが表示されます。
2. 変更を中止する場合は [キャンセル] を選択し、変更を反映させる場合は [続行] を選択します。変更内容に応じて、Orchestrator に操作が反映されます。

フォルダーへのアセットのリンクを解除する

フォルダーへのアセットのリンクの解除は、リンク操作とほぼ同じ方法で実行できます。上記の手順のリンク管理領域に移動し、特定のアセットと特定のフォルダー間の接続を削除します。

または、[ 削除 ] 機能を使用してアセットを削除することもできます。アセットの削除を参照してください。

重要:

複数のフォルダーに存在するアセットを削除すると、アセットは削除操作を実行したフォルダーからのみ削除され、他のフォルダーからは削除されません。アセットを完全に削除するには、既存のリンクをすべて削除する必要があります。

アセットの編集

アセットを編集するには、[その他のアクション] > [編集] ボタンをクリックし、必要な変更を加えて、[アセットを更新] ウィンドウで [更新] をクリックします。アセット値と名前のみを編集できます。すべての変更は監査対象となり、[ 監査 ] ページで表示できます。資格情報アセットのユーザー名を変更する場合は、パスワードも変更する必要があります。

ユーザーごとおよびロボットごとのアセット値を削除する

特定のユーザーまたはロボットに対して定義されたアセット値をアセット エディターから直接削除できます。

1. [アセット] を開きます。
2. 新しいアセットを作成するか、既存のアセットを編集します。
3. [アセット値] セクションで、削除する値を選択します。
4. [削除] を選択します。
5. 確認ダイアログで [削除] を選択します。

グリッド ヘッダーの [削除] オプションを使用し、複数のエントリを選択して同時に削除することもできます。

アセットにタグを追加する

注:

アセットに既存のタグを追加するには、アセットに対する [編集] 権限とタグに対する [表示] 権限が必要です。 アセットに新しいタグを追加するには、アセットに対する [編集] 権限とタグに対する [作成] 権限が必要です。

注:

• 各アセットには、最大 100 万個のキー/値のペアを設定できます。
• ラベルおよびキー/値のプロパティに使用できる文字数は、最大 256 文字です。
• タグ名に含められない文字は、 <、 >、 %、 &、 ?、 /、 :です。

アセットへのタグの適用は、アセットの作成時または既存のアセットの編集時に行うことができます。アセットの編集時にアセットにタグを追加するには、以下の手順に従います。

1. [ アセット] ページで、目的のアセットの横にある [ その他のアクション ] > [編集 ] を選択します。アセットが編集用に開きます。
2. [ラベル] フィールドで、ラベル名の入力を開始します。既存のラベルを選択するか、新しいラベルを作成することができます。
3. [ プロパティ (キーと値のペア)] フィールドで、[ 新規追加] を選択します。
4. 新しいキーと値を追加します。既存のキーまたは値を選択するか、新しいキーまたは値を作成することができます。
5. 完了したら、[ 更新] を選択します。アセットが更新され、新しく作成されたタグ (ある場合) が他のオブジェクトで利用できるようになります。

アセットからタグを削除する

アセットからタグを削除するには、以下の手順に従います。

1. [ アセット] ページで、目的のアセットの横にある [ その他のアクション ] > [編集 ] を選択します。アセットが編集用に開きます。
2. [ ラベル] フィールドで、ラベルの名前の横にある [X ] を選択して削除します。ラベルが削除されます。
3. [プロパティ (キーと値のペア)] フィールドで、キーや値の横にある X を選択して削除します。キーや値が削除されます。
4. キーと値のペアを削除するには、次の手順を実行します。 そのエントリに対応する [削除 ] アイコンを選択します。キーと値のペアが削除されます。
5. 完了したら、[ 更新] を選択します。アセットが更新され、タグが削除されます。

アセットを削除する

アセットを削除するには [その他のアクション] > [削除] をクリックします。

または、1つまたは複数のアセットを選択して [削除] ボタンをクリックすることもできます。