SecurityTokenHandler.CreateSecurityTokenReference Metode

Definisi

Ruang nama:

System.IdentityModel.Tokens

Rakitan:

System.IdentityModel.dll

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.SecurityKeyIdentifierClause

Public Overridable Function CreateSecurityTokenReference (token As SecurityToken, attached As Boolean) As SecurityKeyIdentifierClause

Parameter

token

SecurityToken

Token yang referensinya akan dibuat.

attached

Boolean

true jika referensi terlampir harus dibuat; false jika referensi yang tidak terpasang harus dibuat.

Mengembalikan

SecurityKeyIdentifierClause

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.