ServiceNow の認証

ユーザー名とパスワードを使用するか、Automation Suite の OAuth 2.0 認証を使用して UiPath を ServiceNow に接続します。

UiPath は、ServiceNow に対して以下の認証の種類をサポートしています。

認証の種類	説明	最適な用途
Basic (ユーザー名/パスワード)	HTTPS 基本認証を介した ServiceNow ユーザーによる直接ログイン。	OAuth を使用しないシンプルな設定で、迅速な POC に最適
OAuth 2.0 パスワード付与	サービス アカウントのユーザー名/パスワードと、トークンと交換される OAuth クライアント資格情報。	サービス間の連携: OAuth は必要だが対話型ログインは実用的ではない

Basic (ユーザー名/パスワード)

接続フィールド

フィールド	説明
サイト URL	ServiceNow インスタンスの完全な URL (例: https://your-instance.service-now.com
ユーザー名	ServiceNow 連携のユーザー名です。
パスワード	連携ユーザーのパスワードです。

一般的な問題

4XX エラー

• Verify Instance URL, Username, and Password (インスタンスの URL、ユーザー名、パスワード)アカウントがアクティブであり、IP/ログインポリシーによってロックまたはブロックされていないことを確認します。
• ユーザーが sys_db_object 、 sys_dictionary を読み取ることができ、ターゲット テーブルに対して必要な ACL (読み取り/挿入/更新/削除) を持っていることを確認します。
• ServiceNow インスタンスが休止状態になっていないことを確認します。

OAuth 2.0 パスワード

接続フィールド

フィールド	説明
サイト URL	ServiceNow インスタンスの完全な URL。
ユーザー名	ServiceNow サービス アカウントのユーザー名です。
パスワード	そのサービス アカウントのパスワード。
クライアント ID	ServiceNow OAuth クライアントのクライアント ID。
クライアント シークレット	同じ OAuth クライアントのクライアント シークレット。

OAuth を設定する

注:

次の手順は 、Washington、Yokohama、および以前のバージョン の ServiceNow に適用されます。チューリッヒまたはオーストラリアを使用している場合は、「チューリッヒとオーストラリアの OAuth を設定する (インバウンド連携)」をご覧ください。

ServiceNow ドキュメントの「Set up OAuth」の手順を完了します。

ドキュメントに記載されている手順は ServiceNow プラットフォームのすべてのリージョンで同じであると考えられますが、違いがある場合に備えて、特定のリージョン向けの手順に従ってください。

参考までに、次の手順では、今回の例で OAuth を設定する方法を説明します。

1. ServiceNow インスタンスにサインインします (例: https://<span>dev74293.service-now.com/login</span>)。
2. [システム定義] > [プラグイン] に移動し、[OAuth プラグインのステータス] が [アクティブ] に設定されていることを確認します。

3. システム OAuth の > アプリケーション レジストリに移動し、[新規] を選択します。
   • [OAuth アプリケーションの種類] という質問が表示されたら、[外部クライアント用の OAuth API エンドポイントを作成する] を選択します。

4. アプリケーションの [名前 ] を入力します (例:UiPathQuickstart) をクリックし、[ 送信 ] を選択します (成功すると、 アプリケーション登録 リストにリダイレクトされます)。

5. [アプリケーション レジストリ] リストで新しいアプリケーションを見つけ、[名前] を選択して詳細ページを開きます。
6. [クライアント シークレット] の横にあるロック アイコンを選択して値を表示します。
7. [Client ID] と [Client Secret] の値をメモします。
8. 対応するフィールドに、次のリダイレクト URL を入力します。 https://{yourDomain}/provisioning_/callback。

チューリッヒとオーストラリアの OAuth を設定する (インバウンド連携)

チューリッヒ、オーストラリア、およびそれ以降のバージョンでは、ServiceNow が [外部クライアント用の OAuth API エンドポイントを作成] オプションを、マシン ID コンソールで設定される簡素化されたインバウンド連携フローに置き換えました。

ServiceNow ドキュメントの 「Configure an OAuth Authorization Code Grant 」の手順に従って、インバウンド連携を作成します。

インバウンドインテグレーションを設定する場合、リダイレクト(コールバック)URLを「 https://{yourDomain}/provisioning_/callback」に設定します。

注:

• ユーザーのアクセス制御と API ポリシーを既定で適用する場合は、[ 選択したスコープ内の API にのみアクセスを許可する ] をオフにします。
• [ 選択したスコープ内の API にのみアクセスを許可 し、スコープを割り当てる] を有効化した場合、連携を機能させるには Tables API スコープが必要です。

注:

チューリッヒ/オーストラリアのインバウンド統合手順は、OAuth 認可コードの付与フローについて記載されています。OAuth 2.0 のパスワード許可を使用している場合は、ServiceNow のドキュメントを参照して、同じ受信連携の設定がお使いの ServiceNow バージョンのパスワード許可クライアント設定にも対応しているかどうかを確認してください。

ServiceNow コネクションを追加する

お使いの ServiceNow インスタンスへのコネクションを作成するには、次の手順を実行する必要があります。

1. 左側のレールから [Integration Service] を選択します。
2. [コネクタ] のリストから [ServiceNow] を選択します。 検索バーで検索して、表示されるコネクタの数を絞ることもできます。
3. [ ServiceNow に接続 ] ボタンを選択します。
4. 使用する認証の種類を選択して、必要な資格情報を入力します。
5. [接続] を選択します。
6. 次に、ServiceNow のユーザー名とパスワードを入力します。アプリから、ServiceNow のアカウントに接続してレコードを操作する権限が要求されます。[許可する] を選択します。

ServiceNow のコネクション作成に関する詳細については、ServiceNow の「製品ドキュメント」をご覧ください。

ServiceNow のロールと権限

以下の表に、コネクションを作成し、ServiceNow コネクタを使用するために必要な、最小限のロールと権限を示します。この要件は、すべての認証の種類に適用されます。

ServiceNow テーブル	操作	アクセス理由
Tables (sys_db_object)	読み取り	Tables モジュール/テーブルは、ServiceNow インスタンスの各テーブルに対応する行を保持するリポジトリとして機能します。 これは、アクションを実行したり、イベントをトリガーしたりする目的でテーブルのリストをコンパイルするために使用されます。 これは、CRUD アクティビティに [オブジェクトを選択] ドロップダウンを使用するときにすべてのテーブルを読み込むために必要です。
Dictionary (sys_dictionary)	読み取り	このテーブルには、ServiceNow インスタンス内の特定のテーブルのそれぞれの列に関するデータが含まれます。 このテーブルは、アクションを実行するテーブルを選択するときに入力フィールドと出力フィールドを読み込むために必要です。
Choices (sys_choice)	読み取り	Choice テーブルには、選択リストに表示されるオプションの値と、UiPath の選定されたアクティビティで検索するための値が含まれます。 Choice テーブルがなければ、設計時におけるアクティビティ内の検索の読み込みに失敗します。
ユーザー (sys_user)	読み取り	Choice テーブルには、選択リストに表示されるオプションの翻訳されたテキストと、UiPath の選定されたアクティビティで検索するための値が含まれます。 Choice テーブルがなければ、設計時におけるアクティビティ内のユーザー関連の検索の読み込みに失敗します。

さらに、ユーザーは連携シナリオに不可欠な、テーブルに対して必要なアクセス制御も保持している必要があります。 たとえば、一般的な ITIL ヘルプデスク アクション (インシデント、問題、変更、構成管理アイテムのオープン、更新、クローズなど) を実行できる統合ユーザーを確立する場合は、itil ロールを割り当てる必要があります。

カスタム ロールを作成する

admin などの特定のベース システム ロールには、これらのテーブルへのアクセス制御が既に含まれています。ただし、ベース システム ロールを割り当てず、ServiceNow コネクタを使用するのに必要な必須のアクセス制御のみを付与する場合は、必要なアクセス権を持つカスタム ロールを作成することを検討してください。

特定のテーブルまたは既定のベース システム ロールでカバーされないテーブルにのみアクセス権を付与するには、カスタム ロールを作成し、必要に応じて適切なアクセス制御を割り当てることをお勧めします。

ServiceNow のコネクタ/アクティビティを利用するには、新しいロールに以下の表に示すアクセス制御を付与する必要があります。たとえば、管理者権限を持たないユーザーが sys_dictionary テーブルにアクセスするには、personalize_dictionary ロールが必要です。

表	入力	操作
Tables (sys_db_object)	レコード	読み取り
Dictionary (sys_dictionary)	レコード	読み取り
Choices (sys_choice)	レコード	読み取り
ユーザー (User) (sys_user)	レコード	読み取り
フィールドクラス(sys_glide_object)	レコード	読み取り

注:

アクセス制御の編集または作成は、security\_admin ロールを持つユーザー専用の機能です。 不明な点がある場合は、ServiceNow の管理者にお問い合わせください。詳細については、「昇格された特権ロール」をご覧ください。

アクティビティまたはトリガーを実行するには、他のアクセス制御も付与する必要があります。

たとえば、特定のシナリオで ServiceNow インシデントを含むワークフローの開始や ServiceNow インシデントの作成を行う場合は、次のアクセス制御を付与する必要があります。

表	入力	操作
インシデント	レコード	読み取り
インシデント	レコード	書き込み