ThingWorx를 리소스 공급자로 구성
resourceServerSettings.json 파일 구성
이 절차는 ThingWorx가 리소스 서버 응용 프로그램인 경우 필요합니다.
1. ThingWorx 서버를 중지합니다.
2. sso-settings.json과 동일한 디렉터리에서 resourceServerSettings.json 파일을 만듭니다.
다음은 resourceServerSettings.json 파일의 샘플 구조입니다.
{
"ResourceServerSettings": {
"accessTokenServicesSettings": {
"tokenUsernameAttribute": "See information in the table below",
"tokenPublicKeyUrl": "See information in the table below",
"administratorAlias": "See information in the table below",
"administratorInternalName": "Administrator",
"issuer": "See information in the table below",
"tokenValidationType": "local",
"tokenClientIDAttribute": "See information in the table below"
},
"globalScopes": "See information in the table below",
"scopeClaimName: "See information in the table below",
"uriScopes": [
{
"uri": "See information in the table below",
"scopes": "See information in the table below",
"method": "See information in the table below"
}
]
}
3. 모든 매개 변수의 값을 사용자의 요구사항에 따라 편집해야 합니다. 구현은 조직의 보안 정책, 페더레이션에 대한 CAS 등 여러 요인에 따라 다를 수 있습니다. 다음 표의 정보를 지침으로 사용하여 서로 다른 매개 변수의 값을 설정합니다.
4. ThingWorx 서버를 시작합니다.
|
매개 변수
|
설명
|
값
|
||
|---|---|---|---|---|
|
tokenUsernameAttribute
|
선택 사항: 리소스 요청에 대한 사용자 이름을 보유하는 클레임 이름입니다.
|
기본값: “unique_name”
|
||
|
tokenPublicKeyUrl
|
필수: AD FS 공개 키 끝점입니다(액세스 토큰의 유효성 검사에 사용됨).
|
값은 다음과 같이 구성됩니다.
https://<ADFS 호스트 FQDN>adfs/discovery/keys
|
||
|
administratorAlias
|
선택 사항.
ThingWorx 관리자와 함께 RP에 액세스하려는 경우에만 필수입니다.
|
AD FS에서 구성된 관리자 사용자 이름입니다.
|
||
|
administratorInternalName
|
선택 사항: ThingWorx에서 구성된 관리자 사용자 이름입니다.
|
Administrator
|
||
|
tokenValidationType
|
필수: 로컬에서 수행된 액세스 토큰(JWT) 유효성 검사의 속성 지점입니다.
|
local
|
||
|
issuer
|
선택 사항: 추가 토큰 유효성 검사에 대한 발급자 값입니다.
|
토큰의 ISS 클레임에 나타나는 발급자 값입니다.
|
||
|
tokenClientIDAttribute
|
M2M(클라이언트 자격 증명) 흐름에 필요합니다. 리소스 요청에 대한 SP clientID를 보유하는 클레임 이름입니다.
|
appid
|
|
매개 변수
|
설명
|
값
|
|---|---|---|
|
globalScopes
|
쉼표로 구분된 전역 범위의 목록입니다. accessToken에는 모든 리소스에 액세스하기 위해 최소한 하나가 포함되어야 합니다. 매개 변수가 없거나 비어 있으면 THINGWORX가 기본 전역 범위로 설정됩니다.
|
"globalScopes": "THINGWORX |
|
scopeClaimName
|
선택 사항. 기본값은 scp입니다.
|
|
매개 변수
|
설명
|
값
|
||
|---|---|---|---|---|
|
uri
|
URI 패턴입니다. 전역 범위에 추가 범위가 필요한 리소스 또는 리소스 그룹을 정의합니다.
|
Thingworx/Things/** - control all Things Thingworx/Things/Thing1 – control Thing1 |
||
|
scopes
|
추가 범위의 쉼표로 구분된 목록입니다. 나열된 모든 범위(전역 포함)에 대한 권한을 가진 사용자만 리소스를 볼 수 있습니다.
|
|||
|
method
|
선택 사항. 범위가 적용될 URI 메소드를 정의합니다.
|
가능한 값은 REST 프로토콜에서 사용할 수 있는 메소드(예: GET 또는 POST)입니다.
|
URI에 대해 정의된 범위가 있는 경우 전역 범위와 정의된 URI 범위를 부여해야 해당 리소스에 액세스할 수 있습니다. 요청된 리소스에 적용할 수 있는 URI 규칙이 두 개 이상일 경우 해당 리소스에 액세스하려면 모든 관련 범위를 부여해야 합니다. 제한된 리소스에 액세스하지 않으려면 승인 서버에 없는 범위를 사용하여 이러한 REST 끝점에 URIscope를 추가합니다. 범위 보호 외에 ThingWorx에는 범위 위에도 적용될 고유한 사용자 기반 권한도 있습니다. 예를 들어, 사용자 A가 올바른 범위로 리소스를 요청하지만 권한이 없는 경우 403 오류와 함께 요청이 실패합니다.
예제 파일
