# Sous-domaine personnalisé (/fr/docs/platform/websites/custom-subdomain)





Chaque site web reçoit un hostname d'endpoint généré aléatoirement à sa création. Réserver un sous-domaine remplace ce hostname par un libellé de votre choix, pour que vos headers affichent `acme.report.centralcsp.com` plutôt qu'une suite de caractères hexadécimaux.

C'est cosmétique et organisationnel. Cela ne change rien à la façon dont les reports sont collectés ou attribués.

## Prérequis [#prérequis]

* Un plan qui inclut les sous-domaines personnalisés.
* Le rôle **Gestionnaire** ou supérieur sur le site web.

## Réserver un sous-domaine [#réserver-un-sous-domaine]

1. Ouvrez le site web et allez sur **Configuration**.
2. Sous **Endpoint de reporting**, sélectionnez **Réserver un sous-domaine**.
3. Saisissez le libellé souhaité. Il s'agit uniquement de la partie la plus à gauche du hostname, pas d'un domaine complet.
4. Confirmez.

Il n'y a aucun travail DNS de votre côté ni étape de vérification. CentralCSP possède la zone d'ingestion et crée l'enregistrement lui-même.

<Callout type="warn" title="Mettez vos headers à jour ensuite">
  Réserver un sous-domaine ne réécrit pas les headers de votre site. Votre ancienne URL d'endpoint n'est plus celle affichée sur la page Configuration, alors copiez le nouveau bloc de headers et déployez-le. Tant que vous ne l'avez pas fait, les reports continuent d'aller vers l'ancien hostname.
</Callout>

Le nouvel enregistrement est créé avant que l'ancien ne soit supprimé, l'endpoint reste donc résolvable en permanence. Il n'y a aucune fenêtre pendant laquelle des reports sont perdus.

<img alt="La boîte de dialogue Revendiquer un sous-domaine, avec un seul label saisi dans le champ Sous-domaine, et la note indiquant que seuls les minuscules, chiffres et tirets sont acceptés" src="__img0" width="1412" height="390" />

## Règles de nommage [#règles-de-nommage]

Un libellé doit être :

* de 1 à 63 caractères
* en lettres minuscules, chiffres et traits d'union uniquement
* sans trait d'union en début ou en fin

Une chaîne hexadécimale de 21 caractères est refusée. Cette forme est réservée aux hostnames que CentralCSP attribue automatiquement, et l'autoriser permettrait à une réservation d'entrer en collision avec une future attribution automatique.

## Limites de fréquence [#limites-de-fréquence]

Les changements sont plafonnés avant tout traitement :

* 3 changements par site web et par jour
* 10 changements par espace de travail et par jour

Les deux fenêtres sont glissantes sur 24 heures. Choisissez un nom que vous comptez garder plutôt que d'itérer.

## Quand un nom est indisponible [#quand-un-nom-est-indisponible]

Deux refus différents, avec des sens différents :

* **Déjà réservé:** Un autre site web le détient. Les noms sont uniques sur l'ensemble de CentralCSP, pas seulement dans votre espace de travail.
* **En quarantaine:** Quelqu'un l'a libéré récemment et il est mis de côté. Le message d'erreur vous indique la date à laquelle il redevient disponible.

Votre propre espace de travail peut toujours reprendre un hostname qu'il détenait auparavant, revenir en arrière après une erreur n'est donc pas bloqué par la quarantaine.

## Ce que devient l'ancien sous-domaine [#ce-que-devient-lancien-sous-domaine]

Le hostname que vous abandonnez est mis en quarantaine pendant **90 jours** avant que quelqu'un d'autre puisse le réserver. Cela correspond à la fenêtre de rétention des reports, et la raison est la même dans les deux cas : un navigateur qui a mis en cache votre header `Reporting-Endpoints` continue de poster vers l'ancienne URL pendant un temps, et confier ce hostname à un autre client pendant cette fenêtre lui enverrait vos reports.

Anticipez-le. Si vous enchaînez les noms dans un espace de travail de test, chacun de ceux que vous abandonnez sort de la circulation pour un trimestre.

## Étapes suivantes [#étapes-suivantes]

* [Connecter votre site](/fr/docs/platform/websites/connect-your-site)
* [Filtres d'ingestion](/fr/docs/platform/websites/reporting-settings)
