Configurando Qlik Data Gateway - Acesso direto em um servidor Windows

Você também pode registrar Direct Access gateway automaticamente pela linha de comando, sem usar a central de atividades Administração. Este método utiliza um token de sessão de curta duração gerado a partir de um cliente OAuth.

Pré-requisitos

Uma chave de API com permissão de administrador de locatário para criar e gerenciar clientes OAuth.

Registrar o gateway com registro automático

1. Gere uma JSON Web Key (JWK) na máquina Direct Access gateway. Este comando cria chaves privadas na máquina Direct Access gateway:

   ConnectorAgent.exe qcs generate_jwk

2. Copie o JWK retornado pelo comando.

3. Usando a chave de API, crie um cliente OAuth para o gateway por meio da API de administração do locatário, fornecendo o JWK que você copiou na etapa anterior.

   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. Copie o valor client_id retornado na resposta.

5. Defina o método de consentimento do cliente OAuth como confiável.

   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. Crie uma asserção de registro na máquina Direct Access gateway:

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

7. Solicite um token de acesso. Isso também aciona a criação automática da conta de usuário do bot usada pelo gateway.

   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. Localize o usuário de bot criado automaticamente.

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

9. Copie o ID de my-bot-client.

10. Crie uma função "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. Atribua funções em nível de locatário ao usuário do bot.

    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. Obter o espaço do Direct Access Gateway.

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

13. Copie o ID do espaço do Direct Access Gateway.

14. Adicione o usuário do bot ao espaço com a permissão Pode editar.

    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. Caso a asserção existente tenha expirado, gere uma nova.

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

16. Registre o gateway:

    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>

Removendo um gateway registrado automaticamente

Use as etapas a seguir para cancelar o registro de um gateway que foi registrado usando o método automático baseado em token de sessão descrito acima. Estas etapas também removem o cliente OAuth, o usuário do bot e a função que foram criados para ele.

1. Gere uma asserção, conforme descrito na etapa seis do Registro automático de gateway usando um token de sessão.

2. Exclua o gateway:

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

3. Exclua a JWK.

   ConnectorAgent.exe qcs delete_jwk

4. Localize a conta de usuário do bot que foi criada para o gateway.

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

5. Copie o ID do bot.

6. Exclua esta conta de usuário bot.

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

7. Localize a função “DAG Registration” que foi criada para o gateway.

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

8. Copie o ID da função.

9. Excluir esta função.

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

10. Exclua o cliente OAuth.

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