# Clients

# Fiche Atelier Penhoat

<p class="callout info">**En bref**  
**Niveau** : référence  
**Durée** : 3 minutes de lecture  
**Prérequis** : aucun  
**Niveau de test** : illustratif</p>

## Atelier Penhoat, c'est quoi ?

L'Atelier Penhoat est une très petite entreprise artisanale, premier client de l'offre Nébuleuse (client « alpha »). Elle utilise trois services : un espace de fichiers partagé, une galerie de photos de ses réalisations et un gestionnaire de mots de passe pour l'équipe.

Cette fiche rassemble ce qu'un technicien doit savoir avant d'intervenir sur ce client. Les valeurs sont celles utilisées dans les pages techniques du livre.

<table id="bkmrk-rubrique-valeur-clie"><thead><tr><th>Rubrique</th><th>Valeur</th></tr></thead><tbody><tr><td>Client</td><td>Atelier Penhoat</td></tr><tr><td>Identifiant dans l'inventaire</td><td>`client-alpha`</td></tr><tr><td>Identifiant court (conteneurs)</td><td>`alpha`</td></tr><tr><td>Domaine</td><td>`penhoat.example`</td></tr><tr><td>Contact administrateur</td><td>`admin@penhoat.example`</td></tr><tr><td>Adresse d'administration</td><td>`10.99.0.21`</td></tr><tr><td>Adresse publique</td><td>`192.0.2.21`</td></tr></tbody></table>

**Atelier Penhoat → `penhoat.example` → VM `client-alpha` → Nextcloud, Immich, Vaultwarden**

## Services commandés

<table id="bkmrk-service-adresse-r%C3%B4le"><thead><tr><th>Service</th><th>Adresse</th><th>Rôle pour le client</th></tr></thead><tbody><tr><td>Authentik (SSO)</td><td>`sso.penhoat.example`</td><td>Connexion unique à Nextcloud et Immich</td></tr><tr><td>Nextcloud</td><td>`cloud.penhoat.example`</td><td>Fichiers, devis et plans partagés, agenda</td></tr><tr><td>Immich</td><td>`photos.penhoat.example`</td><td>Photos des réalisations, albums partagés avec les clients de l'atelier</td></tr><tr><td>Vaultwarden</td><td>`vault.penhoat.example`</td><td>Mots de passe de l'équipe</td></tr></tbody></table>

## Fichiers de configuration

```yaml
# inventory/host_vars/client-alpha/vars.yml
client_name: alpha
client_domain: penhoat.example
client_admin_email: admin@penhoat.example

nebuleuse_apps:
  - nextcloud
  - immich
  - vaultwarden

client_subdomains:
  sso: sso
  nextcloud: cloud
  immich: photos
  vaultwarden: vault

```

Les secrets du client sont dans `inventory/host_vars/client-alpha/vault.yml` (chiffré). Aucun secret n'est reproduit dans cette fiche.

## Points d'attention

1. **Photos volumineuses** : Immich est l'application qui grossit le plus. L'espace disque de la VM doit être surveillé, et une VM avec 4 Go de mémoire au minimum est nécessaire pour la reconnaissance de visages.
2. **Mots de passe principaux** : le client est prévenu à l'ouverture de son compte Vaultwarden qu'un mot de passe principal perdu ne peut pas être récupéré.
3. **Accès SSH** : l'administrateur passe par le bastion ; aucune connexion directe depuis Internet.

## Commandes utiles

```bash
# Depuis le serveur Ansible : rejouer tout le déploiement pour ce client.
ansible-playbook site.yml --limit client-alpha

# Depuis le bastion : se connecter à la VM.
tsh ssh deploy@client-alpha

```

Page suivante : **Fiche Cabinet Kerjean**.

# Fiche Cabinet Kerjean

<p class="callout info">**En bref**  
**Niveau** : référence  
**Durée** : 3 minutes de lecture  
**Prérequis** : aucun  
**Niveau de test** : illustratif</p>

## Cabinet Kerjean, c'est quoi ?

Le Cabinet Kerjean est un cabinet de petite taille, deuxième client de l'offre Nébuleuse (client « beta »). Il manipule des documents confidentiels et n'utilise que deux services : un espace de fichiers et un gestionnaire de mots de passe. Il n'a pas commandé la galerie de photos.

Cette fiche rassemble ce qu'un technicien doit savoir avant d'intervenir sur ce client, et sert de modèle pour les suivantes.

<table id="bkmrk-rubrique-valeur-clie"><thead><tr><th>Rubrique</th><th>Valeur</th></tr></thead><tbody><tr><td>Client</td><td>Cabinet Kerjean</td></tr><tr><td>Identifiant dans l'inventaire</td><td>`client-beta`</td></tr><tr><td>Identifiant court (conteneurs)</td><td>`beta`</td></tr><tr><td>Domaine</td><td>`kerjean.example`</td></tr><tr><td>Contact administrateur</td><td>`admin@kerjean.example`</td></tr><tr><td>Adresse d'administration</td><td>`10.99.0.22`</td></tr><tr><td>Adresse publique</td><td>`192.0.2.22`</td></tr></tbody></table>

**Cabinet Kerjean → `kerjean.example` → VM `client-beta` → Nextcloud, Vaultwarden**

## Services commandés

<table id="bkmrk-service-adresse-r%C3%B4le"><thead><tr><th>Service</th><th>Adresse</th><th>Rôle pour le client</th></tr></thead><tbody><tr><td>Authentik (SSO)</td><td>`sso.kerjean.example`</td><td>Connexion unique à Nextcloud</td></tr><tr><td>Nextcloud</td><td>`cloud.kerjean.example`</td><td>Dossiers clients, échange sécurisé de documents</td></tr><tr><td>Vaultwarden</td><td>`vault.kerjean.example`</td><td>Mots de passe du cabinet</td></tr></tbody></table>

## Fichiers de configuration

```yaml
# inventory/host_vars/client-beta/vars.yml
client_name: beta
client_domain: kerjean.example
client_admin_email: admin@kerjean.example

# Immich n'est pas commandé : le rôle n'est pas déployé et aucun sous-domaine photos n'existe.
nebuleuse_apps:
  - nextcloud
  - vaultwarden

client_subdomains:
  sso: sso
  nextcloud: cloud
  vaultwarden: vault

```

Les secrets du client sont dans `inventory/host_vars/client-beta/vault.yml` (chiffré), avec des valeurs distinctes de celles du premier client. Les secrets propres à Immich n'y figurent pas.

## Points d'attention

1. **Données sensibles** : les sauvegardes et la durée de conservation sont à convenir avec le client. L'accès à la VM reste tracé par le bastion.
2. **Immich non commandé** : si le client le commande plus tard, il suffit d'ajouter `immich` à `nebuleuse_apps`, un sous-domaine et deux secrets, puis de rejouer les étiquettes `sso`, `immich` et `fail2ban`.
3. **Inscriptions Vaultwarden** : fermées par défaut. Elles sont ouvertes le temps d'intégrer l'équipe du cabinet, puis refermées.

## Commandes utiles

```bash
# Depuis le serveur Ansible : rejouer tout le déploiement pour ce client.
ansible-playbook site.yml --limit client-beta

# Depuis le bastion : se connecter à la VM.
tsh ssh deploy@client-beta

```

Page suivante : retour à la page **Présentation** du livre, ou premier livre de l'étagère **Base de connaissance**.