接続の作成の前提条件
「ServiceNowアダプタ」接続を作成するには、次の前提条件を満たす必要があります。
ServiceNowへのサブスクリプションの購入
サブスクライブの際、インスタンス名のURL、ユーザー名およびパスワードを受け取ります。 この情報は、「Connections」ページでServiceNowアダプタ接続を作成するために必要です。 「接続プロパティの構成」と「接続セキュリティの構成」を参照してください。
ユーザーとロールの要件を満たす
Adminロールまたはカスタム・ユーザーを持つServiceNowユーザーは、Oracle Integrationの「ServiceNowアダプタ」を使用できます。 ServiceNowにカスタム・ユーザー(統合ユーザーなど)を作成し、ServiceNowの次の表に示す表名へのアクセス権を持つカスタム・ロールを割り当てることができます。
webサービスが有効になっており、ServiceNowインスタンスの次の表にそれぞれの権限が割り当てられていることを確認します。
統合ユーザーに適切なロールがあることを確認します。
「ServiceNowアダプタ」を構成または使用するには、デフォルトのSOAPロール(カスタマイズまたは変更を除く)を持つServiceNowユーザーが必要です。
デフォルトのSOAPロールには次の権限があります: すべての表に対するレコードの問合せ、作成、更新および削除、およびスクリプトの実行が可能です。 検証は可能ですが、ServiceNowは管理ロールを使用して推奨します。
ノート:
SOAPのロールが変更されている場合、またはSOAPロールが機能していない場合は、ServiceNowの推奨事項に従って、管理ロールを使用する必要があります。 管理ロールを割り当てない場合は、カスタム・ロールを作成し、次の表にアクセスを追加し、カスタム・ロールにデフォルトのSOAPロールを割り当てることができます。| 表名 | 権限 |
|---|---|
sys_soap_message |
ServiceNowアウトバウンドSOAPメッセージの挿入/削除用。
ノート: この権限は、トリガー接続にのみ必要です。 |
sys_soap_message_function |
ServiceNowアウトバウンドSOAPメッセージ挿入関数の場合。
ノート: この権限は、トリガー接続にのみ必要です。 |
sys_script |
insert/update/delete of ServiceNowビジネス・ルールの場合。
ノート: この権限は、トリガー接続にのみ必要です。 |
sys_db_object |
モジュールを取得するため。 ノート: この権限は、両方の接続(つまり、起動およびトリガー接続)に必要です。 |
Sys_package |
標準パッケージをフェッチします。 ノート: この権限は、両方の接続(つまり、起動およびトリガー接続)に必要です。 |
次の表にアクセス権を追加すると、アダプタでサポートされているアプリケーションおよびモジュールがユーザー・インタフェースに表示され、選択できるようになります:
| 権限 | 操作 |
|---|---|
|
|
標準アプリケーションを取得するには:。 |
|
|
カスタム・アプリケーションを取得します。 |
|
|
モジュールを取得するため。 |
|
|
Get操作でViewフィールドを取得します。 |
sys_documentation |
ユーザー・インタフェースで実際のフィールド名のかわりにフィールド・ラベルを表示します。 |
sys_package |
標準パッケージをフェッチする場合。
ノート: この権限は、両方の接続(つまり、起動およびトリガー接続)に必要です。 |
|
|
Get操作でViewフィールドを取得します。 |
|
|
ServiceNowアウトバウンドSOAPメッセージの挿入/削除の場合。 ノート: この権限は、トリガー接続にのみ必要です。 |
|
|
ServiceNowアウトバウンドSOAPメッセージ挿入関数の場合。 ノート: この権限は、トリガー接続にのみ必要です。 |
|
|
insert/update/delete of ServiceNowビジネス・ルールの場合。 ノート: この権限は、トリガー接続にのみ必要です。 |
カスタム・ユーザーの作成と必要な権限の割当て
- カスタム・ロールを作成します:
- 管理者の資格証明を使用して、ServiceNowクラウド・アプリケーション(
xxx.service-now.com)にログインします。 - ホーム・ページの左ペインの検索ボックスで「ロール」を検索し、検索結果の「ユーザー管理」の下にある「ロール」をクリックします。
- 新しいロールを作成するには、「新規」をクリックします。
- 必要な詳細を入力し、「送信」をクリックします。
- 管理者の資格証明を使用して、ServiceNowクラウド・アプリケーション(
-
先行する表に対してwebサービスを有効にし、権限を割り当てます:
-
管理者の資格証明を使用して、ServiceNowクラウド・アプリケーション(
xxx.service-now.com)にログインします。 -
ホーム・ページの左ペインで検索ボックスで表を検索し、検索結果で「システム定義」の下にある「表」リンクをクリックします。
-
「検索」ボックスを使用して前の表から各ServiceNow表を検索するか、表示/非表示フィルタを使用して表を検索します。
-
検索結果で表名または「ビジネス・ルール」 (トリガー・ロールの場合)をクリックします。
- 「アプリケーション・アクセス」タブを探してクリックします。
- 起動ロールについては、「既読可能」チェック・ボックスを選択し(必要な権限について次の表を参照)、「Webサービス経由でこの表へのアクセスを許可」チェック・ボックスを選択し(選択されていない場合)。
表名 権限 Sys_db_object読取り専用 Sys_plugins読取り専用 Sys_app読取り専用 Sys_ui_section読取り専用 Sys_ui_element読取り専用 Sys_package読取り専用 表へのアクセスを最小限に抑えて「ServiceNowアダプタ」接続を作成する場合は、次の表で必要な権限を参照できます。
表名 権限 sys_db_object読取り専用 Sys_package読取り専用 -
トリガー・ロールの場合、それぞれの権限を選択し(必要な権限について次の表を参照)、「Webサービス経由でこの表へのアクセスを許可」チェック・ボックスを選択します(まだ選択されていない場合)。
表名 権限 sys_soap_message作成、更新および削除 sys_soap_message_function作成、更新および削除 sys_script作成、更新および削除 sys_db_object読取り専用 sys_plugins読取り専用 sys_app読取り専用 sys_ui_section読取り専用 Sys_ui_element読取り専用 Sys_package読取り専用 sys_documentation読取り専用 ノート: リスト内の実際のフィールド名のかわりにフィールド・ラベルを表示する場合は、この権限を割り当てます。
これにより、表に必要なアクセス権が付与され、webサービスで表にアクセスする権限が付与されます。
表へのアクセスを最小限に抑えて「ServiceNowアダプタ」接続を作成する場合は、次の表で必要な権限を参照できます。表名 権限 sys_soap_message作成、更新および削除 sys_soap_message_function作成、更新および削除 sys_script作成、更新および削除 sys_db_object読取り専用 Sys_package読取り専用
-
- 前述の表に対する権限を割り当てるには、アクセス制御リストを作成または変更します。
- security_admin権限が管理ユーザーに割り当てられていない場合は、管理者ユーザーに割り当てます。 管理ユーザーは、アクセス制御リストを変更するためのsecurity_admin権限を持っている必要があります。
- ホーム・ページで、lockアイコンをクリックします。 ユーザー・インタフェース16の場合は、「システム管理者」ドロップダウン・リストから「ロールの昇格」を選択します。
- まだ選択されていない場合は、security_adminチェック・ボックスを選択します。
- 左側のペインの「検索」ボックスで「アクセス制御」を検索し、「システムのセキュリティ」の下の「アクセス制御(ACL)」をクリックします。
- 表に対する読取り、作成および書込みアクセスを提供する表(表レベルのアクセス制御およびフィールド・レベルのアクセス制御)に対する2つのアクセス制御リストを作成します。
- 表レベルのアクセス制御リストを作成します:
- 「新規」をクリックします。
- 起動ロールの場合、「タイプ」フィールドでrecordを選択し、「操作」フィールドでreadを選択し、sys_pluginsなどの表名を「名前」フィールドで選択します。
- トリガー・ロールの場合、「タイプ」フィールドでrecordを選択し、「操作」フィールドでcreateを選択し、
sys_soap_messageなどの表名を「名前」フィールドで選択します。 - 「ロールが必要」セクションでカスタム・ロール(たとえば統合固有のロール)を検索し、チェック・マークをクリックします。
- 「送信」をクリックします。
- フィールド・レベルのアクセス制御を提供します:
- 「新規」をクリックします。
- 起動ロールの場合、「タイプ」フィールドでrecordを選択し、「操作」フィールドでreadを選択し、「名前」フィールドで表名(
sys_pluginsなど)を選択し、「名前」フィールドのとなりの* (アスタリスク)を選択します。 - トリガー・ロールの場合、「タイプ」フィールドでrecordを選択し、「操作」フィールドでcreateを選択し、「名前」フィールドで表名(
sys_soap_messageなど)を選択し、「名前」フィールドのとなりのドロップダウン・リストから* (アスタリスク)を選択します。 - 「ロールが必要」セクションでカスタム・ロール(たとえば統合固有のロール)を検索し、チェック・マークをクリックします。
- 「送信」をクリックします。
- security_admin権限が管理ユーザーに割り当てられていない場合は、管理者ユーザーに割り当てます。 管理ユーザーは、アクセス制御リストを変更するためのsecurity_admin権限を持っている必要があります。
- 同様に、読取り、作成、書込みおよび削除権限を提供するには、前述の表に対してアクセス制御リストを作成する必要があります。 表のアクセス制御リストが存在する場合は、「ロールが必要」セクションの下にカスタム・ロールを追加できます。
- ホーム・ページの左側のペインで検索ボックス内のユーザーを検索し、検索結果で「ユーザー管理」の下の「ユーザー」をクリックします。
- 新しいユーザーを作成するには、「新規」をクリックします。
- 必要な値を入力し、「送信」をクリックします。
- ロールを割り当てるユーザーIDを持つユーザーを検索します。
- 「ロール」セクションの「編集」をクリックします。
- カスタム・ロール(統合固有ロールなど)、SOAPおよびITILロールを検索し、それらのロールをユーザーに割り当てます。
- 「保存」をクリックします。