BizTalk Server 관리 REST API 설치 및 구성

아티클
10/14/2023

관리 데이터 API란?

관리 데이터 API는 BizTalk Server 환경에서 다른 아티팩트 상태 원격으로 업데이트, 추가 및 쿼리할 수 있는 엔드포인트입니다. 엔드포인트는 REST를 사용하여 추가되며 swagger 정의와 함께 제공됩니다.

BizTalk Server 2016 기능 팩 1부터 이러한 REST API 및 해당 swagger 정의를 설치하는 Windows PowerShell 스크립트가 있습니다. 이러한 API는 REST를 호출하여 포트, 오케스트레이션, 파트너, 계약, 파이프라인 등을 원격으로 관리합니다.

사용 가능한 API를 보려면 REST API 참조를 참조하세요.

필수 구성 요소

BizTalk Server 기능 팩 2 이상 기능 팩을 설치합니다.
BizTalk Server IIS를 설치합니다. 대부분의 BizTalk Server 환경에서 IIS가 이미 설치되어 있습니다. BizTalk Server 2016의 하드웨어 및 소프트웨어 요구 사항을 참조하세요. 인터넷 정보 서비스 관리자를 열어 IIS가 설치되어 있는지 확인합니다.

1단계: REST API 설치

관리자 권한으로 Windows PowerShell 실행합니다(시작 메뉴 > 유형 PowerShell>에서 관리자 권한으로 실행을 마우스 오른쪽 단추로 클릭>).
BizTalk 설치 폴더로 이동합니다(예: cd 'C:\Program Files (x86)\Microsoft BizTalk Server 2016\').
다음 텍스트에서 , , mgmtServiceAppPool, domain/user및 passworddomain\group 을 값으로 바꿉 Default Web Site있습니다.
```
FeaturePack.ConfigureServices.ps1 -Service management -WebSiteName '<Default Web Site>' -ApplicationPool <mgmtServiceAppPool> -ApplicationPoolUser <domain>\<user> -ApplicationPoolUserPassword <password> -AuthorizationRoles '<domain>\<group>, <domain>\<group>'
```
다음 예제에서는 라는 애플리케이션 풀RESTAppPool을 만들고, Default Web SiteappPool을 계정으로 bootcampbts2016\btsservice 실행하고, 를 사용자 계정 암호로 사용하고BIZTALK-serviceacct, BizTalk Server Administrators 그룹 권한을 부여합니다. 공백이 있는 값을 둘러싼 작은따옴표를 포함하여 다음을 입력해야 합니다.
```
FeaturePack.ConfigureServices.ps1 -Service management -WebSiteName 'Default Web Site' -ApplicationPool RESTAppPool -ApplicationPoolUser bootcampbts2016\btsservice -ApplicationPoolUserPassword  BIZTALK-serviceacct -AuthorizationRoles 'BOOTCAMPBTS2016\BizTalk Server Administrators'
```
완료되면 BizTalkManagementService 애플리케이션이 IIS 내에 만들어집니다.
작동하는지 확인하려면 로 이동합니다 http://localhost/BizTalkManagementService/swagger. 로그인하라는 메시지가 표시되면 이전 단계(-AuthorizationRoles 'BOOTCAMPBTS2016\BizTalk Server Administrators')에서 입력한 domain\group의 구성원인 계정으로 로그인합니다.

경고

IIS의 BizTalkManagementService 애플리케이션은 web.config 파일을 사용합니다. web.config 내 의 요소는 대/소문자를 구분합니다. 따라서 Windows PowerShell 스크립트를 실행할 때 값에 대한 -AuthorizationRoles 올바른 대/소문자를 입력해야 합니다. 사례를 잘 모르는 경우 다음을 쉽게 확인할 수 있습니다.

컴퓨터 관리를 열고 로컬 사용자 및 그룹을 확장합니다.
그룹을 선택하고 SQLServer... 그룹으로 아래로 스크롤합니다.
다음 예제에서는 BOOTCAMPBTS2016 모두 대문자로 표시됩니다. 모든 대문자로 표시되면 컴퓨터 이름을 모든 대문자로 입력합니다.

컴퓨터 이름은 모두 CAPS에 있습니다.

이제 REST API가 IIS를 통해 노출되었으므로 다른 애플리케이션에서 액세스하고 실행할 수 있습니다. REST API 참조는 API를 나열합니다.

관리 애플리케이션의 루트 폴더에 있는 web.config 파일을 수동으로 업데이트하여 액세스 권한이 있는 사용자를 변경할 수 있습니다. 예를 들어 다음을 사용하여 모든 사용자가 swagger 출력에 액세스할 수 있도록 허용합니다.

<authorization>
   <allow users="*" />
</authorization>

2단계: API 테스트

BizTalk Server 으로 이동합니다http://localhost/BizTalkManagementService/swagger.
호스트로 스크롤하고 표시/숨기기를 선택합니다. GET 명령이 있습니다. 다음 행을 클릭합니다.
세부 정보를 표시합니다. 사용해 보기를 선택합니다.
응답 본문은 모든 호스트를 반환합니다.

참고

로 이동 http://localhost/BizTalkManagementService하면 500 오류가 발생합니다. 그건 좋은 일이다. URL 끝에 를 추가 /swagger 하면 사용 가능한 REST API가 표시됩니다.

추가 정보

REST API 참조

기능 팩의 새로운 기능

다음을 통해 공유