Configuração

Visão geral

Cada componente tem o seu arquivo de configuração. A configuração do Riversoft® STCP DirectLink e dos componentes de gestão é criada a partir de um modelo instalado com o pacote:

Os parâmetros de cada arquivo estão descritos em Referência de parâmetros.

Chave de criptografia das senhas

As senhas e os demais dados sensíveis gravados no banco de configuração (por exemplo, as senhas dos usuários, dos bancos de dados e das credenciais de supervisão) são criptografados. Todos os módulos que leem ou gravam esses dados precisam usar a mesma chave. Caso contrário, um módulo não consegue ler as senhas gravadas por outro.

    flowchart LR
    K[Mesma chave] --> G[Gemini Server]
    K --> D[DirectLink]
    K --> R[Gemini Rename]
    K --> A[Gemini API]
    G --> DB[(Banco de configuração<br/>senhas criptografadas)]
    D --> DB
    R --> DB
    A --> DB
  

• Use um valor forte e aleatório, guardado fora do código.
• No Riversoft STCP DirectLink, o parâmetro aceita referência a segredo (env:, file: ou kms:). Prefira ler o valor de uma variável de ambiente, de um arquivo protegido ou de um cofre de segredos.
• Na Riversoft STCP Gemini API, o api_secret também assina os tokens de acesso.
• Guarde a chave no backup seguro do ambiente: sem ela, as senhas de um banco restaurado não podem ser lidas.

Origens da configuração

Além dos arquivos, o Riversoft STCP DirectLink usa a configuração mantida na instância:

O config.json não substitui a configuração da instância.

Checklist de produção

• O JSON foi validado com jq empty.
• A licença existe, é válida e tem permissões restritas.
• applDir e applLockDir existem e são graváveis pelo usuário do serviço.
• applSecret e applConfigPassPhrase foram trocados pelos valores reais.
• applConfigPassPhrase é igual nos demais módulos do ambiente (Riversoft STCP Gemini Server, Riversoft STCP Gemini Rename e api_secret da Riversoft STCP Gemini API). Veja Chave de criptografia das senhas.
• Senhas e tokens foram substituídos por referências a segredos.
• O banco de configuração e o banco de log foram testados.
• A configuração da instância contém os usuários, agendas e diretórios necessários.
• TLS, host da API e certificados foram configurados no serviço da API.
• Upload, download, links, notificações e recuperação de senha foram testados.
• Backup e retenção foram validados antes de habilitar a remoção automática.
• Telemetria e logs não expõem segredos.
• Com turnstileEnable ativo, a secret key está protegida e o servidor alcança challenges.cloudflare.com.
• O processo foi executado em primeiro plano antes da instalação como serviço.
• O config.json do Riversoft STCP DirectLink Portal aponta url para a API do ambiente e lista apenas provedores SSO configurados na instância.

Próximos passos

• Inicie os serviços: Operação.
• Crie a instância e troque a senha do operador administrador (stcpadmin): Administração.