This repository has been archived on 2026-06-26. You can view files and clone it, but cannot push or open issues or pull requests.
Set-OPS/roles/serveur_nginx/README.md
Daniel Allaire b775b7f99d Neutraliser le moteur pour partage public (100% neutre)
Suppression de toute trace Chezlepro de l'outil (roles, scripts, docs
publiques, exemples, LICENSE). Prouve par scan exhaustif : git grep vide
pour chezlepro, asgard/TrueNAS, supernet reel 10.1.x.

Corrige 5 defauts de genericite fonctionnels (motd, app.ini Forgejo,
organisation openldap, nom AC step-ca, et IP reelles codees en dur dans
les defaults de roles -> plage d'exemple 10.0.x). LICENSE -> Alliance
Boreale. Fichiers mainteneur + CHANGELOG conserves (par decision).

La separation moteur/instance tient : OPS-Chezlepro surcharge deja ses
vraies valeurs de topologie. Verifie : make verifier exit 0 (4 tests).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-24 19:58:00 -04:00

37 lines
1.6 KiB
Markdown

# serveur_nginx
Installe et configure nginx comme **edge** interne : reverse proxy et terminaison TLS.
## Rôle
- Installe `nginx` et `ssl-cert` (certificat auto-signé).
- Durcissement de base via `conf.d/99-setops.conf` (`server_tokens off`, TLS 1.2/1.3, taille de corps).
- Publie des sites de reverse proxy déclarés dans `serveur_nginx_sites` (vide par défaut).
- **Valide la configuration (`nginx -t`) avant de recharger** (handler `Valider et recharger nginx`).
## TLS
- Par défaut, certificat auto-signé Debian (`snakeoil`) — l'edge répond en HTTPS dès l'installation.
- `serveur_nginx_certificat` / `serveur_nginx_cle` (ou par site) permettent de basculer vers les certificats de l'AC interne / ACME quand `serveur_step_ca` existera.
## Variables principales
| Variable | Défaut | Rôle |
| --- | --- | --- |
| `serveur_nginx_certificat` / `_cle` | snakeoil | Certificat TLS par défaut |
| `serveur_nginx_ssl_protocols` | `TLSv1.2 TLSv1.3` | Protocoles TLS |
| `serveur_nginx_server_tokens` | `off` | Masque la version |
| `serveur_nginx_taille_max_corps` | `16m` | `client_max_body_size` |
| `serveur_nginx_redirection_http` | `true` | Redirige 80 → 443 |
| `serveur_nginx_desactiver_defaut` | `false` | Retire le site Debian par défaut |
| `serveur_nginx_sites` | `[]` | Sites reverse proxy |
## Déclarer un site
```yaml
serveur_nginx_sites:
- nom: forge
domaine: forge.exemple.internal
amont: "http://10.0.15.11:3000"
# certificat / cle optionnels (sinon snakeoil)
```
## Hors périmètre
- WAF (ModSecurity) — lift externe, à traiter dans une phase dédiée.
- Émission automatique des certificats (dépend de `serveur_step_ca`).