Bir Windows sunucusunda Qlik Data Gateway - Doğrudan Erişim kurulumu

Ayrıca Yönetim etkinlik merkezini kullanmadan, komut satırından otomatik olarak Doğrudan Erişim ağ geçidi kaydı da yapabilirsiniz. Bu yöntem, bir OAuth istemcisinden oluşturulan kısa ömürlü bir oturum belirteci kullanır.

Ön koşullar

OAuth istemcileri oluşturmak ve yönetmek için kiracı yöneticisi iznine sahip bir API anahtarı.

Ağ geçidini otomatik kayıt ile kaydetme

1. Doğrudan Erişim ağ geçidi makinesinde bir JSON Web Key (JWK) oluşturun. Bu komut, Doğrudan Erişim ağ geçidi makinesinde özel anahtarlar oluşturur:

   ConnectorAgent.exe qcs generate_jwk

2. Komutun döndürdüğü JWK'yi kopyalayın.

3. API anahtarını kullanarak ve önceki adımda kopyaladığınız JWK'yi sağlayarak, kiracı yönetici API'si aracılığıyla ağ geçidi için bir OAuth istemcisi oluşturun.

   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. Yanıtta döndürülen client_id değerini kopyalayın.

5. OAuth istemcisinin onay yöntemini güvenilir olarak ayarlayın.

   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. Doğrudan Erişim ağ geçidi makinesinde bir kayıt onaylaması oluşturun:

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

7. Bir erişim belirteci isteyin. Bu, ağ geçidi tarafından kullanılan bot kullanıcı hesabının otomatik olarak oluşturulmasını da tetikler.

   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. Otomatik oluşturulan bot kullanıcısını arayın.

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

9. my-bot-client kimliğini kopyalayın.

10. Bir "DAG Registration" rolü oluşturun.

    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. Bot kullanıcısına kiracı düzeyinde roller atayın.

    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. Direct Access Gateway alanını alın.

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

13. Direct Access Gateway alan kimliğini kopyalayın.

14. Bot kullanıcısını Düzenleyebilir izniyle alana ekleyin.

    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. Mevcut onaylamanın süresi dolduysa yeni bir tane oluşturun.

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

16. Ağ geçidini kaydedin:

    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>

Otomatik olarak kaydedilen bir ağ geçidini kaldırma

Yukarıda açıklanan otomatik, oturum belirteci tabanlı yöntem kullanılarak kaydedilen bir ağ geçidinin kaydını silmek için aşağıdaki adımları kullanın. Bu adımlar ayrıca bunun için oluşturulan OAuth istemcisini, bot kullanıcısını ve rolü de kaldırır.

1. Oturum belirteci kullanarak otomatik ağ geçidi kaydının altıncı adımında açıklandığı gibi bir onaylama oluşturun.

2. Ağ geçidini silin:

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

3. JWK'yi silin.

   ConnectorAgent.exe qcs delete_jwk

4. Ağ geçidi için oluşturulan bot kullanıcı hesabını arayın.

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

5. Bot kimliğini kopyalayın.

6. Bu bot kullanıcı hesabını silin.

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

7. Ağ geçidi için oluşturulan “DAG Registration” rolünü arayın.

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

8. Rol kimliğini kopyalayın.

9. Bu rolü silin.

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

10. OAuth istemcisini silin.

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