OAuth 2.0移行ガイド

ワクチンの仕組み

1.CoupaでのAPIキーの確認

1. 自分のCoupaインスタンスにログインします。
2. [設定] > [APIキー]に移動します。
3. すべてのキーを確認します。

2.OAuthクライアントの作成とスコープの割り当て

1. [設定] > [Oauth 2/OpenID接続クライアント(/ oauth 2/clients)]に移動します。
2. [作成]をクリックし、[グラントタイプ]ドロップダウンで[クライアント資格情報]を選択します。
3. フィールドに記入し、クライアントが必要とするスコープ（アクセス許可）を選択します。クライアントにすべてのAPIエンドポイントと操作へのアクセスを許可する場合は、すべてのスコープをそのクライアントに追加する必要があることに注意してください。 
   
4. クライアントを保存すると、クライアントの資格情報が取得されます。識別子、シークレット、Oidcスコープ。
   

1. ターミナル（リンク）を使用して、コマンドラインを使用してCurl POST:
   curl - X POST - H "Content - Type: application/x - www - form - urlencoded" - d "client_id<CLIENT_ID> =& grant_type = client_credentials&scope<SPACE_SEPARATED_LIST_OF_SCOPES> =& client_secret<CLIENT_SECRET> =" https :///oauth 2<INSTANCE_DOMAIN>/tokenを実行します
   
2. Postmanや他のRESTクライアントのようなHTTPクライアントを使用して、Coupa APIを使用するようにOAuth 2/OIDCクライアント接続を構成します。
3. 投稿を選択します。
4. 上記でクライアントを定義したインスタンス名にURLを設定します。例: https :// {your_instance_address}/oauth 2/token
5. Content - Type = application/x - www - form - urlencodedのヘッダーキー値を設定します
   
6. 投稿本文では、次の値を設定します。
   1. クライアントID = <Your Client Identifier value>
   2. grant_type = client_credentials
   3. 範囲 ＝ <Copy/paste all the scopes that you selected in Client credentials setup without the comma.>
   4. client_secret = < Coupaクライアントシークレットの値をコピー/貼り付け>
      

7. 送信をクリックします。POST応答には、定義されたスコープ内のAPI呼び出しを次の24時間（ 86,399秒でexpires_）で認証するために生成されたaccess_tokenがあります。 


8. 応答本文からaccess_token値をコピーし、このクライアント接続に定義したスコープ内でCoupa API呼び出しの承認ヘッダーのトークン値として使用します。 

9. GET、POST、またはPUTなどのAPI呼び出しを行うための新しいタブを作成し、リクエストビルダーのAuthorization部分で‘TYPE‘ = OAuth 2.0を定義します。

10. [トークン]フィールド値としてaccess_tokenを貼り付けます。


11. ヘッダーに移動し、[Accept]キーフィールドにapplication/xmlまたはapplication/jsonの値を入力します。呼び出しと使用しようとしているインターフェースに応じて、他の要求パラメータを設定および定義する必要があります。この例では、請求書APIへのGET API呼び出しを見ることができます。
    

12. 送信をクリックします。Authorizationヘッダーでそのaccess_tokenを設定すると、その接続に対して定義したクライアントスコープへのGET、PUT、またはPOST呼び出しを行うことができます。