Bagikan melalui

enumerasi WS_REQUEST_SECURITY_TOKEN_PROPERTY_ID (webservices.h)

  • Artikel

Mengidentifikasi properti untuk meminta token keamanan dari penerbit. Ini digunakan dengan WsRequestSecurityToken sebagai bagian dari parameter WS_REQUEST_SECURITY_TOKEN_PROPERTY* .

Sintaks

typedef enum {
  WS_REQUEST_SECURITY_TOKEN_PROPERTY_APPLIES_TO = 1,
  WS_REQUEST_SECURITY_TOKEN_PROPERTY_TRUST_VERSION = 2,
  WS_REQUEST_SECURITY_TOKEN_PROPERTY_SECURE_CONVERSATION_VERSION = 3,
  WS_REQUEST_SECURITY_TOKEN_PROPERTY_ISSUED_TOKEN_TYPE = 4,
  WS_REQUEST_SECURITY_TOKEN_PROPERTY_REQUEST_ACTION = 5,
  WS_REQUEST_SECURITY_TOKEN_PROPERTY_EXISTING_TOKEN = 6,
  WS_REQUEST_SECURITY_TOKEN_PROPERTY_ISSUED_TOKEN_KEY_TYPE = 7,
  WS_REQUEST_SECURITY_TOKEN_PROPERTY_ISSUED_TOKEN_KEY_SIZE = 8,
  WS_REQUEST_SECURITY_TOKEN_PROPERTY_ISSUED_TOKEN_KEY_ENTROPY = 9,
  WS_REQUEST_SECURITY_TOKEN_PROPERTY_LOCAL_REQUEST_PARAMETERS = 10,
  WS_REQUEST_SECURITY_TOKEN_PROPERTY_SERVICE_REQUEST_PARAMETERS = 11,
  WS_REQUEST_SECURITY_TOKEN_PROPERTY_MESSAGE_PROPERTIES = 12,
  WS_REQUEST_SECURITY_TOKEN_PROPERTY_BEARER_KEY_TYPE_VERSION = 13
} WS_REQUEST_SECURITY_TOKEN_PROPERTY_ID;

