個人用アクセス トークン

個人用アクセス トークン (PAT) を使用すると、高レベルのセキュリティを維持しながら、UiPath のサービスやリソースに簡単にアクセスできます。

個人用アクセス トークンとは何ですか?

個人用アクセス トークンとは、UiPath の API やサービスを操作する際に資格情報の代わりに機能する、一意の英数字の文字列です。ユーザー名とパスワードを直接指定する代わりに、個人用アクセス トークンを生成することで特定の UiPath リソースに対して制御されたアクセスが付与されます。

注:

PAT はローカル ユーザーのみが利用できます。ディレクトリ ユーザーや SAML では利用できません。

認証にトークンを使用するメリット

認証に個人用アクセス トークンを使用する主なメリットは、次のとおりです。

1. セキュリティの強化: PAT はユーザー名とパスワードの代わりに使用されるため、プライマリ資格情報を公開するリスクが削減されます。

2. きめ細かいアクセス制御: 範囲と権限を定めることで、各トークンのアクセスのレベルを正確に定義し、ユーザーのアクションを必要な対象に対してのみに制限できます。

3. 有効期限: トークンに有効期限を割り当てることで、有効期間を制限できます。

トークンの範囲と権限

トークンの範囲は、トークンがアクセスできる特定のアクションやリソースを定義します。トークンを作成する際に、トークンの利用目的に基づいた適切な範囲を選択するよう求められます。範囲の例として以下が挙げられます。

• TM.Defects.Read - Test Manager で、不具合の読み取りやアクセスに関連するアクションを実行できます。
• OR.Folders - Orchestrator で、フォルダー データの読み取り、フォルダーの作成、変更、管理を可能にします。

ニーズに適した範囲を選択する

個人用アクセス トークンを生成する際は、実行しようとするタスクに合う範囲を選択する必要があります。自身のユース ケースに必要な範囲のみを要求してください。トークンの権限を最小化することで、セキュリティ侵害を受けた場合に受ける影響を軽減し、セキュリティを強化します。

適切な範囲を選択するには、以下の手順を実行します。

1. フォルダー データの読み取りやフォルダーの管理など、トークンに実行させる必要のあるタスクを決定します。

2. トークン生成プロセスで利用可能な範囲とその説明のリストを確認します。

3. トークンがタスクを効果的に達成できる最小限の範囲セットを選択します。

トークンを生成する

トークンを生成するには、以下の手順に従います。

1. ウィンドウの右上隅にあるユーザー アイコンをクリックし、[設定] を選択します。 [設定] ページが開きます。
   図 1. ユーザー メニューの設定 [設定] オプションを表示しているユーザー メニューのスクリーンショット。このオプションでは、好きなように設定を調整してユーザー エクスペリエンスをパーソナライズできます。
2. 左側の [個人用アクセス トークン] をクリックします。[個人用アクセス トークン] ページには、ユーザーに対して生成された個人用トークンのリストが表示されます (ある場合)。
3. 新しいトークンを生成するには、[新しいトークンを生成] をクリックします。右側に [個人用アクセス トークンを生成] ペインが開きます。
4. 識別できるよう、[名前] フィールドに名前を入力します。
5. [有効期限] フィールドに有効期限を入力します。この日付を過ぎるとトークンが無効になります。
6. [範囲] > [リソース] フィールドから範囲を選択し、トークンがアプリケーション内で実行を許可される特定の権限やアクションを定義します。
   図 2. 個人用アクセス トークンの設定 個人用アクセス トークンとその範囲の設定ウィンドウのスクリーンショット。ユーザーは、各トークンのリソース、範囲、有効期限を定義することで、アクセス権を管理・カスタマイズできます。
7. フィールドを設定したら、[保存] をクリックしてトークンを保存します。システムによって一意のアクセス トークンが生成されます。このトークンは [生成されたトークン] ウィンドウに表示されます。
   図 3. 生成されたトークンの確認。 トークンの生成が成功したことを確認するスクリーンショット。インターフェイスには、新しく生成されたトークンと一意の英数字のコードが表示されます。チェックマークはプロセスの完了を表しています。これでユーザーは、このトークンを使用して UiPath の特定のリソースに対して安全に認証を行い、アクセスできます。通知では、このトークンが再度表示されないことが示されます。
