다음을 통해 공유

SOAP 송신 포트 구성 방법

  • 아티클

프로그래밍 방식으로 또는 BizTalk Server 관리 콘솔을 사용하여 SOAP 송신 포트를 구성할 수 있습니다.

프로그래밍 방식으로 SOAP 송신 포트를 구성하는 방법

BizTalk Explorer 개체 모델은 TransportTypeData 읽기/쓰기 속성이 있는 ITransportInfo라는 송신 포트에 대한 어댑터별 인터페이스를 노출합니다. 이 속성은 이름/값 쌍 XML 문자열 형식의 SOAP 송신 포트 구성 속성 모음을 허용합니다. BizTalk Explorer 개체 모델에서 이 속성을 설정하려면 먼저 ITransportInfo 인터페이스의 OutboundTransportLocation 속성을 설정해야 합니다.

ITransportInfo 인터페이스의 TransportTypeData 속성은 필요하지 않습니다. 이 속성을 설정하지 않으면 어댑터에서는 다음 표에 표시된 SOAP 송신 포트 구성에 대한 기본값을 사용합니다.

다음 표에는 SOAP 송신 포트에 대해 BizTalk 탐색기 개체 모델에서 설정할 수 있는 구성 속성이 나와 있습니다.

속성 이름 Type Description
URI 문자열 배포 서버에 있는 웹 서비스를 포함한 가상 디렉터리입니다.
사용자 이름 String 대상 웹 서비스에 액세스하기 위해 지정하는 사용자 이름

기본값: 공백
암호 String 서버 인증에 사용할 암호입니다.

기본값: 공백
ClientCertificate String 클라이언트 SSL 인증서의 손 도장(Thumbprint)입니다.

기본값: 공백
AffiliateApplicationName 문자열 클라이언트 자격 증명을 위해 티켓을 발급하는 데 사용할 SSO 응용 프로그램의 이름

AffiliateApplicationName은 사용자 이름 및 암호 쌍에 대해 상호 배타적입니다.

기본값: 공백
UseProxy 부울 SOAP 송신 포트가 대상 웹 서비스에 액세스하기 위해 프록시 서버를 사용하는지 여부를 나타냅니다. 프록시 서버는 모든 SOAP 송신 포트에서 공유할 수 있습니다.

기본값: False
ProxyAddress 문자열 웹 서비스 호출에 사용할 HTTP 프록시의 주소

기본값: 공백
ProxyPort 정수 웹 서비스 호출에 사용할 HTTP 프록시의 포트

기본값: 공백
ProxyUsername String 프록시에 사용할 사용자 이름

기본값: 공백
ProxyPassword 문자열 프록시에 사용할 암호

기본값: 공백

다음 코드는 이러한 속성을 설정하기 위해 사용하는 형식을 보여 줍니다.

<CustomProps>  
   <URI vt="8"/>  
   <ClientCertificate vt="8"/>  
   <Password vt="8">Encrypted</Password>  
   <ProxyAddress vt="8"/>  
   <ProxyPassword vt="8">Encrypted</ProxyPassword>  
   <ProxyPort vt="3"/>  
   <ProxyUsername vt="8"/>  
   <UseProxy vt="11"/>  
   <Username vt="8"/>  
   <AffiliateApplicationName vt="8"/>  
</CustomProps>

BizTalk Server 관리 콘솔을 사용하여 SOAP 송신 포트를 구성하는 방법

BizTalk Server 관리 콘솔에서 SOAP 송신 포트 어댑터 변수를 설정할 수 있습니다. 송신 포트에 대해 속성을 설정하지 않으면 BizTalk Server 관리 콘솔에 설정된 기본 송신 핸들러 값이 사용됩니다.

