この文章は Salesforce 機械翻訳システムを使用して翻訳されました。詳細はこちらをご参照ください。

Web サーバ OAuth 認証フローについて

安全なサーバでホストされているアプリケーションでは、Web サーバ認証フローを使用します。Web サーバフローにおける重要な点は、サーバがコンシューマの秘密を保護できる必要があります。

このフローでは、クライア��トアプリケーションは、ユーザを認証してアプリケーションに認証コードを送信する他の Web サーバまたはリソースにユーザをリダイレクトするように認証サーバに要求します。アプリケーションは認証コードを使用してアクセストークンを要求します。このフローの手順は、次のとおりです。

アプリケーションはユーザを適切な Salesforce 認証エンドポイント (https://login.salesforce.com/services/oauth2/authorize など) にリダイレクトします。次のパラメータは必須です。

パラメータ	説明
`response_type`	この認証フローの場合、`code` にする必要があります。
`client_id`	接続アプリケーション定義の [コンシューマ鍵]。
`redirect_uri`	接続アプリケーション定義の [コールバック URL]。

次のパラメータは省略可能です。

パラメータ	説明
`display`	ログインページの表示の種類を変更します。有効な値は、次のとおりです。 `page` — 全画面のページ認証。これは、値が指定されていない場合のデフォルト値です。 `popup` — 最新の Web ブラウザのポップアップウィンドウ用に最適化されたコンパクトなダイアログ。 `touch` — Android や iPhone など、最新のスマートフォン用に設計されたモバイル用に最適化されたダイアログ。 `mobile` — BlackBerry OS 5 など、タッチスクリーンをサポートしていないスマートフォン用に設計された、モバイル用に最適化されたダイアログ。
`immediate`	ログインと承認についてユーザにプロンプトメッセージを表示するかどうかを決定します。値は、`true` か `false` のいずれかです。デフォルトは `false` です。 `true` に設定され、ユーザが現在ログインしており、以前にこのアプリケーションを承認している場合、承認ステップはスキップされます。 `true` に設定され、ユーザがログインしていないか、これまでこのアプリケーションを承認したことがない場合、セッションはただちにエラーコード `immediate_unsuccessful` で終了します。
`state`	承認後にコールバック URL で返される、追加の URL 符号化された状態データを指定します。
`scope`	アプリケーションがアクセスできるデータを指定します。詳細は、オンラインヘルプの「範囲パラメータの値」を参照してください。
`prompt`	認証サーバがユーザに再認証および再承認を求める方法を指定します。このパラメータは省略可能です。Salesforce でサポートされる値は、次のとおりです。 `login` — 認証サーバがユーザに再認証を求める必要があり、ユーザに強制的に再ログインさせます。 `consent` — クライアントに情報を戻す前に、認証サーバがユーザに再認証を求める必要があります。ユーザにログインおよび再認証の両方を求めるには、スペースで区切られた両方の値を渡すことが有効��す。以下に例を示します。 `1?prompt=login%20consent`

認証 URL の例は、次のようになります。

1https://login.salesforce.com/services/oauth2/authorize?response_type=code
2&client_id=3MVG9lKcPoNINVBIPJjdw1J9LLM82HnFVVX19KY1uA5mu0QqEWhqKpoW3svG3X
3HrXDiCQjK1mdgAvhCscA9GE&redirect_uri=https%3A%2F%2Fwww.mysite.com%2F
4code_callback.jsp&state=mystate

ユーザが自分のログイン情報で Salesforce にログインします。ユーザは認証エンドポイントを直接操作するため、アプリケーションがユーザのログイン情報を認識することはありません。ログインに成功したら、ユーザはアプリケーションを認証するように要求されます。ユーザがすでにアプリケーションを認証している場合、このステップはスキップされます。

クライアントアプリケーションが認証されたことが Salesforce で確認されると、エンドユーザの Web ブラウザは、redirect_uri パラメータで指定されたコールバック URL にリダイレクトされます。Salesforce は、認証情報を次の値でリダイレクト URL に付加します。

パラメータ	説明
`code`	コンシューマがアクセストークンと更新トークンを取得するために使用する必要がある認証コード。
`state`	最初の要求の一部として渡される状態値 (該当する場合のみ)。

認証情報が付属するコールバック URL の例は、次のようになります。

1https://www.mysite.com/authcode_callback?code=aWekysIEeqM9PiT
2hEfm0Cnr6MoLIfwWyRJcqOqHdF8f9INokharAS09ia7UNP6RiVScerfhc4w%3D%3D

アプリケーションは認証コードを抽出して、これをアクセストークン要求に含めて Salesforce に渡す必要があります。この要求は、適切な Salesforce トークン要求エンドポイント (https://login.salesforce.com/services/oauth2/token など) に対して送信される POST 要求です。次のパラメータは必須です。

パラメータ	説明
`grant_type`	このフローの値は `authorization_code` である必要があります。
`client_id`	接続アプリケーション定義の [コンシューマ鍵]。
`client_secret`	接続アプリケーション定義の [コンシューマの秘密]。
`redirect_uri`	接続アプリケーション定義の [コールバック URL]。
`code`	コンシューマがアクセストークンと更新トークンを取得するために使用する必要がある認証コード。

次のパラメータは省略可能です。

パラメータ	説明
`format`	期待される戻り形式。デフォルトは `json` です。値は次のとおりです。 `urlencoded` `json` `xml` 返される形式は、要求のヘッダーに次のいずれかを使用して指定することもできます。 `Accept: application/x-www-form-urlencoded` `Accept: application/json` `Accept: application/xml`

パラメータ

説明

format

期待される戻り形式。デフォルトは json です。値は次のとおりです。

urlencoded
json
xml

返される形式は、要求のヘッダーに次のいずれかを使用して指定することもできます。

Accept: application/x-www-form-urlencoded
Accept: application/json
Accept: application/xml

アクセストークン POST 要求の例は、次のようになります。

1POST /services/oauth2/token HTTP/1.1
2Host: login.salesforce.com 
3grant_type=authorization_code&code=aPrxsmIEeqM9PiQroGEWx1UiMQd95_5JUZ
4VEhsOFhS8EVvbfYBBJli2W5fn3zbo.8hojaNW_1g%3D%3D&client_id=3MVG9lKcPoNI
5NVBIPJjdw1J9LLM82HnFVVX19KY1uA5mu0QqEWhqKpoW3svG3XHrXDiCQjK1mdgAvhCs
6cA9GE&client_secret=1955279925675241571&
7redirect_uri=https%3A%2F%2Fwww.mysite.com%2Fcode_callback.jsp

この要求が成功した場合、サーバは次の内容を持つレスポンスボディを返します。

パラメータ	説明
`access_token`	アプリケーションが要求を行うために使用するセッション ID として機能するアクセストークン。このトークンは、ユーザログイン情報と同様に保護する必要があります。
`refresh_token`	新しいアクセストークンを取得するために将来使用できるトークン。この値は秘密です。ユーザのパスワードなどと同様に処理し、適切な手段で保護する必要があります。警告
`instance_url`	API コールの送信先となる Salesforce インスタンスを示します。
`id`	ユーザ、およびユーザの詳細に関するクエリの両方を識別するために使用できる ID URL。エンドユーザに関する詳細な情報を取得するための HTTP 要求で使用できます。
`issued_at`	署名が作成された日時。UNIX エポック (1970 年 1 月 1 日 00:00:00 UTC) からの秒数として表されます。
`signature`	連結 ID と `issued_at` 値を含むコンシューマの非公開鍵で署名されている Base64 符号化された HMAC-SHA256 署名。この `signature` は、ID URL がサーバから送信された後に変更されていないことを確認するために使用できます。

JSON レスポンスボディの例は、次のようになります。

1{"id":"https://login.salesforce.com/id/00Dx0000000BV7z/005x00000012Q9P",
2"issued_at":"1278448101416",
3"refresh_token":"5Aep8614iLM.Dq661ePDmPEgaAW9Oh_L3JKkDpB4xReb54_
4pZebnUG0h6Sb4KUVDpNtWEofWM39yg==",
5"instance_url":"https://na1.salesforce.com",
6"signature":"CMJ4l+CCaPQiKjoOEwEig9H4wqhpuLSk4J2urAe+fVg=",
7"access_token":"00Dx0000000BV7z!AR8AQP0jITN80ESEsj5EbaZTFG0R
8NBaT1cyWk7TrqoDjoNIWQ2ME_sTZzBjfmOE6zMHq6y8PIW4eWze9JksNEkWUl.Cju7m4"}

アプリケーションは、提供されたアクセストークンと更新トークンを使用して保護されたユーザデータにアクセスします。

Force.com REST API 開発者ガイド

No Results

Web サーバ OAuth 認証フローについて