방법: PrincipalPermissionAttribute 클래스를 사용하여 액세스 제한

아티클
04/07/2023

Windows 도메인 컴퓨터의 리소스에 대한 액세스 제어는 기본적인 보안 작업입니다. 예를 들어, 특정 사용자만 급여 정보와 같은 민감한 데이터를 볼 수 있어야 합니다. 이 항목에서는 사용자가 미리 정의된 그룹에 속하도록 요청하여 메서드에 대한 액세스를 제한하는 방법을 설명합니다. 작업 샘플은 서비스 작업에 대한 액세스 권한 부여를 참조하세요.

작업은 두 가지 별도의 절차로 구성됩니다. 첫 번째는 그룹을 만들어 이 그룹을 사용자로 채웁니다. 두 번째는 그룹을 지정할 PrincipalPermissionAttribute 클래스를 적용합니다.

Windows 그룹을 만들려면

컴퓨터 관리 콘솔을 엽니다.
왼쪽 패널에서 로컬 사용자 및 그룹을 클릭합니다.
그룹을 마우스 오른쪽 단추로 클릭하고 새 그룹을 클릭합니다.
그룹 이름 상자에서 새 그룹의 이름을 입력합니다.
설명 상자에서 새 그룹에 대한 설명을 입력합니다.
추가 단추를 클릭하여 새 멤버를 그룹에 추가합니다.
사용자 자신을 그룹에 추가하고 다음 코드를 테스트하려면, 컴퓨터를 로그오프한 후 다시 로그온하여 그룹에 포함되어야 합니다.

사용자 멤버 자격을 요구하려면

구현된 서비스 계약 코드가 포함된 WCF(Windows Communication Foundation) 코드 파일을 엽니다. 계약 구현에 대한 자세한 내용은 서비스 계약 구현을 참조하세요.

PrincipalPermissionAttribute 특성을 특정 그룹에 대해 제한되어야 하는 각 메서드에 적용합니다. Action 속성을 Demand로 설정하고 Role 속성을 그룹 이름으로 설정합니다. 예시:

// Only members of the CalculatorClients group can call this method.
[PrincipalPermission(SecurityAction.Demand, Role = "CalculatorClients")]
public double Add(double a, double b)
{
    return a + b;
}

' Only members of the CalculatorClients group can call this method.
<PrincipalPermission(SecurityAction.Demand, Role:="CalculatorClients")> _
Public Function Add(ByVal a As Double, ByVal b As Double) As Double
    Return a + b
End Function

참고 항목

PrincipalPermissionAttribute 특성을 계약에 적용하면 SecurityException이 throw됩니다. 메서드 수준에서만 이 특성을 적용할 수 있습니다.

인증서를 사용하여 메서드에 대한 액세스 제어

또한 클라이언트 자격 증명 형식이 인증서인 경우 PrincipalPermissionAttribute 클래스를 사용하여 메서드에 대한 액세스를 제어할 수 있습니다. 이를 수행하려면 인증서의 주체 및 지문이 있어야 합니다.

인증서의 속성을 검사하려면 방법: MMC 스냅인으로 인증서 보기를 참조하세요. 지문 값을 찾으려면 방법: 인증서 지문 검색을 참조하세요.

인증서를 사용하여 액세스를 제어하려면

PrincipalPermissionAttribute 클래스를 액세스를 제한할 메서드에 적용합니다.
특성의 동작을 SecurityAction.Demand로 설정합니다.

Name 속성을 주체 이름 및 인증서 지문으로 구성된 문자열로 설정합니다. 다음 예제와 같이 두 개의 값을 세미콜론 및 공백으로 구분합니다.

// Only a client authenticated with a valid certificate that has the
// specified subject name and thumbprint can call this method.
[PrincipalPermission(SecurityAction.Demand,
    Name = "CN=ReplaceWithSubjectName; 123456712345677E8E230FDE624F841B1CE9D41E")]
public double Multiply(double a, double b)
{
    return a * b;
}

' Only a client authenticated with a valid certificate that has the 
' specified subject name and thumbprint can call this method.
<PrincipalPermission(SecurityAction.Demand, Name:="CN=ReplaceWithSubjectName; 123456712345677E8E230FDE624F841B1CE9D41E")> _
Public Function Multiply(ByVal a As Double, ByVal b As Double) As Double
    Return a * b
End Function

다음 구성 예제와 같이 PrincipalPermissionMode 속성을 UseAspNetRoles로 설정합니다.
```
<behaviors>  
  <serviceBehaviors>  
  <behavior name="SvcBehavior1">  
  <serviceAuthorization principalPermissionMode="UseAspNetRoles" />  
  </behavior>  
  </serviceBehaviors>  
</behaviors>  
```
이 값을 UseAspNetRoles로 설정하면 Name의 PrincipalPermissionAttribute 속성이 문자열 비교를 수행하는 데 사용됨을 나타냅니다. 인증서가 클라이언트 자격 증명으로 사용되는 경우 기본적으로 WCF는 인증서 일반 이름과 지문을 세미콜론으로 연결하여 클라이언트의 기본 ID에 대한 고유한 값을 만듭니다. UseAspNetRoles를 서비스의 PrincipalPermissionMode로 설정한 경우 이 기본 ID 값을 Name 속성 값과 비교하여 사용자의 액세스 권한을 결정합니다.

또는 자체 호스팅되는 서비스를 만드는 경우 코드의 PrincipalPermissionMode 속성을 다음 코드와 같이 설정합니다.
```
ServiceHost myServiceHost = new ServiceHost(typeof(Calculator), baseUri);
ServiceAuthorizationBehavior myServiceBehavior =
    myServiceHost.Description.Behaviors.Find<ServiceAuthorizationBehavior>();
myServiceBehavior.PrincipalPermissionMode =
    PrincipalPermissionMode.UseAspNetRoles;
```
```
Dim myServiceBehavior As ServiceAuthorizationBehavior
myServiceBehavior = _
   myServiceHost.Description.Behaviors.Find(Of ServiceAuthorizationBehavior)()
myServiceBehavior.PrincipalPermissionMode = _
   PrincipalPermissionMode.UseAspNetRoles
```

다음을 통해 공유