OAuth 2.0とOIDC

CoupaはOAuth 2.0とOIDCを使用してAPIリクエストを認証します。クライアントの目的、IPホワイトリスト登録、データアクセス制限を設定して、統合のセキュリティを強化します。

OIDC/OAuth 2.0を使用したAPIセキュリティ

Coupaは、CoupaとのAPI連携のセキュリティレベルを向上させるために、OAuth 2.0を拡張するオープン認証プロトコルであるOpenID Connect (OIDC)を使用しています。

注:

APIキーは廃止されました。既存のキーをOAuthクライアントに移行し、 [設定] > [APIキー] からキーを取り消す必要があります。この移行は顧客作成によるCoupa CoreプラットフォームへのAPI統合にのみ影響し、Treasury、CSO、サプライチェーン最適化などのアプリケーションには影響しません。

クライアントの目的

[OAuth/OIDCクライアント設定]ページには、必須の クライアント目的 ドロップダウンフィールドが含まれています。このフィールドは、統合においてクライアントがどのように使用されるかを特定します。たとえば、顧客/内部管理ツール、サードパーティソフトウェアプロバイダー、マーケットプレイスアプリケーションパートナーなどです。

  • [OAuth/OIDCクライアント設定]ページに、 クライアントの目的 ドロップダウンが表示されます。オプションは次のとおりです。
    • 顧客/内部管理者
    • サードパーティソフトウェアプロバイダー
    • アプリのマーケットプレイスのアプリケーションパートナー
  • サードパーティソフトウェアプロバイダーを選択した場合は、プロバイダー名も入力する必要があります。
  • 確認チェックボックスでは、保存する前に、入力した情報が正確かつ完全であることを確認する必要があります。
  • すべてのフィールドは必須です。それらを完了することなくクライアント構成を保存することはできません。
図 1. クライアント目的フィールド
クライアント目的フィールド

新規クライアントのクライアント目的の設定

新しいOAuth/OIDCクライアントを作成すると、システムは次のことを促します。

  1. ドロップダウンから クライアントの目的 を選択します。
  2. サードパーティプロバイダー名を入力します(該当する場合)。
  3. ページの下部にある確認ボックスにチェックを入れます。
  4. [保存]を選択します。

既存クライアントのクライアント目的を更新する

クライアントの目的が指定されていない既存のOAuth/OIDCクライアントがある場合:

  1. [OAuth/OIDCクライアント設定]ページに移動します。
  2. 更新するクライアントで 編集 (鉛筆アイコン)を選択します。
  3. クライアントの目的 フィールドと確認チェックボックスを完了してください。
  4. [保存]を選択します。

既存のクライアントを すべて 更新する必要があります。設定ページのバナーは次のようにお知らせします: 「新しく必要となったOAuth/OIDC設定を更新してください。」

IPホワイトリスト

OAuth/OIDCクライアントでIP許可リストを設定することで、特定のIPアドレスへのAPIアクセスを制限できます。 IPホワイトリストが有効になっている場合、Coupaは許可リストに含まれていないIPアドレスからのAPI申請を却下します。

IPホワイトリスト登録を設定するには:

  1. [OAuth/OIDCクライアント設定]ページに移動します。
  2. 制限するクライアントで 編集 を選択します。
  3. [ IPホワイトリスト登録 ]フィールドに、許可するIPアドレスまたはCIDR範囲を入力します。
  4. [保存]を選択します。

許可リストに含まれていないIPアドレスからのリクエストには、 403 Forbidden という応答が返されます。

データアクセスの制限

クライアント認証情報 の付与タイプを使用して、OAuth/OIDCクライアントが特定のデータサブセットのみにアクセスするように制限できます。これにより、単一のクライアントがインスタンス全体のすべての取引データとマスターデータにアクセスすることを防ぐことができます。

  • アカウントグループ (取引データ): 1つ以上のアカウントグループをクライアントに割り当てます。クライアントは、それらの口座グループに属するトランザクションデータ(請求書、発注書、申請書、経費レポートなど)にのみアクセスできます。
  • ビジネスグループ (マスターデータ): 1つ以上のビジネスグループをクライアントに割り当てます。クライアントは、これらのビジネスグループでタグ付けされたマスターデータ(サプライヤー、契約、住所、支払条件など)にのみアクセスできます。

データアクセス制限を設定するには、次の手順に従ってください。

  1. [OAuth/OIDCクライアント設定]ページに移動します。
  2. 制限するクライアント資格情報クライアントで 編集 を選択します。
  3. Account Groups フィールドで、取引データにアクセスするアカウントグループを選択します。
  4. Business Groups フィールドで、マスターデータにアクセスするビジネスグループを選択します。
  5. [保存]を選択します。
注:

グループ制限のないクライアントは、引き続き無制限アクセスが可能です。制限は、グループを明示的に割り当てた場合にのみ適用されます。

APIテレメトリと使用状況の追跡

Coupaは、API申請を個々の顧客、パートナーアプリ、AIエージェントにリンクする包括的なAPIテレメトリデータを取得します。このデータにより、インスタンス全体のAPI使用パターン、申請数、統合アクティビティに関する内部レポートを作成することが可能になります。

テレメトリデータは、OAuth/OIDCクライアントを介して行われたすべてのAPI申請について自動的に収集されます。追加の設定は必要ありません。

注:

APIテレメトリレポートは、GovCloud、FedRAMP、HIPAA以外のAWSのお客様が利用できます。 AzureおよびGCP環境は現在サポートされていません。