Bagikan melalui


Alat Pengkompilasi WsUtil

Alat pengkompilasi Windows Web Services, WsUtil.exe, mendukung model layanan dan serialisasi jenis data. Ini memproses WSDL, skema XML dan dokumen kebijakan, dan menghasilkan header C dan file sumber. Alat ini mirip dengan alat pengkompilasi WSDL untuk kode terkelola tetapi ditujukan untuk kode asli sebagai gantinya.

Untuk mendukung model layanan , WsUtil.exe menghasilkan header yang akan digunakan untuk klien dan layanan. Ini menghasilkan file proksi C untuk sisi klien, dan file stub C untuk sisi layanan, sesuai kebutuhan.

Untuk mendukung serialisasi , pengkompilasi menghasilkan header untuk deskripsi elemen untuk definisi elemen global, dan semua informasi definisi jenis dalam file proksi yang digunakan oleh mesin serialisasi.

Untuk opsi baris perintah untuk memproses file WSDL, file Skema XML, dan file kebijakan layanan web, lihat topik berikut:

Keamanan

Saat Anda menggunakan WsUtil, ketahui masalah berikut dan amati tindakan pencegahan yang sesuai:

  • Wsutil tidak mengambil metadata XML melalui jaringan, dan wsutil tidak menyelesaikan impor dan/atau menyertakan pernyataan dalam file metadata input. Wsutil membuka dan membaca file kebijakan wsdl, xsd, dan . Metadata XML tidak tahan terhadap perubahan. Pastikan Anda hanya menggunakan file wsdl, xsd, dan kebijakan diperoleh dari sumber tepercaya dan pastikan untuk melindungi file dari perubahan sebelum dan sesudah menggunakannya. Tinjau konten file input dengan hati-hati dan validasi bahwa konten file aman untuk digunakan dalam aplikasi. Wsutil.exe tidak melakukan verifikasi keaslian file metadata.
  • Wsutil menghasilkan file header dan stub, yang tidak tahan terhadap perubahan. Anda perlu mengatur hak akses tingkat yang benar pada file sumber yang dihasilkan oleh wsutil.exe untuk mencegah akses tidak terautoritisasi ke file-file tersebut. Wsutil menggunakan System.IO.StreamWriter untuk membuat file output.
  • Pengguna perlu menyadari bahwa Wsutil dapat menimpa file lokal mereka, dan mereka harus berhati-hati untuk menentukan nama file dan direktori yang aman untuk file output menggunakan sakelar /out.
  • Wsutil atau wsutilhelper.dll yang dimuat dalam wsutil.exe, dapat mengakhiri secara tak terduga atau mengonsumsi sejumlah besar sumber daya sistem saat diserang atau dalam memproses sejumlah besar metadata input. Alat ini dirancang untuk digunakan selama waktu pengembangan hanya Alat ini harus digunakan sebagai alat waktu pengembangan saja. Mungkin tidak aman untuk digunakan di tingkat menengah untuk memproses informasi kebijakan.
  • Wsutilhelper.dll HELPER DLL dimuat ke dalam wsutil.exe terkelola untuk memproses informasi kebijakan. Pengguna harus memastikan tidak ada biner berbahaya dengan nama file yang sama yang ada di jalur biner. Demikian pula, pengguna harus memastikan di lingkungan build, jalur biner disiapkan dengan benar bahwa tidak ada biner berbahaya dengan nama "wsutil.exe" yang sama.
  • Wsutil menghasilkan anotasi SAL untuk operasi dan bidang struktur jika memungkinkan. Pengguna file yang dihasilkan wsutil harus mengikuti persyaratan yang ditentukan melalui anotasi SAL.

Gambaran Umum Lapisan Model Layanan

Serialisasi

Alat Pengkompilasi Layanan Web

dukungan WSDL

dukungan Skema

Dukungan Kebijakan