FormsAuthenticationConfiguration Klasa
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Konfiguruje aplikację ASP.NET do używania AuthenticationMode modalności formularzy.
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
- Dziedziczenie
Przykłady
Poniższy przykład kodu pokazuje, jak uzyskać FormsAuthenticationConfiguration obiekt z pliku konfiguracji istniejącej aplikacji internetowej. Tego obiektu można użyć do uzyskiwania dostępu do jego elementów członkowskich. Plik konfiguracji będzie zawierać konfigurację podobną do poniższej.
Uwaga Jeśli używasz credentials
tej sekcji, postępuj zgodnie z wytycznymi opisanymi w artykule ASP.NET Authentication (Uwierzytelnianie). W celu zapewnienia skalowalności i lepszych zabezpieczeń zaleca się przechowywanie poświadczeń użytkowników przy użyciu zewnętrznej bazy danych. Aby uzyskać więcej informacji na temat tworzenia bezpiecznych aplikacji ASP.NET, zobacz Zabezpieczanie aplikacji ASP.NET i Tworzenie bezpiecznych aplikacji ASP.NET: Uwierzytelnianie, autoryzacja i bezpieczna komunikacja.
W tym przykładzie użyto algorytmu SHA1. Ze względu na problemy z kolizją z sha1 firma Microsoft zaleca 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
Uwagi
Klasa FormsAuthenticationConfiguration zapewnia sposób programowego uzyskiwania dostępu i modyfikowania forms
elementu sekcji konfiguracji authentication
.
Ten typ jest częścią grupy, która zawiera FormsAuthenticationCredentialstypy , FormsAuthenticationUserCollectioni FormsAuthenticationUser . Typy inne niż typ kolekcji mają bezpośredni wpływ na bazowe tagi konfiguracji.
Uwaga
Plik FormsAuthenticationConfiguration konfiguracji może zapisywać informacje w powiązanej sekcji pliku konfiguracji zgodnie z ograniczeniami zdefiniowanymi przez właściwość AllowDefinition sekcji, której wartość to MachineToApplication. Każda próba zapisania w pliku konfiguracji na poziomie niedozwolonym w hierarchii spowoduje wyświetlenie komunikatu o błędzie wygenerowanego przez analizator. Można jednak użyć tej klasy do odczytywania informacji o konfiguracji na dowolnym poziomie w hierarchii. W celu zapewnienia bezpieczeństwa i skalowalności zaleca się używanie zewnętrznego repozytorium, takiego jak baza danych, w celu zachowania poświadczeń użytkowników.
Konstruktory
FormsAuthenticationConfiguration() |
Inicjuje nowe wystąpienie klasy FormsAuthenticationConfiguration. |
Właściwości
Cookieless |
Pobiera lub ustawia wartość wskazującą, czy uwierzytelnianie oparte na formularzach powinno używać plików cookie. |
CookieSameSite |
Pobiera lub ustawia wartość atrybutu SameSite pliku cookie. |
Credentials |
FormsAuthenticationCredentials Pobiera kolekcję nazw użytkowników i haseł. |
CurrentConfiguration |
Pobiera odwołanie do wystąpienia najwyższego poziomu Configuration , które reprezentuje hierarchię konfiguracji, do którego należy bieżące ConfigurationElement wystąpienie. (Odziedziczone po ConfigurationElement) |
DefaultUrl |
Pobiera lub ustawia domyślny adres URL. |
Domain |
Pobiera lub ustawia nazwę domeny do wysłania przy użyciu plików cookie uwierzytelniania formularzy. |
ElementInformation |
ElementInformation Pobiera obiekt, który zawiera niezstosowalne informacje i funkcje ConfigurationElement obiektu. (Odziedziczone po ConfigurationElement) |
ElementProperty |
ConfigurationElementProperty Pobiera obiekt reprezentujący ConfigurationElement sam obiekt. (Odziedziczone po ConfigurationElement) |
EnableCrossAppRedirects |
Pobiera lub ustawia wartość wskazującą, czy uwierzytelnieni użytkownicy mogą być przekierowywani do adresów URL w innych aplikacjach. |
EvaluationContext |
ContextInformation Pobiera obiekt dla ConfigurationElement obiektu. (Odziedziczone po ConfigurationElement) |
HasContext |
Pobiera wartość wskazującą, czy CurrentConfiguration właściwość to |
Item[ConfigurationProperty] |
Pobiera lub ustawia właściwość lub atrybut tego elementu konfiguracji. (Odziedziczone po ConfigurationElement) |
Item[String] |
Pobiera lub ustawia właściwość, atrybut lub element podrzędny tego elementu konfiguracji. (Odziedziczone po ConfigurationElement) |
LockAllAttributesExcept |
Pobiera kolekcję zablokowanych atrybutów. (Odziedziczone po ConfigurationElement) |
LockAllElementsExcept |
Pobiera kolekcję zablokowanych elementów. (Odziedziczone po ConfigurationElement) |
LockAttributes |
Pobiera kolekcję zablokowanych atrybutów. (Odziedziczone po ConfigurationElement) |
LockElements |
Pobiera kolekcję zablokowanych elementów. (Odziedziczone po ConfigurationElement) |
LockItem |
Pobiera lub ustawia wartość wskazującą, czy element jest zablokowany. (Odziedziczone po ConfigurationElement) |
LoginUrl |
Pobiera lub ustawia adres URL przekierowania dla żądania. |
Name |
Pobiera lub ustawia nazwę pliku cookie. |
Path |
Pobiera lub ustawia ścieżkę pliku cookie. |
Properties |
Pobiera kolekcję właściwości. (Odziedziczone po ConfigurationElement) |
Protection |
Pobiera lub ustawia typ szyfrowania używany do szyfrowania pliku cookie. |
RequireSSL |
Pobiera lub ustawia wartość wskazującą, czy podczas przesyłania informacji uwierzytelniania wymagane jest połączenie secure Sockets Layer (SSL). |
SlidingExpiration |
Pobiera lub ustawia przesuwane wygaśnięcie uwierzytelniania. |
TicketCompatibilityMode |
Pobiera lub ustawia wartość wskazującą, czy należy używać uniwersalnego czasu koordynowanego (UTC) lub czasu lokalnego dla daty wygaśnięcia biletu. |
Timeout |
Pobiera lub ustawia limit czasu uwierzytelniania. |
Metody
DeserializeElement(XmlReader, Boolean) |
Odczytuje kod XML z pliku konfiguracji. (Odziedziczone po ConfigurationElement) |
Equals(Object) |
Porównuje bieżące ConfigurationElement wystąpienie z określonym obiektem. (Odziedziczone po ConfigurationElement) |
GetHashCode() |
Pobiera unikatową wartość reprezentującą bieżące ConfigurationElement wystąpienie. (Odziedziczone po ConfigurationElement) |
GetTransformedAssemblyString(String) |
Zwraca przekształconą wersję określonej nazwy zestawu. (Odziedziczone po ConfigurationElement) |
GetTransformedTypeString(String) |
Zwraca przekształconą wersję określonej nazwy typu. (Odziedziczone po ConfigurationElement) |
GetType() |
Type Pobiera bieżące wystąpienie. (Odziedziczone po Object) |
Init() |
ConfigurationElement Ustawia obiekt na stan początkowy. (Odziedziczone po ConfigurationElement) |
InitializeDefault() |
Służy do inicjowania domyślnego zestawu wartości dla ConfigurationElement obiektu. (Odziedziczone po ConfigurationElement) |
IsModified() |
Wskazuje, czy ten element konfiguracji został zmodyfikowany od czasu ostatniego zapisania lub załadowania, gdy został zaimplementowany w klasie pochodnej. (Odziedziczone po ConfigurationElement) |
IsReadOnly() |
Pobiera wartość wskazującą, czy ConfigurationElement obiekt jest tylko do odczytu. (Odziedziczone po ConfigurationElement) |
ListErrors(IList) |
Dodaje błędy nieprawidłowej właściwości w tym ConfigurationElement obiekcie i we wszystkich podelementach do przekazanej listy. (Odziedziczone po ConfigurationElement) |
MemberwiseClone() |
Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object) |
OnDeserializeUnrecognizedAttribute(String, String) |
Pobiera wartość wskazującą, czy podczas deserializacji napotkano nieznany atrybut. (Odziedziczone po ConfigurationElement) |
OnDeserializeUnrecognizedElement(String, XmlReader) |
Pobiera wartość wskazującą, czy podczas deserializacji napotkano nieznany element. (Odziedziczone po ConfigurationElement) |
OnRequiredPropertyNotFound(String) |
Zgłasza wyjątek, gdy nie znaleziono wymaganej właściwości. (Odziedziczone po ConfigurationElement) |
PostDeserialize() |
Wywoływana po deserializacji. (Odziedziczone po ConfigurationElement) |
PreSerialize(XmlWriter) |
Wywoływane przed serializacji. (Odziedziczone po ConfigurationElement) |
Reset(ConfigurationElement) |
Resetuje stan ConfigurationElement wewnętrzny obiektu, w tym blokady i kolekcje właściwości. (Odziedziczone po ConfigurationElement) |
ResetModified() |
Resetuje wartość IsModified() metody w |
SerializeElement(XmlWriter, Boolean) |
Zapisuje zawartość tego elementu konfiguracji do pliku konfiguracji po zaimplementowaniu w klasie pochodnej. (Odziedziczone po ConfigurationElement) |
SerializeToXmlElement(XmlWriter, String) |
Zapisuje zewnętrzne tagi tego elementu konfiguracji do pliku konfiguracji po zaimplementowaniu w klasie pochodnej. (Odziedziczone po ConfigurationElement) |
SetPropertyValue(ConfigurationProperty, Object, Boolean) |
Ustawia właściwość na określoną wartość. (Odziedziczone po ConfigurationElement) |
SetReadOnly() |
IsReadOnly() Ustawia właściwość obiektu ConfigurationElement i wszystkich podelementów. (Odziedziczone po ConfigurationElement) |
ToString() |
Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object) |
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode) |
Modyfikuje obiekt, ConfigurationElement aby usunąć wszystkie wartości, które nie powinny być zapisywane. (Odziedziczone po ConfigurationElement) |