UiPath スポークを設定
ServiceNow インスタンスと UiPath アカウントを統合し、ServiceNow 要求を認証します。
始める前に
- 統合ハブ サブスクリプションの要求。
- UiPath スポークを有効にします。
- 必要なロール:admin。
このタスクについて
- OAuth 認証を使用して UiPath スポークを設定するには、「オプション 1:OAuth 認証の使用」を参照してください。
- この認証は UiPath スポーク v2.2.1 から利用できます。
- OAuth 認証を使用してスポークを設定する場合は、MID サーバー を使用できません。
- API キーを使用して UiPath スポークを設定するには、「オプション 2:API キーの使用」を参照してください。
オプション 1:OAuth 認証の使用
OAuth を使用して ServiceNow インスタンスと UiPath アカウントをデータ連携し、ServiceNow 要求を認証します。
始める前に
必要なロール:admin
注:
- この認証は UiPath スポーク v2.2.1 から利用できます。
- OAuth 認証を使用してスポークを設定する場合は、MID サーバー を使用できません。
手順
-
アプリケーションを UiPath アカウントで登録します。
- アドミニストレーターとして UiPath アカウントにログインします。
- 移動先 管理者 > 外部アプリケーション.
- [+ アプリケーションを追加] をクリックします。
-
フォームに、これらの値を入力します。
フィールド 説明 アプリケーション名 OAuth アプリケーションの名前。 アプリケーションタイプ OAuth アプリケーションのタイプ。[機密アプリケーション (Confidential application)] を選択します。 リソース 必要なリソースとスコープ。 - [+ スコープの追加] をクリックします。
- [リソース] リストから [オーケストレーター API アクセス (Orchestrator API Access)] を選択します。
- 次のようなアプリケーションスコープを選択します。
- OR.Robots.Read
- OR.Robots.Write
- OR.Jobs.Read
- OR.Jobs.Write
- OR.Machines.Read
- OR.Execution.Read
- OR.Queues.Read
- OR.Queues.Write
- OR.Folders.Read
- [保存] をクリックします。
リダイレクト URL ServiceNow インスタンスのリダイレクト URL は次の形式になります:https://<ServiceNow-instance>.service-now.com/oauth_redirect.do -
[追加] をクリックします。
アプリケーションが登録され、アプリ ID とアプリシークレットの値が表示されます。
- アプリ ID とアプリ シークレットの値をコピーして記録します。
-
ServiceNow インスタンスで、必要な接続および資格情報エイリアスを構成します。
- アドミニストレーターとして ServiceNow インスタンスにログインします。
- 移動先 すべて > 接続 & 認証情報 > 接続と認証情報エイリアス.
- [UiPath] のレコードを開きます。
- [構成テンプレート] に、[UiPath 構成テンプレート - OAuth クライアント認証情報] を選択します。
- [新しい接続および資格情報の作成] 関連リンクをクリックします。
-
フォームの各フィールドに入力します。
表 : 1. 接続および認証情報フォームを作成 フィールド 説明 接続情報 名前 OAuth アプリケーションレジストリレコードを識別する名前。 接続 URL 接続 URL は次の形式となります:https://{base_url}/{organization_name}/{tenant-name}/orchestrator_。この URL は UiPath 展開のタイプによって異なります。 認証情報 名前 認証情報レコードを識別する名前です。 トークン URL トークンを取得および更新するためにインスタンスが使用するトークンエンドポイントの場所です。 この URL は UiPath 展開のタイプによって異なります。 OAuth クライアント ID UiPath アカウントにアプリケーションを登録した後にコピーしたアプリ ID。 OAuth クライアントシークレット UiPath アカウントにアプリケーションを登録した後にコピーしたアプリ シークレット。 OAuth リダイレクト URL ServiceNow インスタンスのリダイレクト URL は次の形式になります:https://<ServiceNow-instance>.service-now.com/oauth_redirect.do。 - [作成] をクリックします。
-
[送信] をクリックします。
接続および認証情報レコードが作成されます。
- [接続 ] タブから UiPath 接続レコードを開きます。
- [Orchestrator 機能の有効化] フィールドの値を選択します。
タスクの結果
オプション 2:API キーの使用
API キーを使用して ServiceNow インスタンスと UiPath アカウントをデータ連携し、ServiceNow 要求を認証します。
始める前に
必要なロール:admin
手順
-
UiPath クラウドアカウントから、必要な API リフレッシュトークンの値を取得します。
注:これらの手順は、UiPath クラウドアカウントに適用されます。
- アドミニストレーターとして UiPath アカウントにログインします。
- 移動先 設定 > プライバシーとセキュリティ.
-
必要なテナントで、[API アクセスを表示 (View API access)] をクリックします。
[ユーザーキー]、[組織 ID]、[テナント名]、[クライアント ID] の値が表示されます。
- これらの値をコピーして記録します。
-
ServiceNow インスタンスで、必要な接続および資格情報エイリアスを構成します。
- アドミニストレーターとして ServiceNow インスタンスにログインします。
- 移動先 すべて > 接続 & 認証情報 > 接続と認証情報エイリアス.
- [UiPath] のレコードを開きます。
- [構成テンプレート] で、要件に応じて [UiPath 構成テンプレート - UiPath クラウド] または [UiPath 構成テンプレート - プライベート/パブリッククラウド] を選択します。
- [新しい接続および資格情報の作成] 関連リンクをクリックします。
-
フォームの各フィールドに入力します。
- [構成テンプレート] に [UiPath 構成テンプレート - UiPath クラウド] を選択した場合は、次のフィールドに入力します。注:このオプションは、UiPath クラウドアカウントを使用している場合に適用されます。
表 : 2. 接続および認証情報フォームを作成 フィールド 説明 接続名 接続レコードを識別する名前。たとえば、UiPath 接続です。 接続 URL 接続 URL のフォーマット:https://platform.uipath.com/<account-logical-name>/<instance-logical-name> 認証情報名 認証情報レコードを識別する名前です。たとえば、UiPath 認証情報です。 トークン URL トークンを取得および更新するためにインスタンスが使用するトークンエンドポイントの場所です。たとえば、https://account.uipath.com/oauth/token です。 クライアント ID UiPath Orchestrator アプリケーションからコピーしたクライアント ID の値。 アカウント論理名 UiPath Orchestrator アプリケーションからコピーした組織 ID。 テナント論理名 UiPath Orchestrator アプリケーションからコピーしたテナント名。 ユーザーキー UiPath Orchestrator アプリケーションからコピーしたユーザーキー。 - [構成テンプレート] に [UiPath 構成テンプレート - プライベート/パブリッククラウド] を選択した場合は、次のフィールドに入力します。
表 : 3. 接続および認証情報フォームを作成 フィールド 説明 接続名 接続レコードを識別する名前。たとえば、UiPath 接続です。 接続 URL UiPathインスタンスの URL です。 認証情報名 認証情報レコードを識別する名前です。たとえば、UiPath 認証情報です。 トークン URL トークンを取得および更新するためにインスタンスが使用するトークンエンドポイントの場所のフォーマット:http://<instance-URL>/api/account/authenticate テナント名 テナント論理名 ユーザー名またはメール UiPathOrchestrator API を認証するためのユーザー名またはメールアドレスです。 パスワード 関連付けられたパスワードです。
注:- オンプレミスをサポートするには、接続レコードで [MID サーバーを使用] オプションを有効にし、信頼できる機関から SSL 証明書を作成する必要があります。
- MID サーバー ユーザーには、sn_uipath_spoke.uipath_admin ロールが必要です。
- [構成テンプレート] に [UiPath 構成テンプレート - UiPath クラウド] を選択した場合は、次のフィールドに入力します。
- [作成] をクリックします。
-
[送信] をクリックします。
接続および認証情報レコードが作成されます。
- [接続 ] タブから UiPath 接続レコードを開きます。
- [Orchestrator 機能の有効化] フィールドの値を選択します。