HTTP 어댑터 구성 속성
다음 표는 HTTP 어댑터 수신 위치에 대해 설정할 수 있는 구성 속성을 보여 줍니다.
| 속성 이름 | Type | 설명 | 제한 | 의견 |
|---|---|---|---|---|
| ReturnCorrelationHandle | VT_BOOL | 성공하면 수신 위치가 HTTP 응답에 전송된 메시지의 상관 관계 토큰을 클라이언트에게 보내도록 지정합니다. | 이 속성은 단방향 수신 위치에만 유효합니다. 유효한 값은 다음과 같습니다. - -1(true) - 0(false) |
없음 |
| ResponseContentType | VT_BSTR | 수신 위치에서 클라이언트로 반환되는 HTTP 응답 메시지의 콘텐츠 유형을 지정합니다. | 이 속성은 요청-응답 수신 위치에만 유효합니다. 최소 길이: 0 최대 길이: 256 |
기본값은 text/xml입니다. |
| SuspendFailedRequests | VT_BOOL | 인바운드 처리에 실패하는 HTTP 요청을 일시 중단할지 여부를 지정합니다. | 유효한 값은 다음과 같습니다. - -1(true) - 0(false) |
이 값이 0(False)이면 실패한 요청을 삭제하고 클라이언트에게 오류 상태 코드(401 또는 500)를 보냅니다. 이 값이 -1(Ttrue)이면 실패한 요청을 일시 중단하고 단방향 수신 포트의 경우 클라이언트에게 "수락됨" 상태 코드(200)를 보내거나 양방향 수신 포트의 경우 클라이언트에게 "오류" 상태 코드(500)를 보냅니다. 기본값은 0(false)입니다. |
| UseSSO | VT_BOOL | Enterprise Single Sign-On을 사용하도록 지정합니다. | 유효한 값은 다음과 같습니다. - -1(true) - 0(false) |
기본값은 0(false)입니다. |
| 루프백 | VT_BOOL | 이 위치에서 수신한 요청 메시지를 송신 포트로 라우팅하거나 이 수신 위치로 반환하여 응답 메시지로 보내도록 지정합니다. | 이 속성은 요청-응답 수신 위치에만 유효합니다. 유효한 값은 다음과 같습니다. - -1(true) - 0(false) |
기본값은 0(false)입니다. |
다음 코드는 속성을 설정하는 데 사용하는 XML 문자열의 형식을 보여 줍니다.
<CustomProps>
<ReturnCorrelationHandle vt="11">-1</ReturnCorrelationHandle>
<ResponseContentType vt="8">text/xml</ResponseContentType>
<SuspendFailedRequests vt="11">-1</SuspendFailedRequests>
<UseSSO vt="11">-1</UseSSO>
<LoopBack vt="11">-1</LoopBack>
</CustomProps></
다음 표는 HTTP 어댑터 송신 포트에 대해 설정할 수 있는 구성 속성을 보여 줍니다.
| 속성 이름 | Type | 설명 | 제한 | 의견 |
|---|---|---|---|---|
| ProxyPort | VT_I4 | 이 송신 포트에 대한 프록시 서버 포트를 지정합니다. | 유효한 값은 0에서 65535까지입니다. | UseProxy가 0(False)으로 설정된 경우 이 속성에 값을 입력할 필요가 없습니다. 기본값은 80입니다. |
| RequestTimeout | VT_I4 | HTTP/HTTPS 전송에 대한 시간 초과(초)를 지정합니다. | 유효한 값은 0-MAX_LONG입니다. | HTTP 어댑터가 이 시간 내에 응답을 받지 못하면 서비스는 오류를 기록한 다음 재시도 기본 방식에 따라 메시지를 다시 전송합니다. 0으로 설정하면 BizTalk 메시징 엔진이 요청 메시지 크기를 기반으로 시간 초과를 계산합니다. 값을 제공하지 않는 경우 핸들러 값이 사용됩니다. |
| 인증서 | VT_BSTR | SSL 연결을 설정하는 데 사용할 클라이언트 인증서의 손 도장(Thumbprint)을 지정합니다. | 최소 길이: 0 최대 길이: 59 |
기본값은 비어 있습니다. |
| AuthenticationScheme | VT_BSTR | 대상 서버에 사용할 인증 유형을 지정합니다. | 유효한 값은 다음과 같습니다. -익명 -기본 -다이제스트 -Kerberos |
기본값은 익명입니다. |
| 사용자 이름 | VT_BSTR | 대상 서버 인증에 사용할 사용자 이름을 지정합니다. | AuthenticationScheme에 기본 또는 다이제스트를 사용하고 Enterprise Single Sign-On을 사용하지 않는 경우 이 속성에 값을 입력해야 합니다. 최소 길이: 0 최대 길이: 256 |
없음 |
| EnableChunkedEncoding | VT_BOOL | 청크 분할 인코딩을 사용하도록 지정합니다. | HTTP 송신 핸들러가 프록시 사용으로 구성되어 있으면 청크 분할 인코딩은 암시적으로 해제됩니다. 유효한 값은 다음과 같습니다. - -1(true) - 0(false) |
이 옵션을 설정하면 HTTP 어댑터가 최대 청크 크기가 8KB인 HTTP 청크 분할 인코딩을 사용합니다. 기본값은 0(false)입니다. |
| UseProxy | VT_BOOL | HTTP 송신 핸들러가 프록시 서버를 사용하는지 여부를 지정합니다. | 유효한 값은 다음과 같습니다. - -1(true) - 0(false) |
기본값은 0(false)입니다. |
| ProxyName | VT_BSTR | 이 송신 포트에 대한 프록시 서버 주소를 지정합니다. | 최소 길이: 0 최대 길이: 256 |
UseProxy가 0(False)으로 설정된 경우 이 속성에 값을 입력할 필요가 없습니다. |
| UseSSO | VT_BOOL | 대상 서버 인증을 위한 클라이언트 자격 증명을 검색하는 데 Single Sign-On을 사용할지 여부를 지정합니다. | 유효한 값은 다음과 같습니다. - -1(true) - 0(false) |
기본값은 0(false)입니다. |
| 암호 | VT_NULL | 대상 서버 인증에 사용할 암호를 지정합니다. | AuthenticationScheme에 기본 또는 다이제스트를 사용하고 Enterprise Single Sign-On을 사용하지 않는 경우 이 속성에 값을 입력해야 합니다. 바인딩 파일을 내보낼 때 이 값은 항상 Null로 설정됩니다. 바인딩 파일을 대상 BizTalk Server 구성으로 내보내기 전에 이 필드에 직접 암호를 입력해야 합니다. 최소 길이: 0 최대 길이: 256 |
이 필드에 대한 값을 제공하는 경우 바인딩 파일을 가져오기 전에 이 속성의 유형을 VT_BSTR(vt="8")로 설정합니다. |
| MaxRedirects | VT_I4 | 송신될 메시지에 허용되는 최대 리디렉션 횟수를 지정합니다. | 유효한 값은 0에서 10까지입니다. | 기본값은 5입니다. |
| ContentType | VT_BSTR | 요청 메시지의 콘텐츠 유형을 지정합니다. | 최소 길이: 0 최대 길이: 256 |
이 값을 설정하지 않으면 핸들러 값이 사용됩니다. |
| ProxyPassword | VT_NULL | 프록시 서버 인증에 사용할 사용자 암호를 지정합니다. | 바인딩 파일을 내보낼 때 이 값은 항상 Null로 설정됩니다. 바인딩 파일을 대상 BizTalk Server 구성으로 내보내기 전에 이 필드에 직접 암호를 입력해야 합니다. 최소 길이: 0 최대 길이: 256 |
UseProxy가 0(False)으로 설정된 경우 이 속성에 값을 입력할 필요가 없습니다. |
| ProxyUsername | VT_BSTR | 프록시 서버 인증에 사용할 사용자 이름을 지정합니다. | 최소 길이: 0 최대 길이: 256 |
UseProxy가 0(False)으로 설정된 경우 이 속성에 값을 입력할 필요가 없습니다. |
| UseHandlerSetting | VT_BOOL | 송신 포트 구성이 HTTP 송신 핸들러에 대해 지정된 프록시 설정을 사용해야 함을 지정합니다. | 유효한 값은 다음과 같습니다. - -1(true) - 0(false) |
기본값은 -1(True)입니다. |
다음 코드는 속성을 설정하는 데 사용하는 XML 문자열의 형식을 보여 줍니다.
<CustomProps>
<ProxyPort vt="3">80</ProxyPort>
<RequestTimeout vt="3">60</RequestTimeout>
<Certificate vt="8">A7 6D F9 06 5E FC 97 66 75 59 B5 D6 67 0C 84 DC 64 F5 BF B9</Certificate>
<AuthenticationScheme vt="8">Basic</AuthenticationScheme>
<Username vt="8">authenticateduser</Username>
<EnableChunkedEncoding vt="11">-1</EnableChunkedEncoding>
<UseProxy vt="11">-1</UseProxy>
<ProxyName vt="8">proxyserver</ProxyName>
<UseSSO vt="11">0</UseSSO>
<Password vt="1" />
<MaxRedirects vt="3">5</MaxRedirects>
<ContentType vt="8">text/xml</ContentType>
<ProxyPassword vt="1" />
<ProxyUsername vt="8">proxyuser</ProxyUsername>
<UseHandlerSetting vt="11">0</UseHandlerSetting>
</CustomProps>