====== 🖥️ Ingressar Ubuntu no Domínio Samba do NethServer ======

===== 📋 Visão Geral =====

Este procedimento mostra como ingressar uma VM **Ubuntu** em um domínio **Samba Active Directory (AD)** disponibilizado pelo **NethServer**.

Após o ingresso, usuários do domínio poderão ser utilizados para autenticação na VM Ubuntu.

**Fluxo do procedimento**

<code>
Configurar DNS
↓
Instalar pacotes necessários
↓
Validar descoberta do domínio
↓
Ingressar no domínio
↓
Validar ingresso
↓
Permitir usuários do domínio
↓
Habilitar criação automática do /home
↓
Testar login
</code>

---

===== ⚠️ Pré-requisitos =====

Antes de iniciar, confirme:

^ Item ^ Esperado ^
| NethServer funcionando | Sim |
| Samba AD funcionando | Sim |
| Ubuntu com acesso à rede | Sim |
| Ubuntu resolvendo o DNS do domínio | Sim |
| Usuário administrador do domínio | Disponível |
| IP do NethServer | Conhecido |
| Nome do domínio | Conhecido |

<WRAP important>
O DNS é fundamental para o ingresso no domínio. A Ubuntu deve utilizar o DNS responsável pelo domínio Samba/AD.
</WRAP>

---

===== 🧭 Informações utilizadas =====

Substitua os valores abaixo pelos dados do seu ambiente.

<code>
DOMINIO.LOCAL
IP_DO_NETHSERVER
usuario
</code>

Exemplo:

<code>
empresa.local
192.168.10.10
administrator
</code>

---

====== 1️⃣ Configurar o DNS ======

Antes de tentar ingressar no domínio, confirme se a Ubuntu consegue resolver o domínio.

Teste:

<code bash>
nslookup empresa.local
</code>

Também teste o servidor:

<code bash>
nslookup nethserver.empresa.local
</code>

<WRAP warning>
Se a resolução DNS não funcionar, não prossiga com o ingresso no domínio.

Corrija o DNS primeiro.
</WRAP>

---

====== 2️⃣ Instalar os pacotes necessários ======

Execute na Ubuntu:

<code bash>
sudo apt update
sudo apt install realmd sssd sssd-ad adcli samba-common-bin oddjob oddjob-mkhomedir packagekit -y
</code>

Os principais componentes utilizados são:

* **realmd** — gerenciamento do ingresso no domínio
* **sssd** — autenticação dos usuários do domínio
* **adcli** — comunicação com o Active Directory
* **samba-common-bin** — ferramentas Samba
* **oddjob / mkhomedir** — criação automática do diretório `/home`

---

====== 3️⃣ Descobrir o domínio ======

Execute:

<code bash>
realm discover empresa.local
</code>

Substitua:

<code>
empresa.local
</code>

pelo domínio utilizado no NethServer.

Se estiver funcionando, serão apresentadas informações sobre o domínio encontrado.

Exemplo:

<code>
empresa.local
type: kerberos
realm-name: EMPRESA.LOCAL
domain-name: empresa.local
configured: no
server-software: active-directory
client-software: sssd
</code>

<WRAP important>
Se o comando não encontrar o domínio, verifique principalmente o DNS da Ubuntu.
</WRAP>

---

====== 4️⃣ Ingressar no domínio ======

Execute:

<code bash>
sudo realm join --user=administrator empresa.local
</code>

Será solicitada a senha do usuário administrador do domínio.

Exemplo:

<code bash>
sudo realm join --user=administrator empresa.local
</code>

Informe a senha quando solicitado.

<WRAP tip>
O usuário utilizado precisa ter permissão para adicionar computadores ao domínio.
</WRAP>

---

====== 5️⃣ Validar o ingresso ======

Execute:

<code bash>
realm list
</code>

O domínio deverá aparecer na lista.

Exemplo:

<code>
empresa.local
  type: kerberos
  realm-name: EMPRESA.LOCAL
  domain-name: empresa.local
  configured: kerberos-member
  server-software: active-directory
  client-software: sssd
</code>

---

====== 6️⃣ Testar usuário do domínio ======

Verifique se a Ubuntu consegue localizar um usuário do domínio:

