Requisitos do Sistema

Esta página descreve os requisitos mínimos e recomendados para executar o Sincroniza.

Requisitos do Servidor

Hardware

Componente	Mínimo	Recomendado
CPU	2 cores	4+ cores
Memória RAM	4 GB	8+ GB
Armazenamento	20 GB	50+ GB SSD
Rede	100 Mbps	1 Gbps

Software

Componente	Versão
Sistema Operacional	Linux (Ubuntu 22.04+ recomendado) ou qualquer host compatível com Docker
Docker	Docker Engine 24+ com Docker Compose v2

Nota

O Sincroniza é distribuído exclusivamente como containers Docker. O .NET 9.0 Runtime e o PostgreSQL 17 já estão inclusos nas imagens — não é necessário instalá-los separadamente no servidor.

Requisitos de Rede

Portas

Porta	Protocolo	Direção	Descrição
443	HTTPS	Entrada	Interface Web
5432	TCP	Saída	PostgreSQL
389/636	LDAP/LDAPS	Saída	Active Directory
443	HTTPS	Saída	Microsoft Graph API (Entra ID)

Conectividade

O servidor Sincroniza precisa de conectividade com:

• Sistema de RH: Acesso ao banco de dados ou API do sistema de RH
• Active Directory: Acesso LDAP/LDAPS aos controladores de domínio
• Entra ID: Acesso HTTPS à API do Microsoft Graph
• Azure Communication Services: Acesso HTTPS para notificações por e-mail (se configurado)
• Microsoft Teams: Acesso HTTPS para notificações via Incoming Webhook (se configurado)

Requisitos do Navegador

A interface web do Sincroniza é compatível com:

Navegador	Versão Mínima
Google Chrome	100+
Mozilla Firefox	100+
Microsoft Edge	100+
Safari	15+

Atenção

Internet Explorer não é suportado.

Requisitos do Active Directory

Para integração com Active Directory:

Requisito	Descrição
Versão	Windows Server 2012 R2+
Conta de Serviço	Conta com permissões para criar/modificar/desabilitar usuários
Protocolo	LDAP (porta 389) ou LDAPS (porta 636)
Certificado	Certificado válido para LDAPS (recomendado)

Permissões da Conta de Serviço

A conta de serviço precisa das seguintes permissões nas OUs onde os usuários serão gerenciados:

• Criar objetos de usuário
• Modificar objetos de usuário
• Habilitar/Desabilitar contas
• Redefinir senhas (se usar geração automática)
• Modificar membros de grupos (para atribuição de grupos)

Requisitos do Entra ID

Para integração com Microsoft Entra ID (Azure AD):

Requisito	Descrição
Licença	Azure AD Premium P1+ ou Microsoft 365 E3+
Registro de Aplicativo	Aplicativo registrado no Azure AD
Permissões da API	Permissões do Microsoft Graph

Permissões do Microsoft Graph

O aplicativo registrado precisa das seguintes permissões de aplicativo:

Permissão	Tipo	Descrição
User.ReadWrite.All	Aplicativo	Criar e gerenciar usuários
Group.ReadWrite.All	Aplicativo	Gerenciar membros de grupos
Directory.ReadWrite.All	Aplicativo	Acessar dados do diretório

Dica

Use o princípio do menor privilégio. Conceda apenas as permissões necessárias para as funcionalidades que você irá utilizar.

Requisitos do Sistema de RH

O Sincroniza conecta-se diretamente ao banco de dados do sistema de RH através de uma View SQL que expõe os dados de funcionários. O sistema é compatível com qualquer sistema de RH, desde que o banco de dados seja de um dos tipos suportados.

Bancos de Dados Suportados

Banco de Dados	Porta Padrão
SQL Server	1433
PostgreSQL	5432
Oracle	1521

Requisitos

• View ou tabela no banco de dados do RH com os campos de funcionários mapeados
• Conta de acesso com permissão de leitura na view/tabela
• Conectividade de rede entre o servidor Sincroniza e o banco de dados do RH

Verificação de Requisitos

Antes de iniciar a instalação, verifique:

• [ ] Hardware atende aos requisitos mínimos
• [ ] Docker Engine 24+ e Docker Compose v2 instalados
• [ ] Conectividade com sistema de RH
• [ ] Conectividade com Active Directory (se aplicável)
• [ ] Conectividade com Entra ID (se aplicável)
• [ ] Conta de serviço com permissões adequadas
• [ ] Domínio configurado apontando para o servidor (produção)
• [ ] Certificados SSL/TLS são gerenciados automaticamente via Caddy (produção)

Próximos Passos

• Início Rápido - Configure o Sincroniza rapidamente
• Primeira Sincronização - Execute sua primeira sincronização