Windows 서버에 Qlik 데이터 게이트웨이 - 직접 액세스 설정하기

관리 활동 센터를 사용하지 않고 명령줄에서 직접 액세스 게이트웨이을(를) 자동으로 등록할 수도 있습니다.이 메서드는 OAuth 클라이언트에서 생성된 수명이 짧은 세션 토큰을 사용합니다.

전제 조건

OAuth 클라이언트를 생성하고 관리할 수 있는 테넌트 관리자 권한을 가진 API 키.

자동 등록으로 게이트웨이 등록하기

1. 직접 액세스 게이트웨이 머신에서 JSON Web Key(JWK)를 생성합니다.이 명령은 직접 액세스 게이트웨이 머신에서 프라이빗 키를 생성합니다:

   ConnectorAgent.exe qcs generate_jwk

2. 명령에서 반환된 JWK를 복사합니다.

3. API 키를 사용하여 이전 단계에서 복사한 JWK를 제공하고, 테넌트 관리자 API를 통해 게이트웨이용 OAuth 클라이언트를 생성합니다.

   curl "https://<tenant-url>/api/v1/oauth-clients" -X POST -H 'accept: application/json' -H 'content-type: application/json' -H 'authorization: Bearer <api-key>' -d '{"appType":"web","clientName":"<client-name>","description":"","allowedScopes":["admin.direct-access-gateways:register_gateway","admin.direct-access-gateways:delete_gateway"],"allowedAuthMethods":["private_key_jwt"],"publicKeys":[<jwk>],"allowedGrantTypes":["client_credentials"]}'

4. 응답에서 반환된 client_id 값을 복사합니다.

5. OAuth 클라이언트의 동의 방법을 신뢰할 수 있음으로 설정하십시오.

   curl "https://<tenant-url>/api/v1/oauth-clients/<client-id>/connection-configs/me" -X PATCH -H 'accept: application/json' -H 'content-type: application/json' -H 'authorization: Bearer <api-key>' -d '[{"op":"replace","path":"/consentMethod","value":"trusted"}]'

6. 직접 액세스 게이트웨이 머신에서 등록 어설션을 생성합니다:

   ConnectorAgent.exe qcs generate_registration_assertion --tenant_url <tenant-url> --client-id <client-id>

7. 액세스 토큰을 요청합니다.또한 게이트웨이에서 사용하는 봇 사용자 계정의 자동 생성을 트리거합니다.

   curl "https://<tenant-url>/oauth/token" -X POST -H 'content-type: application/x-www-form-urlencoded' -d "grant_type=client_credentials" -d "client_id=<client-id>" -d "client_assertion_type=urn:ietf:params:oauth:client-assertion-type:jwt-bearer" -d "client_assertion=<assertion>" -d "scope=admin.direct-access-gateways:register_gateway admin.direct-access-gateways:delete_gateway"

8. 자동 생성된 봇 사용자를 조회합니다.

   curl "https://<tenant-url>/api/v1/users" -H 'accept: application/json' -H 'authorization: Bearer <API-key>'

9. my-bot-client의 ID를 복사합니다.

10. "DAG Registration" 역할을 생성합니다.

    curl "https://<tenant-url>/api/v1/roles" -X POST -H 'accept: application/json' -H 'content-type: application/json' -H  'authorization: Bearer API-key' -d '{"name":"DAG Registration","description":"Role for registering a gateway","assignedScopes":["admin.direct-access-gateways:register_gateway", "admin.direct-access-gateways:delete_gateway"]}'

11. 봇 사용자에게 테넌트 수준 역할을 할당합니다.

    curl "https://<tenant-url>/api/v1/users/<bot-user-ID>" -X PATCH  -H 'accept: application/json' -H 'content-type: application/json' -H  'authorization: Bearer <API-key>' -d ' [ { "op": "replace", "path": "/assignedRoles", "value": [ { "name": "DAG Registration" } ] } ]'

12. 직접 액세스 게이트웨이 공간을 가져옵니다.

    curl "https://<tenant-url>/api/v1/spaces" -H  'authorization: Bearer <API-key>'

13. Direct Access Gateway 스페이스 ID를 복사합니다.

14. 편집 가능 권한으로 봇 사용자를 스페이스에 추가하세요.

    curl "https://<tenant-url>/api/v1/spaces/<DAG-space-ID>/assignments" -X POST -H 'accept: application/json' -H 'content-type: application/json' -H  'authorization: Bearer <API-key>' -d '{"assigneeId": "<Bot-user-ID>","roles": ["consumer","dataconsumer","producer"], "type": "user"}'

15. 기존 어설션이 만료된 경우 새 어설션을 생성하십시오.

    ConnectorAgent.exe qcs generate_registration_assertion --tenant_url <tenant-url> --client-id <client-ID>

16. 게이트웨이 등록:

    ConnectorAgent.exe qcs register_gateway --tenant_url <tenant-url> --gateway_name <gateway-name> --gateway_description <gateway-description> --space_name <space-name> --client-id <client-ID> --assertion <assertion>

자동으로 등록된 게이트웨이 제거

위에서 설명한 자동 세션 토큰 기반 방법을 사용하여 등록된 게이트웨이의 등록을 취소하려면 다음 단계를 따르십시오.이 단계를 수행하면 이를 위해 생성된 OAuth 클라이언트, 봇 사용자 및 역할도 제거됩니다.

1. 세션 토큰을 사용한 자동 게이트웨이 등록의 6단계에 설명된 대로 어설션을 생성합니다.

2. 게이트웨이 삭제:

   ConnectorAgent.exe qcs delete_gateway --tenant_url <tenant-url> --gateway_name <gateway-name> --client-id <client-ID> --assertion <assertion>

3. JWK를 삭제합니다.

   ConnectorAgent.exe qcs delete_jwk

4. 게이트웨이용으로 생성된 봇 사용자 계정을 조회합니다.

   curl "https://<tenant-url>/api/v1/users" -H 'accept: application/json' -H 'authorization: Bearer <api-key>'

5. 봇 ID를 복사합니다.

6. 이 봇 사용자 계정을 삭제합니다.

   curl -X DELETE "https://<tenant-url>/api/v1/users/<bot-user-ID>" -H "Authorization: Bearer <api-key>"

7. 게이트웨이를 위해 생성된 “DAG Registration” 역할을 조회합니다.

   curl "https://<tenant-url>/api/v1/roles?limit=1&filter=(name eq \"DAG Registration\")" -H "Authorization: Bearer <api-key>"

8. 역할 ID를 복사합니다.

9. 이 역할을 삭제합니다.

   curl -X DELETE "https://<tenant-url>/api/v1/roles/<role-ID>" -H "Authorization: Bearer <api-key>"

10. OAuth 클라이언트를 삭제합니다.

    curl -X DELETE "https://<tenant-url>/api/v1/oauth-clients/<client-ID>" -H "qlik-confirm-delete: <client-ID>" -H "Authorization: Bearer <api-key>"