SignInRequestMessage Klasse

Referenz

Definition

Namespace:: System.IdentityModel.Services

Assembly:: System.IdentityModel.Services.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Stellt eine WS-Verbund-Anmeldungs-Anforderungsnachricht dar.

public ref class SignInRequestMessage : System::IdentityModel::Services::WSFederationMessage

public class SignInRequestMessage : System.IdentityModel.Services.WSFederationMessage

type SignInRequestMessage = class
    inherit WSFederationMessage

Public Class SignInRequestMessage
Inherits WSFederationMessage

Vererbung: Object

FederationMessage

WSFederationMessage
SignInRequestMessage

Beispiele

string identityProviderUri = Request.QueryString["whr"];
string action = Request.QueryString["wa"];

SignInRequestMessage signInRequest = FederatedAuthentication.WSFederationAuthenticationModule.CreateSignInRequest(Guid.NewGuid().ToString(), 
                                                                                                                  "http://MyAppreturnUrl", 
                                                                                                                  false);
signInRequest.Realm = "htp://MyApp.com";
signInRequest.HomeRealm = identityProviderUri;

Response.Redirect(signInRequest.RequestUrl);

Hinweise

Eine WS-Federation Anmeldenachricht wird von einer vertrauenden Seite (RP) an einen Sicherheitstokendienst (SECURITY Token Service, STS) gesendet, um ein Sicherheitstoken anzufordern. Der wa-Parameter muss auf "wsignout1.0" festgelegt werden, und der wtrealm-Parameter sollte auf den Sicherheitsbereich der angeforderten Ressource festgelegt werden (dies ist häufig die URL der angeforderten Ressource). In der Anforderung können auch andere optionale Parameter angegeben werden.

Eine SignOutRequestMessage Nachricht wird von den statischen Methoden der SignOutRequestMessage -Klasse erstellt, z. B. der CreateFromUri -Methode, wenn der wa-Parameter auf "wsignin1.0" festgelegt ist, kein wresult- oder wresultptr-Parameter vorhanden ist und entweder ein wtrealm-Parameter oder ein wreply-Parameter vorhanden ist.

Wichtig

Aus Gründen der Abwärtskompatibilität mit Active Directory-Verbunddienste (AD FS) Version 1.0 (AD FS) ermöglicht Windows Identity Foundation (WIF) entweder das Festlegen des wtrealm-Parameters oder des wreply-Parameters (oder beides), damit eine Anmeldenachricht gültig ist. Das WS-Federation-Protokoll erfordert jedoch, dass der wtrealm-Parameter in einer Anmeldeanforderung vorhanden ist. In den meisten Szenarien sollten Sie sicherstellen, dass der wtrealm-Parameter angegeben ist.

Die SignInRequestMessage -Klasse macht mehrere Eigenschaften verfügbar, die zum Festlegen oder Zugreifen auf einzelne Nachrichtenparameter verwendet werden können. Auf diese Parameter kann auch über das Parameters Wörterbuch zugegriffen werden. Beispielsweise können Sie den wtrealm-Parameter in der Nachricht entweder über die Realm -Eigenschaft oder durch Angabe von "wtrealm" als Schlüssel für das Parameters Wörterbuch lesen.

Weitere Informationen zu der Nachricht, die diese Klasse darstellt, finden Sie im Abschnitt 13 der folgenden Spezifikation: Web Services Federation Language (WS-Federation) Version 1.2.

Konstruktoren

SignInRequestMessage(Uri, String)	Initialisiert eine neue Instanz der SignInRequestMessage-Klasse mit der angegebenen Basis-URI und wtrealm-Parameter.
SignInRequestMessage(Uri, String, String)	Initialisiert eine neue Instanz der SignInRequestMessage-Klasse unter Verwendung des angegebenen Basis-URI, wtrealm-Parameters und wreplyParameters. Unterstützt die nicht standardmäßige Nachrichtenerstellung für Abwärtskompatibilität.

Eigenschaften

Action	Übernimmt oder bestimmt den wa-Parameter der Nachricht. (Geerbt von WSFederationMessage)
AuthenticationType	Übernimmt oder bestimmt den wauth-Parameter der Nachricht.
BaseUri	Ruft die Basis-URL ab, für die die Meldung gilt, oder legt diesen fest. (Geerbt von FederationMessage)
Context	Übernimmt oder bestimmt den wctx-Parameter der Nachricht. (Geerbt von WSFederationMessage)
CurrentTime	Übernimmt oder bestimmt den wct-Parameter der Nachricht.
Encoding	Ruft den wencoding-Parameter der Nachricht ab, bzw. legt ihn fest. (Geerbt von WSFederationMessage)
Federation	Übernimmt oder bestimmt den wfed-Parameter der Nachricht.
Freshness	Übernimmt oder bestimmt den wfresh-Parameter der Nachricht.
HomeRealm	Übernimmt oder bestimmt den whr-Parameter der Nachricht.
Parameters	Ruft die Meldungsparameter als Wörterbuch ab. (Geerbt von FederationMessage)
Policy	Übernimmt oder bestimmt den wp-Parameter der Nachricht.
Realm	Übernimmt oder bestimmt den wtrealm-Parameter der Nachricht.
Reply	Übernimmt oder bestimmt den wreply-Parameter der Nachricht.
Request	Übernimmt oder bestimmt den wreq-Parameter der Nachricht.
RequestPtr	Übernimmt oder bestimmt den wreqptr-Parameter der Nachricht.
RequestUrl	Ruft eine Zeichenfolgendarstellung der URL ab, die dieser Nachricht zugeordnet ist.
Resource	Übernimmt oder bestimmt den wres-Parameter der Nachricht.

Methoden

Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetParameter(String)	Gibt den angegebenen Parameterwert aus dem Parameterwörterbuch zurück. (Geerbt von FederationMessage)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
RemoveParameter(String)	Entfernt einen Parameter aus dem Parameterwörterbuch. (Geerbt von FederationMessage)
SetParameter(String, String)	Legt den Wert eines Parameters im Wörterbuch für Parameter fest. (Geerbt von FederationMessage)
SetUriParameter(String, String)	Legt den Wert eines Parameters im Wörterbuch für Parameter fest. Der Wert muss ein absoluter URI sein. (Geerbt von FederationMessage)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)
Validate()	Überprüft die aktuelle Instanz.
Write(TextWriter)	Schreibt diese Nachricht in der Form für Abfragezeichenfolgen in den angegebenen Textwriter.
WriteFormPost()	Serialisiert die Nachricht als eine Formularbereitstellung und gibt das resultierende Formular zusammen mit seinem JavaScript als Zeichenfolge zurück. (Geerbt von FederationMessage)
WriteQueryString()	Gibt eine Zeichenfolgendarstellung der Meldung im Abfragezeichenfolgenformat zurück. (Geerbt von FederationMessage)

Gilt für:

Weitere Informationen

SignInResponseMessage

Freigeben über