SecurityTokenHandler.CreateSecurityTokenReference Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Saat ditimpa di kelas turunan, membuat referensi token keamanan untuk token yang diproses oleh kelas tersebut. Metode ini biasanya disebut oleh layanan token keamanan (STS).
public:
virtual System::IdentityModel::Tokens::SecurityKeyIdentifierClause ^ CreateSecurityTokenReference(System::IdentityModel::Tokens::SecurityToken ^ token, bool attached);public virtual System.IdentityModel.Tokens.SecurityKeyIdentifierClause CreateSecurityTokenReference (System.IdentityModel.Tokens.SecurityToken token, bool attached);abstract member CreateSecurityTokenReference : System.IdentityModel.Tokens.SecurityToken * bool -> System.IdentityModel.Tokens.SecurityKeyIdentifierClause
override this.CreateSecurityTokenReference : System.IdentityModel.Tokens.SecurityToken * bool -> System.IdentityModel.Tokens.SecurityKeyIdentifierClausePublic Overridable Function CreateSecurityTokenReference (token As SecurityToken, attached As Boolean) As SecurityKeyIdentifierClauseParameter
- token
- SecurityToken
Token yang referensinya akan dibuat.
- attached
- Boolean
true jika referensi terlampir harus dibuat; false jika referensi yang tidak terpasang harus dibuat.
Mengembalikan
Klausa pengidentifikasi kunci yang mereferensikan token yang ditentukan.
Contoh
Kode berikut menunjukkan cara mengambil alih CreateSecurityTokenReference metode untuk membuat klausa pengidentifikasi kunci dari token yang ditentukan. Kode diambil dari Custom Token sampel. Sampel ini menyediakan kelas kustom yang memungkinkan pemrosesan Simple Web Tokens (SWT). Untuk informasi tentang sampel ini dan sampel lain yang tersedia untuk WIF dan tempat mengunduhnya, lihat Indeks Sampel Kode WIF.
public override SecurityKeyIdentifierClause CreateSecurityTokenReference(SecurityToken token, bool attached)
{
return token.CreateKeyIdentifierClause<LocalIdKeyIdentifierClause>();
}
Keterangan
Secara default metode ini memberikan NotImplementedException pengecualian.
Kelas turunan mengambil alih metode ini untuk mengembalikan klausa pengidentifikasi kunci (SecurityKeyIdentifierClause) yang dapat digunakan untuk membuat <wsse:SecurityTokenReference> elemen untuk token yang ditentukan.
Dipanggil dari implementasi SecurityTokenService kelas .
Biasanya, SecurityKeyIdentifierClause tidak perlu digunakan, selain ketika layanan token keamanan kustom dibuat. Saat layanan token keamanan mengembalikan token keamanan, token keamanan yang dikeluarkan berisi referensi untuk token keamanan yang terpasang dan tidak terpasang. Referensi terlampir mengacu pada token keamanan yang terkandung dalam header keamanan pesan SOAP dan referensi yang tidak terpasang mereferensikan token keamanan yang tidak disertakan dalam header keamanan pesan SOAP. Referensi ini biasanya mensinyalkan keaslian token keamanan yang dikeluarkan.
