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

AuthProviderPlugin インターフェース

Salesforce へのシングルサインオン用に OAuth ベースのカスタム認証プロバイダプラグインを作成するには、このインターフェースを使用します。

名前空間

Auth

使用方法

シングルサインオンのカスタム認証プロバイダを作成するには、Auth.AuthProviderPlugin を実装するクラスを作成します。このクラスにより、認証プロバイダのカスタム設定を保存し、ユーザが外部サービスプロバイダのログイン情報を使用して Salesforce にログインしたときに認証プロトコルを処理できます。Salesforce で、このインターフェースを実装するクラスは、[設定] の [認証プロバイダ] にある [プロバイダタイプ] ドロップダウンリストに表示されます。クラスを実行するよう指定するユーザに「アプリケーションのカスタマイズ」権限と「認証プロバイダの管理」権限があることを確認します。

AuthProviderPlugin メソッド

AuthProviderPlugin のメソッドは次のとおりです。

getCustomMetadataType()

Salesforce へのシングルサインオン用に OAuth ベースのカスタム認証プロバイダのカスタムメタデータ型 API 名を返します。

署名

public String getCustomMetadataType()

戻り値

型: String

認証プロバイダのカスタムメタデータ型 API 名。

getUserInfo(authProviderConfiguration, response)

カスタム認証プロバイダから現在のユーザに関する情報を返します。この情報は、登録ハンドラによって、他の認証プロバイダフローで使用されます。

署名

public Auth.UserData getUserInfo(Map<String,String> authProviderConfiguration, Auth.AuthProviderTokenResponse response)

パラメータ

authProviderConfiguration
型: Map<String, String>
カスタム認証プロバイダの設定。Salesforce にカスタムメタデータ型を作成すると、設定にカスタムメタデータ型のデフォルト値が入力されます。または、[設定] の [承認プロバイダ] でカスタムプロバイダを作成したときに入力した値を設定で指定することもできます。
response
型: Auth.AuthProviderTokenResponse

OAuth アクセストークン、OAuth の秘密または更新トークン、および現在のユーザを認証するために認証プロバイダによって指定された状態。

戻り値

型: Auth.UserData

Auth.UserData クラスの新しいインスタンスを作成します。

handleCallback(authProviderConfiguration, callbackState)

認証プロバイダのサポート対象認証プロトコルを使用して、OAuth アクセストークン、OAuth の秘密または更新トークン、現在のユーザへの要求が開始されたときに渡された状態を返します。

署名

public Auth.AuthProviderTokenResponse handleCallback(Map<String,String> authProviderConfiguration, Auth.AuthProviderCallbackState callbackState)

パラメータ

authProviderConfiguration
型: Map<StringString>
カスタム認証プロバイダの設定。Salesforce にカスタムメタデータ型を作成すると、設定にカスタムメタデータ型のデフォルト値が入力されます。または、[設定] の [承認プロバイダ] でカスタムプロバイダを作成したときに入力した値を設定で指定することもできます。
callbackState
型: Auth.AuthProviderCallbackState
認証要求の HTTP ヘッダー、本文、および queryParams が含まれるクラス。

戻り値

型: Auth.AuthProviderTokenResponse

AuthProviderTokenResponse クラスのインスタンスを作成します。

initiate(authProviderConfiguration, stateToPropagate)

ユーザが認証のためにリダイレクトされる URL を返します。

署名

public System.PageReference initiate(Map<String,String> authProviderConfiguration, String stateToPropagate)

パラメータ

authProviderConfiguration
型: Map<StringString>
カスタム認証プロバイダの設定。Salesforce にカスタムメタデータ型を作成すると、設定にカスタムメタデータ型のデフォルト値が入力されます。または、[設定] の [承認プロバイダ] でカスタムプロバイダを作成したときに入力した値を設定で指定することもできます。
stateToPropagate
型: String
ユーザに対する認証要求を開始するために渡される状態。

戻り値

型: System.PageReference

ユーザが認証のためにリダイレクトされるページの URL。