클라이언트 채널 속성
이 항목은 이전 버전의 기존 응용 프로그램과의 호환성을 위해 유지되고 있으나 새로운 개발에는 권장되지 않는 레거시 기술에 대해 설명합니다. 분산 응용 프로그램은 이제 WCF(Windows Communication Foundation)를 사용하여 개발됩니다.
다음 표에서는 지정할 수 있는 클라이언트 채널 속성을 보여 줍니다.
속성 | 설명 | 이 속성을 지원하는 형식 |
---|---|---|
allowAutoRedirect |
서버 리디렉션 자동 처리가 활성화되어 있는지 여부를 나타내는 부울 값입니다. |
|
clientConnectionLimit |
지정된 서버에 대해 동시에 열 수 있는 연결 수를 나타내는 정수입니다. 기본값은 2입니다. |
HttpChannel HttpClientChannel |
connectionGroupName |
unsafeAuthenticatedConnectionSharing 값이 true로 설정된 경우 서버의 연결 그룹 이름으로 사용할 이름을 지정하는 문자열입니다. unsafeAuthenticatedConnectionSharing이 true로 설정되지 않은 경우 이 속성은 무시됩니다. 지정하는 경우 이 이름이 하나의 인증된 사용자에만 매핑되게 합니다. 이 속성은 Windows 98, Windows NT 4.0, Windows Me, Windows 2000, Windows XP Home Edition, Windows XP Professional 및 Windows Server 2003 제품군 플랫폼의 .NET Framework 버전 1.1 이상에서만 지원됩니다. |
HttpChannel HttpClientChannel |
connectionTimeout |
성공적인 연결을 기다릴 시간(밀리초)을 지정하는 정수입니다. 0 또는 -1은 시간 제한이 없음을 나타냅니다. 기본값은 Infinite입니다. |
|
인증서 |
클라이언트의 ID를 나타내는 ICredentials 인터페이스를 구현하는 개체입니다. |
HttpChannel HttpClientChannel |
domain |
서버 채널에 인증할 때 username에 지정된 사용자 이름 및 password에 지정된 암호와 함께 사용할 도메인 이름을 지정하는 문자열입니다. |
HttpClientChannel |
password |
서버 채널에 인증할 때 username에 지정된 사용자 이름 및 domain에 지정된 도메인과 함께 사용할 암호를 지정하는 문자열입니다. |
HttpClientChannel TcpClientChannel |
proxyName |
프록시에서 원격 서버를 호출할 때 사용하는 이름을 지정하는 문자열입니다. 기본적으로 클라이언트 컴퓨터의 호스트 이름이 사용됩니다. |
HttpChannel HttpClientChannel |
proxyPort |
프록시에서 원격 서버를 호출할 때 사용하는 포트 번호를 지정하는 정수입니다. 기본적으로 사용 가능한, 권한 없는 포트가 런타임에 선택됩니다. |
HttpChannel HttpClientChannel |
retryCount |
클라이언트가 처음에 실패한 원격 호출을 반복하는 횟수를 지정하는 정수입니다. 기본값은 1입니다. |
TcpClientChannel |
servicePrincipleName |
Kerberos 인증에 사용할 servicePrincipalName을 지정하는 문자열입니다. 기본값은 null입니다. |
HttpChannel HttpClientChannel TcpClientChannel |
socketCachePolicy |
socketCacheTimeout 속성에 지정된 시간을 소켓이 마지막으로 사용된 시간부터 측정할지 아니면 소켓이 만들어진 시간부터 측정할지를 지정하는 SocketCachePolicy 열거형의 멤버입니다. 기본값은 Default입니다. |
TcpClientChannel |
socketCacheTimeout |
소켓이 TcpClientChannel 개체에 의해 유지 관리되는 캐시에서 제거되기까지의 시간(초)을 지정하는 정수입니다. 기본값은 5초입니다. |
TcpClientChannel |
timeout |
요청이 시간 초과되기까지 기다릴 수 있는 시간(밀리초)을 지정하는 정수입니다. 0 또는 -1은 시간 제한이 없음을 나타냅니다. 기본값은 Infinite입니다. |
HttpChannel HttpClientChannel TcpChannel TcpClientChannel |
tokenImpersonationLevel |
TokenImpersonationLevel 형식의 값입니다. 이 속성은 클라이언트가 서버에서 인증되는 방법을 지정합니다. 기본값은 None입니다. 단, secure 속성이 true로 설정된 경우의 기본값은 Identification입니다. |
TcpChannel TcpClientChannel |
unsafeAuthenticatedConnectionSharing |
고속 NTLM 인증 연결 공유를 허용할지 여부를 나타내는 부울 값입니다. 이 값을 true로 설정하면 connectionGroupName 값이 하나의 인증된 사용자로만 매핑되어야 합니다. useAuthenticatedConnectionSharing 값이 true로 설정되어 있으면 이 속성은 무시됩니다. 이 속성은 Windows 98, Windows NT 4.0, Windows Me, Windows 2000, Windows XP Home Edition, Windows XP Professional 및 Windows Server 2003 플랫폼의 .NET Framework 버전 1.1 이상에서만 지원됩니다. |
HttpChannel HttpClientChannel |
useAuthenticatedConnectionSharing |
서버 채널에서 들어오는 각 호출을 인증하는 대신 인증된 연결을 다시 사용할지 여부를 나타내는 부울 값입니다. 기본적으로 useDefaultCredentials 값을 true로 설정하면 이 값도 true로 설정됩니다. 그렇지 않으면 값이 false로 설정되어 서버에 인증이 필요한 경우 각 호출이 인증됩니다. 이는 프로그래밍 방식에도 적용됩니다. IDictionary를 구현하는 개체를 만들고 credentials 속성을 CredentialCache.DefaultCredentials로 설정한 다음 이 값을 채널 싱크로 전달하거나 ChannelServices.GetChannelSinkProperties 메서드에서 반환된 IDictionary를 사용하면 됩니다. 이 이름/값 쌍은 .NET Framework on the following platforms: Microsoft Windows 98, Windows NT 4.0, Windows Millennium Edition(Windows Me), Windows 2000, Windows XP Home Edition, Windows XP Professional 및 Windows Server 2003 플랫폼의 .NET Framework 버전 1.1 이상에서만 지원됩니다. |
HttpChannel HttpClientChannel |
useDefaultCredentials |
서버 채널에 인증할 때 현재 스레드와 연결된 ID에 대한 자격 증명을 제공할지 여부를 지정하는 부울 값입니다. |
HttpChannel HttpClientChannel |
username |
서버 채널에 인증할 때 password에 지정된 암호 및 domain에 지정된 도메인과 함께 사용할 사용자 이름을 지정하는 문자열입니다. |
HttpClientChannel TcpClientChannel |
참고: |
---|
Windows 98과 Windows Me에는 인증 연결 그룹 이름을 식별할 보안 ID가 없습니다. 따라서 이러한 플랫폼에는 하나의 연결 그룹 이름이 있습니다. |
참고: |
---|
응용 프로그램에서 ICredentials 구현이나 HttpClientChannel 속성의 명시적 username, password 및 domain 값을 전달하게 하려면 unsafeAuthenticatedConnectionSharing 속성을 true로 설정하고 connectionGroupName 속성을 설정하여 인증 연결 공유를 활성화하고 connectionGroupName 값이 하나의 인증된 사용자에만 매핑되게 할 수 있습니다. |
참고 항목
작업
방법: 구성 파일에서 채널 구성
방법: 프로그래밍 방식으로 채널 구성