API アクセスポリシーの優先順位付け

  • リリースバージョン: Zurich
  • 更新日 2025年07月31日
  • 所要時間:1分
  • ServiceNow® インスタンスに複数の API アクセスポリシーが設定されている場合のポリシーの優先順位付けのロジックについて説明します。

    API アクセスポリシーは、ServiceNow® インスタンスに設定された REST API ポリシーのタイプに基づいて優先順位が付けられます。

    このアプローチでは、メソッド、リソース、バージョンなどの API の各部分に異なる重み付けを定義します。

    API ポリシーでは、最初に非グローバル、次にグローバルが優先されます。つまり、非グローバルアクセスポリシーは常にグローバル API アクセスポリシーを上書きします。

    優先順位付けのロジックは次のとおりです。

    表 : 1. 優先順位付け
    フィールド 優先度 優先順位付けのロジック
    メソッド、リソース、およびバージョン 1 3 つのフィールドがポリシーと一致する場合、そのポリシーが 1 番目の優先順位になります。
    メソッド + リソース 2 2 つのフィールドがポリシーと一致する場合、そのポリシーが 1 番目の優先順位になります。
    リソース + バージョン 3 2 つのフィールドおよび [すべてのメソッドに適用] フィールドがポリシーと一致する場合、そのポリシーが 3 番目の優先順位になります。
    リソース 4 フィールドおよび [すべてのメソッドに適用] フィールドがポリシーと一致する場合、そのポリシーが 4 番目の優先順位になります。
    メソッド + バージョン 5 2 つのフィールドおよび [すべてのリソースに適用] フィールドがポリシーと一致する場合、そのポリシーが 5 番目の優先順位になります。
    メソッド 6 フィールドおよび [すべてのリソースに適用] フィールドがポリシーと一致する場合、そのポリシーが 5 番目の優先順位になります。
    バージョン 7 フィールドおよび [すべてのメソッドに適用] フィールドおよび [すべてのバージョンに適用] フィールドがポリシーと一致する場合、そのポリシーが 7 番目の優先順位になります。
    グローバルおよびすべてのメソッドに適用 8 [グローバル] フィールドが [true] で、[すべてのメソッドに適用][false] の場合、そのポリシーは 8 番目の優先順位になります。
    グローバルおよびすべてのメソッドに適用 9 [グローバル] フィールドが [true] で、[すべてのメソッドに適用][true] の場合、そのポリシーは 9 番目の優先順位になります。