미디어
미디어 엔티티는 ThingWorx 응용 프로그램 구현에 사용되는 로컬로 저장된 미디어 아티팩트 또는 동적 콘텐츠일 수 있습니다. 대부분의 경우 메뉴, 스타일 정의 및 매쉬업과 같은 엔티티에 사용되는 이미지와 아이콘이 여기에 포함됩니다. 로컬로 저장된 미디어 엔티티는 JPEG, PNG 및 BMP 이미지 유형을 지원합니다. 다른 파일 유형을 사용하려면 해당 유형을 동적 콘텐츠로 참조하고 원하는 MIME 유형을 포함하도록 platform-settings.json 파일에서 supportedMediaEntityContentTypes 매개 변수를 수정합니다.
일반 정보
다음 필드는 미디어 엔티티를 정의합니다.
• 이름
필수 필드
• 설명
엔티티를 설명하는 선택 필드
• 프로젝트
이 미디어 엔티티가 속한 객체의 컬렉션
• 태그
적용 가능한 태그를 포함하는 선택 필드
• 이미지
미디어 엔티티가 사용하는 로컬에 저장된 이미지
• 마지막으로 수정한 날짜
마지막 편집 날짜 및 시간
구성
|
이름
|
기본값
|
설명
|
|---|---|---|
|
커넥터 이름
|
-
|
ThingWorx Flow 커넥터 이름을 지정합니다.
미디어 엔티티를 통해 ThingWorx Flow에 액세스하려면 이 속성을 설정합니다.
|
|
SSL 오류 무시
|
선택되지 않음/false
|
URL에 액세스할 때 발생하는 자체 서명된 인증서와 같은 SSL 오류를 무시하려면 이 속성을 선택합니다.
ThingWorx 8.0.7, 8.1.3 및 8.2.1 이상 버전에서 호환 가능 SSL(Secure Sockets Layer) 인증을 지원하기 위해 아래의 SSL 연결 구성 설정을 사용할 수 있습니다.
|
|
이름
|
기본값
|
설명
|
||
|---|---|---|---|---|
|
동적 콘텐츠
|
선택되지 않음/false
|
동적 콘텐츠를 사용하려면 이 속성을 선택합니다. 선택하지 않으면 미디어 엔티티는 ThingWorx 서버에 저장된 콘텐츠를 사용합니다.
|
||
|
URL
|
동적 콘텐츠 업스트림 원본 서버의 URL입니다. 특정 파일에 대한 전체 URL이거나 콘텐츠가 저장된 서버의 기본 URL일 수 있습니다. SSO(Single Sign-On)의 경우 OAuth를 지원하는 URL을 입력합니다. 기본 URL 사용에 대한 자세한 내용은 미디어 엔티티 서비스 메소드 항목의 GetProxyUrl 단원을 참조하십시오.
|
|||
|
SSL 오류 무시
|
선택되지 않음/false
|
URL에 액세스할 때 발생하는 자체 서명된 인증서와 같은 SSL 오류를 무시하려면 이 속성을 선택합니다.
양방향 SSL(Secure Sockets Layer) 인증을 지원하기 위해 아래의 SSL 연결 구성 설정을 사용할 수 있습니다.
|
||
|
제한 시간
|
60
|
URL에 지정된 원본 서버의 응답 대기 시간(초)입니다. 원본 서버가 이 시간 내에 응답하지 않으면 요청이 실패합니다.
|
||
|
인증 유형
|
없음
|
URL에 지정된 원본 서버에 필요한 인증입니다. 옵션은 다음과 같습니다.
• 없음: 인증이 필요하지 않습니다. 이는 기본 설정입니다.
• 기본: 기본 인증이 필요한 서버에 콘텐츠가 있는 경우 이 옵션을 선택합니다. 선택하면 사용자 이름 및 암호 속성이 서버 인증에 사용됩니다.
• SSO(Single Sign-On):
SSO에 대한 자세한 내용은 ThingWorx SSO(Single Sign-On) 기능을 참조하십시오.
• 세션 사용자:
SSO를 사용하지 않고 사용자 계정에 대한 인증을 지원하려면 이 옵션을 선택합니다. 이 옵션을 선택할 때 아래의 세션 사용자 질의 매개 변수를 제공해야 합니다. 이 매개 변수는 콘텐츠 프록시 요청에 질의 매개 변수로 전송됩니다.
|
||
|
사용자 이름
|
기본 인증을 위한 사용자 이름입니다. 이 속성은 기본이 인증 유형으로 선택된 경우에만 사용되더라도 항상 표시됩니다.
|
|||
|
암호
|
기본 인증을 위한 암호입니다. 이 속성은 기본이 인증 유형으로 선택된 경우에만 사용되더라도 항상 표시됩니다.
|
|||
|
승인 서버 ID
|
이 설정은 SSO(Single Sign-On) 인증 유형에만 적용됩니다. 연결할 승인 서버의 ID를 입력합니다. ThingWorx가 SSO 인증을 위해 구성되는 경우 서버 관리자가 ID를 지정합니다. 이 값을 검색하려면 ThingWorx가 설치된 sso-settings.json 파일의 authServerId.clientID 설정에 사용된 <authServerId> 변수를 참조하십시오. 승인 서버 ID를 요청하려면 Apache Tomcat 서버 관리자에게 문의해야 합니다. 자세한 내용은 sso-settings.json 파일 구성을 참조하십시오.
|
|||
|
연결 테스트 URL
|
미디어 엔티티 구성의 유효성을 검사하는 데 사용되는 URL입니다. 저장할 때 미디어 엔티티 구성이 잘못된 경우 연결 오류 메시지가 나타납니다. 관리자는 해당 구성을 수정하고 저장해야 합니다. 잘못된 미디어 엔티티 구성을 가져오거나 내부 마이그레이션을 수행하면 응용 프로그램 로그에 오류 메시지가 기록되고, 미디어 엔티티에 대한 동적 콘텐츠 플래그가 false로 설정되고, 가져오기 또는 내부 마이그레이션이 계속됩니다. 관리자는 동적 콘텐츠 플래그를 true로 재설정하는 것을 비롯하여 해당 구성을 수정해야 합니다.
예를 들어, 다음 URL을 사용하여 인증 유형에 따라 Windchill 서버에 대한 프록시를 테스트할 수 있습니다.
• 기본: https://HOST/Windchill/servlet/WindchillAuthGW/wt.httpgw.HTTPServer/echo
• SSO: https://HOST/Windchill/oauth/servlet/WindchillAuthGW/wt.httpgw.HTTPServer/echo
• 세션 사용자: https://HOST/Windchill/sslClientAuth/servlet/WindchillAuthGW/wt.httpgw.HTTPServer/echo
|
|||
|
Headers To Forward on POSTs
|
이 값은 POST 요청으로 액세스되는 동적 콘텐츠에만 사용되는 경우에도 항상 표시됩니다. 값은 머리글 이름의 쉼표로 구분된 목록이어야 합니다. 이 엔티티가 HTTP POST 요청을 수신하면 선택한 머리글과 값이 ThingWorx 요청에서 동적 콘텐츠의 URL에 대한 요청으로 복사됩니다.
|
|||
|
서버에서 브라우저 캐시 유효성 검사
|
선택되지 않음/false
|
성능을 향상시키기 위해 ThingWorx는 미디어 엔티티를 캐시합니다. 동적 콘텐츠가 선택되거나 true인 경우 미디어 엔티티를 서버에서 가져옵니다. 동적 콘텐츠를 수정할 때 이 확인란을 true로 설정하고 미디어 엔티티 새로 고침을 강제로 수행합니다.
새로 고침을 강제로 수행하는 방법에 대한 자세한 내용은 인터넷 브라우저의 도움말을 참조하십시오.
|
승인 서버 범위 설정
이러한 설정은 SSO(Single Sign-On) 인증 유형에만 해당됩니다.
승인 서버에 표시된 대로 정확하게 범위 이름을 입력합니다. 이러한 범위는 리소스 공급자에서 정의되고 승인 서버에 등록됩니다. 자세한 내용은 범위 작업을 참조하십시오.
SSL 연결 구성
SSL 오류 무시 설정(위에 설명됨)이 선택되었거나 true인 경우 또는 다음 구성 설정이 정의된 경우 미디어 엔티티에 대해 모든 프록시 요청을 실행할 때 SSL 컨텍스트를 사용해야 합니다. 이 구성은 호환 가능 SSL 인증 또는 인증서의 교환을 활성화합니다.
|
이름
|
설명
|
|---|---|
|
SSL 키 저장소 경로
|
인증서에 대한 경로입니다.
|
|
SSL 키 저장소 암호
|
키 저장소 파일/인증서에 대한 암호입니다.
|
|
SSL 신뢰 저장소 경로
|
CA(인증 기관) 또는 다른 인증서의 신뢰 인증서에 대한 경로입니다.
|
|
SSL 신뢰 저장소 암호
|
신뢰 저장소 파일/다른 인증서에 대한 암호입니다.
|
세션 사용자 구성
인증 유형을 세션 사용자로 설정한 경우 이 구성이 필요합니다.
|
이름
|
기본값
|
설명
|
|---|---|---|
|
세션 사용자 질의 매개 변수
|
인증 유형을 세션 사용자로 설정할 때 세션 사용자 질의 매개 변수를 입력해야 합니다. 이 값 및 로그인된 세션 사용자 ID는 콘텐츠 프록시 요청에 질의 매개 변수로 전송됩니다. 예를 들어, 콘텐츠 프록시 요청과 함께 wt.effectiveUid를 Windchill로 보낼 수 있습니다.
|