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

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

例外

ArgumentException

プロパティを null または空の文字列に設定しようとしました。

- または -

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

注釈

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

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

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