다음을 통해 공유

HTTP 수신 위치를 구성하는 방법

  • 아티클

프로그래밍 방식으로 또는 BizTalk Server 관리 콘솔을 사용하여 HTTP 수신 위치 어댑터 변수를 설정할 수 있습니다. 수신 위치에서 속성을 설정하지 않은 경우에는 BizTalk Server 관리 콘솔에 설정된 기본 수신 핸들러 값이 사용됩니다.

참고

다음 절차를 완료하기 전에 수신 포트를 이미 추가한 상태여야 합니다. 자세한 내용은 수신 포트를 만드는 방법을 참조하세요.

프로그래밍 방식으로 HTTP 수신 위치를 구성하는 방법

HTTP 어댑터는 구성 데이터베이스라고도 하는 BizTalk 관리 데이터베이스에 구성 정보를 저장합니다. 구성은 사용자 지정 XML 속성 모음에 저장됩니다.

BizTalk Explorer 개체 모델은 TransportTypeData 읽기/쓰기 속성이 있는 IReceiveLocation 구성 인터페이스를 노출합니다. 이 속성은 이름/값 쌍 XML 문자열 형식의 HTTP 수신 위치 구성 속성 모음을 허용합니다.

IReceiveLocation의 TransportTypeData 속성을 설정할 필요는 없습니다. 이 값을 설정하지 않으면 HTTP 수신 위치 구성의 기본값이 사용됩니다. 다음 표에서는 기본값 목록과 함께 HTTP 수신 위치의 BizTalk 탐색기 개체 모델에서 설정할 수 있는 구성 속성 목록을 보여 줍니다.

속성 이름 Type 설명 제한 의견
ResponseContentType 문자열 HTTP 어댑터가 이 수신 위치에서 클라이언트로 다시 보내는 HTTP 응답 메시지의 콘텐츠 유형입니다. 이 속성은 요청-응답 수신 포트에 대해서만 유효하며 단방향 수신 포트에 대해서는 무시됩니다. 문자열

최소 길이: 0

최대 길이: 256		 기본값: 텍스트/XML
루프백 부울 이 위치에서 수신한 요청 메시지를 송신 포트로 라우팅하거나 이 수신 위치로 반환하여 응답 메시지로 보내도록 지정합니다. 이 속성은 요청-응답 수신 포트에 대해서만 유효합니다. 단방향 수신 포트에 대해서는 무시됩니다. 없음 기본값: False
ReturnCorrelationHandle 부울 제출에 성공한 경우 HTTP 어댑터가 HTTP 응답으로 보내는 제출된 메시지의 상관 관계 토큰을 지정합니다. 이 속성은 단방향 수신 포트에 대해서만 유효하며 요청-응답 수신 포트에 대해서는 무시됩니다. 없음 기본값: 사실
SuspendFailedRequests 부울 실패한 HTTP 요청의 일시 중단 여부를 지정합니다. 이 값이 True이면 실패한 요청을 일시 중단하며, 단방향 수신 포트의 경우 클라이언트에 "수락됨" 상태 코드(202)를 보내고 양방향 수신 포트의 경우 클라이언트에 "오류" 상태 코드(500)를 보냅니다. 없음 기본값: False
UseSSO 부울 HTTP 어댑터가 이 수신 포트에 도착하는 메시지에 대해 SSO 티켓을 발급할지 여부를 지정합니다. 없음 기본값: False

이러한 속성을 설정하기 위한 XML 문자열의 형식은 다음과 같습니다.

<CustomProps>  
   <UseSSO vt="11">-1</UseSSO>  
   <SuspendFailedRequests vt="11">-1</SuspendFailedRequests>  
   <ReturnCorrelationHandle vt="11">-1</ReturnCorrelationHandle>  
   <ResponseContentType vt="8">text/xml</ResponseContentType>  
   <LoopBack vt="11">-1</LoopBack>  
</CustomProps>

BizTalk Server 관리 콘솔을 사용하여 HTTP 수신 위치를 구성하는 방법

BizTalk Server 관리 콘솔을 사용하여 수신 위치를 구성하려면 다음 절차를 사용합니다.

