SignInRequestMessage Klasse
Definition
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
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) |