RequestSecurityToken 클래스

정의

public ref class RequestSecurityToken : System::IdentityModel::Protocols::WSTrust::WSTrustMessage

public class RequestSecurityToken : System.IdentityModel.Protocols.WSTrust.WSTrustMessage

type RequestSecurityToken = class
    inherit WSTrustMessage

Public Class RequestSecurityToken
Inherits WSTrustMessage

상속

Object

OpenObject

WSTrustMessage

RequestSecurityToken

예제

이 항목에서 사용되는 코드 예제는 샘플에서 Custom Token 가져옵니다. 이 샘플에서는 SWT(Simple Web Tokens)를 처리할 수 있는 사용자 지정 클래스를 제공하며 SWT 토큰을 제공할 수 있는 수동 STS의 구현을 포함합니다. STS는 에서 SecurityTokenService파생된 클래스에 의해 구현됩니다. 토큰 발급 파이프라인에서 호출되는 클래스의 SecurityTokenService 많은 메서드는 해당 매개 변수인 경우 개체를 RequestSecurityToken 하나로 사용합니다. WIF에 사용할 수 있는 이 샘플 및 기타 샘플 및 다운로드 위치에 대한 자세한 내용은 WIF 코드 샘플 인덱스(Sample Index)를 참조하세요.

다음 코드 예제에서는 메서드의 구현을 SecurityTokenService.GetScope 보여줍니다. 메서드는 매개 변수 중 하나로 사용하고 RequestSecurityToken 이 매개 변수의 속성은 메서드에서 반환되는 개체의 Scope 속성을 설정하는 데 사용됩니다.

// Certificate Constants
private const string SIGNING_CERTIFICATE_NAME = "CN=localhost";
private const string ENCRYPTING_CERTIFICATE_NAME = "CN=localhost";

private SigningCredentials _signingCreds;
private EncryptingCredentials _encryptingCreds;
// Used for validating applies to address, set to URI used in RP app of application, could also have been done via config
private string _addressExpected = "http://localhost:19851/";

/// <summary>
/// This method returns the configuration for the token issuance request. The configuration
/// is represented by the Scope class. In our case, we are only capable of issuing a token to a
/// single RP identity represented by the _encryptingCreds field.
/// </summary>
/// <param name="principal">The caller's principal</param>
/// <param name="request">The incoming RST</param>
/// <returns></returns>
protected override Scope GetScope(ClaimsPrincipal principal, RequestSecurityToken request)
{
    // Validate the AppliesTo address
    ValidateAppliesTo( request.AppliesTo );

    // Create the scope using the request AppliesTo address and the RP identity
    Scope scope = new Scope( request.AppliesTo.Uri.AbsoluteUri, _signingCreds );

    if (Uri.IsWellFormedUriString(request.ReplyTo, UriKind.Absolute))
    {
        if (request.AppliesTo.Uri.Host != new Uri(request.ReplyTo).Host)
            scope.ReplyToAddress = request.AppliesTo.Uri.AbsoluteUri;
        else
            scope.ReplyToAddress = request.ReplyTo;
    }
    else
    {
        Uri resultUri = null;
        if (Uri.TryCreate(request.AppliesTo.Uri, request.ReplyTo, out resultUri))
            scope.ReplyToAddress = resultUri.AbsoluteUri;
        else
            scope.ReplyToAddress = request.AppliesTo.Uri.ToString() ;
    }

    // Note: In this sample app only a single RP identity is shown, which is localhost, and the certificate of that RP is 
    // populated as _encryptingCreds
    // If you have multiple RPs for the STS you would select the certificate that is specific to 
    // the RP that requests the token and then use that for _encryptingCreds
    scope.EncryptingCredentials = _encryptingCreds;

    return scope;
}

/// <summary>
/// Validates the appliesTo and throws an exception if the appliesTo is null or appliesTo contains some unexpected address.
/// </summary>
/// <param name="appliesTo">The AppliesTo parameter in the request that came in (RST)</param>
/// <returns></returns>
void ValidateAppliesTo(EndpointReference appliesTo)
{
    if (appliesTo == null)
    {
        throw new InvalidRequestException("The appliesTo is null.");
    }

    if (!appliesTo.Uri.Equals(new Uri(_addressExpected)))
    {
        throw new InvalidRequestException(String.Format("The relying party address is not valid. Expected value is {0}, the actual value is {1}.", _addressExpected, appliesTo.Uri.AbsoluteUri));
    }
}

설명

wst:RequestSecurityToken 요소(메시지)에는 STS(보안 토큰 서비스)에서 보안 토큰을 요청하는 데 사용되는 매개 변수 및 속성이 포함됩니다. 메시지(또는 요소)는 RST로 축약됩니다. 클래스에는 RequestSecurityToken RST의 요소를 나타내는 속성이 포함되어 있습니다. RST는 WS-Trust에서 정의한 요청 바인딩에 해당하는 요청을 구성할 수 있습니다. 예를 들어 발급 바인딩, 갱신 바인딩, 유효성 검사 바인딩 또는 취소 바인딩입니다. 클래스의 많은 속성 RequestSecurityToken 은 이러한 바인딩에 정의된 특정 종류의 요청에만 존재하는 요소에 해당합니다. 특정 RequestSecurityToken 개체가 나타내는 요청의 종류 또는 개체가 나타내는 특정 요청에 있는 매개 변수에 따라 개체의 일부 속성이 될 null수 있습니다.

STS는 wst:RequestSecurityTokenResponse 요소(RSTR)를 포함하는 메시지의 요청에 대한 응답을 반환합니다. 이 메시지는 클래스로 RequestSecurityTokenResponse 표시됩니다.

이 클래스가 나타내는 요소에 대한 자세한 내용은 시나리오에 적용되는 WS-Trust 사양( WS-Trust 2005년 2월, WS-Trust 1.3 또는 WS-Trust 1.4)을 참조하세요.

추가 정보

• SecurityTokenService
• RequestedSecurityToken
• RequestSecurityTokenResponse