HTTP 수신 위치에 대한 변수를 구성하려면

  1. HTTP 수신 위치에서 작업에 사용할 IIS(인터넷 정보 서비스)를 구성합니다. IIS 구성에 대한 지침은 HTTP 수신 위치에 대해 IIS를 구성하는 방법을 참조하세요.

  2. BizTalk Server 관리 콘솔에서 BizTalk Server관리, BizTalk 그룹, 애플리케이션, 수신 위치를 만들 애플리케이션을 차례로 확장합니다.

  3. 왼쪽 창에서 수신 포트 노드를 클릭합니다. 그런 다음 오른쪽 창에서 기존 수신 위치와 연결되어 있거나 새 수신 위치와 연결하려는 수신 포트를 마우스 오른쪽 단추로 클릭하고 속성을 클릭합니다.

  4. 수신 포트 속성 대화 상자의 왼쪽 창에서 수신 위치를 선택하고 오른쪽 창에서 기존 수신 위치를 두 번 클릭하거나 새로 만들기를 클릭하여 새 수신 위치를 만듭니다.

  5. 수신 위치 속성 대화 상자의 형식 옆의 전송 섹션에서 드롭다운 목록에서 HTTP를 선택한 다음 구성을 클릭합니다.

  6. HTTP 전송 속성 대화 상자에서 다음을 수행합니다.

    사용 항목 원하는 작업
    가상 디렉터리 및 ISAPI 확장 HTTP/HTTPS 수신 위치로 수신되는 메시지를 게시할 가상 디렉터리의 이름을 지정합니다. 가상 디렉터리는 수신 위치 DLL 이름 및 선택적 쿼리 문자열을 포함합니다. 가상 디렉터리 이름의 예는 다음과 같습니다.

    /<virtual directory>/BTSHTTPReceive.dll

    /<virtual directory>/BTSHTTPReceive.dll? 구매%20Order

    이 위치에는 모든 하위 폴더를 포함하여 둘 이상의 BTSHTTPReceive.dll ISAPI 확장이 포함되면 안 됩니다.

    형식: 문자열

    최대 길이: 256 참고: 송신 포트 또는 수신 위치의 URI는 256자를 초과할 수 없습니다.
    공용 주소 이 수신 위치의 정규화된 URI를 지정합니다. 이 속성 값은 서버 이름과 가상 디렉터리의 조합입니다. BizTalk 메시징 엔진은 이 주소를 외부 파트너에게 노출합니다. 지정한 URI는 BizTalk Server로 메시지를 보낼 때 거래 업체에서 연결할 공용 웹 사이트 URL을 지정해야 합니다.

    이 정보는 선택적이며 BizTalk Server에서 사용되지 않습니다. 이 매개 변수는 관리자가 수신 위치에서 연결할 공용 URL을 문서화하는 데 사용할 수 있습니다.

    형식: 문자열

    최소 길이: 0

    최대 길이: 256
    콘텐츠 형식 반환 수신 위치에서 클라이언트로 반환되는 HTTP 응답 메시지의 콘텐츠 유형을 지정합니다. 이 속성은 요청-응답 수신 위치에만 유효합니다.

    기본값: text/xml

    형식: 문자열

    최소 길이: 0

    최대 길이: 256
    Loopback 이 위치에서 수신한 요청 메시지를 송신 포트로 라우팅하거나 이 수신 위치로 반환하여 응답 메시지로 보내도록 정의합니다. 이 속성은 요청-응답 수신 위치에만 유효합니다.

    기본값: False

    형식: 부울
    성공 시 상관 관계 핸들 반환(단방향 포트에만 해당) 성공하면 수신 위치는 HTTP 응답에 전송된 메시지의 상관 관계 토큰을 클라이언트에게 보냅니다. 이 속성은 단방향 수신 위치에만 유효합니다.

    기본값: 사실

    형식: 부울
    Single Sign-On 사용 Enterprise Single Sign-On을 사용하도록 지정합니다.

    기본값: False

    형식: 부울 참고: 이 옵션을 사용하도록 설정한 경우 SSO 시스템 수준에서 티켓 허용 옵션을 사용하도록 설정해야 합니다. 티켓 허용 옵션은 SSO 관리 MMC 인터페이스에서 사용할 수 있는 SSO 시스템 속성 대화 상자의 옵션 탭에서 구성할 수 있습니다. 이 옵션을 사용하도록 설정하고 SSO 시스템 수준에서 티켓 허용 옵션을 사용하도록 설정하지 않으면 이 수신 위치에서 받은 모든 메시지가 일시 중단됩니다.
    실패한 요청 일시 중단 인바운드 처리에 실패하는 HTTP 요청을 일시 중단할지 여부를 나타냅니다.

    이 값이 False이면 실패한 요청을 삭제하고 클라이언트에게 오류 상태 코드(401 또는 500)를 보냅니다.

    True 값은 실패한 요청을 일시 중단하고 단방향 수신 포트에 대해 클라이언트에 "수락됨" 상태 코드(200)를 보내거나 양방향 수신 포트에 대해 클라이언트에 "오류" 상태 코드(500)를 보내도록 나타냅니다.

    기본값: False

    형식: 부울

  7. 확인을 클릭하여 설정을 저장합니다.

  8. 수신 위치 속성 대화 상자에서 적절한 값을 입력하여 수신 위치의 구성을 완료한 다음 확인 을 클릭하여 설정을 저장합니다. 수신 위치 속성 대화 상자에 대한 자세한 내용은 수신 위치를 만드는 방법을 참조하세요.

    HTTP 클라이언트에서 HTTP 위치를 호출하는 동안 HTTP 어댑터는 익명, 기본, 다이제스트 또는 Windows 통합 인증을 사용하여 HTTP 클라이언트를 인증합니다. 사용자가 확인되면 사용자 컨텍스트가 수신 핸들러에 전달됩니다.

참고

SOAP와 HTTP가 동일한 프로세스를 공유하도록 하는 IIS 구성은 잘못되었습니다. 프로세스당 하나의 격리된 수신기만 사용할 수 있습니다.