Bagikan melalui

enumerasi WS_SECURITY_TOKEN_PROPERTY_ID (webservices.h)

  • Artikel

Menentukan kunci untuk bidang dan properti yang dapat diekstrak dari token keamanan. Tidak semua properti valid untuk semua jenis token keamanan. Fungsi WsGetSecurityTokenProperty menggunakan nilai yang ditentukan di sini sebagai kunci.

Lihat juga WS_SECURITY_BINDING_PROPERTY.

Sintaks

typedef enum {
  WS_SECURITY_TOKEN_PROPERTY_KEY_TYPE = 1,
  WS_SECURITY_TOKEN_PROPERTY_VALID_FROM_TIME = 2,
  WS_SECURITY_TOKEN_PROPERTY_VALID_TILL_TIME = 3,
  WS_SECURITY_TOKEN_PROPERTY_SERIALIZED_XML = 4,
  WS_SECURITY_TOKEN_PROPERTY_ATTACHED_REFERENCE_XML = 5,
  WS_SECURITY_TOKEN_PROPERTY_UNATTACHED_REFERENCE_XML = 6,
  WS_SECURITY_TOKEN_PROPERTY_SYMMETRIC_KEY = 7
} WS_SECURITY_TOKEN_PROPERTY_ID;

Konstanta

 
WS_SECURITY_TOKEN_PROPERTY_KEY_TYPE
Nilai: 1
Parameter nilai yang menyertai fungsi WsGetSecurityTokenProperty adalah nilai WS_SECURITY_KEY_TYPE yang menunjukkan jenis kunci bukti token keamanan.
WS_SECURITY_TOKEN_PROPERTY_VALID_FROM_TIME
Nilai: 2
Parameter nilai yang menyertai fungsi WsGetSecurityTokenProperty adalah struktur WS_DATETIME yang berisi waktu sejak token keamanan valid. Untuk token keamanan
yang tidak menentukan waktu mulai eksplisit untuk periode validitasnya,
WS_DATETIME dengan jumlah centang 0 dikembalikan.
WS_SECURITY_TOKEN_PROPERTY_VALID_TILL_TIME
Nilai: 3
Parameter nilai yang menyertai fungsi WsGetSecurityTokenProperty adalah struktur WS_DATETIME yang berisi titik waktu di mana token keamanan yang saat ini valid menjadi tidak valid. Untuk token keamanan
yang tidak menentukan waktu akhir eksplisit untuk periode validitasnya,
WS_DATETIME dengan jumlah centang 0 dikembalikan.
WS_SECURITY_TOKEN_PROPERTY_SERIALIZED_XML
Nilai: 4
Parameter nilai yang menyertai fungsi WsGetSecurityTokenProperty adalah penunjuk ke WS_XML_BUFFER yang berisi bentuk kawat XML dari token keamanan.
WS_SECURITY_TOKEN_PROPERTY_ATTACHED_REFERENCE_XML
Nilai: 5
Parameter nilai yang menyertai fungsi WsGetSecurityTokenProperty adalah penunjuk ke WS_XML_BUFFER yang berisi
bentuk kawat XML dari referensi terlampir ke token keamanan.
Referensi terlampir digunakan untuk merujuk ke token keamanan saat
token keamanan dan titik referensinya (seperti tanda tangan menggunakan
token) keduanya terjadi dalam pesan yang sama.
WS_SECURITY_TOKEN_PROPERTY_UNATTACHED_REFERENCE_XML
Nilai: 6
Parameter nilai yang menyertai fungsi WsGetSecurityTokenProperty adalah penunjuk ke WS_XML_BUFFER yang berisi
bentuk kawat XML dari referensi yang tidak terpasang ke token keamanan.
Referensi yang tidak terpasang digunakan untuk merujuk ke token keamanan saat
token keamanan tidak terjadi dalam pesan yang sama dengan yang dirujuk
titik (seperti tanda tangan menggunakan token tersebut).
WS_SECURITY_TOKEN_PROPERTY_SYMMETRIC_KEY
Nilai: 7
Parameter nilai yang menyertai fungsi WsGetSecurityTokenProperty adalah penunjuk ke struktur WS_BYTES yang berisi
data kunci mentah dari kunci token simetris. Properti ini tersedia jika WS_SECURITY_TOKEN_PROPERTY_KEY_TYPE
WS_SECURITY_KEY_TYPE_SYMMETRIC.


Jika token diperoleh melalui WsRequestSecurityToken, buffer yang dikembalikan berisi bahan kunci yang dihasilkan selama
permintaan token, yang merupakan entropi yang dihasilkan oleh klien, entropi yang dihasilkan oleh server atau bahan kunci yang berasal dari kedua klien
dan entropi server, tergantung pada WS_REQUEST_SECURITY_TOKEN_PROPERTY_ISSUED_TOKEN_KEY_ENTROPY.


Saat menggunakan properti ini dengan WsGetSecurityTokenProperty, parameter 'heap' harus non-NULL.


Buffer yang dikembalikan harus dihapus atau dienkripsi dengan aman segera setelah digunakan untuk mencegah kebocoran data sensitif.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 7 [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung Windows Server 2008 R2 [aplikasi desktop | Aplikasi UWP]
Header webservices.h