MachineKeySessionSecurityTokenHandler Kelas

Referensi

Definisi

Ruang nama:: System.IdentityModel.Services.Tokens

Rakitan:: System.IdentityModel.Services.dll

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.

Memproses token sesi dengan menggunakan kunci penandatanganan dan enkripsi yang ditentukan dalam elemen ASP.NET <machineKey> dalam file konfigurasi.

public ref class MachineKeySessionSecurityTokenHandler : System::IdentityModel::Tokens::SessionSecurityTokenHandler

public class MachineKeySessionSecurityTokenHandler : System.IdentityModel.Tokens.SessionSecurityTokenHandler

type MachineKeySessionSecurityTokenHandler = class
    inherit SessionSecurityTokenHandler

Public Class MachineKeySessionSecurityTokenHandler
Inherits SessionSecurityTokenHandler

Warisan: Object

SecurityTokenHandler

SessionSecurityTokenHandler
MachineKeySessionSecurityTokenHandler

Contoh

XML berikut menunjukkan cara menggunakan elemen ASP.NET <machineKey> dalam konfigurasi untuk secara eksplisit menentukan kunci penandatanganan dan enkripsi. Elemen <machineKey> ditentukan di <system.web> bawah elemen dalam file konfigurasi.

<machineKey compatibilityMode="Framework45" decryptionKey="CC510D … 8925E6" validationKey="BEAC8 … 6A4B1DE" />

XML berikut ini memperlihatkan cara menambahkan ke MachineKeySessionSecurityTokenHandler koleksi handler token. SessionSecurityTokenHandler Default pertama kali dihapus dari koleksi. Penangan token dikonfigurasi di <bawah elemen securityTokenHandlers> .

<securityTokenHandlers>  
  <remove type="System.IdentityModel.Tokens.SessionSecurityTokenHandler, System.IdentityModel, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />  
  <add type="System.IdentityModel.Services.Tokens.MachineKeySessionSecurityTokenHandler, System.IdentityModel.Services, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />  
</securityTokenHandlers>

Keterangan

Secara default, SessionSecurityTokenHandler kelas menggunakan ProtectedDataCookieTransform kelas , yang menggunakan API Perlindungan Data (DPAPI), untuk melindungi token sesi. DPAPI memberikan perlindungan dengan menggunakan kredensial pengguna atau mesin dan menyimpan data kunci di profil pengguna. Ini berarti bahwa token sesi yang ditandatangani dan dienkripsi pada satu komputer tidak dapat divalidasi atau didekripsi pada komputer yang berbeda.

Sebaliknya, MachineKeySessionSecurityTokenHandler kelas menggunakan MachineKeyTransform kelas , yang melindungi data cookie sesi dengan menggunakan materi kriptografi yang ditentukan dalam <machineKey> elemen dalam file konfigurasi. Ini berarti bahwa kunci yang sama (dan token sesi) dapat digunakan di beberapa komputer. Ini sangat penting ketika aplikasi disebarkan di farm web. Untuk informasi selengkapnya tentang cara menggunakan Windows Identity Foundation untuk melindungi aplikasi yang disebarkan di farm web, lihat WIF dan Web Farms.

Konfigurasikan aplikasi untuk menggunakan MachineKeySessionSecurityTokenHandler dengan menambahkannya ke koleksi handler token. Anda harus terlebih dahulu menghapus SessionSecurityTokenHandler (atau handler apa pun yang berasal dari SessionSecurityTokenHandler kelas) dari koleksi handler token jika handler tersebut ada. Ini karena MachineKeySessionSecurityTokenHandler berasal dari SessionSecurityTokenHandler dan koleksi handler token tidak boleh berisi beberapa handler dari jenis tertentu.

Konstruktor

