X509SecurityTokenAuthenticator コンストラクター
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
X509SecurityTokenAuthenticator クラスの新しいインスタンスを初期化します。
オーバーロード
| 名前 | 説明 |
|---|---|
| X509SecurityTokenAuthenticator() |
X509SecurityTokenAuthenticator クラスの新しいインスタンスを初期化します。 |
| X509SecurityTokenAuthenticator(X509CertificateValidator) |
指定した証明書検証コントロールを使用して、 X509SecurityTokenAuthenticator クラスの新しいインスタンスを初期化します。 |
| X509SecurityTokenAuthenticator(X509CertificateValidator, Boolean) |
指定した証明書検証メソッドを使用して、 X509SecurityTokenAuthenticator クラスの新しいインスタンスを初期化し、証明書の ID が Windows ID にマップされているかどうかを示します。 |
| X509SecurityTokenAuthenticator(X509CertificateValidator, Boolean, Boolean) |
指定した証明書検証メソッドを使用して、 X509SecurityTokenAuthenticator クラスの新しいインスタンスを初期化し、証明書の ID が Windows ID にマップされ、ユーザーが属する Windows グループかどうかを示します。 |
X509SecurityTokenAuthenticator()
X509SecurityTokenAuthenticator クラスの新しいインスタンスを初期化します。
public:
X509SecurityTokenAuthenticator();public X509SecurityTokenAuthenticator();Public Sub New ()注釈
トークンを認証するために ValidateTokenCore メソッドが呼び出されると、X.509 証明書は Windows ID にマップされず、証明書チェーンを使用して証明書が検証されます。
適用対象
X509SecurityTokenAuthenticator(X509CertificateValidator)
指定した証明書検証コントロールを使用して、 X509SecurityTokenAuthenticator クラスの新しいインスタンスを初期化します。
public:
X509SecurityTokenAuthenticator(System::IdentityModel::Selectors::X509CertificateValidator ^ validator);public X509SecurityTokenAuthenticator(System.IdentityModel.Selectors.X509CertificateValidator validator);new System.IdentityModel.Selectors.X509SecurityTokenAuthenticator : System.IdentityModel.Selectors.X509CertificateValidator -> System.IdentityModel.Selectors.X509SecurityTokenAuthenticatorPublic Sub New (validator As X509CertificateValidator)パラメーター
- validator
- X509CertificateValidator
証明書が有効であることを確認する X509CertificateValidator 。
注釈
X509CertificateValidator クラスは、ChainTrust プロパティなどの定義済みの証明書検証モデルのセットを提供します。 これらの検証モデルは、 validator パラメーターに渡すことができます。 アプリケーションでカスタム検証メソッドが必要な場合は、 X509CertificateValidator からクラスを派生させ、 Validate(X509Certificate2) メソッドをオーバーライドします。
Validate(X509Certificate2) メソッドは、ValidateTokenCore メソッドによって呼び出されます。
既定では、 X509SecurityTokenAuthenticator は X.509 証明書を Windows ID にマップしません。
適用対象
X509SecurityTokenAuthenticator(X509CertificateValidator, Boolean)
指定した証明書検証メソッドを使用して、 X509SecurityTokenAuthenticator クラスの新しいインスタンスを初期化し、証明書の ID が Windows ID にマップされているかどうかを示します。
public:
X509SecurityTokenAuthenticator(System::IdentityModel::Selectors::X509CertificateValidator ^ validator, bool mapToWindows);public X509SecurityTokenAuthenticator(System.IdentityModel.Selectors.X509CertificateValidator validator, bool mapToWindows);new System.IdentityModel.Selectors.X509SecurityTokenAuthenticator : System.IdentityModel.Selectors.X509CertificateValidator * bool -> System.IdentityModel.Selectors.X509SecurityTokenAuthenticatorPublic Sub New (validator As X509CertificateValidator, mapToWindows As Boolean)パラメーター
- validator
- X509CertificateValidator
証明書が有効であることを確認する X509CertificateValidator 。
- mapToWindows
- Boolean
true 証明書の ID を Windows ID にマップする場合。それ以外の場合は false。
注釈
X509CertificateValidator クラスは、ChainTrust プロパティなどの定義済みの証明書検証モデルのセットを提供します。 これらの検証モデルは、 validator パラメーターに渡すことができます。 アプリケーションでカスタム検証メソッドが必要な場合は、 X509CertificateValidator からクラスを派生させ、 Validate(X509Certificate2) メソッドをオーバーライドします。
Validate(X509Certificate2) メソッドは、ValidateTokenCore メソッドによって呼び出されます。
トークンを認証するために ValidateTokenCore メソッドが呼び出され、 mapToWindows が trueされると、X.509 証明書が Windows アカウントにマップされ、ユーザーが属する Windows グループを使用して EvaluationContext に要求が追加されます。 X.509 証明書を Windows アカウントにマップする方法は、セキュリティ トークンの種類によって異なります。
セキュリティ トークンの種類が X509WindowsSecurityToken の場合、X.509 証明書は WindowsIdentity プロパティを使用してマップされます。
セキュリティ トークンの種類が
X509SecurityTokenの場合、X.509 証明書はユーザー プリンシパル名 (UPN) を使用して Windows アカウントにマップされます。
適用対象
X509SecurityTokenAuthenticator(X509CertificateValidator, Boolean, Boolean)
指定した証明書検証メソッドを使用して、 X509SecurityTokenAuthenticator クラスの新しいインスタンスを初期化し、証明書の ID が Windows ID にマップされ、ユーザーが属する Windows グループかどうかを示します。
public:
X509SecurityTokenAuthenticator(System::IdentityModel::Selectors::X509CertificateValidator ^ validator, bool mapToWindows, bool includeWindowsGroups);public X509SecurityTokenAuthenticator(System.IdentityModel.Selectors.X509CertificateValidator validator, bool mapToWindows, bool includeWindowsGroups);new System.IdentityModel.Selectors.X509SecurityTokenAuthenticator : System.IdentityModel.Selectors.X509CertificateValidator * bool * bool -> System.IdentityModel.Selectors.X509SecurityTokenAuthenticatorPublic Sub New (validator As X509CertificateValidator, mapToWindows As Boolean, includeWindowsGroups As Boolean)パラメーター
- validator
- X509CertificateValidator
証明書が有効であることを確認する X509CertificateValidator 。
- mapToWindows
- Boolean
true 証明書の ID を Windows ID にマップする場合。それ以外の場合は false。
- includeWindowsGroups
- Boolean
注釈
パフォーマンスを向上させるために Windows グループ情報が必要ない場合は、 false を includeWindowsGroups パラメーターに渡します。
X509CertificateValidator クラスには、validator パラメーターに渡すことができるChainTrust プロパティなど、いくつかの静的プロパティがあります。 これらのプロパティは、X.509 証明書の一般的な検証方法を提供します。 カスタム検証メソッドが必要な場合は、 X509CertificateValidator からクラスを派生させ、 Validate(X509Certificate2) メソッドをオーバーライドします。
Validate(X509Certificate2) メソッドは、ValidateTokenCore メソッドによって呼び出されます。
trueが mapToWindows パラメーターに渡されると、X.509 証明書が Windows アカウントにマップされ、関連する要求がユーザーが属する Windows グループなどのEvaluationContextに追加されます。 セキュリティ トークンの種類が X509WindowsSecurityToken の場合、 WindowsIdentity プロパティはトークンで指定された ID を使用します。それ以外の場合、X.509 証明書のユーザー プリンシパル名 SubjectAltNames 拡張機能に基づいて Kerberos S4U ログオンを使用して、X.509 証明書が Windows ID にマップされます。
