共用方式為


X509SecurityTokenAuthenticator 建構函式

定義

初始化 X509SecurityTokenAuthenticator 類別的新執行個體。

多載

X509SecurityTokenAuthenticator()

初始化 X509SecurityTokenAuthenticator 類別的新執行個體。

X509SecurityTokenAuthenticator(X509CertificateValidator)

使用指定的憑證驗證器,初始化 X509SecurityTokenAuthenticator 類別的新執行個體。

X509SecurityTokenAuthenticator(X509CertificateValidator, Boolean)

使用指定的憑證驗證方法,初始化 X509SecurityTokenAuthenticator 類別的新執行個體,並且指出憑證的身分識別是否對應至 Windows 身分識別。

X509SecurityTokenAuthenticator(X509CertificateValidator, Boolean, Boolean)

使用指定的憑證驗證方法,初始化 X509SecurityTokenAuthenticator 類別的新執行個體,並且指出憑證的身分識別是否對應至 Windows 身分識別以及使用者所屬的 Windows 群組。

X509SecurityTokenAuthenticator()

來源:
X509SecurityTokenAuthenticator.cs
來源:
X509SecurityTokenAuthenticator.cs
來源:
X509SecurityTokenAuthenticator.cs

初始化 X509SecurityTokenAuthenticator 類別的新執行個體。

public:
 X509SecurityTokenAuthenticator();
public X509SecurityTokenAuthenticator ();
Public Sub New ()

備註

當呼叫 ValidateTokenCore 方法來驗證權杖時,X.509 憑證無法對應 Windows 身分識別,且憑証會使用憑證鏈結進行驗證。

適用於

X509SecurityTokenAuthenticator(X509CertificateValidator)

來源:
X509SecurityTokenAuthenticator.cs
來源:
X509SecurityTokenAuthenticator.cs
來源:
X509SecurityTokenAuthenticator.cs

使用指定的憑證驗證器,初始化 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.X509SecurityTokenAuthenticator
Public Sub New (validator As X509CertificateValidator)

參數

validator
X509CertificateValidator

用來檢查憑證是否有效的 X509CertificateValidator

備註

X509CertificateValidator 類別提供了一組預先定義的憑證驗證模式,例如 ChainTrust 屬性。 這些驗證模式可以傳遞至 validator 參數。 當應用程式需要自訂的驗證方法時,請從 X509CertificateValidator 衍生類別並覆寫 Validate(X509Certificate2) 方法。 Validate(X509Certificate2) 方法會呼叫 ValidateTokenCore 方法。

根據預設,X509SecurityTokenAuthenticator 不會將 X.509 憑證對應至 Windows 身分識別。

適用於

X509SecurityTokenAuthenticator(X509CertificateValidator, Boolean)

使用指定的憑證驗證方法,初始化 X509SecurityTokenAuthenticator 類別的新執行個體,並且指出憑證的身分識別是否對應至 Windows 身分識別。

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.X509SecurityTokenAuthenticator
Public Sub New (validator As X509CertificateValidator, mapToWindows As Boolean)

參數

validator
X509CertificateValidator

用來檢查憑證是否有效的 X509CertificateValidator

mapToWindows
Boolean

如果要將憑證的身分識別對應至 Windows 身分識別,則為 true,否則為 false

備註

X509CertificateValidator 類別提供了一組預先定義的憑證驗證模式,例如 ChainTrust 屬性。 這些驗證模式可以傳遞至 validator 參數。 當應用程式需要自訂的驗證方法時,請從 X509CertificateValidator 衍生類別並覆寫 Validate(X509Certificate2) 方法。 Validate(X509Certificate2) 方法會呼叫 ValidateTokenCore 方法。

當呼叫 ValidateTokenCore 方法來驗證權杖且 mapToWindowstrue 時,X.509 憑證會對應至 Windows 帳戶,並且會新增宣告至使用者所屬之 Windows 群組的 EvaluationContext。 X.509 憑證對應至 Windows 帳戶的方式需視安全性權杖型別而定:

  • 當安全性權杖的類型是 X509WindowsSecurityToken 時,會使用 WindowsIdentity 屬性來對應 X.509 憑證。

  • 當安全性權杖的類型是 X509SecurityToken 時,會使用其使用者主要名稱 (UPN) 將 X.509 憑證對應至 Windows 帳戶。

適用於

X509SecurityTokenAuthenticator(X509CertificateValidator, Boolean, Boolean)

使用指定的憑證驗證方法,初始化 X509SecurityTokenAuthenticator 類別的新執行個體,並且指出憑證的身分識別是否對應至 Windows 身分識別以及使用者所屬的 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.X509SecurityTokenAuthenticator
Public Sub New (validator As X509CertificateValidator, mapToWindows As Boolean, includeWindowsGroups As Boolean)

參數

validator
X509CertificateValidator

用來檢查憑證是否有效的 X509CertificateValidator

mapToWindows
Boolean

如果要將憑證的身分識別對應至 Windows 身分識別,則為 true,否則為 false

includeWindowsGroups
Boolean

如果要將 Windows 使用者所屬的群組包含在透過驗證程序建構的 true 屬性內,則為 ClaimSets,否則為 false

備註

當不需要 Windows 群組資訊來改善效能時,傳遞 falseincludeWindowsGroups 參數。

X509CertificateValidator 類別有多個靜態屬性,例如可以傳遞至 ChainTrust 參數的 validator 屬性。 這些屬性提供了常用的 X.509 憑證驗證方法。 當需要自訂的驗證方法時,請從 X509CertificateValidator 衍生類別並覆寫 Validate(X509Certificate2) 方法。 Validate(X509Certificate2) 方法會呼叫 ValidateTokenCore 方法。

當傳遞 truemapToWindows 參數時,X.509 憑證會對應至 Windows 帳戶而且相關宣告會新增至 EvaluationContext,例如使用者所屬的 Windows 群組。 當安全性權杖的型別是 X509WindowsSecurityToken 時,WindowsIdentity 屬性會使用權杖所指定的身分識別;否則,會使用以 X.509 憑證之使用者主要名稱 SubjectAltNames 延伸為基礎的 Kerberos S4U 登入將 X.509 憑證對應至 Windows 身分識別。

適用於