MachineKeySessionSecurityTokenHandler()	Menginisialisasi instans baru kelas MachineKeySessionSecurityTokenHandler.
MachineKeySessionSecurityTokenHandler(TimeSpan)	Menginisialisasi instans MachineKeySessionSecurityTokenHandler baru kelas yang memiliki masa pakai token default yang ditentukan.

Properti

CanValidateToken	Mendapatkan nilai yang menunjukkan apakah handler ini mendukung validasi token jenis SessionSecurityToken. (Diperoleh dari SessionSecurityTokenHandler)
CanWriteToken	Mendapatkan nilai yang menunjukkan apakah handler ini dapat menulis token jenis SessionSecurityToken. (Diperoleh dari SessionSecurityTokenHandler)
Configuration	Mendapatkan atau mengatur SecurityTokenHandlerConfiguration objek yang menyediakan konfigurasi untuk instans saat ini. (Diperoleh dari SecurityTokenHandler)
ContainingCollection	Mendapatkan koleksi handler token yang berisi instans saat ini. (Diperoleh dari SecurityTokenHandler)
CookieElementName	Mendapatkan nama untuk elemen cookie. (Diperoleh dari SessionSecurityTokenHandler)
CookieNamespace	Mendapatkan namespace untuk elemen cookie. (Diperoleh dari SessionSecurityTokenHandler)
TokenLifetime	Mendapatkan atau mengatur masa pakai token. (Diperoleh dari SessionSecurityTokenHandler)
TokenType	Mendapatkan jenis token yang diproses handler ini. (Diperoleh dari SessionSecurityTokenHandler)
Transforms	Mendapatkan transformasi yang akan diterapkan ke cookie. (Diperoleh dari SessionSecurityTokenHandler)

Metode

