FormsAuthenticationConfiguration Kelas
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Mengonfigurasi aplikasi ASP.NET untuk menggunakan AuthenticationMode modalitas formulir.
public ref class FormsAuthenticationConfiguration sealed : System::Configuration::ConfigurationElement
public sealed class FormsAuthenticationConfiguration : System.Configuration.ConfigurationElement
type FormsAuthenticationConfiguration = class
inherit ConfigurationElement
Public NotInheritable Class FormsAuthenticationConfiguration
Inherits ConfigurationElement
- Warisan
Contoh
Contoh kode berikut menunjukkan cara mendapatkan FormsAuthenticationConfiguration objek dari file konfigurasi aplikasi Web yang ada. Anda dapat menggunakan objek ini untuk mengakses anggotanya. File konfigurasi akan berisi penyiapan yang mirip dengan yang berikut ini.
Catatan Jika Anda menggunakan bagian tersebut credentials
, pastikan untuk mengikuti panduan yang dijelaskan di Autentikasi ASP.NET. Untuk skalabilitas dan keamanan yang lebih baik, disarankan agar Anda menggunakan database eksternal untuk menyimpan kredensial pengguna. Untuk informasi selengkapnya tentang membangun aplikasi ASP.NET yang aman, lihat Mengamankan Aplikasi ASP.NET Anda dan Membangun Aplikasi ASP.NET Aman: Autentikasi, Otorisasi, dan Komunikasi Aman.
Contoh ini menggunakan SHA1. Karena masalah tabrakan dengan SHA1, Microsoft merekomendasikan SHA256.
<authentication mode="Forms">
<forms name="MyAppCookie" loginUrl="login.aspx"
defaultUrl="default.aspx"
protection="Encryption" timeout="5" path="aspnetTest"
slidingExpiration="false"
cookieless="UseCookies" domain="domainName">
<credentials passwordFormat="SHA1">
<user name="aspnetuser1"
password="5BAA61E4C9B93F3F0682250B6CF8331B7EE68FD8"/>
<user name="aspnetuser2"
password="E38AD214943DAAD1D64C102FAEC29DE4AFE9DA3D"/>
</credentials>
</forms>
</authentication>
// Get the Web application configuration.
System.Configuration.Configuration configuration =
WebConfigurationManager.OpenWebConfiguration("/aspnetTest");
// Get the external Authentication section.
AuthenticationSection authenticationSection =
(AuthenticationSection)configuration.GetSection(
"system.web/authentication");
// Get the external Forms section .
FormsAuthenticationConfiguration formsAuthentication =
authenticationSection.Forms;
' Get the Web application configuration.
Dim configuration As System.Configuration.Configuration = _
WebConfigurationManager.OpenWebConfiguration( _
"/aspnetTest")
' Get the external Authentication section.
Dim authenticationSection _
As AuthenticationSection = _
CType(configuration.GetSection( _
"system.web/authentication"), AuthenticationSection)
' Get the external Forms section .
Dim formsAuthentication _
As FormsAuthenticationConfiguration = _
authenticationSection.Forms
Keterangan
Kelas ini FormsAuthenticationConfiguration menyediakan cara untuk mengakses dan memodifikasi forms
elemen bagian konfigurasi authentication
secara terprogram.
Jenis ini adalah bagian dari grup yang mencakup FormsAuthenticationCredentials, FormsAuthenticationUserCollection, dan jenisnya FormsAuthenticationUser . Jenis selain jenis koleksi secara langsung memengaruhi tag konfigurasi yang mendasar.
Catatan
FormsAuthenticationConfiguration dapat menulis informasi ke bagian terkait dari file konfigurasi sesuai dengan batasan yang ditentukan oleh properti AllowDefinition bagian yang nilainya adalah MachineToApplication. Setiap upaya untuk menulis dalam file konfigurasi pada tingkat yang tidak diizinkan dalam hierarki akan mengakibatkan pesan kesalahan yang dihasilkan oleh pengurai. Namun, Anda dapat menggunakan kelas ini untuk membaca informasi konfigurasi di tingkat mana pun dalam hierarki. Untuk keamanan dan skalabilitas, disarankan agar Anda menggunakan repositori eksternal, seperti database, untuk menyimpan kredensial pengguna.
Konstruktor
FormsAuthenticationConfiguration() |
Menginisialisasi instans baru kelas FormsAuthenticationConfiguration. |
Properti
Cookieless |
Mendapatkan atau menetapkan nilai yang menunjukkan apakah autentikasi berbasis formulir harus menggunakan cookie. |
CookieSameSite |
Mendapatkan atau menetapkan nilai untuk atribut SameSite cookie. |
Credentials |
FormsAuthenticationCredentials Mendapatkan kumpulan nama pengguna dan kata sandi. |
CurrentConfiguration |
Mendapatkan referensi ke instans tingkat Configuration atas yang mewakili hierarki konfigurasi tempat instans saat ini ConfigurationElement berada. (Diperoleh dari ConfigurationElement) |
DefaultUrl |
Mendapatkan atau mengatur URL default. |
Domain |
Mendapatkan atau mengatur nama domain yang akan dikirim dengan cookie autentikasi formulir. |
ElementInformation |
ElementInformation Mendapatkan objek yang berisi informasi dan fungsionalitas ConfigurationElement objek yang tidak dapat disesuaikan. (Diperoleh dari ConfigurationElement) |
ElementProperty |
ConfigurationElementProperty Mendapatkan objek yang mewakili objek itu ConfigurationElement sendiri. (Diperoleh dari ConfigurationElement) |
EnableCrossAppRedirects |
Mendapatkan atau menetapkan nilai yang menunjukkan apakah pengguna yang diautentikasi dapat dialihkan ke URL di aplikasi lain. |
EvaluationContext |
ContextInformation Mendapatkan objek untuk ConfigurationElement objek . (Diperoleh dari ConfigurationElement) |
HasContext |
Mendapatkan nilai yang menunjukkan apakah CurrentConfiguration properti adalah |
Item[ConfigurationProperty] |
Mendapatkan atau mengatur properti atau atribut elemen konfigurasi ini. (Diperoleh dari ConfigurationElement) |
Item[String] |
Mendapatkan atau mengatur properti, atribut, atau elemen turunan dari elemen konfigurasi ini. (Diperoleh dari ConfigurationElement) |
LockAllAttributesExcept |
Mendapatkan koleksi atribut terkunci. (Diperoleh dari ConfigurationElement) |
LockAllElementsExcept |
Mendapatkan koleksi elemen terkunci. (Diperoleh dari ConfigurationElement) |
LockAttributes |
Mendapatkan koleksi atribut terkunci. (Diperoleh dari ConfigurationElement) |
LockElements |
Mendapatkan koleksi elemen terkunci. (Diperoleh dari ConfigurationElement) |
LockItem |
Mendapatkan atau menetapkan nilai yang menunjukkan apakah elemen dikunci. (Diperoleh dari ConfigurationElement) |
LoginUrl |
Mendapatkan atau mengatur URL pengalihan untuk permintaan tersebut. |
Name |
Mendapatkan atau mengatur nama cookie. |
Path |
Mendapatkan atau mengatur jalur cookie. |
Properties |
Mendapatkan koleksi properti. (Diperoleh dari ConfigurationElement) |
Protection |
Mendapatkan atau mengatur jenis enkripsi yang digunakan untuk mengenkripsi cookie. |
RequireSSL |
Mendapatkan atau menetapkan nilai yang menunjukkan apakah koneksi Secure Sockets Layer (SSL) diperlukan saat mengirimkan informasi autentikasi. |
SlidingExpiration |
Mendapatkan atau mengatur kedaluwarsa geser autentikasi. |
TicketCompatibilityMode |
Mendapatkan atau menetapkan nilai yang menunjukkan apakah akan menggunakan Waktu Universal Terkoordinasi (UTC) atau waktu setempat untuk tanggal kedaluwarsa tiket. |
Timeout |
Mendapatkan atau mengatur waktu habis autentikasi. |
Metode
DeserializeElement(XmlReader, Boolean) |
Membaca XML dari file konfigurasi. (Diperoleh dari ConfigurationElement) |
Equals(Object) |
Membandingkan instans saat ini ConfigurationElement dengan objek yang ditentukan. (Diperoleh dari ConfigurationElement) |
GetHashCode() |
Mendapatkan nilai unik yang mewakili instans saat ini ConfigurationElement . (Diperoleh dari ConfigurationElement) |
GetTransformedAssemblyString(String) |
Mengembalikan versi yang ditransformasi dari nama rakitan yang ditentukan. (Diperoleh dari ConfigurationElement) |
GetTransformedTypeString(String) |
Mengembalikan versi yang ditransformasi dari nama jenis yang ditentukan. (Diperoleh dari ConfigurationElement) |
GetType() |
Mendapatkan instans Type saat ini. (Diperoleh dari Object) |
Init() |
Mengatur objek ke ConfigurationElement status awalnya. (Diperoleh dari ConfigurationElement) |
InitializeDefault() |
Digunakan untuk menginisialisasi sekumpulan nilai default untuk ConfigurationElement objek. (Diperoleh dari ConfigurationElement) |
IsModified() |
Menunjukkan apakah elemen konfigurasi ini telah dimodifikasi sejak terakhir disimpan atau dimuat, ketika diimplementasikan di kelas turunan. (Diperoleh dari ConfigurationElement) |
IsReadOnly() |
Mendapatkan nilai yang menunjukkan apakah ConfigurationElement objek bersifat baca-saja. (Diperoleh dari ConfigurationElement) |
ListErrors(IList) |
Menambahkan kesalahan properti yang tidak valid dalam objek ini ConfigurationElement , dan di semua subelemen, ke daftar yang diteruskan. (Diperoleh dari ConfigurationElement) |
MemberwiseClone() |
Membuat salinan dangkal dari yang saat ini Object. (Diperoleh dari Object) |
OnDeserializeUnrecognizedAttribute(String, String) |
Mendapatkan nilai yang menunjukkan apakah atribut yang tidak diketahui ditemui selama deserialisasi. (Diperoleh dari ConfigurationElement) |
OnDeserializeUnrecognizedElement(String, XmlReader) |
Mendapatkan nilai yang menunjukkan apakah elemen yang tidak diketahui ditemui selama deserialisasi. (Diperoleh dari ConfigurationElement) |
OnRequiredPropertyNotFound(String) |
Memberikan pengecualian ketika properti yang diperlukan tidak ditemukan. (Diperoleh dari ConfigurationElement) |
PostDeserialize() |
Dipanggil setelah deserialisasi. (Diperoleh dari ConfigurationElement) |
PreSerialize(XmlWriter) |
Dipanggil sebelum serialisasi. (Diperoleh dari ConfigurationElement) |
Reset(ConfigurationElement) |
Mereset status ConfigurationElement internal objek, termasuk kunci dan koleksi properti. (Diperoleh dari ConfigurationElement) |
ResetModified() |
Mengatur ulang nilai metode ke IsModified() |
SerializeElement(XmlWriter, Boolean) |
Menulis konten elemen konfigurasi ini ke file konfigurasi saat diimplementasikan di kelas turunan. (Diperoleh dari ConfigurationElement) |
SerializeToXmlElement(XmlWriter, String) |
Menulis tag luar elemen konfigurasi ini ke file konfigurasi saat diimplementasikan di kelas turunan. (Diperoleh dari ConfigurationElement) |
SetPropertyValue(ConfigurationProperty, Object, Boolean) |
Mengatur properti ke nilai yang ditentukan. (Diperoleh dari ConfigurationElement) |
SetReadOnly() |
IsReadOnly() Mengatur properti untuk ConfigurationElement objek dan semua sublemen. (Diperoleh dari ConfigurationElement) |
ToString() |
Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object) |
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode) |
Memodifikasi ConfigurationElement objek untuk menghapus semua nilai yang tidak boleh disimpan. (Diperoleh dari ConfigurationElement) |