クライアント・アプリケーション用 OAuth 2.0 ベース認証の使用

OAuth 2.0 /token エンドポイントを使用してクライアント資格情報 (クライアント ID およびクライアント秘密鍵) やサービス資格情報 (ユーザー名およびパスワード) などのアクセス・トークンを取得します。例:

curl -k -v -X POST -H 'content-type: application/x-www-form-urlencoded' 
-d grant_type=password -d client_id=<clientId> -d client_secret=<clientSecret>
-d username=<serviceCredId> -d password=<svcCredSecret>
https://www.bpm.ibmcloud.com/mga/sps/oauth/oauth20/token

この呼び出しにより、後続のクラウド操作 API 呼び出しで使用されるアクセス・トークン、アクセス・トークンをリフレッシュするためのリフレッシュ・トークン、およびアクセス・トークンの有効期間が返されます。アクセス・トークンの有効期間は通常、数分ないし数時間ですが、リフレッシュ・トークンは数日間にわたって有効な可能性があります。スコーピングはサポートされていません。

{"access_token":"CJ7yDymDAfSRz03W7zdX","refresh_token":"fGAv2qzuLnM030Brs8KFaIuY1Kd2P87sLFXI85lH","scope":"","token_type":"bearer","expires_in":1799}*

呼び出しが成功した場合、HTTP 応答コード 201 が返されます。クライアント資格情報またはサービス資格情報が無効である場合、HTTP 応答コード BAD_REQUEST (400) が返されます。

前のステップで返されたアクセス・トークンをクラウド操作 API 呼び出しの許可ヘッダーに含めます。例:

curl -k -v -H "Authorization: Bearer CJ7yDymDAfSRz03W7zdX" https://<tenantHost>/baw/dev/rest/bpm/wle/v1/user/current

アクセス・トークンが無効であるか期限切れである場合、HTTP 応答コード 302 が返されます。

OAuth 2.0 /token エンドポイントを使用します。

curl -k -v -X POST -H 'content-type: application/x-www-form-urlencoded' 
-d grant_type=refresh_token -d refresh_token=fGU3UjAHG0XKTdnInU8ihqTLf48XJIzQtRUjNFVo
-d client_id=<clientId> -d client_secret=<clientSecret>
https://www.bpm.ibmcloud.com/mga/sps/oauth/oauth20/token

この呼び出しによって、新しい一連のトークンが返されます。

{"access_token":"DkhN7gg7mk2gsBjGi8ay","refresh_token":"ToY13V2yfoYaeVbBjTwFLhzwX7GiKd7Y801VfjGC","scope":"","token_type":"bearer","expires_in":1799}

リフレッシュ・トークンが無効であるか既に使用されていた場合、もしくはクライアント資格情報が (削除されたなどの理由で) 無効である場合、 この呼び出しによって HTTP BAD_REQUEST (400) 応答コードが返されます。

例えば、リフレッシュ・トークンを取り消すには次の呼び出しを使用します。

curl -k -v -X POST -H 'content-type: application/x-www-form-urlencoded' 
-d client_id=<clientId> -d client_secret=<clientSecret>
-d token=ToY13V2yfoYaeVbBjTwFLhzwX7GiKd7Y801VfjGC
https://www.bpm.ibmcloud.com/mga/sps/oauth/oauth20/revoke

この呼び出しでは常に成功の HTTP 応答コード (例: 200) が返されます。