ApplyTransforms(Byte[], Boolean)	Menerapkan transformasi yang ditentukan oleh Transforms properti untuk mengodekan atau mendekode cookie yang ditentukan. (Diperoleh dari SessionSecurityTokenHandler)
CanReadKeyIdentifierClause(XmlReader)	Mengembalikan nilai yang menunjukkan apakah elemen XML yang dirujuk oleh pembaca XML yang ditentukan adalah klausa pengidentifikasi kunci yang dapat dideserialisasi oleh instans ini. (Diperoleh dari SecurityTokenHandler)
CanReadToken(String)	Mengembalikan nilai yang menunjukkan apakah string yang ditentukan dapat dideserialisasi sebagai token jenis yang diproses oleh instans ini. (Diperoleh dari SecurityTokenHandler)
CanReadToken(XmlReader)	Mengembalikan nilai yang menunjukkan apakah pembaca diposisikan pada `<wsc:SecurityContextToken>` elemen. (Diperoleh dari SessionSecurityTokenHandler)
CanWriteKeyIdentifierClause(SecurityKeyIdentifierClause)	Mengembalikan nilai yang menunjukkan apakah klausa pengidentifikasi kunci yang ditentukan dapat diserialisasikan oleh instans ini. (Diperoleh dari SecurityTokenHandler)
CreateSecurityTokenReference(SecurityToken, Boolean)	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). (Diperoleh dari SecurityTokenHandler)
CreateSessionSecurityToken(ClaimsPrincipal, String, String, DateTime, DateTime)	SessionSecurityToken Membuat berdasarkan prinsip klaim dan rentang waktu yang ditentukan di mana token valid. (Diperoleh dari SessionSecurityTokenHandler)
CreateToken(SecurityTokenDescriptor)	Membuat token keamanan berdasarkan deskriptor token yang ditentukan. (Diperoleh dari SessionSecurityTokenHandler)
DetectReplayedToken(SecurityToken)	Saat ditimpa di kelas turunan, melemparkan pengecualian jika token yang ditentukan terdeteksi sedang diputar ulang. (Diperoleh dari SecurityTokenHandler)
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetTokenTypeIdentifiers()	Mendapatkan URI jenis token untuk jenis token yang dapat diproses oleh handler ini. (Diperoleh dari SessionSecurityTokenHandler)
GetType()	Mendapatkan instans Type saat ini. (Diperoleh dari Object)
LoadCustomConfiguration(XmlNodeList)	Memuat konfigurasi kustom dari XML. (Diperoleh dari SessionSecurityTokenHandler)
MemberwiseClone()	Membuat salinan dangkal dari yang saat ini Object. (Diperoleh dari Object)
ReadKeyIdentifierClause(XmlReader)	Saat ditimpa di kelas turunan, deserialisasi XML yang direferensikan oleh pembaca XML yang ditentukan ke klausa pengidentifikasi kunci yang mereferensikan token yang diproses oleh kelas turunan. (Diperoleh dari SecurityTokenHandler)
ReadToken(Byte[], SecurityTokenResolver)	SessionSecurityToken Membaca dari aliran byte dengan menggunakan pemecah masalah token yang ditentukan. (Diperoleh dari SessionSecurityTokenHandler)
ReadToken(String)	Saat ditimpa di kelas turunan, deserialisasi string yang ditentukan ke token jenis yang diproses oleh kelas turunan. (Diperoleh dari SecurityTokenHandler)
ReadToken(XmlReader)	SessionSecurityToken Membaca menggunakan pembaca XML yang ditentukan. (Diperoleh dari SessionSecurityTokenHandler)
ReadToken(XmlReader, SecurityTokenResolver)	SessionSecurityToken Membaca menggunakan pembaca XML dan pemecah masalah token yang ditentukan. (Diperoleh dari SessionSecurityTokenHandler)
SetTransforms(IEnumerable<CookieTransform>)	Mengatur transformasi yang akan diterapkan ke cookie. (Diperoleh dari SessionSecurityTokenHandler)
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)
TraceTokenValidationFailure(SecurityToken, String)	Melacak peristiwa kegagalan selama validasi token keamanan saat pelacakan diaktifkan. (Diperoleh dari SecurityTokenHandler)
TraceTokenValidationSuccess(SecurityToken)	Melacak validasi peristiwa token keamanan yang berhasil saat pelacakan diaktifkan. (Diperoleh dari SecurityTokenHandler)
ValidateSession(SessionSecurityToken)	Menentukan apakah sesi yang terkait dengan token yang ditentukan masih valid. Validitas ditentukan dengan memeriksa ValidFrom properti dan ValidTo dari token yang ditentukan. Pengecualian dilemparkan jika sesi tidak lagi valid. (Diperoleh dari SessionSecurityTokenHandler)
ValidateToken(SecurityToken)	Memvalidasi token yang ditentukan dan mengembalikan klaimnya. (Diperoleh dari SessionSecurityTokenHandler)
ValidateToken(SessionSecurityToken, String)	Memvalidasi token sesi yang ditentukan dan mengembalikan klaimnya. (Diperoleh dari SessionSecurityTokenHandler)
WriteKeyIdentifierClause(XmlWriter, SecurityKeyIdentifierClause)	Saat ditimpa di kelas turunan, menserialisasikan klausa pengidentifikasi kunci yang ditentukan ke XML. Klausa pengidentifikasi kunci harus berjenis yang didukung oleh kelas turunan. (Diperoleh dari SecurityTokenHandler)
WriteToken(SecurityToken)	Saat ditimpa di kelas turunan, menserialisasikan token keamanan yang ditentukan ke string. Token harus dari jenis yang diproses oleh kelas turunan. (Diperoleh dari SecurityTokenHandler)
WriteToken(SessionSecurityToken)	Menserialisasikan token yang ditentukan ke dalam array byte. (Diperoleh dari SessionSecurityTokenHandler)
WriteToken(XmlWriter, SecurityToken)	Menserialisasikan token yang ditentukan dengan menggunakan penulis XML yang ditentukan. (Diperoleh dari SessionSecurityTokenHandler)

Berlaku untuk

Bagikan melalui