在 Windows 伺服器上設定 Qlik 資料閘道 - 直接存取

您也可以從命令列自動註冊 直接存取閘道，而無需使用 管理 活動中心。此方法使用由 OAuth 用戶端產生的短效工作階段 Token。

必要條件

具有建立與管理 OAuth 用戶端的租用戶管理員權限之 API 金鑰。

使用自動註冊來註冊閘道

1. 在 直接存取閘道 機器上產生 JSON Web Key (JWK)。此命令會在 直接存取閘道 機器上建立私密金鑰：

   ConnectorAgent.exe qcs generate_jwk

2. 複製命令傳回的 JWK。

3. 使用 API 金鑰，透過租用戶管理員 API 為閘道建立 OAuth 用戶端，並提供您在上一步複製的 JWK。

   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. 要求存取 Token。這也會觸發自動建立閘道所使用的機器人使用者帳戶。

   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 註冊」角色。

    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>

移除自動註冊的閘道

請使用下列步驟，取消註冊透過上述以工作階段 Token 為基礎的自動方法所註冊的閘道。這些步驟也會移除為其建立的 OAuth 用戶端、機器人使用者和角色。

1. 產生斷言，如使用工作階段 Token 自動註冊閘道的步驟六中所述。

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>"