ThingWorx 공용 액세스 구성
Vuforia Studio에서, 프로젝트의 액세스 속성을 공용으로 설정하면 게시된 프로젝트의 경험에 공용 액세스가 가능하도록 구성할 수 있습니다. 이렇게 하면 Experience Service에 게시된 콘텐츠에 인증 없이 액세스할 수 있습니다. 공용 경험이 ThingWorx의 데이터에 액세스해야 하는 경우 Experience Service는 공용 경험이 ThingWorx에 익명으로 액세스할 수 있도록 구성되어야 합니다.
Experience Service는 ThingWorx 서버에 대해 프록시로 동작합니다. 경험이 ThingWorx에 속성 값 읽어들이기 또는 서비스 호출을 요청하면 해당 요청은 먼저 Experience Service를 통해 경로가 지정됩니다. 공개 경험의 경우 요청을 ThingWorx 서버에 전달하기 전에 Experience Service 프록시는 응용 프로그램 키를 해당 요청에 첨부합니다. 이 응용 프로그램 키는 요청의 실행에 사용된 ThingWorx 자격 증명을 식별합니다. 필요한 ThingWorx 공용 액세스가 경험에 부여될 수 있도록 Experience Service는 적절한 응용 프로그램 키로 구성되어야 합니다.
경험이 ThingWorx의 데이터를 제공하는 경우, ThingWorx의 데이터에 대한 공용 액세스 권한 역시 제공되어야 합니다.
응용 프로그램 키 구성
|
|
설치 프로그램에서 ThingWorx 서버를 구성할 때 ThingWorx Core 서버의 공용 액세스 구성 옵션을 선택한 경우, 이 섹션에 설명된 공용 액세스 응용 프로그램 키 구성을 설치 프로그램이 자동으로 완료합니다. 이 응용 프로그램 키를 수동으로 생성하려면 다음 설명에 따르십시오.
|
사용자 인증 요청 프롬프트 없이 ThingWorx에 대해 공용 경험 액세스를 허용하려면 Experience Service 및 연결된 ThingWorx 서버가 공용 액세스를 사용 가능하도록 구성되어야 합니다. ThingWorx에 대해 공용 액세스를 허용하려면, 공개적으로 연결된 경험이 요구하는 ThingWorx의 속성 또는 서비스 액세스에 사용할 수 있는 공용 응용 프로그램 키가 ThingWorx에 생성되어야 합니다. 다음 단계를 사용하여 필요한 응용 프로그램 키를 ThingWorx에 생성합니다.
1. es-public-access라는 이름으로 사용자를 생성합니다.
2. es-public-access-org라는 이름으로 조직을 생성합니다.
3. es-public-access 사용자를 es-public-access-org 조직에 추가합니다.
4. 사용자를 구성하여 사용자가 공용 경험이 요구하는 ThingWorx 데이터 액세스에 필요한 사용 권한을 보유하도록 합니다. es-public-access 사용자에게 반드시 부여해야 하는 사용 권한에 대한 자세한 내용은 아래 “사용자 승인” 섹션을 참조하십시오.
5. es-public-access-org 조직을 구성하여, 공용 경험이 요구하는 ThingWorx 데이터 액세스에 필요한 표시 유형 사용 권한을 조직에 부여합니다. es-public-access-org 조직에 반드시 부여해야 하는 표시 유형 사용 권한에 대한 자세한 내용은 아래 “사용자 승인” 섹션을 참조하십시오.
6. 응용 프로그램 키를 만들어
es-public-access 사용자에 연결합니다. 자세한 내용은
응용 프로그램 키 생성 항목을 참조하십시오.
|
|
응용 프로그램 키에는 반드시 적절한 만료 날짜가 설정되어야 합니다.
|
7. Experience Service 설치 디렉터리에 있는 configuration.json 파일을 편집하여 proxies.0.appKey 매개변수 값을 6단계에서 만든 응용 프로그램 키의 keyId 속성 값과 같게 설정하십시오.
WebSocket 연결에 대한 사용자 승인
|
|
설치 프로그램에서 ThingWorx 서버를 구성할 때 ThingWorx Core 서버의 공용 액세스 구성 옵션을 선택한 경우, 이 장에 설명된 액세스 제어 구성을 설치 프로그램이 자동으로 완성합니다. 다음 설명은 필요한 사용 권한을 수동으로 구성하는 경우에 포함됩니다.
|
공용 경험의 사용자가 ThingWorx의 필요한 속성 및 서비스에 액세스할 수 있도록 하려면 위에 정의된 es-public-access 사용자에게 다음과 같은 WebSocket 연결에 대한 ThingWorx의 사용 권한을 부여해야 합니다.
• 런타임 서비스 실행—EntityServices 리소스에 대한 GetClientApplicationKey 서비스 사용 권한
• 표시 유형—EntityServices 리소스에 대한 사용 권한
• 런타임 인스턴스 서비스 실행—SDKGateway 사물 템플릿에 대한 사용 권한
• 표시 유형 인스턴스—SDKGateway 사물 템플릿에 대한 사용 권한
이러한 사용 권한 부여에 대한 자세한 내용은
사용자 권한 부여의 “WebSocket 연결 사용” 섹션을 참조하십시오.
경험 데이터에 대한 사용자 승인
|
|
여기서는 ThingWorx 속성, 서비스 및 해당 경험이 요구하는 이벤트에 액세스할 수 있도록 공용 연결 경험의 사용자에게 부여해야 하는 사용 권한에 대해 설명합니다. 각 경험은 ThingWorx 속성, 서비스 및 이벤트 액세스를 위한 고유의 요구 사항을 가지므로 여기에 설명된 구성은 설치 프로그램이 수행하지 않으며 수동으로 완료해야 합니다.
|
공용 경험의 사용자가 ThingWorx 속성, 서비스 및 공용 연결 경험이 사용하는 이벤트에 액세스할 수 있도록 하려면 위에 정의된 es-public-access 사용자에게 다음과 같은 ThingWorx의 사용 권한을 부여해야 합니다.
• 런타임 속성 읽기—공용 경험에서 값이 표시되는 추가 속성에 대한 사용 권한
• 런타임 속성 쓰기—공용 경험에서 값이 수정되는 추가 속성에 대한 사용 권한
• 런타임 서비스 실행—공용 경험이 사용하는 추가 서비스에 대한 사용 권한
• 표시 유형—공용 경험이 액세스하는 엔티티에 대한 사용 권한
이러한 사용 권한 부여에 대한 자세한 내용은
사용자 권한 부여의 “속성, 서비스 및 이벤트 액세스 사용” 섹션을 참조하십시오.