8. アクセス トークンが生成されたらすぐにコピーしてください。トークンが表示される機会はこの時だけです。再び確認することができないので、安全な場所に保管しておいてください。これで、このトークンを使用して、API を介して UiPath のリソースに認証を行いアクセスできるようになりました。

トークンを取り消す

トークンを取り消すと、不要になった、またはセキュリティ侵害を受けたトークンのアクセス権を直ちに無効化できます。トークンを取り消すには、以下の手順に従います。

1. ウィンドウの右上隅にあるユーザー アイコンをクリックし、[設定] を選択します。 [設定] ページが開きます。
2. 左側の [個人用アクセス トークン] をクリックします。[個人用アクセス トークン] ページには、ユーザーに対して生成された個人用トークンのリストが表示されます。
3. トークンを取り消すには、特定のトークンの [その他のアクションを表示] > [取り消し] をクリックします。[トークンを取り消し] ウィンドウが表示され、取り消しの確定を求められます。
   図 4. トークンの取り消しの確認 トークンの取り消しウィンドウのスクリーンショットです。トークンの取り消しが成功したことを示しています。これまでのトークンの使用は、今後は無効になります。
4. [削除] をクリックして、トークンを取り消します。トークンを削除すると、利用可能なリストからトークンが削除され、UiPath のリソースにアクセスする手段として有効ではなくなります。
   重要: Orchestrator のキャッシュのメカニズムでは、PAT が 1 時間格納されます。したがって、キャッシュの有効期限が切れるまでは、取り消されたトークンが Orchestrator リソースに最大で 1 時間程度アクセスできる場合があります。

トークンの再生成

同じレベルのアクセス権を維持しながらトークンを更新する必要があるシナリオでは、個人用アクセス トークンの再生成を検討してください。再生成では、元のトークンと同じ範囲と権限を持つ新しいトークンが作成されます。ただし、古いトークンを使用しているスクリプト、アプリケーション、連携機能は新しいトークンで必ず更新してください。

重要:

再生成は、まだ有効期限が切れていないトークンにのみ適用できます。トークンの有効期限が切れると再生成できません。

Orchestrator のキャッシュのメカニズムでは、PAT が 1 時間格納されます。その結果、取り消されたトークンは、キャッシュの有効期限が切れるまで、さらに 1 時間ほど Orchestrator のリソースにアクセスする可能性があります。

トークンを再生成する

トークンを再生成するには、以下の手順に従います。

1. ウィンドウの右上隅にあるユーザー アイコンをクリックし、[設定] を選択します。 [設定] ページが開きます。
2. 左側の [個人用アクセス トークン] をクリックします。[個人用アクセス トークン] ページには、ユーザーに対して生成された個人用トークンのリストが表示されます。
3. トークンを再生成するには、有効期限が切れていないトークンの [その他のアクションを表示] >[再生成] をクリックします。[トークンを再生成] ウィンドウが表示されます。
   図 5. トークンの再生成の確認

   トークンの再生成を確定するウィンドウのスクリーンショットです。トークンを再生成する意図を確認するメッセージが表示されます。

   
4. [確定] をクリックしてトークンを再生成します。システムによって一意のアクセス トークンが生成されます。このトークンは [生成されたトークン] ウィンドウに表示されます。
   図 6. 生成されたトークンの確認 トークンの生成が成功したことを確認するスクリーンショット。インターフェイスには、新しく生成されたトークンと一意の英数字のコードが表示されます。チェックマークはプロセスの完了を表しています。これで、このトークンを使用して UiPath の特定のリソースに対して安全に認証を行い、アクセスできるようになりました。通知では、トークンは再度表示されないことが示されます。
5. アクセス トークンが生成されたらすぐにコピーしてください。トークンが表示される機会はこの時だけです。再び確認することができないので、安全な場所に保管しておいてください。これで、このトークンを使用して、API を介して UiPath のリソースに認証を行いアクセスできるようになりました。