Bagikan melalui


Mengonfigurasi Langkah 3: Mengonfigurasi Pengaturan Sumber Data

oleh Keith Newman dan Robert McMurray

Dalam fase membangun situs web ASP.NET Anda ini, Anda mengonfigurasi pengaturan sumber data yang tersedia di IIS.

3.1. String Koneksi Sumber Data

Bagian ini menjelaskan cara membuat string koneksi database di IIS menggunakan UI Manajer IIS atau baris perintah.

Dalam Merencanakan situs web ASP.NET di IIS, Anda membuat keputusan desain berikut tentang kebutuhan untuk menambahkan string koneksi:

  1. Tentukan nama untuk string koneksi.
  2. Tentukan server tempat database berada.
  3. Tentukan nama database.
  4. Berikan kredensial, kecuali menggunakan Windows mengintegrasikan keamanan.

Untuk membuat string koneksi database dengan menggunakan UI

  1. Buka Manajer IIS dan navigasi ke tingkat yang ingin Anda kelola.

  2. Di Tampilan Fitur, klik dua kali String Koneksi.

  3. Pada halaman String Koneksi , klik Tambahkan di panel Tindakan .

  4. Dalam kotak dialog Tambahkan String Koneksi , ketik nama untuk string koneksi, seperti MyConnection, dalam kotak teks Nama .

    Catatan

    Nama yang Anda masukkan di IIS Manager adalah nama yang sama dengan yang Anda referensikan dalam kode aplikasi Anda untuk mengambil data dengan menggunakan string koneksi ini.

  5. Dengan opsi SQL Server dipilih, ketik nama server yang menghosting database di kotak teks Server dan ketik nama database dalam kotak teks Database.

  6. Di bawah Kredensial, pilih salah satu hal berikut ini:

    • Pilih Gunakan Keamanan Terintegrasi Windows.
    • Pilih Tentukan kredensial dan klik Atur. Ketik nama pengguna dan kata sandi untuk akun yang bisa tersambung ke server dan database dalam kotak teks Nama pengguna dan Kata Sandi . Lalu ketik kata sandi yang sama dalam kotak teks Konfirmasi kata sandi , dan klik OK.
  7. Klik OK.

Untuk membuat string koneksi database dengan menggunakan baris perintah

Untuk membuat string koneksi database, gunakan sintaks berikut:

appcmd set config /commit:MACHINE /section:connectionStrings /+"[connectionString='string', name='string', providerName='string']"

Variabel connectionString='string' adalah nilai string koneksi, variabel name='string' adalah kunci yang digunakan untuk mengakses nilai string koneksi, dan variabel providerName='string' adalah nama penyedia ADO.NET untuk digunakan untuk mengakses penyimpanan data yang mendasar. Misalnya, untuk membuat string koneksi untuk aplikasi yang menggunakan database Northwind, ketik berikut ini di prompt perintah, lalu tekan Enter:

appcmd set config /commit:MACHINE /section:connectionStrings /+"[connectionString='Data Source=localhost;Integrated Security=SSPI;Initial Catalog=Northwind;', name='Northwind', providerName='System.Data.SqlClient ']"

3.2. Penyedia ASP.NET

Bagian ini menjelaskan cara menambahkan penyedia .NET ke IIS menggunakan UI Manajer IIS atau baris perintah.

Dalam Merencanakan situs web ASP.NET di IIS, Anda membuat keputusan desain berikut tentang menambahkan penyedia .NET ke IIS:

  • Pilih fitur IIS untuk penyedia yang akan disediakan: Profil .NET, Peran .NET, atau Pengguna .NET.

  • Pilih jenis penyedia.

  • Masukkan nama untuk penyedia.

  • Jika fitur yang dipilih adalah Pengguna .NET, pilih salah satu perilaku penyedia berikut yang Anda inginkan:

    • Aktifkan reset kata sandi
    • Aktifkan pengambilan kata sandi
    • Membutuhkan pertanyaan dan jawaban
    • Memerlukan email unik
    • Menyimpan kata sandi dalam format aman
  • Berikan nama string koneksi ke database.

  • Masukkan nama aplikasi.

