Configuração

Visão geral

Cada componente tem o seu arquivo de configuração, criado a partir de um modelo instalado com o pacote:

Componente	Arquivo	Modelo
Riversoft STCP Gemini API	`/usr/local/stcpgemini-api/configs/config.json`	`example-config.json`
Riversoft Console Portal	`/usr/local/stcpgemini-api/portal/app/configs/config.json`	`example-config.json`
Riversoft STCP Gemini Server	`/usr/local/stcp/configs/stcpserver.config.json`	`example-stcpserver.config.json`

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

Atenção

Os arquivos contêm senhas de banco, chaves e segredos. Substitua todos os valores de exemplo, restrinja o acesso ao usuário e ao grupo do serviço e não versione os arquivos com segredos.

Riversoft STCP Gemini API

Arquivo config.json da Riversoft STCP Gemini API: servidor HTTP, TLS e bancos de dados.

Riversoft Console Portal

Arquivo config.json do Riversoft Console Portal: endereço da API e vários ambientes.

Riversoft STCP Gemini Server

Arquivo stcpserver.config.json do Riversoft STCP Gemini Server: instância, banco de configuração e biblioteca de acesso.

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.

Módulo	Arquivo	Parâmetro
Riversoft STCP Gemini Server	`/usr/local/stcp/configs/stcpserver.config.json`	`ApplConfigPassPhrase` (seção `STCPCore`)
Riversoft STCP DirectLink	`configs/config.json` da instalação	`applConfigPassPhrase`
Riversoft STCP Gemini Rename	`/usr/local/stcpren/configs/config.json`	`applConfigPassPhrase` (seção `General`)
Riversoft STCP Gemini API	`/usr/local/stcpgemini-api/configs/config.json`	`api_secret` (seção `general`)

    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

Importante

Defina a chave antes do primeiro cadastro e use o mesmo valor em todos os módulos do ambiente. Para trocá-la depois, os dados sensíveis já gravados precisam ser criptografados de novo com a nova chave, por um procedimento feito com uma aplicação própria. Acione o suporte Riversoft antes de trocar a chave.

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.

Próximos passos

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