WSFederationAuthenticationModule.Realm プロパティ

定義

名前空間:

System.IdentityModel.Services

アセンブリ:

System.IdentityModel.Services.dll

WS-Federation サインイン要求 ("wsignin1.0") に使用する wtrealm パラメーターの値を取得または設定します。

public:
 property System::String ^ Realm { System::String ^ get(); void set(System::String ^ value); };

public string Realm { get; set; }

member this.Realm : string with get, set

Public Property Realm As String

プロパティ値

String

証明書利用者 (RP) をセキュリティ トークン サービス (STS) に識別する URI。

例外

ArgumentException

プロパティを null に設定しようとすると、空の文字列が発生します。

-又は-

有効な絶対 URI ではない値にプロパティを設定しようとしました。

注釈

これは、WS-Federation サインイン要求に必要なプロパティです。 パッシブ リダイレクトが有効になっている場合は、設定する必要があります。 URI は、STS への RP を識別します。 (RP への STS の識別については、 Issuer プロパティを参照してください)。

このプロパティの値は、WS-Federation プロトコルの wtrealm クエリ文字列パラメーターとしてシリアル化されます。 STS への RP を識別します。 STS は、トークン発行に適用するポリシーと、トークン発行後にユーザーをリダイレクトする場所を決定するために使用されます。 (RP への STS の識別については、 Issuerを参照してください)。

RedirectingToIdentityProvider イベントのハンドラーを追加することで、各 HTTP 要求でこの設定をオーバーライドできます。 このイベントは、モジュールが WS-Federation サインイン要求メッセージを使用してセキュリティ トークン サービス (STS) にリダイレクトする直前に発生します。 STS は、 Issuer プロパティによって指定されます。