Requisitos
Antes de instalar o Riversoft® STCP DirectLink, confirme que o ambiente atende aos requisitos de software, sistema operacional, banco de dados e rede.
Requisitos de software
| Item | Obrigatório | Observação |
|---|---|---|
| Licença do Riversoft STCP DirectLink | Sim | Arquivo informado em applLicense. |
| Banco de configuração da plataforma STCP | Sim | Acessível a partir do servidor da aplicação. |
| Banco de log | Não | Necessário quando logDbEnable é true. |
| Certificado TLS do serviço da API | Sim, em produção | O portal e a API devem ser publicados por HTTPS; o cookie de sessão exige Secure. |
| Provedor de segredos (KMS) | Não | AWS Secrets Manager, Azure Key Vault, GCP Secret Manager ou OCI Vault. Veja KMS e segredos. |
| Collector OpenTelemetry | Não | Necessário quando a telemetria está habilitada. |
Matriz de compatibilidade
Os sistemas operacionais e os bancos de dados abaixo valem para o Riversoft STCP Gemini e para o Riversoft STCP DirectLink.
Sistemas operacionais suportados
| Sistema operacional | Versões suportadas |
|---|---|
| Red Hat Enterprise Linux (RHEL) | 8.x, 9.x e 10.x |
| Oracle Linux | 8.x, 9.x e 10.x |
| Rocky Linux | 8.x, 9.x e 10.x |
| AlmaLinux | 8.x, 9.x e 10.x |
| Amazon Linux | Amazon Linux 2023 |
| Outras distribuições Linux | Mediante validação de compatibilidade |
Dica
Use a versão mais recente de cada versão principal suportada e mantenha o sistema atualizado com as correções de segurança do fabricante.
Bancos de dados suportados
| SGBD | Versão suportada |
|---|---|
| Microsoft SQL Server | 2019 ou superior |
| Oracle Database | 19c ou superior |
| MySQL | 8.4 LTS ou superior |
| MariaDB | 10.11 ou superior |
Nota
Com o Riversoft STCP Enterprise Server (Windows), valem os requisitos de sistema operacional do Enterprise Server.
Conexão com TLS (MySQL e MariaDB)
Com MySQL e MariaDB, a comunicação com o banco de configuração e com o banco de log pode ser protegida por TLS com opções incluídas na própria string de conexão (cfgDbName), no formato:
nome-do-banco?parametro1=valor1¶metro2=valor2As opções são interpretadas pela camada de configuração da plataforma STCP e também se aplicam ao banco de log quando ele usa a mesma forma de conexão.
| Parâmetro | Descrição | Valores |
|---|---|---|
tls | Habilita o TLS e define o nível de verificação. | true, skip-verify, verify-ca, verify-identity |
tls-ca | Arquivo com o certificado da CA. | Caminho do arquivo |
tls-capath | Diretório com os certificados da CA (somente Riversoft STCP Gemini Server). | Caminho do diretório |
tls-cert | Certificado local para autenticação mTLS. | Caminho do arquivo |
tls-key | Chave local para autenticação mTLS. | Caminho do arquivo |
tls-cipher | Cifras permitidas, em nomenclatura OpenSSL, separadas por :. | Veja a lista abaixo |
tls-min-version | Versão mínima do TLS. | TLSv1.2, TLSv1.3 |
tls-max-version | Versão máxima do TLS. | TLSv1.2, TLSv1.3 |
tls-server-name | Nome do servidor usado na validação do certificado. | Hostname |
Valor de tls | Verificação |
|---|---|
true | CA e hostname do servidor. |
verify-identity | CA e hostname do servidor. |
verify-ca | Somente CA. |
skip-verify | Nenhuma. Use somente em laboratório. |
Cifras aceitas em tls-cipher, separadas por : (por exemplo, tls-cipher=ECDHE-RSA-AES128-GCM-SHA256:ECDHE-RSA-AES256-GCM-SHA384): AES128-SHA, AES256-SHA, AES128-SHA256, AES128-GCM-SHA256, AES256-GCM-SHA384, ECDHE-RSA-AES128-SHA, ECDHE-RSA-AES256-SHA, ECDHE-RSA-AES128-SHA256, ECDHE-RSA-AES128-GCM-SHA256, ECDHE-RSA-AES256-GCM-SHA384, ECDHE-ECDSA-AES128-SHA, ECDHE-ECDSA-AES256-SHA, ECDHE-ECDSA-AES128-GCM-SHA256, ECDHE-ECDSA-AES256-GCM-SHA384, ECDHE-RSA-CHACHA20-POLY1305 e ECDHE-ECDSA-CHACHA20-POLY1305.
"cfgProvider": "stcpgeminidb",
"cfgInstanceName": "MinhaInstancia",
"cfgDbName": "stcpcfg?tls=verify-identity&tls-ca=/caminho/ca.pem&tls-server-name=db.exemplo.com"Atenção
tls=skip-verify não valida a CA nem a identidade do servidor. Em produção, use verify-identity com uma CA confiável e o hostname correspondente ao certificado.
Requisitos de rede
| Origem | Destino | Protocolo | Finalidade |
|---|---|---|---|
| Usuários e sistemas | Serviço da API do Riversoft STCP DirectLink | HTTPS | Riversoft STCP DirectLink Portal e API REST. O host usado deve ser exatamente o configurado para a API. |
| Parceiros | Serviços SFTP, AS2 e Webhook do Riversoft STCP DirectLink | SSH/SFTP, HTTPS | Recebimento de arquivos, quando os serviços estão habilitados. |
| Riversoft STCP Gemini API | Riversoft STCP DirectLink, serviço Supervisão (directlink) (porta padrão 33060) | TCP, com TLS opcional | Supervisão pelo Riversoft Console Portal. Veja Serviços de supervisão. |
| Servidor da aplicação | Banco de configuração e banco de log | MySQL/MariaDB, com TLS recomendado | Configuração e logs. |
| Servidor da aplicação | Servidor SMTP e provedores de SMS/WhatsApp | SMTP, HTTPS | Notificações e envio de PIN. |
| Servidor da aplicação | challenges.cloudflare.com | HTTPS | Validação do Cloudflare Turnstile, quando habilitado. |
| Servidor da aplicação | Provedores de identidade (SSO) e KMS | HTTPS | SSO e resolução de segredos, quando configurados. |
| Servidor da aplicação | Parceiros e armazenamento em nuvem | Conforme o conector | Envio de arquivos por SFTP, FTP/FTPS, AS2, Webhook, Amazon S3, Azure Blob Storage, Google Cloud Storage e Oracle Cloud Object Storage. |
| Servidor da aplicação | Collector OpenTelemetry | HTTP/HTTPS | Telemetria, quando habilitada. |
As portas dos serviços são definidas nos serviços de rede da instância, no Riversoft Console Portal. Libere-as no firewall antes de iniciar a instalação.
Checklist de pré-instalação
- Instância do Riversoft STCP Gemini Server ou do Riversoft STCP Enterprise Server disponível.
- Banco de configuração acessível a partir do servidor da aplicação, com TLS configurado.
- Arquivo de licença disponível.
- Certificado TLS do serviço da API disponível.
- Portas dos serviços liberadas e saídas de rede necessárias permitidas.
- Segredos disponíveis no provedor de segredos adotado pelo ambiente.