SOAP 송신 포트에 대해 변수를 구성하려면

  1. BizTalk Server 관리 콘솔에서 새 송신 포트를 만들거나 기존 송신 포트를 두 번 클릭하여 수정합니다. 자세한 내용은 송신 포트를 만드는 방법을 참조하세요. 모든 송신 포트 옵션을 구성하고 일반 탭의 전송 섹션에서 유형 옵션에 SOAP를 지정합니다.

  2. 일반 탭의 형식 옆에 있는 전송 섹션에서 구성을 클릭합니다.

  3. SOAP 전송 속성 대화 상자의 일반 탭에서 다음을 수행합니다.

    사용 항목 원하는 작업
    웹 서비스 URL 호출할 웹 서비스의 주소를 지정합니다. 참고: 송신 포트 또는 수신 위치에 대한 URI는 256자를 초과할 수 없습니다.
    인증 호출할 웹 서비스에 사용되는 인증 방법을 지정합니다.

    옵션:

    - 익명. 기본 설정입니다.
    - 기본. SOAP 연결은 사용자 이름과 암호를 일반 텍스트로 보냅니다.
    - 다이제스트. SOAP 연결은 암호화된 형식으로 암호를 보냅니다.
    - Ntlm. 사용자 이름이나 암호는 SOAP 연결을 통해 전송되지 않습니다. SOAP 어댑터는 이 인증 유형에 대해 항상 SOAP 송신 어댑터가 실행되는 프로세스의 자격 증명을 사용합니다.
    자격 증명 사용할 자격 증명 유형을 지정합니다.

    인증 유형이 기본 또는 다이제스트인 경우에만 사용할 수 있습니다.

    옵션:

    - Single Sign-On 사용 안 함
    사용자 이름
    대상 서버 인증에 사용할 사용자 이름입니다. 인증 유형 속성이 Anonymous 또는 NTLM이면 이 옵션을 사용할 수 없습니다. 기본 또는 다이제스트가 선택되어 있고 Enterprise Single Sign-On 사용되지 않는 경우 이 속성에 값이 필요합니다.
    최소 길이: 0
    최대 길이: 256
    암호
    대상 서버 인증에 사용할 암호입니다. 인증 유형 속성이 Anonymous 또는 NTLM이면 이 옵션을 사용할 수 없습니다. 이 속성은 기본 또는 다이제스트 가 선택되어 있고 단일 Sign-On 사용되지 않는 경우 값이 필요합니다.
    최소 길이: 0
    최대 길이: 256
    - Single Sign-On 사용
    대상 서버 인증을 위한 클라이언트 자격 증명을 검색하는 데 Single Sign-On을 사용할지 여부를 지정합니다.
    관련 애플리케이션
    Single Sign-On에 사용할 관련 응용 프로그램을 지정합니다. 이 목록을 채우는 방법에 대한 자세한 내용은 SSO 관련 애플리케이션을 참조하세요.
    최소 길이: 0
    최대 길이: 256
    클라이언트 인증서 지문 연결 구성에 사용할 클라이언트 인증서의 손 도장(Thumbprint)을 지정합니다.

    예: 01 23 45 67 89 AB CD EF 01 23 45 67 89 AB CD EF 01 23 45 67

    최소 길이: 0

    최대 길이: 59

  4. SOAP 전송 속성 대화 상자의 프록시 탭에서 다음을 수행합니다.

    사용 항목 원하는 작업
    핸들러의 기본 프록시 구성 사용 송신 포트 프록시 처리기 구성을 지정합니다. true로 설정하면 포트가 처리기 수준으로 지정된 프록시 설정을 사용하고, False인 경우 송신 포트에 지정된 프록시 정보를 사용합니다.

    기본 설정은 true입니다.
    프록시 사용 안 함 SOAP 송신 핸들러가 프록시 서버를 사용하는지 여부를 나타냅니다.
    프록시 사용 SOAP 송신 핸들러가 프록시 서버를 사용하는지 여부를 나타냅니다. 프록시 서버는 모든 SOAP 송신 포트에서 공유할 수 있습니다.
    서버 프록시 서버 이름을 지정합니다.

    이 속성은 프록시 사용 이 선택된 경우에만 값이 필요합니다.

    유형: String

    최소 길이: 0

    최대 길이: 256
    포트 SOAP 송신 핸들러가 사용하는 포트를 지정합니다.

    이 속성은 프록시 사용 이 선택된 경우에만 값이 필요합니다.

    기본값: 80

    유형: Long

    최소값: 0

    최대값: 65535 참고: 값 0을 지정하면 포트 80인 기본값이 사용됨을 나타냅니다.
    사용자 이름 인증에 사용할 사용자 이름을 지정합니다. Windows 통합 인증을 사용하는 경우 사용자 이름에는 domain \username 도메인이 포함됩니다. 기본 또는 다이제스트 인증을 사용하는 경우 사용자 이름에 domain\이 포함되지 않습니다.

    이 속성은 프록시 사용 이 선택된 경우에만 값이 필요합니다.

    유형: String

    최소 길이: 0

    최대 길이: 256
    암호 인증에 사용할 암호를 지정합니다.

    이 속성은 프록시 사용 이 선택된 경우에만 값이 필요합니다.

    유형: String

    최소 길이: 0

    최대 길이: 256

  5. SOAP 전송 속성 대화 상자의 웹 서비스 탭에서 다음을 수행합니다.

    사용 항목 원하는 작업
    오케스트레이션 웹 포트 일반 탭에 나열된 웹 서비스 URL에 노출되는 웹 서비스를 사용하도록 지정합니다.

    이 값은 기본 설정입니다.
    어셈블리 이름 웹 서비스 프록시를 포함하는 어셈블리 이름을 지정합니다. 이 필드는 찾아보기 단추로 어셈블리를 찾아 채울 수 있습니다. 어셈블리를 선택하면 이 상자가 어셈블리의 정규화된 이름으로 채워집니다. 참고: 지정된 어셈블리는 런타임에 모든 BizTalk 서버에 있어야 합니다.
    형식 이름 호출할 웹 메서드가 들어 있는 클래스의 이름을 지정합니다. 어셈블리 내에 포함되어 있는 유형 목록에서 선택할 수 있습니다.
    메서드 이름 목록 상자에 있는 메서드 중 하나를 지정하거나 "나중에 지정" 옵션을 선택합니다. "나중에 지정" 옵션을 선택한 경우 파이프라인 구성 요소와 같은 다른 방법으로 웹 메서드를 설정해야 합니다. 이 시나리오에서는 웹 메서드를 Soap Adapter MethodName 컨텍스트 속성에 기록해야 합니다.
    SOAP 1.2 SOAP 1.2 프로토콜을 지원하는 프록시 코드를 생성하도록 지정합니다. 이 옵션을 선택하지 않은 상태로 두면 SOAP 1.1 규격 프록시 코드가 생성됩니다.

    기본값: 지워진

  6. 확인을 클릭하고 확인을 다시 클릭하여 설정을 저장합니다.

참고 항목

웹 서비스 게시