<code bash>
id usuario@empresa.local
</code>

Exemplo:

<code bash>
id joao@empresa.local
</code>

Se funcionar, deverão aparecer informações semelhantes a:

<code>
uid=123456789(joao@empresa.local)
gid=123456789(domain users@empresa.local)
groups=...
</code>

<WRAP tip>
Esse teste confirma que o Ubuntu consegue consultar os usuários do domínio através do SSSD.
</WRAP>

---

====== 7️⃣ Permitir usuários do domínio ======

Para permitir o acesso dos usuários do domínio:

<code bash>
sudo realm permit --all
</code>

<WRAP warning>
O comando permite todos os usuários do domínio.

Em ambientes de produção, recomenda-se posteriormente restringir o acesso a grupos específicos.
</WRAP>

---

====== 8️⃣ Criar automaticamente o /home ======

Para que o Ubuntu crie automaticamente o diretório pessoal do usuário no primeiro login:

<code bash>
sudo pam-auth-update --enable mkhomedir
</code>

Assim, quando um usuário do domínio acessar a máquina pela primeira vez, seu diretório será criado automaticamente.

Exemplo:

<code>
/home/joao@empresa.local
</code>

---

====== 9️⃣ Reiniciar o SSSD ======

Após as configurações:

<code bash>
sudo systemctl restart sssd
</code>

Verificar o serviço:

<code bash>
sudo systemctl status sssd
</code>

Esperado:

<code>
Active: active (running)
</code>

---

====== 🔟 Testar login ======

Teste o usuário do domínio:

<code bash>
su - usuario@empresa.local
</code>

Exemplo:

<code bash>
su - joao@empresa.local
</code>

Digite a senha do usuário do domínio.

Também é possível testar:

<code bash>
id usuario@empresa.local
</code>

---

====== ✅ Checklist Final ======

^ Validação ^ Resultado esperado ^
| DNS do domínio funcionando | ✅ |
| ''realm discover'' encontra o domínio | ✅ |
| ''realm join'' executado com sucesso | ✅ |
| ''realm list'' mostra o domínio | ✅ |
| ''id usuario@dominio'' funciona | ✅ |
| Usuários permitidos | ✅ |
| ''mkhomedir'' habilitado | ✅ |
| SSSD ativo | ✅ |
| Login com usuário do domínio funcionando | ✅ |

---

====== 🚑 Troubleshooting ======

===== Domínio não encontrado =====

Execute:

<code bash>
realm discover empresa.local
</code>

Se não encontrar o domínio, verifique:

<code bash>
resolvectl status
</code>

Teste:

<code bash>
nslookup empresa.local
</code>

<WRAP important>
A primeira coisa a verificar é o DNS. O Ubuntu precisa conseguir localizar os serviços do Active Directory.
</WRAP>

---

===== Usuário não encontrado =====

Teste:

<code bash>
id usuario@empresa.local
</code>

Verifique o SSSD:

<code bash>
sudo systemctl status sssd
</code>

Reinicie:

<code bash>
sudo systemctl restart sssd
</code>

---

===== Verificar logs do SSSD =====

<code bash>
sudo journalctl -u sssd -xe
</code>

---

====== 📌 Comandos principais — Resumo ======

Para facilitar a execução, os principais comandos são:

<code bash>
sudo apt update

sudo apt install realmd sssd sssd-ad adcli samba-common-bin oddjob oddjob-mkhomedir packagekit -y

realm discover empresa.local

sudo realm join --user=administrator empresa.local

realm list

id usuario@empresa.local

sudo realm permit --all

sudo pam-auth-update --enable mkhomedir

sudo systemctl restart sssd
</code>

---

====== 🎯 Resultado Esperado ======

Ao finalizar o procedimento:

<code>
Ubuntu
   │
   │ Autenticação
   ▼
SSSD
   │
   │ Kerberos / LDAP
   ▼
Samba AD
   │
   ▼
NethServer
</code>

A VM Ubuntu estará integrada ao domínio e poderá autenticar usuários do **Samba Active Directory do NethServer**.

---

===== 📚 Referência =====

Documentação do projeto:

<code>
https://www.samba.org/
</code>