struktur WS_USERNAME_MESSAGE_SECURITY_BINDING (webservices.h)

Subjenis pengikatan keamanan untuk menentukan penggunaan pasangan nama pengguna/kata sandi yang disediakan aplikasi sebagai token keamanan langsung (yaitu, satu bidikan). Pengikatan keamanan ini hanya dapat digunakan dengan keamanan pesan. Ini menyediakan autentikasi klien, tetapi bukan penandatanganan lalu lintas atau enkripsi. Jadi, ini digunakan bersama dengan keamanan transportasi lain atau pengikatan keamanan pesan yang memberikan perlindungan pesan.

Hanya satu contoh pengikatan ini yang mungkin ada dalam deskripsi keamanan. Pengikatan keamanan ini tidak didukung dengan WS_NAMEDPIPE_CHANNEL_BINDING.

Dengan pengikatan keamanan ini, tidak ada properti pengikatan keamanan yang dapat ditentukan.

Sintaks

typedef struct _WS_USERNAME_MESSAGE_SECURITY_BINDING {
  WS_SECURITY_BINDING           binding;
  WS_MESSAGE_SECURITY_USAGE     bindingUsage;
  WS_USERNAME_CREDENTIAL        *clientCredential;
  WS_VALIDATE_PASSWORD_CALLBACK passwordValidator;
  void                          *passwordValidatorCallbackState;
} WS_USERNAME_MESSAGE_SECURITY_BINDING;

Anggota

binding

Jenis dasar tempat subjenis pengikatan keamanan ini dan semua subjenis pengikatan keamanan lainnya berasal.

bindingUsage

Bagaimana token keamanan yang sesuai dengan pengikatan keamanan ini harus terikat dengan pesan.

Hanya WS_SUPPORTING_MESSAGE_SECURITY_USAGE yang didukung. Dengan penggunaan ini, pengikatan keamanan ini menyediakan autentikasi klien, tetapi bukan perlindungan pesan (seperti penandatanganan, enkripsi, deteksi pemutaran ulang). Dengan demikian, pengikatan ini harus digunakan bersama dengan pengikatan keamanan lain seperti WS_SSL_TRANSPORT_SECURITY_BINDING yang menyediakan saluran yang dilindungi.

Untuk menggunakan pengikatan ini pada HTTP tanpa SSL, properti deskripsi keamanan WS_SECURITY_PROPERTY_TRANSPORT_PROTECTION_LEVEL harus diatur secara eksplisit ke WS_PROTECTION_LEVEL_NONE. Ini tidak didukung pada klien atau di TCP.

clientCredential

Kredensial nama pengguna yang akan digunakan dengan pengikatan keamanan ini. Ini harus ditentukan ketika pengikatan keamanan ini digunakan pada klien.

passwordValidator

Validator yang akan digunakan untuk memeriksa pasangan nama pengguna/kata sandi yang diterima. Ini harus ditentukan ketika pengikatan keamanan ini digunakan pada layanan.

passwordValidatorCallbackState

Status opsional yang akan diteruskan sebagai argumen saat validator nama pengguna dipanggil.

Persyaratan

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