diff --git a/docs/security.md b/docs/security.md new file mode 100644 index 0000000..6506504 --- /dev/null +++ b/docs/security.md @@ -0,0 +1,177 @@ +# Sécurité + +## Fichiers sensibles et permissions + +| Fichier | Machine | Permissions | Contenu | +|---------|---------|-------------|---------| +| `/etc/sssd/sssd.conf` | VM | `600 root:root` | Credentials LDAP bind | +| `/root/admin_tools/pki/root.crt` | Admin | `644 root:root` | CA cert public (non secret) | +| `/root/.ssh/id_ed25519` | Admin | `600 root:root` | Clé privée SSH admin | +| `/root/.ssh/authorized_keys` | VM | `600 root:root` | Clés publiques autorisées | + +### Vérification des permissions critiques + +```bash +# Sur chaque VM déployée +ls -la /etc/sssd/sssd.conf +# Attendu : -rw------- 1 root root + +# Sur la machine admin +ls -la /root/.ssh/id_ed25519 +# Attendu : -rw------- 1 root root +``` + +--- + +## Credentials dans les scripts + +### Ce qui est en clair dans les scripts + +| Credential | Emplacement | Justification | +|------------|-------------|---------------| +| `Tyujkl46` | `deploy-vm.sh` (Cloud-Init) | Mot de passe initial temporaire — doit être changé après déploiement | +| `Radius123!` | `05-sssd.sh` | Compte de service LDAP bind (lecture seule) | + +### Recommandations + +**Mot de passe Cloud-Init** — changer après le premier déploiement validé : +```bash +# Sur la VM +passwd root +passwd deployer +``` + +**Compte SSSD/LDAP** — utiliser un compte dédié avec des droits minimaux (lecture seule sur `ou=people`) plutôt que `svc-radius` qui est partagé avec Radius. + +Créer un compte `svc-sssd` dédié : +```bash +docker exec -it openldap ldapadd \ + -x -H ldap://localhost \ + -D "cn=admin,dc=adm,dc=ephaitek,dc=com" \ + -w "$(echo 'QWRtaW4xMjMh' | base64 -d)" << 'EOF' +dn: uid=svc-sssd,ou=svc,dc=adm,dc=ephaitek,dc=com +objectClass: inetOrgPerson +objectClass: person +objectClass: top +cn: svc-sssd +sn: svc-sssd +uid: svc-sssd +userPassword: +EOF +``` + +--- + +## Accès SSH + +### Principe de moindre privilège + +- La machine **admin** est le seul point d'entrée SSH vers les VMs +- Les VMs ne sont pas exposées directement sur Internet +- Le port SSH est non-standard (`22`) — obfuscation légère + +### Désactiver l'authentification par mot de passe après déploiement + +Une fois la clé admin déployée par `deploy-dns-keyv3.sh`, désactiver l'auth par mot de passe : + +```bash +ssh root@10.100.0. -p 22 \ + "sed -i 's/PasswordAuthentication yes/PasswordAuthentication no/' \ + /etc/ssh/sshd_config.d/99-custom-port.conf && systemctl restart sshd" +``` + +### SELinux + +Le script `deploy-vm.sh` configure SELinux pour autoriser le port SSH custom : +```bash +semanage port -a -t ssh_port_t -p tcp +``` + +SELinux reste en mode **enforcing** — ne pas le désactiver. + +--- + +## Réseau et segmentation + +### Isolation des VLANs + +Chaque VM est dans son propre VLAN isolé. pfSense n'autorise par défaut que : +- DNS (UDP/TCP port 53) vers `8.8.8.8`, `1.1.1.1`, `10.60.0.10`, `10.60.0.11` +- HTTP (TCP 80) vers any +- HTTPS (TCP 443) vers any + +Tout autre trafic est bloqué par défaut. + +### Accès inter-VLANs + +Pour autoriser des flux supplémentaires (ex: VM vers base de données sur un autre VLAN), ajouter des règles manuellement dans pfSense : +**Firewall → Rules → opt → Add** + +### LDAP en clair (plain) + +Le SSSD utilise `ldap://10.100.0.40` (LDAP plain, port 389) et non LDAPS. Cela est acceptable car : +- Le trafic reste sur le réseau admin interne (VLAN 100) +- Le VLAN 100 est isolé et non exposé à Internet + +Pour activer LDAPS si le certificat Vault est configuré pour iam-kc : +```ini +# Dans sssd.conf +ldap_uri = ldaps://iam-kc.adm.ephaitek.com:636 +ldap_id_use_start_tls = false +ldap_tls_reqcert = demand +ldap_tls_cacert = /etc/pki/ca-trust/source/anchors/ephaitek-root.crt +``` + +--- + +## PKI et certificats + +### CA Vault + +Le certificat `/root/admin_tools/pki/root.crt` est la racine de confiance de l'infra. Il est : +- Public (pas de secret) — permissions `644` suffisantes +- Importé dans le trust-store système de chaque VM (`update-ca-trust`) +- Permet la vérification TLS de Vault, et potentiellement d'autres services internes + +### Rotation du CA cert + +Si le CA Vault est renouvelé : +```bash +# 1. Mettre à jour le cert sur admin +ssh root@10.100.0.42 -p 2242 \ + "vault read -field=certificate pki/cert/ca" \ + > /root/admin_tools/pki/root.crt + +# 2. Rejouer l'étape PKI sur toutes les VMs concernées +./run-all.sh --vmid --name --vlan --only 03 +``` + +--- + +## Audit et logs + +### Logs de provisioning + +Tous les runs sont loggés dans `/var/log/ephaitek/` sur la machine admin : +```bash +ls -lt /var/log/ephaitek/ +``` + +### Rotation des logs + +Configurer logrotate pour éviter l'accumulation : +```bash +cat > /etc/logrotate.d/ephaitek-provisioning << 'EOF' +/var/log/ephaitek/*.log { + monthly + rotate 12 + compress + missingok + notifempty +} +EOF +``` + +### Traçabilité des changements pfSense + +Chaque modification pfSense via les scripts est enregistrée avec un message explicite (`write_config("...")`). Consultable dans pfSense : **Diagnostics → Backup & Restore → Config History**. \ No newline at end of file