ServiceNow の認証

前提条件

コネクションを確立するには、コネクタに OAuth アクセス トークンを取得する機能を与え、アクティビティが ServiceNow API に要求を正常に送信できるようにする必要があります。

OAuth を設定する

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

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

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

1. ServiceNow インスタンスにサインインします (例: https://<span>dev74293.service-now.com/login</span>)。

2. 「システム定義」>「プラグイン」に移動し、OAuth プラグインの「状況」が「アクティブ」に設定されていることを確認します。

   
   

   

   
   

3. [ System OAuth > Application Registry ] に移動し、[ New] を選択します。

   • 「What kind of OAuth application?」というメッセージが表示された場合は、[Create an OAuth API endpoint for external clients] を選択します。

     
     

     

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

   

   
   
5. [ アプリケーション レジストリ ] リストで新しいアプリケーションを見つけ、[ 名前 ] を選択して詳細ページを開きます。
6. [クライアント シークレット] の横にあるカギのアイコンを選択して、値を表示します。
7. [Client ID] と [Client Secret] の値をメモします。

8. 対応するフィールドに、次のリダイレクト URL を入力します。
   https://cloud.uipath.com/provisioning_/callback

   
   

   

   
   

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

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

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

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

ServiceNow のロールと権限

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

注:

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

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

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

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