4.1 KiB
4.1 KiB
MANUAL TÉCNICO - GESTÃO DE USERS, GROUPS E ACLS - TRUENAS SCALE
Código: ITGINF 0012/26 | Classificação: RESTRITO Responsável: João Pedro Toledo Gonçalves | Data: {{DATA_ATUAL}}
1. HISTÓRICO DE REVISÃO
⚠️ REGRA DE OURO:
- Autor: João Pedro Toledo Gonçalves.
- Descrição: Criação do documento.
| Data | Versão | Descrição | Autor |
|---|---|---|---|
| {{DATA_ATUAL}} | 1.0 | Criação Inicial | João Pedro Toledo Gonçalves |
2. OBJETIVO
Padronizar o processo de criação de usuários locais, grupos de permissão e configuração de Listas de Controle de Acesso (ACLs) em Datasets para compartilhamento SMB (Windows Share).
3. PRÉ-REQUISITOS
- Acesso administrativo ao TrueNAS Scale.
- Pool ZFS já criado e funcional.
- Planejamento de quem deve acessar o quê (Matriz de Permissões).
4. PASSO A PASSO (EXECUÇÃO)
Etapa 1: Criação de Grupos
Sempre gerencie permissões via Grupos, nunca por usuários individuais.
- Acesse
Credentials>Local Groupsno menu lateral. - Clique no botão Add (Canto superior direito).
- Preencha:
- Name:
{{NOME_DO_GRUPO}}(Ex:financeiro_rw,engenharia_ro). - Samba Authentication: Marque ✅ (Essencial para shares Windows).
- Name:
- Clique em Save.
Etapa 2: Criação de Usuários
- Acesse
Credentials>Local Users. - Clique em Add.
- Campos obrigatórios:
- Full Name: Nome completo do colaborador.
- Username:
{{USUARIO_LOGIN}}(Padrão:nome.sobrenome). - Password: Defina uma senha temporária forte
{{SENHA_TEMPORARIA}}.
- Seção Auxiliary Groups: Adicione os grupos criados na Etapa 1 (Ex:
financeiro_rw). - Microsoft Account: Desmarcado (a menos que seja integração específica).
- Clique em Save.
Etapa 3: Configuração de Dataset e ACLs (Permissões)
- Acesse
Datasetsno menu lateral. - Selecione o Dataset alvo (Ex:
tank/financeiro). - Procure a seção Permissions e clique em Edit.
- Configuração do ACL Editor:
- ACL Type: Selecione
SMB/NFSv4(Melhor para compatibilidade Windows). - ACL Preset: Use
RestrictedouOpencomo base, se desejar.
- ACL Type: Selecione
- Adicionando uma Regra:
- Clique em Add Item.
- Who: Selecione
Group. - Group: Escolha o grupo criado (ex:
financeiro_rw). - Permissions: Selecione
Full Control(para Admins) ouModify(para usuários comuns). - Flags: Marque
Apply permissions recursivelypara propagar.
- Clique em Save Access Control List.
Etapa 4: Criando o Compartilhamento SMB
- Acesse
Sharesno menu lateral. - Em Windows (SMB) Shares, clique em Add.
- Path: Selecione o Dataset configurado (ex:
/mnt/tank/financeiro). - Name: Nome visível na rede
{{NOME_COMPARTILHAMENTO}}. - Purpose:
Default Share Parameters. - Clique em Save.
- Se solicitado para reiniciar o serviço SMB, aceite.
5. SOLUÇÃO DE PROBLEMAS (TROUBLESHOOTING)
Problema 1: Usuário não consegue acessar a pasta ("Acesso Negado")
- Causa: O usuário não está no grupo correto ou a ACL não propagou.
- Solução:
- Verifique
Credentials>Local Users> Grupos Auxiliares. - Vá no Dataset > Permissions > Strip ACLs e reaplique recursivamente.
- Verifique
Problema 2: Janela de login pede credenciais repetidamente
- Causa: Senha incorreta ou relógio do Windows/Server dessincronizado.
- Solução:
- Resete a senha do usuário no TrueNAS.
- Verifique o horário (
System Settings>General).
6. DADOS TÉCNICOS
| Campo | Valor | Descrição |
|---|---|---|
| Porta SMB | 445 (TCP) | Porta de compartilhamento de arquivos. |
| Protocolo | SMB2 / SMB3 | O TrueNAS desativa SMB1 por segurança. |
7. VALIDAÇÃO FINAL
- O usuário consegue montar a unidade no Windows? (
\\{{IP_SERVIDOR}}\{{SHARE}}) - O usuário consegue criar um arquivo? (Teste de Escrita)
- O usuário consegue ver arquivos de outros? (Teste de Leitura)
