클라이언트에 보안 설정
WCF(Windows Communication Foundation)에서 서비스가 클라이언트에 대한 보안 요구 사항을 지시합니다. 즉, 서비스는 사용할 보안 모드 및 클라이언트가 자격 증명을 제공해야 하는지 여부를 지정합니다. 따라서 클라이언트 보안 설정 프로세스는 간단합니다. 서비스에서 가져온 메타데이터를 사용하여(게시된 경우) 클라이언트를 빌드하면 됩니다. 메타데이터는 클라이언트를 구성하는 방법을 지정합니다. 서비스에서 클라이언트가 자격 증명을 제공해야 하는 경우 요구 사항에 맞는 자격 증명을 가져와야 합니다. 이 항목에서는 프로세스에 대해 자세하게 설명합니다. 보안 서비스 만들기에 대한 자세한 내용은 서비스에 보안 설정을 참조하십시오.
기본적으로 WCF 바인딩에는 보안 기능이 활성화되어 있습니다. BasicHttpBinding은 예외입니다. 따라서 WCF를 사용하여 서비스를 만든 경우 인증, 기밀성 및 무결성을 보장하도록 보안을 구현할 가능성이 높습니다. 이러한 경우 서비스가 제공하는 메타데이터는 보안 통신 채널을 설정하는 데 필요한 사항을 표시합니다. 서비스 메타데이터에 보안 요구 사항이 없는 경우 서비스에 SSL(Secure Sockets Layer) over HTTP와 같은 보안 스키마를 적용할 수 없습니다. 그러나 서비스에서 클라이언트가 자격 증명을 제공해야 하는 경우 클라이언트 개발자, 배포자 또는 관리자는 클라이언트가 서비스에게 자신을 인증하는 데 사용할 실제 자격 증명을 제공해야 합니다.
클라이언트를 만들 때 첫 번째 단계는 클라이언트가 통신할 서비스에 대한 메타데이터를 가져오는 것입니다. 이 작업은 다음 두 가지 방법으로 수행할 수 있습니다. 첫째로 서비스가 MEX(메타데이터 교환) 끝점을 게시하거나 HTTP 또는 HTTPS를 통해 메타데이터를 사용할 수 있도록 하는 경우 ServiceModel Metadata Utility Tool (Svcutil.exe)를 사용하여 메타데이터를 다운로드할 수 있으며, 이를 통해 구성 파일 뿐만 아니라 클라이언트에 대한 코드 파일을 모두 만듭니다. (도구 사용에 대한 자세한 내용은 WCF 클라이언트를 사용하여 서비스 액세스을(를) 참조하십시오. 서비스가 MEX 끝점을 게시하지 않고 또한 HTTP 또는 HTTPS를 통해 메타데이터를 사용할 수 있도록 하지 않은 경우, 보안 요구 사항 및 메타데이터를 설명하는 설명서에 대한 서비스 작성자에게 문의해야 합니다.
참고
메타데이터는 신뢰할 수 있는 소스에서 가져오고 변경하지 않는 것이 좋습니다. HTTP 프로토콜을 사용하여 검색한 메타데이터는 일반 텍스트로 전송되며 변경할 수 있습니다. 서비스가 HttpsGetEnabled 및 HttpsGetUrl 속성을 사용하는 경우 서비스 작성자가 제공하는 URL을 통해 HTTPS 프로토콜을 사용하여 데이터를 다운로드합니다.
메타데이터 소스는 크게 신뢰할 수 있는 소스와 신뢰할 수 없는 소스의 두 가지 범주로 나눌 수 있습니다. 소스를 신뢰하고 소스의 보안 MEX 끝점에서 클라이언트 코드 및 다른 메타데이터를 다운로드한 경우, 해당 클라이언트를 빌드하여 올바른 자격 증명을 제공하고 다른 문제 없이 실행할 수 있습니다.
그러나 잘 모르는 소스에서 클라이언트 및 메타데이터를 다운로드하려는 경우 코드가 사용하는 보안 방법의 유효성을 확인해야 합니다. 예를 들어, 서비스가 최소한의 수준에서 기밀성 및 무결성을 요구하지 않는 한 단순히 개인 정보 또는 재무 정보를 서비스에 보내는 클라이언트를 만들지 않아야 합니다. 이러한 정보가 서비스 소유자에게 표시되기 때문에 이러한 정보를 공개할 정도로 서비스 소유자를 신뢰해야 합니다.
따라서 일반적으로 신뢰할 수 없는 소스에서 코드 및 메타데이터를 사용하는 경우 필요한 보안 수준을 충족하는지 코드 및 메타데이터를 확인합니다.
클라이언트에 대한 클라이언트 자격 증명 설정은 다음 두 단계로 구성됩니다.
- 서비스에서 필요한 클라이언트 자격 증명 형식을 결정합니다. 이 방법은 두 개의 메서드 중 하나에 의해 수행됩니다. 첫째로, 서비스 작성자의 설명서가 있는 경우 서비스에서 필요한 클라이언트 자격 증명 형식(있는 경우)을 지정해야 합니다. 둘째로, Svcutil.exe 도구로 생성된 구성 파일만 있는 경우 개별 바인딩을 검사하여 필요한 자격 증명 형식을 결정할 수 있습니다.
- 실제 클라이언트 자격 증명을 지정합니다. 실제 클라이언트 자격 증명은 해당 형식과 구분하기 위해 클라이언트 자격 증명 값이라고 합니다. 예를 들어, 클라이언트 자격 증명 형식이 인증서를 지정할 경우 서비스가 신뢰하는 인증 기관에서 발급한 X.509 인증서를 제공해야 합니다.
Svcutil.exe 도구가 생성한 구성 파일이 있는 경우 <bindings> 단원을 검토하여 필요한 클라이언트 자격 증명 형식을 결정합니다. 이 단원에는 보안 요구 사항을 지정하는 바인딩 요소가 나와 있습니다. 특히 각 바인딩의 <보안> 요소를 검토하십시오. 해당 요소에는 mode 특성이 포함되어 있으며, 이 특성은 세 가지 가능한 값 즉, Message, Transport 또는 TransportWithMessageCredential 중 하나로 설정할 수 있습니다. 특성 값은 모드를 결정하고 모드는 자식 요소 중 중요한 요소를 결정합니다.
<security>
요소는 <transport>
또는 <message>
요소 중 하나, 또는 둘 다를 포함할 수 있습니다. 중요한 요소는 보안 모드와 일치하는 요소입니다. 예를 들어 다음 코드는 보안 모드를 "Message"
, <message>
요소의 클라이언트 자격 증명 형식은 "Certificate"
지정합니다. 이런 경우 <transport>
요소는 무시될 수 있습니다. 그러나 <message>
요소는 X.509 인증서를 제공해야 하는 것으로 지정합니다.
<wsHttpBinding>
<binding name="WSHttpBinding_ICalculator">
<security mode="Message">
<transport clientCredentialType="Windows"
realm="" />
<message clientCredentialType="Certificate"
negotiateServiceCredential="true"
algorithmSuite="Default"
establishSecurityContext="true" />
</security>
</binding>
</wsHttpBinding>
다음 예제와 같이 clientCredentialType
특성이 "Windows"
로 설정된 경우 실제 자격 증명 값을 제공할 필요가 없습니다. Windows 통합 보안이 클라이언트를 실행하는 사용자의 실제 자격 증명(Kerberos 토큰)을 제공하기 때문입니다.
<security mode="Message">
<transport clientCredentialType="Windows "
realm="" />
</security>
클라이언트가 자격 증명을 제공해야 하는 경우 적절한 메서드를 사용하여 클라이언트를 구성합니다. 예를 들어, 클라이언트 인증서를 설정하려면 SetCertificate 메서드를 사용합니다.
자격 증명의 일반 양식은 X.509 인증서입니다. 다음 두 가지 방법으로 자격 증명을 제공할 수 있습니다.
- 클라이언트 코드에서 자격 증명 프로그래밍(SetCertificate 메서드 사용).
클라이언트에 대한 구성 파일의 <behaviors> 단원 추가 및 clientCredentials
요소 사용(아래 참조).
코드에 <clientCredentials> 값을 설정하려면 ClientBase 클래스의 ClientCredentials 속성에 액세스해야 합니다. 다음 표에 설명한 것처럼 속성은 다양한 자격 증명 형식에 액세스할 수 있는 ClientCredentials 개체를 반환합니다.
ClientCredential 속성 | 설명 | 참고 |
---|---|---|
서비스에게 자신을 인증하기 위해 클라이언트가 제공하는 X.509 인증서를 나타냅니다. |
||
HttpDigestClientCredential을 반환합니다. |
HTTP digest 자격 증명을 나타냅니다. 자격 증명은 사용자 이름 및 암호에 대한 해시입니다. |
|
IssuedTokenClientCredential을 반환합니다. |
보안 토큰 서비스에서 발급한 사용자 지정 보안 토큰을 나타내며 일반적으로 페더레이션 시나리오에서 사용됩니다. |
|
PeerCredential을 반환합니다. |
Windows 도메인의 피어 메시 참가를 위해 사용할 피어 자격 증명을 나타냅니다. |
|
out-of-band 협상에서 서비스가 제공하는 X.509 인증서를 나타냅니다. |
||
UserNamePasswordClientCredential을 반환합니다. |
사용자 이름 및 암호 쌍을 나타냅니다. |
|
WindowsClientCredential을 반환합니다. |
Windows 클라이언트 자격 증명(Kerberos 자격 증명)을 나타냅니다. 클래스의 속성은 읽기 전용입니다. |
자격 증명 값은 <clientCredentials> 요소의 자식 요소로 끝점 동작을 사용하여 지정됩니다. 사용되는 요소는 클라이언트 자격 증명 형식에 따라 다릅니다. 예를 들어 다음 예제에서는 <clientCertificate> of <clientCredentials> Element를 사용하여 X.509 인증서를 설정하는 구성을 보여 줍니다.
<configuration>
<system.serviceModel>
<behaviors>
<endpointBehaviors>
<behavior name="myEndpointBehavior">
<clientCredentials>
<clientCertificate findvalue="myMachineName"
storeLocation="Current" X509FindType="FindBySubjectName" />
</clientCredentials>
</behavior>
</behaviors>
</system.serviceModel>
</configuration>
구성에서 클라이언트 자격 증명을 설정하려면 <endpointBehaviors> 요소를 구성 파일에 추가합니다. 또한 다음 예제와 같이 추가된 동작 요소는 <endpoint> 요소의 behaviorConfiguration
특성을 사용하여 서비스 끝점에 연결해야 합니다. behaviorConfiguration
특성 값은 동작 name 특성 값과 일치해야 합니다.
<configuration>
<system.serviceModel>
<client>
<endpoint address="https://localhost/servicemodelsamples/service.svc"
binding="wsHttpBinding"
bindingConfiguration="Binding1"
behaviorConfiguration="myEndpointBehavior"
contract="Microsoft.ServiceModel.Samples.ICalculator" />
</client>
</system.serviceModel>
</configuration>
참고
예를 들어 사용자 이름 및 암호 또는 Windows 사용자 및 암호 값과 같은 일부 클라이언트 자격 증명 값은 응용 프로그램 구성 파일을 사용하여 설정할 수 없습니다. 이러한 자격 증명 값은 코드에서만 지정할 수 있습니다.
클라이언트 자격 증명 설정에 대한 자세한 내용은 방법: 클라이언트 자격 증명 값 지정을 참조하십시오.
참고
다음 예제 구성과 같이 SecurityMode
가 "TransportWithMessageCredential",
로 설정된 경우 ClientCredentialType
은 무시됩니다.
<wsHttpBinding>
<binding name="PingBinding">
<security mode="TransportWithMessageCredential" >
<message clientCredentialType="UserName"
establishSecurityContext="false"
negotiateServiceCredential="false" />
<transport clientCredentialType="Certificate" />
</security>
</binding>
</wsHttpBinding>
방법: 클라이언트 자격 증명 값 지정
방법: 클라이언트 자격 증명 형식 지정
ClientCredentials
ClientBase
ClientCredentials
HttpsGetEnabled
HttpsGetUrl
서비스에 보안 설정
WCF 클라이언트를 사용하여 서비스 액세스
<bindings>
Configuration Editor Tool (SvcConfigEditor.exe)
ServiceModel Metadata Utility Tool (Svcutil.exe)