Ir para o conteúdo

Secrets

Os secrets são configurações armazenadas com segurança e de forma criptografada. Os trabalhos do projeto terão um acesso automaticamente aos seus secrets. Existem dois tipos de secrets no QFieldCloud:

  • variáveis de ambiente - As variáveis de ambiente estarão disponíveis para o QGIS enquanto os trabalhos do seu projeto estiverem a correr.
  • configurações pg_service - Adicionando uma ligação PostgreSQL/PostGIS conforme definido no ficheiro de configuração pg_service.conf.

Note

Uma vez adicionado, o secret só poderá ser removido, uma vez que não pode ser editado.

Aviso

garante que as suas credenciais sejam armazenadas de maneira segura e criptografada. No entanto, aconselhamos os nossos utilizadores a usar funções com menos privilégios em ambientes partilhados para evitar possíveis quebras de segurança. Observe também que todos os utilizadores com permissões de upload de ficheiro também podem aceder aos valores dessas credenciais.

Adicionar um novo secret

Adicionar um novo secret no QFieldCloud é um processo fácil e pode ser realizado em três etapas.

  1. Navegando nos secrets do projeto
  2. Pressionando o botão Adicionar um novo secret e escolhendo o tipo de secret que deseja adicionar.
  3. Armazenando os conteúdos dos secret

Página de secret do projeto  depois de pressionar o botão **Adicionar novo secret**.
Página de secret do projeto depois de pressionar o botão Adicionar novo secret.

Variável de Ambiente

As variáveis de ambiente serão disponibilizados no QGIS enquanto os seus trabalhos do projeto estiverem a correr.

Precisará de preencher o nome da variável de ambiente (somente em maiúsculas) e o valor da variável de ambiente como texto livre.

Adicionando uma variável de ambiente.
Adicionando uma variável de ambiente.

configuração pg_service

Adicionando uma ligação PostgreSQL/PostGIS conforme definido no ficheiro de configuração pg_service.conf. O "editor avançado" permite colar o conteúdo do ficheiro pg_service.conf diretamente. Se usar várias definições de serviço, deverá adicionar vários secrets para cada um deles.

Nota

Os secrets do QFieldCloud estão disponíveis apenas durante a execução do trabalho do projeto, o que permite que configure as suas camadas do PostgreSQL como "Edição offline". Não poderá usar os secrets QFieldCloud para distribuir ficheiros pg_service.conf entre dispositivos. Por motivos de segurança, deverá fazer isso manualmente. Pode ler como configurar o QField para usar um ficheiro pg_service.conf.

Para adicionar um serviço PostgreSQL pode usar um editor de visualização simples, ou editar diretamente a configuração do serviço como texto simples.

  • nome do serviço
  • nome da base de dados
  • utilizador da base de dados
  • palavra-chave da base de dados
  • servidor da base de dados
  • porta da base de dados
  • ligaçãos SSL da base de dados

Para outras configurações de serviço, poderá usar o botão **Adicionar campo extra pgservice ** para adicionar pares de configurações e os seus respetivos valores. Em alternativa, poderá editar a configuração do serviço diretamente como texto simples.

Adicionar um serviço PostgreSQL - Editor simples.
Adicionar um serviço PostgreSQL - Editor simples.

A configuração avançada permite que edite diretamente as configurações como texto simples. Esta opção pode ser conveniente quando quer copiar e colar diretamente as configurações de um ficheiro pg_service.conf.

Adicionar um serviço PostgreSQL - Editor avançado.
Adicionar um serviço PostgreSQL - Editor avançado.