통합 커넥터 생성
통합 커넥터를 생성하려면 다음을 수행하십시오.
1. Composer에서 > 를 찾은 다음 새로 만들기를 클릭합니다.
2. 다음 사물 템플릿 중 하나를 선택한 다음 확인을 클릭합니다.
◦ GenericConnector
◦ HTTPConnector
◦ ODataConnector
◦ SAPODataConnector
◦ SwaggerConnector
◦ WindchillSwaggerConnector
위의 사물 템플릿에 대한 자세한 내용은 통합 커넥터 개요를 참조하십시오.
3. 이름 및 설명을 입력합니다.
4. 선택한 사물 템플릿에 따라 구성 영역에서 백엔드 시스템에 대한 연결을 설정합니다.
|
사물 템플릿
|
설명
|
||||
|---|---|---|---|---|---|
|
일반 커넥터 연결 설정
|
• 새로 고침 간격(분): 끝점 캐시를 새로 고치는 간격을 지정합니다. 기본값은 60분입니다.
• 인증 유형: 다음 중 하나를 입력합니다.
◦ 없음
◦ 고정
이 인증 유형의 경우 백엔드 응용 프로그램에 대한 서비스 계정이 필요합니다. 이 계정은 실제 사용자가 아닙니다. 이 계정의 목적은 다른 응용 프로그램에 액세스할 수 있도록 하는 것입니다. ThingWorx 응용 프로그램에서의 모든 액세스는 백엔드 응용 프로그램에서 이 서비스 계정을 사용합니다.
◦ SSO
자세한 내용은 SSO(Single Sign-On) 인증을 참조하십시오.
• 승인 서버 ID: SSO 인증 유형에만 해당됩니다.
연결할 승인 서버의 ID를 입력합니다.
ThingWorx가 SSO를 위해 구성되는 경우 서버 관리자가 ID를 지정합니다. 이 값을 읽어들이려면 ThingWorx가 설치된 sso-settings.json 파일의 authServerId.clientID 설정에 사용된 <authServerId> 변수를 참조하십시오. Apache Tomcat 서버 관리자에게 문의하여 승인 서버 ID를 요청할 수 있습니다.
자세한 내용은 sso-settings.json 구성 항목을 참조하십시오.
|
||||
|
CSRF 설정
|
다음 필드에 값을 입력합니다.
• CSRF Get 요청에 대한 상대 URL
기본 URL에 상대적인 값을 설정하면 CSRF 토큰이 응답 머리글로 반환됩니다. Google의 Postman 플러그인과 같은 도구에서 GET 요청을 만들어 URL의 유효성을 검사합니다. 요청 시 백엔드 시스템에서 CSRF 토큰을 반환할 머리글을 지정해야 합니다. 요청 머리글의 값을 Fetch로 설정합니다. 응답에는 유효한 토큰이 있는 머리글이 해당 값으로 포함되어야 합니다.
예를 들어, Windchill REST Services(WRS) 패치가 적용된 Windchill 인스턴스의 경우 이 구성 값은 servlet/odata처럼 간단할 수 있습니다.
• CSRF 토큰 이름
백엔드 시스템이 CSRF 토큰을 반환할 머리글의 이름입니다. WRS가 있는 Windchill 시스템의 경우 머리글 이름은 CSRF_NONCE입니다.
|
||||
|
HTTP 커넥터 연결 설정: 고정 인증 유형에만 해당됩니다.
|
• 다음 필드에 값을 입력합니다.
◦ 사용자 이름
◦ 암호
◦ 암호 확인
OData 백엔드 시스템에 대한 서비스 경로 URL입니다. 도메인이 여러 개 있는 경우 여러 행을 입력합니다. 아래에 상대 URL을 입력하는 경우 해당 URL이 경로의 일부로 사용됩니다.
예를 들어, 상대 URL이 /servlet/odata이고 서비스 경로 URL이 /ProdMgmt 및 /DataAdmin이면 기본 URL에 상대적인 유효한 서비스 URL이 /servlet/odata/ProdMgmt 및 /servlet/odata/DataAdmin이 됩니다. 이러한 서비스 경로 URL은 하나 이상의 OData 사양을 지정합니다. 각 서비스 경로 URL의 경우 /$metadata 경로가 추가되고 OData 사양을 읽어들이도록 리소스가 요청됩니다.
• 모든 인증 유형에 대해 다음 URL 필드에 정보를 입력합니다. 사물 템플릿이 기본값을 제공한 경우 해당 값을 변경하지 마십시오. 예를 들어, SAPODataConnector에 대한 상대 URL 및 연결 URL이 제공됩니다. 이러한 URL은 관련 사양을 찾는 카탈로그 서비스를 가리킵니다.
◦ 기본 URL: 기본 URL은 백엔드 시스템에 액세스하는 데 필요합니다. 여기에는 백엔드 시스템의 호스트, 포트 및 응용 프로그램이 포함됩니다.
SSO의 경우 OAuth를 지원하는 URL을 입력합니다. 자세한 내용은 범위 작업을 참조하십시오.
◦ 상대 URL: API가 서비스되는 URL로, 기본 URL에 상대적입니다.
◦ 연결 URL: 연결을 확인하는 데 사용되는 URL로, 기본 URL에 상대적입니다.
레거시 데이터 가져오기: 확인란을 선택하지 않으면 새로 노출된 매개 변수가 표시됩니다. 최신 매핑에 따라 끝점 정의에 새 매개 변수가 도입되었습니다. 자세한 내용은 속성 기본 유형을 참조하십시오. 이 확인란은 기본적으로 선택되어 있습니다.
|
||||
|
OData 커넥터 연결 설정: ODataConnector에만 해당됩니다.
|
|||||
|
SAPODataConnector
|
|||||
|
Swagger 커넥터 연결 설정
|
• Swagger 사양의 상대 URL: 백엔드 시스템에서 Swagger 사양을 가져오는 데 사용되는 URL입니다. 이는 기본 URL에 상대적입니다.
|
승인 서버 범위 설정 아래: SSO 인증 유형에만 해당됩니다.
승인 서버에 표시된 대로 정확하게 범위 이름을 입력합니다. 이러한 범위는 리소스 공급자에서 정의되고 승인 서버에 등록됩니다. 자세한 내용은 범위 작업을 참조하십시오.
5. 통합 커넥터의 서비스 노출을 진행합니다.
6. 저장을 클릭합니다.
 |
연결 상태 정보는 > > 에서 제공됩니다. 자세한 내용은 통합 커넥터의 상태 모니터링을 참조하십시오.
|