# Identifiants de connexion

> Les deux comptes applicatifs d'une base, les sept champs fournis à vos services, le nommage de la base et le chemin des identifiants jusqu'au conteneur.

Vous ne saisissez jamais de mot de passe de base de données dans Wakastart. À la création de chaque instance, la plateforme génère deux comptes applicatifs, les range dans le coffre de secrets de votre application et les expose à vos services sous forme de variables à relier.

## Définition

Une instance de base reçoit :

- **deux comptes applicatifs**, `primary` et `secondary`, chacun avec un mot de passe aléatoire de 32 caractères ;
- pour chaque compte, **sept champs de connexion** ;
- une **entrée de configuration par champ** dans l'environnement, que vos services consomment par [liaison](/v1.0/glossaire#liaison).

Ces identifiants ne sont jamais affichés en clair dans la console, ni renvoyés par une API. Ils ne quittent le coffre que pour être injectés dans le conteneur d'un service qui les consomme.

## Les sept champs

| Champ | Contenu | Exemple (PostgreSQL dans le cluster) |
|---|---|---|
| `url` | URL de connexion complète, mot de passe inclus | `postgresql://monapp_maindb_primary:…@maindb.wakapp-ab12cd-dev.svc.cluster.local:5432/monapp_maindb` |
| `host` | nom d'hôte | `maindb.wakapp-ab12cd-dev.svc.cluster.local` |
| `port` | port | `5432` |
| `database` | nom de la base applicative | `monapp_maindb` |
| `username` | compte applicatif | `monapp_maindb_primary` |
| `password` | mot de passe | (32 caractères aléatoires) |
| `ssl_mode` | exigence TLS | `disable` dans le cluster, `require` en mode managé (`REQUIRED` pour MySQL) |

Le schéma de l'URL dépend du moteur et du mode :

| Moteur | Dans le cluster | Managée |
|---|---|---|
| PostgreSQL | `postgresql://…:5432/<base>` | `postgresql://…:<port>/<base>` |
| MySQL | `mysql://…:3306/<base>` | `mysql://…:<port>/<base>` |
| MongoDB | `mongodb://…:27017/<base>?authSource=admin&replicaSet=rs0&directConnection=true` | `mongodb+srv://…/<base>?authSource=admin` |
| Valkey | `redis://…:6379/0` | `rediss://…:<port>/0` |

En mode managé, le port est attribué par OVHcloud : lisez-le dans le champ `port`.

## Nommage

Le nom de la base et des comptes est construit à partir de l'identifiant court de l'application et de celui de la base (le **Shortname** saisi à la déclaration) :

| Élément | Dans le cluster | Managée |
|---|---|---|
| Base applicative | `<app>_<base>`, par exemple `monapp_maindb` | `ws<app>_<base>`, par exemple `wsmonapp_maindb` |
| Comptes | `<app>_<base>_primary`, `<app>_<base>_secondary` | `ws<app>_<base>_primary`, `ws<app>_<base>_secondary` |
| Hôte | `<base>.wakapp-<identifiant de l'app>-<environnement>.svc.cluster.local` | attribué par OVHcloud |

Le nom de la base est le même dans tous les environnements : seuls l'hôte et les mots de passe changent. Ne codez aucun de ces noms en dur : lisez-les toujours dans les variables.

## Comment ça marche

```mermaid
flowchart LR
  P["Provisionnement<br/>de l'instance"] --> V["Coffre de secrets<br/>de l'application"]
  V --> E["Configuration de l'environnement<br/>MAINDB_URL, MAINDB_HOST…<br/>filtre Base"]
  E -- "liaison choisie<br/>dans le service" --> K["Conteneur du service<br/>DATABASE_URL=…"]
```

1. À la création de l'instance, Wakastart génère les deux comptes et écrit leurs sept champs dans le coffre de secrets de l'application.
2. Quand la base est prête, chaque champ apparaît dans l'onglet **Configuration** de l'environnement, filtre **Base**, sous une clé `<BASE>_<CHAMP>` en majuscules : `MAINDB_URL`, `MAINDB_HOST`, `MAINDB_PORT`, `MAINDB_DATABASE`, `MAINDB_USERNAME`, `MAINDB_PASSWORD`, `MAINDB_SSL_MODE`. Un tiret dans le shortname devient un tiret bas.
3. Les entrées `…_URL` et `…_PASSWORD` sont sensibles : leur valeur n'est pas affichée. Les entrées sont en **Lecture seule (auto-générée)**.
4. Dans la configuration d'un service, vous reliez une variable attendue, par exemple `DATABASE_URL`, à l'une de ces entrées.
5. Au déploiement, le conteneur reçoit la valeur sous forme de référence de secret Kubernetes, rafraîchie depuis le coffre toutes les 5 minutes.

Les variables reliées depuis la console portent les identifiants du compte `primary`. Le compte `secondary` est créé et synchronisé en même temps, mais il n'est pas proposé dans la configuration des services.

## Exemples

- **Un back NestJS avec Prisma** : la définition du service déclare `DATABASE_URL` ; dans chaque environnement, la variable est reliée à `MAINDB_URL`. Le même code tourne en dev et en prod.
- **Un client qui veut les champs séparés** : le service déclare `DB_HOST`, `DB_PORT`, `DB_NAME`, `DB_USER`, `DB_PASSWORD`, reliés aux entrées `…_HOST`, `…_PORT`, `…_DATABASE`, `…_USERNAME`, `…_PASSWORD`.

## Pour aller plus loin

- [Connecter un service à une base](/v1.0/bases-de-donnees/connecter-un-service)
- [Variables et secrets](/v1.0/variables-et-secrets)
- [Bases dans le cluster ou managées](/v1.0/bases-de-donnees/dans-le-cluster-ou-managee)
