# Domaines et URLs

> Exposer votre application sur un domaine de la plateforme ou sur le vôtre, avec un DNS et un certificat TLS gérés par Wakastart.

Une [wakapp](/v1.0/glossaire#wakapp) devient joignable sur Internet par ses URLs. Vous les déclarez une fois dans l'[architecture](/v1.0/glossaire#architecture) de l'application, puis vous les mettez en ligne environnement par environnement. Wakastart écrit l'enregistrement DNS, obtient le certificat TLS et achemine le trafic jusqu'à vos services.

## Comment ça marche

```mermaid
flowchart LR
  subgraph ARCHI["Architecture de l'app (déclaré une fois)"]
    DOM["Domaine<br/>exemple.fr"] --> URL["URL<br/>app + exemple.fr"]
    URL --> R1["Route /<br/>vers le service front"]
    URL --> R2["Route /api<br/>vers le service api"]
  end
  subgraph ENV["Environnement staging"]
    INST["Route instanciée<br/>app.staging.exemple.fr"]
  end
  R1 -- "Instancier" --> INST
  INST --> DNS["Enregistrement DNS<br/>vers la gateway"]
  INST --> TLS["Certificat<br/>Let's Encrypt"]
  INST --> GW["Gateway<br/>vers le service"]
```

1. Le **domaine** est soit un domaine de la plateforme, commun à toutes les apps, soit votre propre domaine, dont vous confiez la zone DNS à Wakastart.
2. L'**URL** associe un sous-domaine à ce domaine. Les **routes** de l'URL envoient chaque chemin vers un service de l'app.
3. Rien n'est publié tant que vous n'**instanciez** pas une route dans un [environnement](/v1.0/glossaire#environnement). À ce moment, la plateforme calcule le nom d'hôte de cet environnement (avec son préfixe, par exemple `staging`), crée l'enregistrement DNS, demande un certificat et branche la route sur la gateway.
4. La route passe à `PROVISIONED` quand le certificat et le DNS sont prêts. Le trafic HTTP est redirigé vers HTTPS.

Le détail du modèle est dans [URLs, routes et noms d'hôte](/v1.0/domaines-et-urls/urls-et-routes).

## Choisissez votre domaine

::::cards{cols=2}
:::card{title="Domaine de la plateforme" href="/v1.0/domaines-et-urls/creer-une-url-et-ses-routes" icon="Server"}
Aucune configuration DNS de votre côté. Le nom d'hôte contient l'identifiant court de l'app. Idéal pour les environnements de développement et de recette.
:::
:::card{title="Votre propre domaine" href="/v1.0/domaines-et-urls/ajouter-un-domaine-personnalise" icon="Globe"}
Votre marque dans l'URL. Vous fournissez une clé API de votre fournisseur DNS (OVH, IONOS Cloud ou IONOS Hosting) et Wakastart écrit les enregistrements à votre place.
:::
::::

## Commencer

::::cards{cols=3}
:::card{title="Ajouter un domaine personnalisé" href="/v1.0/domaines-et-urls/ajouter-un-domaine-personnalise" icon="Globe"}
Déclarer votre domaine et enregistrer les identifiants de votre fournisseur DNS.
:::
:::card{title="Créer une URL et ses routes" href="/v1.0/domaines-et-urls/creer-une-url-et-ses-routes" icon="Route"}
Associer un sous-domaine à un domaine et envoyer chaque chemin vers un service.
:::
:::card{title="Mettre une route en ligne" href="/v1.0/domaines-et-urls/mettre-une-route-en-ligne" icon="Rocket"}
Instancier la route dans un environnement et suivre son passage à `PROVISIONED`.
:::
::::

## Fonctionnalités

::::cards{cols=2}
:::card{title="Domaine racine" href="/v1.0/domaines-et-urls/exposer-le-domaine-racine" icon="Home"}
Servir `exemple.fr` sans sous-domaine.
:::
:::card{title="Préfixe d'environnement" href="/v1.0/domaines-et-urls/definir-le-prefixe-d-environnement" icon="Tag"}
Distinguer `app.staging.exemple.fr` de `app.exemple.fr` sans dupliquer l'architecture.
:::
:::card{title="Certificats TLS automatiques" href="/v1.0/domaines-et-urls/certificats-et-dns" icon="Lock"}
Un certificat Let's Encrypt par nom d'hôte, demandé et renouvelé par la plateforme.
:::
:::card{title="Gateway dédiée" href="/v1.0/domaines-et-urls/utiliser-une-gateway-dediee" icon="Network"}
Isoler un environnement derrière son propre load balancer et sa propre adresse IP.
:::
:::card{title="Hôtes IAM" href="/v1.0/domaines-et-urls/hotes-iam" icon="KeyRound"}
Relier chaque nom d'hôte au bon realm Keycloak pour la connexion de vos utilisateurs.
:::
::::

## Produits liés

::::cards{cols=3}
:::card{title="Redirections" href="/v1.0/redirections" icon="Waypoints"}
Rediriger un domaine ou un sous-domaine vers une URL de l'app.
:::
:::card{title="Variables et secrets" href="/v1.0/variables-et-secrets" icon="Lock"}
Donner à vos services les URLs publiques calculées par la plateforme.
:::
:::card{title="Authentification" href="/v1.0/authentification" icon="LogIn"}
Comprendre comment Discovery trouve le realm à partir du nom d'hôte.
:::
::::

## Ressources

- [Référence des écrans et des champs](/v1.0/domaines-et-urls/reference)
- [Liste de contrôle avant la production](/v1.0/domaines-et-urls/liste-de-controle)
- [Résoudre les problèmes de domaines et d'URLs](/v1.0/domaines-et-urls/depannage)
- [Limites et quotas](/v1.0/limites)