Konstanta

 
WS_REQUEST_SECURITY_TOKEN_PROPERTY_APPLIES_TO
Nilai: 1
Penunjuk ke struktur WS_ENDPOINT_ADDRESS yang berisi alamat layanan (pihak yang mengandalkan') kepada siapa yang diminta
token akan disajikan.
.
WS_REQUEST_SECURITY_TOKEN_PROPERTY_TRUST_VERSION
Nilai: 2
Nilai WS_TRUST_VERSION yang menentukan versi WS-Trust untuk digunakan.

Jika properti ini tidak ditentukan, defaultnya adalah WS_TRUST_VERSION_FEBRUARY_2005.
WS_REQUEST_SECURITY_TOKEN_PROPERTY_SECURE_CONVERSATION_VERSION
Nilai: 3
Nilai WS_SECURE_CONVERSATION_VERSION yang
menentukan versi WS-SecureConversation yang akan digunakan saat WS_REQUEST_SECURITY_TOKEN_ACTION_NEW_CONTEXT
atau WS_REQUEST_SECURITY_TOKEN_ACTION_RENEW_CONTEXT ditentukan.


Jika properti ini tidak ditentukan, defaultnya adalah WS_SECURE_CONVERSATION_VERSION_FEBRUARY_2005.
WS_REQUEST_SECURITY_TOKEN_PROPERTY_ISSUED_TOKEN_TYPE
Nilai: 4
Penunjuk ke struktur WS_XML_STRING yang menentukan jenis token keamanan yang akan dikeluarkan. Jika properti ini tidak ditentukan,
elemen yang sesuai tidak dihasilkan dalam pesan token keamanan permintaan, dan
pengeluar sertifikat diasumsikan mengetahui jenis token yang diperlukan.
WS_REQUEST_SECURITY_TOKEN_PROPERTY_REQUEST_ACTION
Nilai: 5
Nilai WS_REQUEST_SECURITY_TOKEN_ACTION yang menentukan tindakan yang akan digunakan dengan permintaan. Defaultnya adalah WS_REQUEST_SECURITY_TOKEN_ACTION_ISSUE.
WS_REQUEST_SECURITY_TOKEN_PROPERTY_EXISTING_TOKEN
Nilai: 6
Penunjuk ke struktur WS_SECURITY_TOKEN yang,
jika ditentukan, alih-alih meminta token baru, token yang disediakan diperbarui dengan meminta token baru berdasarkan
yang sudah ada. Token lama menjadi tidak valid jika operasi ini berhasil.
Hanya didukung dengan WS_REQUEST_SECURITY_TOKEN_ACTION_RENEW_CONTEXT.
WS_REQUEST_SECURITY_TOKEN_PROPERTY_ISSUED_TOKEN_KEY_TYPE
Nilai: 7
Nilai WS_SECURITY_KEY_TYPE yang menentukan jenis kunci kriptografi yang akan diminta
token keamanan yang dikeluarkan. Ini harus diatur ke WS_SECURITY_KEY_TYPE_NONE atau WS_SECURITY_KEY_TYPE_SYMMETRIC.


Nilai WS_SECURITY_KEY_TYPE_NONE menentukan token pembawa tanpa
kunci bukti kepemilikan. Token tersebut tidak akan menghasilkan tanda tangan ketika digunakan untuk mengamankan pesan.


Jika properti ini tidak ditentukan, elemen jenis kunci yang sesuai tidak dipancarkan dalam permintaan token.
Tidak memancarkan jenis kunci dalam permintaan token menghasilkan default tersirat dari kunci konten untuk
token yang dikeluarkan, seperti yang didefinisikan dalam spesifikasi WS-Trust.
WS_REQUEST_SECURITY_TOKEN_PROPERTY_ISSUED_TOKEN_KEY_SIZE
Nilai: 8
ULONG yang menentukan ukuran (dalam bit) kunci kriptografi yang akan diminta
dalam token keamanan yang dikeluarkan. Properti ini hanya dapat ditentukan untuk
token yang dikeluarkan dengan kunci konten. Jika properti ini tidak ditentukan,
elemen ukuran kunci yang sesuai tidak dipancarkan dalam permintaan token.
WS_REQUEST_SECURITY_TOKEN_PROPERTY_ISSUED_TOKEN_KEY_ENTROPY
Nilai: 9
Nilai WS_SECURITY_KEY_ENTROPY_MODE yang menentukan bagaimana entropi berkontribusi pada kunci kriptografi
token yang dikeluarkan. Properti ini hanya dapat ditentukan untuk token yang dikeluarkan
dengan kunci konten. Jika properti ini tidak ditentukan, mode WS_SECURITY_KEY_ENTROPY_MODE_SERVER_ONLY digunakan.
WS_REQUEST_SECURITY_TOKEN_PROPERTY_LOCAL_REQUEST_PARAMETERS
Nilai: 10
Penunjuk ke WS_XML_BUFFER yang berisi
parameter utama tambahan yang akan disertakan secara verbatim dalam permintaan
pesan token keamanan. Setiap parameter tersebut harus tingkat atas
elemen dalam buffer XML yang disediakan. Jika properti ini tidak ditentukan, seperti
parameter tidak dipancarkan. Buffer diserialisasikan ke dalam elemen RequestSecurityToken
saat meminta token keamanan.


Tidak seperti WS_REQUEST_SECURITY_TOKEN_PROPERTY_SERVICE_REQUEST_PARAMETERS, permintaan lokal
parameter didefinisikan oleh klien sebagai sarana untuk menambahkan parameter ke permintaan token.
WS_REQUEST_SECURITY_TOKEN_PROPERTY_SERVICE_REQUEST_PARAMETERS
Nilai: 11
Penunjuk ke WS_XML_BUFFER yang berisi
parameter layanan untuk disertakan dalam token keamanan permintaan
pesan, disediakan sebagai buffer XML. Setiap parameter tersebut harus berupa
elemen tingkat atas dalam buffer XML yang disediakan. Jika ini adalah properti yang tidak ditentukan, seperti
parameter tidak dipancarkan.


Jika WS_TRUST_VERSION_FEBRUARY_2005 ditentukan, buffer ini diserialisasikan
ke dalam elemen RequestSecurityToken setelah
WS_REQUEST_SECURITY_TOKEN_PROPERTY_LOCAL_REQUEST_PARAMETERS.


Jika WS_TRUST_VERSION_1_3 ditentukan, buffer ini diserialisasikan ke dalam
Elemen RequestSecurityToken/SecondaryParameters.


Parameter permintaan layanan adalah instruksi mengenai cara mengeluarkan token. Mereka diperoleh dari layanan,
biasanya dengan cara impor metadata. Dalam hal ini, parameter ini dapat diperoleh
dari luar. Bidang RequestSecurityTokenTemplate dari WS_ISSUED_TOKEN_MESSAGE_SECURITY_BINDING_CONSTRAINT.
WS_REQUEST_SECURITY_TOKEN_PROPERTY_MESSAGE_PROPERTIES
Nilai: 12
Kumpulan WS_MESSAGE_PROPERTIES yang akan ditentukan
saat membuat dua pesan dengan WsCreateMessage dan adalah untuk
digunakan untuk token keamanan yang mendapatkan pertukaran. Jika properti ini
tidak ditentukan, pesan permintaan dan balasan dibuat dengan
properti pesan default.
WS_REQUEST_SECURITY_TOKEN_PROPERTY_BEARER_KEY_TYPE_VERSION
Nilai: 13

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