Untuk menambahkan penyedia dengan menggunakan UI

  1. Buka Manajer IIS dan navigasi ke tingkat yang ingin Anda kelola.

  2. Di Tampilan Fitur, klik dua kali Penyedia.

  3. Pada halaman Penyedia , di bawah Fitur, pilih salah satu fitur berikut ini:

    • Peran .NET: untuk mengonfigurasi penyedia untuk menyediakan antarmuka antara layanan manajemen peran ASP.NET ("manajer peran") dan sumber data peran.
    • Pengguna .NET: untuk mengonfigurasi penyedia untuk menyediakan antarmuka antara layanan keanggotaan ASP.NET dan sumber data keanggotaan.
    • Profil .NET: untuk mengonfigurasi penyedia untuk menyediakan antarmuka antara layanan profil ASP.NET dan sumber data profil.
  4. Di panel Tindakan , klik Tambahkan.

  5. Dalam kotak dialog Tambahkan Penyedia , pilih jenis penyedia dari daftar drop-down Jenis .

  6. Dalam kotak teks Nama , ketik nama untuk penyedia.

  7. Jika fitur Pengguna .NET dipilih di langkah #3, di bagian Properti profil , di bawah Perilaku, atur nilai satu atau beberapa perilaku berikut ke True untuk mengaktifkan perilaku:

    • EnablePasswordReset: menunjukkan apakah kata sandi dapat diatur ulang dengan menggunakan metode ResetPassword penyedia. Pengaturan defaultnya adalah False.

    • EnablePasswordRetrieval: menunjukkan apakah kata sandi dapat diambil dengan menggunakan metode GetPassword penyedia. Pengaturan defaultnya adalah False.

      Penting

      Beberapa penyedia, seperti penyedia Direktori Aktif, tidak mendukung pengambilan kata sandi. Untuk penyedia ini, nilai atribut enablePasswordRetrieval selalu False dan tidak dapat diubah dalam konfigurasi.

    • RequiresQuestionAndAnswer: menunjukkan apakah jawaban kata sandi diberikan ketika program memanggil penyedia metode GetPassword dan ResetPassword . Pengaturan defaultnya adalah False.

    • RequiresUniqueEmail: menunjukkan apakah setiap pengguna terdaftar harus memiliki alamat email yang unik. Pengaturan defaultnya adalah False.

    • StorePasswordInSecureFormat: menunjukkan apakah kata sandi di-hash. Pengaturan defaultnya adalah False.

  8. Di bawah Data, ketik nama string koneksi yang digunakan untuk menyambungkan ke database dalam kotak teks ConnectionStringName . (Catatan: Ini adalah string koneksi yang sama yang dikonfigurasi di bawah fitur String Koneksi . Untuk informasi selengkapnya tentang cara mengonfigurasi string koneksi, lihat Mengonfigurasi String Koneksi di IIS 7. Jika WindowsTokenRoleProvider dipilih di langkah #5 prosedur ini, nama string koneksi bersifat opsional.)

  9. Secara opsional, di bagian Properti profil , di bawah Umum, ketik jalur virtual aplikasi di kotak teks ApplicationName . Jika Anda tidak menentukan nilai dalam kotak teks ApplicationName , API keanggotaan default ke HttpContext.Current.Request.ApplicationPath. Jalur ini hanya dapat ditentukan saat runtime.

  10. Secara opsional, di bagian Properti profil , di bawah Umum, ketik deskripsi penyedia di kotak teks Deskripsi .

  11. Klik OK.

Untuk menambahkan penyedia dengan menggunakan baris perintah

Untuk menambahkan penyedia peran .NET, gunakan sintaks berikut:

appcmd set config /commit:MACHINE /section:roleManager /+"providers.[name='string', type='string', connectionStringName='string', applicationName='string']"

Variabel name='string' adalah nama penyedia. Variabel type='string' adalah jenis penyedia. Variabel connectionStringName='string' adalah nama string koneksi yang digunakan untuk menyambungkan ke database. Variabel applicationName='string' bersifat opsional dan merupakan jalur virtual aplikasi. Misalnya, untuk mengonfigurasi aplikasi ASP.NET untuk menggunakan SqlRoleProvider kelas untuk menyimpan dan mengambil informasi peran, ketik yang berikut ini di prompt perintah, lalu tekan Enter:

appcmd set config /commit:MACHINE /section:roleManager /+"providers.[name='SqlProvider', type='System.Web.Security.SqlRoleProvider', connectionStringName='SqlServices', applicationName='SampleApplication']"

Untuk menambahkan penyedia pengguna .NET, gunakan sintaks berikut:

appcmd set config /commit:MACHINE /section:membership /+"providers.[name='string', type='string', connectionStringName='string', applicationName='string', enablePasswordReset='true|false', enablePasswordRetrieval='true|false', requiresQuestionAndAnswer='true|false', requiresUniqueEmail='true|false', storePasswordInSecureFormat='true|false']"

Sintaks ini terdiri dari item berikut:

  • Variabel name='string' adalah nama penyedia.
  • Variabel type='string' adalah jenis penyedia.
  • Variabel connectionStringName='string' adalah nama string koneksi yang digunakan untuk menyambungkan ke database.
  • Variabel applicationName='string' bersifat opsional dan merupakan jalur virtual aplikasi.
  • Variabel enablePasswordReset=true memungkinkan reset kata sandi dengan menggunakan metode ResetPassword penyedia. Pengaturan default-nya false.
  • Variabel enablePasswordRetrieval=true memungkinkan pengambilan kata sandi dengan menggunakan metode GetPassword penyedia. Pengaturan default-nya false.
  • Variabel requiresQuestionAndAnswer=true mengharuskan jawaban kata sandi harus diberikan ketika program memanggil penyedia metode GetPassword dan ResetPassword . Pengaturan default-nya false.
  • Variabel requiresUniqueEmail=true mengharuskan setiap pengguna terdaftar memiliki alamat email yang unik. Pengaturan default-nya false.
  • Variabel storePasswordInSecureFormat=true mengharuskan semua kata sandi harus di-hash. Pengaturan default-nya false.

Misalnya, untuk mengonfigurasi aplikasi ASP.NET untuk menggunakan SqlMembershipProvider kelas untuk menyimpan dan mengambil informasi pengguna, ketik yang berikut ini di prompt perintah, lalu tekan Enter:

appcmd set config /commit:MACHINE /section:membership /+"providers.[name='SqlProvider', type='System.Web.Security.SqlMembershipProvider', connectionStringName='SqlServices', applicationName='/', enablePasswordRetrieval='False', enablePasswordReset='True', requiresQuestionAndAnswer='True']"

Untuk menambahkan penyedia profil .NET, gunakan sintaks berikut:

appcmd set config /commit:MACHINE /section:profile /+"providers.[name='string', type='string', connectionStringName='string', applicationName='string']"

Variabel name='string' adalah nama penyedia. Variabel type='string' adalah jenis penyedia. Variabel connectionStringName='string' adalah nama string koneksi yang digunakan untuk menyambungkan ke database. Variabel applicationName='string' bersifat opsional dan merupakan jalur virtual aplikasi. Misalnya, untuk mengonfigurasi aplikasi ASP.NET untuk menggunakan SqlProfileProvider kelas untuk menyimpan dan mengambil informasi profil, ketik yang berikut ini di prompt perintah, lalu tekan Enter:

appcmd set config /commit:MACHINE /section:profile /+"providers.[name='SqlProvider', type='System.Web.Profile.SqlProfileProvider', connectionStringName='SqlServices', applicationName='SampleApplication']"

3.3. Profil .NET

Bagian ini menjelaskan cara menambahkan properti profil dan grup profil.

Dalam Merencanakan Situs Web ASP.NET di IIS, Anda membuat keputusan desain berikut tentang properti profil dan grup ke IIS:

  • Untuk setiap properti profil, berikan nama properti, jenis data (seperti string atau Boolean), nilai default, opsi serialisasi (string, XML, biner, atau penyedia tertentu), baik itu baca-saja, dan apakah tersedia untuk pengguna anonim.
  • Untuk setiap grup profil, berikan nama grup.

Untuk menambahkan properti profil .NET dengan menggunakan UI

  1. Buka Manajer IIS dan navigasi ke tingkat yang ingin Anda kelola.

  2. Di Tampilan Fitur, klik dua kali Profil .NET.

  3. Di panel Tindakan , klik Tambahkan Properti untuk menambahkan properti profil .NET atau, untuk menambahkan properti profil .NET ke grup, pilih grup yang ingin Anda tambahkan properti profil .NET, lalu klik Tambahkan Properti Ke Grup.

  4. Dalam kotak dialog Tambahkan Properti Profil .NET , ketik nama untuk properti profil .NET di kotak teks Nama .

  5. Di bawah Tipe Data, pilih salah satu jenis data berikut ini:

    • System.Boolean: untuk mengonfigurasi properti profil .NET agar memiliki nilai True atau False.
    • System.Char: untuk mengonfigurasi properti profil .NET agar berisi Karakter Unicode.
    • System.DateTime: Untuk mengonfigurasi properti profil .NET agar berisi tanggal dan waktu dengan nilai yang berkisar antara 12:00:00 tengah malam, 1 Januari 0001 Anno Domini (A.D.) atau Common Era (C.E.) hingga 11:59:59 P.M., 31 Desember 9999 A.D. (C.E.)
    • System.Decimal: untuk mengonfigurasi properti profil .NET agar berisi angka desimal yang berkisar dari positif 79.228.162.514.264.337.593.543,950.335 menjadi negatif 79.228.162.514.264.337.593.543.950.335. Jenis nilai Desimal sesuai untuk perhitungan keuangan yang membutuhkan banyak digit integral dan pecahan yang signifikan dan tidak ada kesalahan round-off.
    • System.Double: Untuk mengonfigurasi properti profil .NET agar berisi angka 64-bit presisi ganda dengan nilai berkisar dari negatif 1,79769313486232e308 ke positif 1,79769313486232e308, serta nol positif atau negatif, PositiveInfinity, NegativeInfinity, dan Not-a-Number (NaN). Untuk informasi selengkapnya tentang Jenis nilai ganda , lihat Struktur Ganda.
    • System.Int32: untuk mengonfigurasi properti profil .NET agar berisi bilangan bulat bertanda tangan dengan nilai berkisar antara negatif 2.147.483.648 hingga positif 2.147.483.647.
    • System.Int64: untuk mengonfigurasi properti profil .NET agar berisi bilangan bulat dengan nilai berkisar dari negatif 9.223.372.036.854.775.808 hingga positif 9.223.372.036.854.775.807.
    • System.Single: Untuk mengonfigurasi properti profil .NET agar berisi angka 32-bit presisi tunggal dengan nilai yang berkisar dari negatif 3,402823e38 hingga positif 3,402823e38, serta nol positif atau negatif, PositiveInfinity, NegativeInfinity, dan Not-a-Number (NaN). Untuk informasi selengkapnya tentang Jenis nilai tunggal , lihat Struktur Tunggal.
    • System.String: Untuk mengonfigurasi properti profil .NET menjadi kumpulan berurutan struktur Char yang mewakili string teks. Setelah Ini adalah default.
  6. Dalam kotak teks Nilai default , ketik nilai yang akan diinisialisasi properti.

  7. Di bawah Opsi serialisasi, pilih salah satu pemformat serialisasi berikut ini:

    • String: Pilih opsi ini saat properti pengaturan diserialisasikan sebagai teks biasa. Setelah Ini adalah default.
    • XML: Pilih opsi ini untuk membuat serialisasi properti dan bidang publik saja. Serialisasi XML tidak mempertahankan keakuratan jenis. Opsi ini berguna ketika Anda ingin menyediakan atau menggunakan data tanpa membatasi aplikasi yang menggunakan data. Karena XML adalah standar terbuka, ini adalah pilihan yang menarik untuk berbagi data di Web.
    • Biner: Pilih opsi ini untuk mempertahankan keakuratan jenis. Serialisasi biner berguna untuk mempertahankan status objek di antara pemanggilan aplikasi yang berbeda. Misalnya, Anda dapat membagikan objek pada sejumlah aplikasi yang berbeda dengan membuat serial ke Clipboard. Anda dapat menserialisasikan objek ke aliran, ke disk, ke memori, melalui jaringan, dan sebagainya.
    • Penyedia Spesifik: Pilih opsi ini ketika penyedia pengaturan memiliki pengetahuan implisit tentang properti atau jenisnya dan dapat memilih mekanisme serialisasi yang sesuai. Opsi ini sering digunakan untuk serialisasi kustom.
  8. Centang kotak Baca saja untuk mengonfigurasi properti profil .NET sehingga tidak dapat dimodifikasi.

  9. Centang kotak Tersedia untuk pengguna anonim untuk membuat properti profil .NET tersedia untuk pengguna yang tidak diaauthenticated.

  10. Klik OK.

Untuk menambahkan properti profil .NET dengan menggunakan baris perintah

Untuk menambahkan properti .NET Profile, gunakan sintaks berikut:

appcmd set config /commit:MACHINE /section:profile /+"properties.[name='string', type='string', defaultValue='string', serializeAs='String|Xml|Binary|ProviderSpecific', readOnly='true|false', allowAnonymous='true|false']"

Variabel name='string' adalah nama properti profil. Variabelnya type='string' adalah jenis data. Variabel defaultValue='string' adalah nilai yang properti profilnya diinisialisasi. Variabel serializeAs='String|Xml|Binary|ProviderSpecific' mengatur pemformat serialisasi. Variabel readOnly=true mengonfigurasi properti profil .NET sehingga tidak dapat dimodifikasi. Nilai defaultnya adalah false. Variabel allowAnonymous=true membuat properti profil .NET tersedia untuk pengguna yang tidak diaauthenticated. Nilai defaultnya adalah false. Misalnya, untuk menentukan properti profil yang menyimpan kumpulan daftar pencarian terbaru, ketik berikut ini di prompt perintah, lalu tekan Enter:

appcmd set config /commit:MACHINE /section:profile /+"properties. [name='RecentSearchList', type='System.Collections.Specialized.StringCollection', serializeAs='Xml', allowAnonymous='true']"

Untuk menambahkan grup profil .NET dengan menggunakan UI

  1. Buka Manajer IIS dan navigasi ke tingkat yang ingin Anda kelola.
  2. Di Tampilan Fitur, klik dua kali Profil .NET.
  3. Di panel Tindakan , klik Tambahkan Grup.
  4. Dalam kotak dialog Tambahkan Grup , ketik nama untuk grup profil .NET di kotak teks Nama , lalu klik OK.

3.4. Peran .NET

Bagian ini menjelaskan cara menambahkan peran .NET dengan menggunakan UI Manajer IIS.

Untuk menambahkan peran .NET dengan menggunakan UI

  1. Buka Manajer IIS dan navigasi ke tingkat yang ingin Anda kelola.
  2. Di Tampilan Fitur, klik dua kali Peran .NET.
  3. Di panel Tindakan , klik Tambahkan.
  4. Dalam kotak dialog Tambahkan Peran .NET , ketik nama peran dalam kotak teks Nama , lalu klik OK.

3.5. Pengguna .NET

Bagian ini menjelaskan cara mengonfigurasi pengguna .NET dengan menggunakan UI Manajer IIS.

Dalam Merencanakan Situs Web ASP.NET di IIS, Anda membuat keputusan desain berikut untuk setiap pengguna yang ingin Anda tambahkan ke IIS:

  • Nama Pengguna
  • E-mail
  • Kata sandi
  • Pertanyaan
  • Jawaban
  • Peran atau peran

Untuk menambahkan pengguna .NET dengan menggunakan UI

  1. Buka Manajer IIS dan navigasi ke tingkat yang ingin Anda kelola.

  2. Di Tampilan Fitur, klik dua kali Pengguna .NET.

  3. Di panel Tindakan , klik Tambahkan.

  4. Dalam kotak dialog Detail Akun Pengguna .NET , masukkan informasi berikut ini:

    • Nama Pengguna (harus unik).
    • Email (harus menggunakan format standar: name@domain.com).
    • Kata sandi (harus kata sandi yang kuat).
    • Konfirmasi Kata Sandi (harus cocok dengan kata sandi).
    • Pertanyaan (masukkan pertanyaan kustom atau pilih dari daftar).
    • Jawab pertanyaannya.
  5. Klik Berikutnya untuk memilih peran untuk pengguna ini. Jika Anda belum mengaktifkan Peran .NET, klik Selesai.

  6. Dalam kotak dialog Peran Pengguna .NET , secara opsional pilih peran yang tersedia dari kotak Peran , lalu klik Selesai.