mirror of
https://github.com/maelgangloff/domain-watchdog.git
synced 2025-12-17 17:55:42 +00:00
docs: add documentation fr translation
This commit is contained in:
Maël Gangloff
parent
bffbe8c8e9
commit
61be7da1e6
@ -30,41 +30,48 @@ export default defineConfig({
|
|||||||
{icon: 'seti:docker', label: 'Docker', href: 'https://hub.docker.com/r/maelgangloff/domain-watchdog'}
|
{icon: 'seti:docker', label: 'Docker', href: 'https://hub.docker.com/r/maelgangloff/domain-watchdog'}
|
||||||
],
|
],
|
||||||
sidebar: [
|
sidebar: [
|
||||||
{label: 'Getting started', slug: 'features'},
|
{label: 'Getting started', slug: 'features', translations: {fr: 'Premiers pas'}},
|
||||||
{
|
{
|
||||||
label: 'Installation & Configuration',
|
label: 'Installation & Configuration',
|
||||||
|
translations: {fr: 'Installation & Configuration'},
|
||||||
items: [
|
items: [
|
||||||
{label: 'Installation', autogenerate: {directory: 'install-config/install'}},
|
{label: 'Installation', autogenerate: {directory: 'install-config/install'}, translations: {fr: 'Installation'}},
|
||||||
{slug: 'install-config/configuration'},
|
{slug: 'install-config/configuration'},
|
||||||
{slug: 'install-config/upgrade'},
|
{slug: 'install-config/upgrade'},
|
||||||
]
|
]
|
||||||
},
|
},
|
||||||
{
|
{
|
||||||
label: 'Features',
|
label: 'Features',
|
||||||
|
translations: {fr: 'Fonctionnalités'},
|
||||||
items: [
|
items: [
|
||||||
{slug: 'features/search/domain-search'},
|
{slug: 'features/search/domain-search'},
|
||||||
{label: 'Domain back-order', autogenerate: {directory: 'features/backorder'}},
|
{label: 'Domain back-order', autogenerate: {directory: 'features/backorder'}, translations: {fr: 'Achat automatisé'}},
|
||||||
{label: 'Domain tracking', autogenerate: {directory: 'features/tracking'}},
|
{label: 'Domain tracking', autogenerate: {directory: 'features/tracking'}, translations: {fr: 'Suivi des domaines'}},
|
||||||
{label: 'Infrastructure', autogenerate: {directory: 'features/infrastructure'}},
|
{label: 'Infrastructure', autogenerate: {directory: 'features/infrastructure'}, translations: {fr: 'Infrastructure'}},
|
||||||
]
|
]
|
||||||
},
|
},
|
||||||
{
|
{
|
||||||
label: 'Developing',
|
label: 'Developing',
|
||||||
|
translations: {fr: 'Développement'},
|
||||||
items: [
|
items: [
|
||||||
{slug: 'developing/technical-stack'},
|
{slug: 'developing/technical-stack'},
|
||||||
{slug: 'developing/implementing-new-provider'},
|
{slug: 'developing/implementing-new-provider'},
|
||||||
{slug: 'developing/translation'},
|
{slug: 'developing/translation'},
|
||||||
{label: 'Contributing', autogenerate: {directory: 'developing/contributing'}}
|
{label: 'Contributing', autogenerate: {directory: 'developing/contributing'}, translations: {fr: 'Contribuer'}}
|
||||||
],
|
],
|
||||||
},
|
},
|
||||||
{label: 'Legal', autogenerate: {directory: 'legal'}, collapsed: true},
|
{label: 'Legal', autogenerate: {directory: 'legal'}, collapsed: true, translations: {fr: 'Légal'}},
|
||||||
{slug: 'acknowledgment'},
|
{slug: 'acknowledgment', translations: {fr: 'Remerciements'}},
|
||||||
{label: 'Definitions', autogenerate: {directory: 'definitions'}, collapsed: true},
|
{label: 'Definitions', autogenerate: {directory: 'definitions'}, collapsed: true, translations: {fr: 'Définitions'}},
|
||||||
],
|
],
|
||||||
locales: {
|
locales: {
|
||||||
en: {
|
en: {
|
||||||
label: 'English',
|
label: 'English',
|
||||||
lang: 'en'
|
lang: 'en'
|
||||||
|
},
|
||||||
|
fr: {
|
||||||
|
label: 'Français',
|
||||||
|
lang: 'fr'
|
||||||
}
|
}
|
||||||
},
|
},
|
||||||
head: [
|
head: [
|
||||||
@ -133,8 +140,8 @@ _paq.push(['enableHeartBeatTimer']);
|
|||||||
}),
|
}),
|
||||||
starlightKbd({
|
starlightKbd({
|
||||||
types: [
|
types: [
|
||||||
{id: 'mac', label: 'macOS', default: true},
|
{id: 'generic', label: 'Generic', default: true},
|
||||||
{id: 'windows', label: 'Windows'},
|
{id: 'mac', label: 'macOS'}
|
||||||
],
|
],
|
||||||
}),
|
}),
|
||||||
],
|
],
|
||||||
|
|||||||
@ -17,7 +17,7 @@ To search for a domain name:
|
|||||||
|
|
||||||
<Steps>
|
<Steps>
|
||||||
1. Enter the domain in the search bar.
|
1. Enter the domain in the search bar.
|
||||||
2. Press <Kbd mac="Enter" windows="Enter" /> to submit the query.
|
2. Press <Kbd mac="Enter" generic="Enter" /> to submit the query.
|
||||||
</Steps>
|
</Steps>
|
||||||
|
|
||||||
|
|
||||||
@ -29,6 +29,6 @@ If the extension you are searching for does **not** have an official RDAP server
|
|||||||
By default, if the domain information stored in the database is still considered valid, the system returns the existing record without performing a new RDAP query.
|
By default, if the domain information stored in the database is still considered valid, the system returns the existing record without performing a new RDAP query.
|
||||||
|
|
||||||
If you need to force an RDAP update for a given domain:
|
If you need to force an RDAP update for a given domain:
|
||||||
* Press <Kbd mac="Shift+Enter" windows="Shift+Enter" /> when submitting the search.
|
* Press <Kbd mac="Shift+Enter" generic="Shift+Enter" /> when submitting the search.
|
||||||
|
|
||||||
This triggers a fresh lookup against the RDAP server.
|
This triggers a fresh lookup against the RDAP server.
|
||||||
|
|||||||
78
docs/src/content/docs/fr/definitions/dns.mdx
Normal file
78
docs/src/content/docs/fr/definitions/dns.mdx
Normal file
@ -0,0 +1,78 @@
|
|||||||
|
---
|
||||||
|
title: Protocole DNS
|
||||||
|
description: Qu'est-ce que le DNS ? Comprendre le système de noms de domaine, comment il traduit les noms de domaine en adresses IP et son rôle dans la navigation Internet.
|
||||||
|
---
|
||||||
|
|
||||||
|
import {LinkCard} from "@astrojs/starlight/components";
|
||||||
|
|
||||||
|
Le **DNS (Domain Name System)** est le système de nommage décentralisé pour les ordinateurs, les services ou toute ressource connectée à Internet ou à un réseau privé.
|
||||||
|
Il agit comme "l'annuaire d'Internet", traduisant les noms de domaine lisibles par les humains en informations lisibles par les machines.
|
||||||
|
|
||||||
|
## Une architecture hiérarchique
|
||||||
|
|
||||||
|
L'architecture DNS est une base de données distribuée et hiérarchique ressemblant à un arbre inversé. Cette structure, connue sous le nom d'**Espace de Noms de Domaine** (Domain Name Space), est traitée de droite à gauche :
|
||||||
|
|
||||||
|
[Image of DNS hierarchical structure]
|
||||||
|
|
||||||
|
* **Niveau Racine (Root)** : Le sommet de la hiérarchie, représenté par un point unique optionnel (`.`) à la fin d'un nom de domaine complet (FQDN).
|
||||||
|
* **Domaines de premier niveau (TLD)** : Le niveau visible le plus élevé (par exemple, `.com`, `.org`, `.fr`).
|
||||||
|
* **Domaines de second niveau (SLD)** : Le nom spécifique enregistré par une entité (par exemple, `example` dans `example.com`).
|
||||||
|
* **Sous-domaines** : Subdivisions supplémentaires pour des services spécifiques ou des structures organisationnelles (par exemple, `www`, `blog` ou `api`).
|
||||||
|
|
||||||
|
## Serveurs faisant autorité
|
||||||
|
|
||||||
|
Les serveurs DNS faisant autorité détiennent les enregistrements de ressources définitifs pour une zone de domaine spécifique. Contrairement aux résolveurs récursifs qui mettent les réponses en cache, les serveurs faisant autorité fournissent les données originales.
|
||||||
|
|
||||||
|
[Image of DNS resolution process]
|
||||||
|
|
||||||
|
Lorsqu'un client demande un domaine, la chaîne de résolution interroge :
|
||||||
|
|
||||||
|
1. **Serveurs Racines** : Dirigent vers les serveurs TLD.
|
||||||
|
2. **Serveurs TLD** : Dirigent vers les serveurs de noms faisant autorité du domaine.
|
||||||
|
3. **Serveur faisant autorité** : Renvoie l'adresse IP finale (ou un autre enregistrement).
|
||||||
|
|
||||||
|
<LinkCard
|
||||||
|
title="Domaine de premier niveau"
|
||||||
|
description="Un aperçu des domaines de premier niveau (TLD), leur classification (gTLD, ccTLD, etc.) et la structure de la zone racine DNS."
|
||||||
|
href="/fr/definitions/top-level-domain"/>
|
||||||
|
|
||||||
|
## Enregistrements GLUE
|
||||||
|
|
||||||
|
Un enregistrement GLUE est un enregistrement A (ou AAAA) **fourni par la zone parente** pour éviter les dépendances circulaires. Normalement, la zone parente ne fait que déléguer, mais ici, elle doit fournir des données.
|
||||||
|
Ils sont strictement nécessaires lorsque le serveur de noms d'un domaine est un sous-domaine du domaine lui-même (par exemple, `example.com` utilise `ns1.example.com` comme serveur de noms). Sans l'enregistrement GLUE dans la zone `.com` pointant vers l'IP de `ns1`, le résolveur serait bloqué dans une boucle en essayant de résoudre le nom du serveur de noms.
|
||||||
|
|
||||||
|
### Exemple : `ns.icann.org`
|
||||||
|
|
||||||
|
Dans cet exemple, `icann.org` utilise `ns.icann.org` comme l'un de ses serveurs de noms.
|
||||||
|
|
||||||
|
Pour résoudre `icann.org`, vous devez interroger `ns.icann.org`, mais vous ne pouvez pas trouver `ns.icann.org` sans d'abord résoudre `icann.org`.
|
||||||
|
|
||||||
|
Lors de l'interrogation du serveur TLD `.org` (`A0.ORG.AFILIAS-NST.INFO`), le serveur renvoie les enregistrements de serveur de noms (NS) dans la **Section Autorité**, mais de manière cruciale, il fournit également les adresses IP dans la **Section Additionnelle**. Ce sont les enregistrements GLUE.
|
||||||
|
|
||||||
|
```text title="Requête DNS de ns.icann.org utilisant la commande dig" {17-18}
|
||||||
|
; <<>> DiG 9.20.15 <<>> ns.icann.org @A0.ORG.AFILIAS-NST.INFO
|
||||||
|
;; global options: +cmd
|
||||||
|
;; Got answer:
|
||||||
|
;; ->>HEADER<<- opcode: QUERY, status: NOERROR, id: 52458
|
||||||
|
;; flags: qr rd; QUERY: 1, ANSWER: 0, AUTHORITY: 4, ADDITIONAL: 3
|
||||||
|
|
||||||
|
;; QUESTION SECTION:
|
||||||
|
;ns.icann.org. IN A
|
||||||
|
|
||||||
|
;; AUTHORITY SECTION:
|
||||||
|
icann.org. 3600 IN NS ns.icann.org.
|
||||||
|
icann.org. 3600 IN NS a.icann-servers.net.
|
||||||
|
icann.org. 3600 IN NS c.icann-servers.net.
|
||||||
|
icann.org. 3600 IN NS b.icann-servers.net.
|
||||||
|
|
||||||
|
;; ADDITIONAL SECTION:
|
||||||
|
ns.icann.org. 3600 IN A 199.4.138.53
|
||||||
|
ns.icann.org. 3600 IN AAAA 2001:500:89::53
|
||||||
|
|
||||||
|
;; Query time: 241 msec
|
||||||
|
;; SERVER: 199.19.56.1#53(A0.ORG.AFILIAS-NST.INFO) (UDP)
|
||||||
|
```
|
||||||
|
|
||||||
|
## Voir aussi
|
||||||
|
|
||||||
|
- [Domain Name System (Système de noms de domaine)](https://fr.wikipedia.org/wiki/Domain_Name_System) sur Wikipédia
|
||||||
52
docs/src/content/docs/fr/definitions/dnssec.mdx
Normal file
52
docs/src/content/docs/fr/definitions/dnssec.mdx
Normal file
@ -0,0 +1,52 @@
|
|||||||
|
---
|
||||||
|
title: DNSSEC
|
||||||
|
description: Sécurisez votre résolution de domaine. En savoir plus sur DNSSEC (Extensions de sécurité du système de noms de domaine) et comment il protège les utilisateurs contre les données DNS falsifiées.
|
||||||
|
---
|
||||||
|
|
||||||
|
import {LinkCard} from "@astrojs/starlight/components";
|
||||||
|
|
||||||
|
**DNSSEC (Domain Name System Security Extensions)** ajoute une couche de sécurité cryptographique au protocole DNS. Il défend contre des attaques spécifiques, telles que l'**empoisonnement du cache DNS** et les **attaques de l'homme du milieu**, en garantissant que les données DNS reçues sont identiques à celles publiées par le propriétaire de la zone.
|
||||||
|
|
||||||
|
## Ce que fait DNSSEC
|
||||||
|
|
||||||
|
DNSSEC utilise la cryptographie à clé publique pour établir une **Chaîne de Confiance**.
|
||||||
|
|
||||||
|
* **Authentification de l'origine** : Vérifie que les données proviennent du bon serveur faisant autorité.
|
||||||
|
* **Intégrité des données** : Garantit que les données n'ont pas été modifiées en transit.
|
||||||
|
* **Déni d'existence authentifié** : Prouve de manière sécurisée qu'un domaine ou un enregistrement n'existe *pas* (en utilisant NSEC/NSEC3).
|
||||||
|
|
||||||
|
De nouveaux enregistrements de ressources permettent cette validation :
|
||||||
|
|
||||||
|
* `RRSIG` : La signature numérique associée à un jeu d'enregistrements.
|
||||||
|
* `DNSKEY` : La clé publique utilisée pour vérifier le RRSIG.
|
||||||
|
* `DS` (Delegation Signer) : Un hachage de la clé de la zone enfant, stocké dans la zone parente pour lier la chaîne de confiance.
|
||||||
|
|
||||||
|
## Ce que DNSSEC ne fait pas
|
||||||
|
|
||||||
|
* **Pas de chiffrement** : Les requêtes et réponses DNS restent en texte clair (contrairement à DoH ou DoT).
|
||||||
|
* **Pas de validation d'identité** : Il ne valide pas la légitimité du propriétaire du domaine (par exemple, il n'empêche pas les domaines de phishing, il prouve juste que l'IP du domaine de phishing est correcte).
|
||||||
|
|
||||||
|
## Configurer DNSSEC sur votre nom de domaine
|
||||||
|
|
||||||
|
La mise en œuvre de DNSSEC implique deux étapes principales :
|
||||||
|
|
||||||
|
1. **Signature de la zone** : Le serveur de noms faisant autorité génère des clés (`ZSK` et `KSK`) et signe les données de la zone, créant des enregistrements `RRSIG` et `DNSKEY`.
|
||||||
|
2. **Établissement de la confiance** : Le propriétaire du domaine doit envoyer l'enregistrement `DS` (hachage de la KSK) au Bureau d'enregistrement (Registrar). Le Bureau d'enregistrement transmet cela au Registre pour publication dans la zone TLD parente.
|
||||||
|
|
||||||
|
<LinkCard
|
||||||
|
title="Nom de domaine"
|
||||||
|
description="Une explication de ce qu'est un nom de domaine et de sa structure."
|
||||||
|
href="/fr/definitions/domain-name"/>
|
||||||
|
|
||||||
|
## L'adoption de DNSSEC
|
||||||
|
|
||||||
|
L'adoption est un processus descendant commençant par la Zone Racine. Alors que la Racine et la plupart des TLD sont signés, l'adoption au niveau de l'utilisateur final (domaines de second niveau) dépend du support du bureau d'enregistrement et de la sensibilisation du titulaire.
|
||||||
|
|
||||||
|
<LinkCard
|
||||||
|
title="Domaine de premier niveau"
|
||||||
|
description="Un aperçu des domaines de premier niveau (TLD) et leur classification (gTLD, ccTLD, etc.)."
|
||||||
|
href="/fr/definitions/top-level-domain"/>
|
||||||
|
|
||||||
|
## Voir aussi
|
||||||
|
|
||||||
|
- [Carte mondiale DNSSEC](https://stats.labs.apnic.net/dnssec) des laboratoires APNIC
|
||||||
42
docs/src/content/docs/fr/definitions/domain-lifecycle.mdx
Normal file
42
docs/src/content/docs/fr/definitions/domain-lifecycle.mdx
Normal file
@ -0,0 +1,42 @@
|
|||||||
|
---
|
||||||
|
title: Cycle de vie d'un domaine
|
||||||
|
description: Explorez le cycle de vie d'un domaine, de l'enregistrement et du renouvellement à l'expiration et la rédemption. Connaissez les phases critiques pour gérer votre nom de domaine.
|
||||||
|
---
|
||||||
|
|
||||||
|
import {LinkCard} from "@astrojs/starlight/components";
|
||||||
|
|
||||||
|
Le **Cycle de vie d'un domaine** définit les statuts qu'un nom de domaine traverse de sa création à sa suppression.
|
||||||
|
Comprendre ces phases est critique pour éviter la perte involontaire d'un domaine.
|
||||||
|
|
||||||
|
## Le cycle de vie générique
|
||||||
|
|
||||||
|
Pour la plupart des domaines de premier niveau génériques (gTLD) régulés par l'ICANN, le cycle suit ce chemin :
|
||||||
|
|
||||||
|
1. **Disponible** : Le domaine est ouvert à l'enregistrement.
|
||||||
|
2. **Enregistré (Actif)** : Le domaine est détenu et fonctionnel. Il peut être mis à jour, transféré ou renouvelé (généralement 1 à 10 ans).
|
||||||
|
3. **Période de grâce de renouvellement automatique** : (0–45 jours) Le domaine expire. Le propriétaire peut généralement le renouveler au tarif standard. Le domaine peut cesser de résoudre (ServerHold).
|
||||||
|
4. **Période de rédemption** : (30 jours) Le domaine est supprimé du bureau d'enregistrement mais conservé par le registre. La récupération est possible mais nécessite des **frais de restauration** plus élevés.
|
||||||
|
5. **Suppression en attente** (Pending Delete) : (5 jours) Le domaine est programmé pour une suppression définitive. Il ne peut être ni récupéré ni renouvelé.
|
||||||
|
6. **Libéré** : Le domaine devient à nouveau **Disponible** pour l'enregistrement public.
|
||||||
|
|
||||||
|
<LinkCard
|
||||||
|
title="Nom de domaine"
|
||||||
|
description="Une explication de ce qu'est un nom de domaine et de sa structure."
|
||||||
|
href="/fr/definitions/domain-name"/>
|
||||||
|
|
||||||
|
## Cas particuliers de certains ccTLD
|
||||||
|
|
||||||
|
Les domaines de premier niveau géographiques (ccTLD) fonctionnent selon des réglementations locales, ce qui conduit à des cycles de vie divers :
|
||||||
|
|
||||||
|
* **Pas de périodes de grâce** : Certains ccTLD entrent en "Suppression en attente" immédiatement après l'expiration.
|
||||||
|
* **Renouvellement pré-expiration** : Certains registres exigent que les frais de renouvellement soient payés des semaines avant la date d'expiration réelle.
|
||||||
|
* **Processus manuels** : La restauration dans certains ccTLD peut nécessiter une intervention manuelle et de la paperasse.
|
||||||
|
|
||||||
|
\<LinkCard
|
||||||
|
title="Domaine de premier niveau"
|
||||||
|
description="Un aperçu des domaines de premier niveau (TLD) et leur classification (gTLD, ccTLD, etc.)."
|
||||||
|
href="/fr/definitions/top-level-domain"/\>
|
||||||
|
|
||||||
|
## Voir aussi
|
||||||
|
|
||||||
|
- [Cycle de vie d'un nom de domaine gTLD typique](https://www.icann.org/en/contracted-parties/accredited-registrars/resources/gtld-lifecycle) sur le site de l'ICANN
|
||||||
53
docs/src/content/docs/fr/definitions/domain-name.mdx
Normal file
53
docs/src/content/docs/fr/definitions/domain-name.mdx
Normal file
@ -0,0 +1,53 @@
|
|||||||
|
---
|
||||||
|
title: Nom de domaine
|
||||||
|
description: Définissez votre identité en ligne. Une explication de ce qu'est un nom de domaine et de sa structure.
|
||||||
|
---
|
||||||
|
Un **Nom de Domaine** est une chaîne d'identification lisible par l'homme utilisée pour localiser des ressources sur Internet. Il mappe des adresses IP numériques complexes vers des noms mémorables.
|
||||||
|
|
||||||
|
## La structure d'un nom de domaine
|
||||||
|
|
||||||
|
Un nom de domaine se lit hiérarchiquement de droite à gauche :
|
||||||
|
|
||||||
|
1. **Domaine de premier niveau (TLD)** : Le suffixe (par exemple, `.com`, `.fr`).
|
||||||
|
2. **Domaine de second niveau (SLD)** : Le nom unique choisi par le titulaire (par exemple, `example`).
|
||||||
|
3. **Sous-domaine** : préfixes pour des services spécifiques (par exemple, `www`, `api`).
|
||||||
|
|
||||||
|
Un **Nom de Domaine Complètement Qualifié (FQDN)** inclut tous les labels jusqu'à la racine (par exemple, `www.example.com.`).
|
||||||
|
|
||||||
|
## Les statuts EPP
|
||||||
|
|
||||||
|
Le protocole EPP (Extensible Provisioning Protocol) attribue des codes de statut aux domaines pour indiquer leur état ou des restrictions. Ceux-ci sont visibles dans les recherches WHOIS/RDAP.
|
||||||
|
|
||||||
|
### Statuts serveur (définis par le registre)
|
||||||
|
|
||||||
|
Le registre peut appliquer des codes EPP pour modifier l'état d'un nom de domaine. Ce sont tous les codes sauf ceux commençant par `client`, qui sont réservés aux bureaux d'enregistrement.
|
||||||
|
Les codes génériques sont listés dans la documentation de l'ICANN.
|
||||||
|
|
||||||
|
Certains registres ont développé des codes supplémentaires pour décrire des cas non standard.
|
||||||
|
Par exemple, l'AFNIC a ajouté le code `server trade prohibited` pour décrire l'interdiction de l'opération de `trade` (cession) sur un nom de domaine.
|
||||||
|
Cette opération fait partie de l'extension EPP de l'AFNIC et n'est pas une opération standard pour un nom de domaine.
|
||||||
|
|
||||||
|
### Statuts client (définis par le bureau d'enregistrement)
|
||||||
|
|
||||||
|
Les bureaux d'enregistrement peuvent également appliquer des codes EPP à un nom de domaine. Ces codes commencent toujours par `client` pour les distinguer des codes appliqués par le registre.
|
||||||
|
|
||||||
|
Certains codes ont le même effet que ceux appliqués par le registre.
|
||||||
|
|
||||||
|
Par exemple, les codes `client hold` et `server hold` bloquent la résolution de la zone DNS d'un nom de domaine.
|
||||||
|
Cela signifie que la zone DNS du domaine de premier niveau ne contient plus les enregistrements `NS` nécessaires à la délégation de la zone du nom de domaine.
|
||||||
|
Cela entraîne l'arrêt complet des services pour le nom de domaine.
|
||||||
|
Ce code est souvent utilisé par le bureau d'enregistrement pour encourager fortement le titulaire à payer les frais de renouvellement (lorsque le nom de domaine n'est pas dans sa période de rédemption).
|
||||||
|
|
||||||
|
## Nom de domaine internationalisé (IDN)
|
||||||
|
|
||||||
|
Un IDN est un nom de domaine qui contient des caractères autres que le format ASCII standard (a-z, 0-9 et traits d'union). Cela inclut les caractères avec des diacritiques (accents) ou des caractères d'écritures non latines (arabe, chinois, cyrillique, etc.).
|
||||||
|
|
||||||
|
Pour fonctionner dans le système DNS hérité, les IDN sont convertis dans un format compatible ASCII appelé **Punycode**, qui commence toujours par `xn--`.
|
||||||
|
|
||||||
|
| Affichage | Punycode |
|
||||||
|
|:-----------------:|:------------------------:|
|
||||||
|
| `maëlgangloff.fr` | `xn--malgangloff-0bb.fr` |
|
||||||
|
|
||||||
|
## Voir aussi
|
||||||
|
|
||||||
|
- [Codes de statut EPP](https://icann.org/epp) sur le site de l'ICANN
|
||||||
44
docs/src/content/docs/fr/definitions/epp.mdx
Normal file
44
docs/src/content/docs/fr/definitions/epp.mdx
Normal file
@ -0,0 +1,44 @@
|
|||||||
|
---
|
||||||
|
title: Protocole EPP
|
||||||
|
description: Qu'est-ce qu'un bureau d'enregistrement de noms de domaine ? Apprenez leur rôle dans la gestion de l'enregistrement et du transfert des noms de domaine pour le public.
|
||||||
|
---
|
||||||
|
|
||||||
|
import {LinkCard} from "@astrojs/starlight/components";
|
||||||
|
|
||||||
|
L'**Extensible Provisioning Protocol (EPP)** est le protocole de couche application standard pour l'allocation d'objets au sein des registres sur Internet. Bien qu'il soit principalement utilisé pour les noms de domaine, il peut également gérer les contacts et les objets hôtes.
|
||||||
|
|
||||||
|
## Les acteurs
|
||||||
|
|
||||||
|
### Client (Bureau d'enregistrement)
|
||||||
|
|
||||||
|
Le Bureau d'enregistrement (Registrar) agit comme le Client EPP. Il envoie des commandes XML pour créer, mettre à jour, renouveler ou supprimer des noms de domaine en fonction des demandes des clients.
|
||||||
|
|
||||||
|
<LinkCard
|
||||||
|
title="Bureau d'enregistrement"
|
||||||
|
description="Qu'est-ce qu'un bureau d'enregistrement de noms de domaine ?"
|
||||||
|
href="/fr/definitions/registrar"/>
|
||||||
|
|
||||||
|
### Serveur (Registre)
|
||||||
|
|
||||||
|
Le Registre agit comme le Serveur EPP. Il traite les commandes, valide la logique (par exemple, "ce domaine est-il disponible ?"), met à jour la base de données centrale et renvoie des réponses de succès ou d'erreur.
|
||||||
|
|
||||||
|
<LinkCard
|
||||||
|
title="Registre"
|
||||||
|
description="Qu'est-ce qu'un registre de noms de domaine ?"
|
||||||
|
href="/fr/definitions/registry"/>
|
||||||
|
|
||||||
|
## Le mécanisme du protocole
|
||||||
|
|
||||||
|
EPP utilise des messages **XML** transportés sur **TCP**, sécurisés par **TLS**. C'est un protocole à états, ce qui signifie qu'une session est établie (Connexion) avant que les commandes ne soient exécutées.
|
||||||
|
|
||||||
|
Les commandes EPP courantes incluent :
|
||||||
|
|
||||||
|
* `<check>` : Vérifier la disponibilité.
|
||||||
|
* `<create>` : Enregistrer un nouvel objet.
|
||||||
|
* `<info>` : Récupérer les détails de l'objet.
|
||||||
|
* `<transfer>` : Initier un transfert de bureau d'enregistrement.
|
||||||
|
* `<poll>` : Récupérer les notifications asynchrones du Registre.
|
||||||
|
|
||||||
|
## Voir aussi
|
||||||
|
|
||||||
|
- [RFC 5730 - Extensible Provisioning Protocol (EPP)](https://datatracker.ietf.org/doc/html/rfc5730)
|
||||||
38
docs/src/content/docs/fr/definitions/icann.mdx
Normal file
38
docs/src/content/docs/fr/definitions/icann.mdx
Normal file
@ -0,0 +1,38 @@
|
|||||||
|
---
|
||||||
|
title: ICANN
|
||||||
|
description: En savoir plus sur l'ICANN (Internet Corporation for Assigned Names and Numbers), l'organisation à but non lucratif coordonnant les identifiants uniques de l'Internet mondial.
|
||||||
|
---
|
||||||
|
|
||||||
|
import {LinkCard} from "@astrojs/starlight/components";
|
||||||
|
|
||||||
|
L'**ICANN (Internet Corporation for Assigned Names and Numbers)** est l'organisation à but non lucratif responsable de la coordination de la maintenance et de la sécurité des identifiants uniques de l'Internet mondial.
|
||||||
|
|
||||||
|
L'ICANN agit comme le principal organe de gouvernance pour l'infrastructure technique du DNS. Ses responsabilités incluent :
|
||||||
|
|
||||||
|
* **Fonctions IANA** : Gestion de l'allocation de l'espace d'adressage IP et de la Zone Racine du DNS.
|
||||||
|
* **Développement de politiques** : Faciliter la création de politiques mondiales pour le système de noms de domaine via un modèle multipartite.
|
||||||
|
|
||||||
|
## Gestion des domaines de premier niveau
|
||||||
|
|
||||||
|
L'ICANN décide quels nouveaux domaines de premier niveau (TLD) sont ajoutés à la Zone Racine.
|
||||||
|
|
||||||
|
* Elle supervise le **Programme des nouveaux gTLD**, qui a étendu Internet de quelques douzaines d'extensions (comme `.com`) à plus de 1 000 (comme `.app`, `.shop`).
|
||||||
|
* Elle délègue les **ccTLD** (comme `.uk`, `.fr`) à des gestionnaires nationaux spécifiques, bien qu'elle ait moins de contrôle direct sur leurs politiques locales.
|
||||||
|
|
||||||
|
<LinkCard
|
||||||
|
title="Domaine de premier niveau"
|
||||||
|
description="Un aperçu des domaines de premier niveau (TLD) et leur classification (gTLD, ccTLD, etc.)."
|
||||||
|
href="/fr/definitions/top-level-domain"/>
|
||||||
|
|
||||||
|
## Accréditation des bureaux d'enregistrement
|
||||||
|
|
||||||
|
L'ICANN gère le système d'accréditation pour les bureaux d'enregistrement souhaitant vendre des TLD génériques. L'accréditation garantit que les entreprises gérant les enregistrements de domaines respectent les normes de sécurité, de stabilité et de conservation des données.
|
||||||
|
|
||||||
|
<LinkCard
|
||||||
|
title="Bureau d'enregistrement"
|
||||||
|
description="Qu'est-ce qu'un bureau d'enregistrement de noms de domaine ?"
|
||||||
|
href="/fr/definitions/registrar"/>
|
||||||
|
|
||||||
|
## Voir aussi
|
||||||
|
|
||||||
|
- [Site officiel](https://www.icann.org/)
|
||||||
29
docs/src/content/docs/fr/definitions/rdap.mdx
Normal file
29
docs/src/content/docs/fr/definitions/rdap.mdx
Normal file
@ -0,0 +1,29 @@
|
|||||||
|
---
|
||||||
|
title: Protocole RDAP
|
||||||
|
description: Le protocole d'accès aux données moderne. Comprendre RDAP (Registration Data Access Protocol) pour un accès fiable et structuré aux données d'enregistrement et de propriété des domaines.
|
||||||
|
---
|
||||||
|
|
||||||
|
import {LinkCard} from "@astrojs/starlight/components";
|
||||||
|
|
||||||
|
Le **RDAP (Registration Data Access Protocol)** est la norme moderne pour accéder aux données d'enregistrement. Il a été conçu pour remplacer l'ancien protocole WHOIS en remédiant à son manque de standardisation et de sécurité.
|
||||||
|
|
||||||
|
## Améliorations clés par rapport à WHOIS
|
||||||
|
|
||||||
|
* **Données structurées (JSON)** : Contrairement à WHOIS, qui renvoie du texte libre non structuré, RDAP renvoie des données au format JSON. Cela permet une analyse automatisée facile et un affichage cohérent par les clients.
|
||||||
|
* **Requêtes standardisées** : RDAP utilise des services web RESTful (HTTP/HTTPS).
|
||||||
|
* **Internationalisation** : Support natif des caractères non latins (IDN).
|
||||||
|
* **Accès différencié** : RDAP prend en charge l'authentification, permettant aux registres d'afficher des données limitées au public (conformité RGPD) tout en fournissant des données complètes aux autorités accréditées.
|
||||||
|
|
||||||
|
<LinkCard
|
||||||
|
title="Protocole WHOIS"
|
||||||
|
description="Obtenez un aperçu du protocole WHOIS."
|
||||||
|
href="/fr/definitions/whois"/>
|
||||||
|
|
||||||
|
## État du déploiement
|
||||||
|
|
||||||
|
L'ICANN rend obligatoire la mise en œuvre de RDAP pour tous les bureaux d'enregistrement accrédités et les registres gTLD.
|
||||||
|
Alors que WHOIS est encore largement utilisé par les systèmes hérités, RDAP est la source faisant autorité pour les données d'enregistrement gTLD. L'adoption parmi les ccTLD est volontaire et en cours.
|
||||||
|
|
||||||
|
## Voir aussi
|
||||||
|
|
||||||
|
- [Tableau de bord de déploiement RDAP](https://deployment.rdap.org)
|
||||||
36
docs/src/content/docs/fr/definitions/registrar.mdx
Normal file
36
docs/src/content/docs/fr/definitions/registrar.mdx
Normal file
@ -0,0 +1,36 @@
|
|||||||
|
---
|
||||||
|
title: Bureau d'enregistrement
|
||||||
|
description: Qu'est-ce qu'un bureau d'enregistrement de noms de domaine ? Apprenez leur rôle dans la gestion de l'enregistrement et du transfert des noms de domaine pour le public.
|
||||||
|
---
|
||||||
|
|
||||||
|
import {LinkCard} from "@astrojs/starlight/components";
|
||||||
|
|
||||||
|
Un **Bureau d'enregistrement** (Registrar) est une entité commerciale accréditée qui vend des enregistrements de noms de domaine au public. Il agit comme intermédiaire entre le Titulaire (le propriétaire du domaine) et le Registre (l'opérateur de la base de données).
|
||||||
|
|
||||||
|
<LinkCard
|
||||||
|
title="Registre"
|
||||||
|
description="Qu'est-ce qu'un registre de noms de domaine ?"
|
||||||
|
href="/fr/definitions/registry"/>
|
||||||
|
|
||||||
|
## Responsabilités principales
|
||||||
|
|
||||||
|
### Gestion administrative
|
||||||
|
|
||||||
|
* **Enregistrement & Renouvellement** : Gestion de l'achat et du renouvellement périodique des domaines.
|
||||||
|
* **Gestion du cycle de vie** : Gestion des périodes de grâce, des frais de rédemption et des transferts.
|
||||||
|
* **Précision des données** : Collecte et maintien d'informations de contact précises pour les répertoires WHOIS/RDAP.
|
||||||
|
|
||||||
|
### Services techniques
|
||||||
|
|
||||||
|
* **Interface EPP** : Traduction des actions de l'utilisateur en commandes EPP envoyées au Registre.
|
||||||
|
* **Hébergement DNS** : La plupart des bureaux d'enregistrement fournissent des serveurs de noms par défaut, permettant aux utilisateurs de gérer leurs enregistrements DNS (A, MX, CNAME) via un tableau de bord convivial.
|
||||||
|
* **DNSSEC** : Facilitation de la rotation et de la publication des enregistrements DS.
|
||||||
|
|
||||||
|
<LinkCard
|
||||||
|
title="Protocole DNS"
|
||||||
|
description="Qu'est-ce que le DNS ? Comprendre le système de noms de domaine."
|
||||||
|
href="/fr/definitions/dns"/>
|
||||||
|
|
||||||
|
## Voir aussi
|
||||||
|
|
||||||
|
- [Bureau d'enregistrement (Domain name registrar)](https://fr.wikipedia.org/wiki/Registrar) sur Wikipédia
|
||||||
33
docs/src/content/docs/fr/definitions/registry.mdx
Normal file
33
docs/src/content/docs/fr/definitions/registry.mdx
Normal file
@ -0,0 +1,33 @@
|
|||||||
|
---
|
||||||
|
title: Registre
|
||||||
|
description: Comprendre le registre de noms de domaine. Apprenez comment ces organisations gèrent la base de données centrale pour tous les noms de domaine sous un TLD spécifique.
|
||||||
|
---
|
||||||
|
|
||||||
|
import {LinkCard} from "@astrojs/starlight/components";
|
||||||
|
|
||||||
|
Un **Registre** (ou Opérateur de Registre) est l'organisation responsable de la maintenance de la base de données maître de tous les noms de domaine enregistrés sous un domaine de premier niveau (TLD) spécifique.
|
||||||
|
|
||||||
|
## Rôles techniques
|
||||||
|
|
||||||
|
Le Registre est la source faisant autorité pour son TLD. Ses devoirs incluent :
|
||||||
|
|
||||||
|
* **Génération du fichier de zone** : Publication du fichier de zone qui dirige le trafic DNS mondial vers les bons serveurs de noms pour chaque domaine de l'extension.
|
||||||
|
* **Gestion IDN & DNSSEC** : Application des politiques pour les caractères spéciaux et gestion de la signature cryptographique de la zone TLD.
|
||||||
|
* **Serveur WHOIS/RDAP** : Exploitation du service d'annuaire qui fournit des informations publiques sur les domaines enregistrés.
|
||||||
|
|
||||||
|
## Rôles opérationnels
|
||||||
|
|
||||||
|
Les registres ne vendent généralement pas directement au public. Au lieu de cela, ils :
|
||||||
|
|
||||||
|
* Définissent les **Politiques d'Utilisation Acceptable** pour le TLD.
|
||||||
|
* Fixent le prix de gros pour les domaines.
|
||||||
|
* Accréditent et se connectent avec les **Bureaux d'enregistrement** via EPP.
|
||||||
|
|
||||||
|
<LinkCard
|
||||||
|
title="Bureau d'enregistrement"
|
||||||
|
description="Qu'est-ce qu'un bureau d'enregistrement de noms de domaine ?"
|
||||||
|
href="/fr/definitions/registrar"/>
|
||||||
|
|
||||||
|
## Voir aussi
|
||||||
|
|
||||||
|
- [Registre de noms de domaine](https://fr.wikipedia.org/wiki/Registre_de_noms_de_domaine) sur Wikipédia
|
||||||
50
docs/src/content/docs/fr/definitions/top-level-domain.mdx
Normal file
50
docs/src/content/docs/fr/definitions/top-level-domain.mdx
Normal file
@ -0,0 +1,50 @@
|
|||||||
|
---
|
||||||
|
title: Domaine de premier niveau (TLD)
|
||||||
|
description: Un aperçu des domaines de premier niveau (TLD), leur classification (gTLD, ccTLD, etc.) et la structure de la zone racine DNS.
|
||||||
|
---
|
||||||
|
|
||||||
|
Un **Domaine de premier niveau (TLD)** est le segment le plus à droite d'un nom de domaine (après le dernier point). Les TLD sont le niveau le plus élevé de la hiérarchie DNS en dessous de la racine.
|
||||||
|
|
||||||
|
## Classifications des TLD
|
||||||
|
|
||||||
|
### TLD Générique (gTLD)
|
||||||
|
|
||||||
|
Initialement destinés à des cas d'utilisation spécifiques, la plupart des gTLD sont maintenant ouverts à tous.
|
||||||
|
|
||||||
|
* **Hérités** : `.com` (commercial), `.net` (réseau), `.org` (organisation).
|
||||||
|
* **Nouveaux gTLD** : Des milliers d'extensions de niche comme `.app`, `.blog`, `.guru`.
|
||||||
|
* **Restreints** : Les domaines comme `.bank` ou `.pharmacy` nécessitent une vérification d'éligibilité.
|
||||||
|
* **Marque** : TLD fermés pour les entreprises, par exemple, `.google` ou `.bmw`.
|
||||||
|
|
||||||
|
### TLD Code Pays (ccTLD)
|
||||||
|
|
||||||
|
Réservés aux pays et territoires (deux lettres, basées sur ISO 3166).
|
||||||
|
|
||||||
|
* **Exemples** : `.uk` (Royaume-Uni), `.de` (Allemagne), `.io` (Territoire britannique de l'océan Indien).
|
||||||
|
* **Règles** : Les politiques varient strictement selon les pays. Certains exigent une résidence locale (par exemple, `.no`, `.ca`), tandis que d'autres sont commercialisés mondialement (par exemple, `.tv`, `.ai`).
|
||||||
|
|
||||||
|
### TLD Sponsorisé (sTLD)
|
||||||
|
|
||||||
|
Gérés par des organisations privées représentant une communauté spécifique.
|
||||||
|
|
||||||
|
* `.gov` (Gouvernement américain)
|
||||||
|
* `.edu` (Institutions américaines accréditées)
|
||||||
|
* `.aero` (Industrie aéronautique)
|
||||||
|
|
||||||
|
### TLD d'infrastructure
|
||||||
|
|
||||||
|
* `.arpa` : Géré par l'IANA, utilisé exclusivement pour l'infrastructure technique (par exemple, les recherches DNS inverses).
|
||||||
|
|
||||||
|
## TLD réservés
|
||||||
|
|
||||||
|
Selon la [RFC 2606](https://tools.ietf.org/html/rfc2606), quatre TLD sont réservés en permanence pour les tests et la documentation afin d'éviter toute confusion dans les environnements de production :
|
||||||
|
|
||||||
|
* `.test`
|
||||||
|
* `.example`
|
||||||
|
* `.invalid`
|
||||||
|
* `.localhost`
|
||||||
|
|
||||||
|
## Voir aussi
|
||||||
|
|
||||||
|
- [Domaine de premier niveau (Wikipédia)](https://fr.wikipedia.org/wiki/Domaine_de_premier_niveau)
|
||||||
|
- [Base de données de la zone racine IANA](https://www.iana.org/domains/root/db)
|
||||||
97
docs/src/content/docs/fr/definitions/whois.mdx
Normal file
97
docs/src/content/docs/fr/definitions/whois.mdx
Normal file
@ -0,0 +1,97 @@
|
|||||||
|
---
|
||||||
|
title: Protocole WHOIS
|
||||||
|
description: Obtenez un aperçu de WHOIS. Apprenez comment ce protocole est utilisé pour interroger des bases de données afin d'obtenir des informations sur l'utilisateur enregistré ou les attributaires d'un nom de domaine.
|
||||||
|
---
|
||||||
|
|
||||||
|
import {LinkCard} from "@astrojs/starlight/components";
|
||||||
|
|
||||||
|
WHOIS est un protocole de requête/réponse basé sur du texte (écoutant sur le **Port TCP 43**) largement utilisé pour interroger des bases de données qui stockent les utilisateurs enregistrés ou les attributaires d'une ressource Internet, telle qu'un nom de domaine ou un bloc d'adresses IP.
|
||||||
|
|
||||||
|
## Cas d'utilisation principaux
|
||||||
|
|
||||||
|
* **Vérification de la disponibilité** : Vérifier si un nom de domaine spécifique est disponible à l'enregistrement.
|
||||||
|
* **Identification de la propriété** : Identifier le Titulaire ou le Bureau d'enregistrement gérant le domaine.
|
||||||
|
* **Dépannage technique** : Trouver les serveurs de noms faisant autorité ou les contacts techniques pour résoudre les problèmes de réseau.
|
||||||
|
* **Juridique & Abus** : Fournir un dossier pour l'application de la loi, la protection de la propriété intellectuelle et le signalement des abus.
|
||||||
|
|
||||||
|
## Registres Thick (Lourd) vs Thin (Léger)
|
||||||
|
|
||||||
|
Comprendre les réponses WHOIS nécessite de comprendre comment le Registre TLD stocke les données.
|
||||||
|
|
||||||
|
### Registre Thin (par exemple, .com, .net)
|
||||||
|
|
||||||
|
Le Registre ne stocke que des données techniques (DNSSEC, serveurs de noms) et un pointeur vers le Bureau d'enregistrement.
|
||||||
|
|
||||||
|
Pour obtenir les coordonnées complètes, une seconde requête WHOIS doit être envoyée au **serveur WHOIS du Bureau d'enregistrement**.
|
||||||
|
|
||||||
|
### Registre Thick (par exemple, .org, .info, la plupart des ccTLD)
|
||||||
|
|
||||||
|
Le Registre stocke *toutes* les informations, y compris les coordonnées du Titulaire et les données administratives.
|
||||||
|
|
||||||
|
Une seule requête au Registre fournit l'enregistrement complet.
|
||||||
|
|
||||||
|
## Exemple : Requête WHOIS récursive
|
||||||
|
|
||||||
|
L'outil de ligne de commande standard `whois` gère souvent automatiquement la redirection du "Registre Thin".
|
||||||
|
Cependant, voir les étapes brutes aide à comprendre le protocole.
|
||||||
|
|
||||||
|
Dans l'exemple ci-dessous pour un **TLD Thin** (`.com`), nous interrogeons d'abord le Registre, qui nous dirige vers le Bureau d'enregistrement.
|
||||||
|
|
||||||
|
### Requête au Registre (Verisign)
|
||||||
|
|
||||||
|
Notez le champ `Registrar WHOIS Server` dans la réponse.
|
||||||
|
|
||||||
|
```text title="Requête WHOIS au Registre"
|
||||||
|
$ whois --verbose example.com -h whois.verisign-grs.com.
|
||||||
|
Using server whois.verisign-grs.com..
|
||||||
|
Query string: "example.com"
|
||||||
|
|
||||||
|
Domain Name: EXAMPLE.COM
|
||||||
|
Registry Domain ID: 2336799_DOMAIN_COM-VRSN
|
||||||
|
Registrar WHOIS Server: whois.iana.org
|
||||||
|
Registrar URL: http://res-dom.iana.org
|
||||||
|
Updated Date: 2025-08-14T07:01:39Z
|
||||||
|
Creation Date: 1995-08-14T04:00:00Z
|
||||||
|
Registry Expiry Date: 2026-08-13T04:00:00Z
|
||||||
|
Registrar: RESERVED-Internet Assigned Numbers Authority
|
||||||
|
Domain Status: clientDeleteProhibited https://icann.org/epp#clientDeleteProhibited
|
||||||
|
Domain Status: clientTransferProhibited https://icann.org/epp#clientTransferProhibited
|
||||||
|
Name Server: A.IANA-SERVERS.NET
|
||||||
|
Name Server: B.IANA-SERVERS.NET
|
||||||
|
DNSSEC: signedDelegation
|
||||||
|
>>> Last update of whois database: 2025-11-20T08:05:54Z <<<
|
||||||
|
```
|
||||||
|
|
||||||
|
### Requête au Bureau d'enregistrement (IANA)
|
||||||
|
|
||||||
|
Suite au renvoi, nous interrogeons le Bureau d'enregistrement spécifique pour obtenir les détails de propriété.
|
||||||
|
|
||||||
|
```text title="Requête WHOIS au Bureau d'enregistrement"
|
||||||
|
$ whois --verbose example.com -h whois.iana.org
|
||||||
|
Using server whois.iana.org..
|
||||||
|
Query string: "example.com"
|
||||||
|
|
||||||
|
% IANA WHOIS server
|
||||||
|
% for more information on IANA, visit http://www.iana.org
|
||||||
|
% This query returned 1 object
|
||||||
|
|
||||||
|
domain: EXAMPLE.COM
|
||||||
|
organisation: Internet Assigned Numbers Authority
|
||||||
|
created: 1992-01-01
|
||||||
|
source: IANA
|
||||||
|
```
|
||||||
|
|
||||||
|
## Considérations de confidentialité
|
||||||
|
|
||||||
|
Depuis la mise en œuvre du **RGPD** (Règlement Général sur la Protection des Données) et des lois mondiales similaires sur la confidentialité, la sortie WHOIS a considérablement changé.
|
||||||
|
|
||||||
|
* **Rédaction des données** : La plupart des champs personnels (Nom, Email, Téléphone) sont désormais remplacés par des espaces réservés comme `DATA REDACTED` ou `Redacted for Privacy`.
|
||||||
|
* **Proxies de confidentialité** : Les bureaux d'enregistrement fournissent souvent des services qui remplacent les détails du titulaire par les coordonnées génériques du bureau d'enregistrement pour empêcher le spam et le harcèlement.
|
||||||
|
* **Accès par niveaux** : Les données complètes et non rédigées ne sont souvent plus accessibles publiquement de manière anonyme et nécessitent une demande légale légitime ou une accréditation.
|
||||||
|
|
||||||
|
<LinkCard title="Protocole RDAP" href="/fr/definitions/rdap"
|
||||||
|
description="Découvrez le successeur de WHOIS conçu pour gérer les données structurées et l'accès confidentiel."/>
|
||||||
|
|
||||||
|
## Voir aussi
|
||||||
|
|
||||||
|
* [RFC 3912 - Spécification du protocole WHOIS](https://datatracker.ietf.org/doc/html/rfc3912)
|
||||||
39
docs/src/content/docs/fr/features/backorder/connector.mdx
Normal file
39
docs/src/content/docs/fr/features/backorder/connector.mdx
Normal file
@ -0,0 +1,39 @@
|
|||||||
|
---
|
||||||
|
title: Connecteurs
|
||||||
|
description: Découvrez comment fonctionne un Connecteur, ses prérequis et comment il s'intègre aux API des bureaux d'enregistrement.
|
||||||
|
---
|
||||||
|
|
||||||
|
import {LinkCard, Steps} from '@astrojs/starlight/components';
|
||||||
|
|
||||||
|
Un Connecteur permet à Domain Watchdog de communiquer avec l'API d'un bureau d'enregistrement (registrar) pour effectuer des actions telles que l'enregistrement de domaine.
|
||||||
|
|
||||||
|
## Créer un Connector
|
||||||
|
|
||||||
|
<Steps>
|
||||||
|
1. Choisissez un fournisseur d'API externe dans la liste des bureaux d'enregistrement supportés.
|
||||||
|
<LinkCard title="Bureaux d'enregistrement supportés" description="Liste des registrars supportés pour la création d'un Connecteur" href="/fr/features/backorder/supported-registrar"/>
|
||||||
|
|
||||||
|
2. Saisissez les informations requises en utilisant les identifiants obtenus depuis l'espace client de votre fournisseur.
|
||||||
|
:::tip{icon="heart"}
|
||||||
|
Un lien vous permet d'accéder directement à la page du fournisseur pour récupérer ces informations d'authentification.
|
||||||
|
:::
|
||||||
|
|
||||||
|
3. Examinez et acceptez les conditions requises. Pour rappel, vous pouvez supprimer un Connecteur à tout moment depuis votre espace personnel.
|
||||||
|
|
||||||
|
4. Cliquez sur le bouton pour créer votre Connecteur. **Félicitations 🎉**
|
||||||
|
</Steps>
|
||||||
|
|
||||||
|
## Considérations juridiques
|
||||||
|
|
||||||
|
Ces exigences légales garantissent que toutes les opérations sur les domaines sont conformes aux politiques des bureaux d'enregistrement et aux réglementations applicables.
|
||||||
|
|
||||||
|
Domain Watchdog agit uniquement en tant qu'interface technique et ne sert pas d'intermédiaire de paiement.
|
||||||
|
Vos identifiants sont transmis directement à l'API du fournisseur pour les opérations sur les domaines.
|
||||||
|
En créant un Connecteur, vous consentez aux conditions du fournisseur et à l'utilisation de vos identifiants pour les opérations autorisées.
|
||||||
|
|
||||||
|
En particulier, vous devez consentir à ces élements :
|
||||||
|
|
||||||
|
- Accepter les conditions d'utilisation de l'API du fournisseur
|
||||||
|
- Confirmer que vous avez l'âge légal pour accepter ces conditions
|
||||||
|
|
||||||
|
Les conditions d'utilisation pouvant changer à tout moment, le lien vers ces conditions est toujours accessible sur la page listant les Connecteurs.
|
||||||
@ -0,0 +1,108 @@
|
|||||||
|
---
|
||||||
|
title: Liste des registrars supportés
|
||||||
|
description: Liste des bureaux d'enregistrement supportés pour la récupération de domaines, avec détails sur la compatibilité.
|
||||||
|
---
|
||||||
|
|
||||||
|
import {LinkButton} from '@astrojs/starlight/components';
|
||||||
|
|
||||||
|
:::caution[Rappel]
|
||||||
|
* Veuillez noter que ce projet N'EST PAS affilié aux fournisseurs d'API utilisés pour commander des noms de domaine.
|
||||||
|
* Les installeurs du projet sont responsables de l'utilisation de leur propre instance.
|
||||||
|
* En aucun cas, le mainteneur de ce projet ne pourra être tenu responsable d'autres cas sur lesquels il n'a aucun contrôle.
|
||||||
|
:::
|
||||||
|
|
||||||
|
## OVH
|
||||||
|
|
||||||
|
| Champ | Description | Requis |
|
||||||
|
|----------------|-------------------------------------------------------------------------------------------------|:------:|
|
||||||
|
| App key | La clé qui permet à OVH d'identifier votre application | Requis |
|
||||||
|
| App secret key | La clé secrète associée à votre application | Requis |
|
||||||
|
| Consumer key | La clé secrète qui lie l'application à votre compte | Requis |
|
||||||
|
| Endpoint | Permet de choisir quel serveur utiliser (Europe, États-Unis ou Canada) | Requis |
|
||||||
|
| Subsidiary | Le pays lié à la filiale OVH associée à votre compte | Requis |
|
||||||
|
| Pricing mode | Choisissez si vous voulez payer pour un nom de domaine Premium ou uniquement les prix standards | Requis |
|
||||||
|
|
||||||
|
<LinkButton variant="secondary"
|
||||||
|
icon="external"
|
||||||
|
target="\_blank"
|
||||||
|
href="https://www.google.com/search?q=https://api.ovh.com/createToken/%3FGET%3D/order/cart%26GET%3D/order/cart/*\&POST=/order/cart\&POST=/order/cart/*\&DELETE=/order/cart/\*\&GET=/domain/extensions">
|
||||||
|
Récupérer mon token sur le site d'OVH
|
||||||
|
</LinkButton>
|
||||||
|
|
||||||
|
## Gandi
|
||||||
|
|
||||||
|
| Champ | Description | Requis |
|
||||||
|
|------------|------------------------------------------------------------|:---------:|
|
||||||
|
| Token | Le token d'authentification de votre compte | Requis |
|
||||||
|
| Sharing ID | Indique l'organisation qui paiera pour le produit commandé | Optionnel |
|
||||||
|
|
||||||
|
<LinkButton variant="secondary"
|
||||||
|
icon="external"
|
||||||
|
target="\_blank"
|
||||||
|
href="https://admin.gandi.net/organizations/account/pat">
|
||||||
|
Récupérer mon token sur le site de Gandi
|
||||||
|
</LinkButton>
|
||||||
|
|
||||||
|
## Namecheap
|
||||||
|
|
||||||
|
:::caution
|
||||||
|
Ce fournisseur exige que l'adresse IPv4 de votre instance soit renseignée sur son interface web lors de la création de la connexion API. Cette information doit également être saisie dans la configuration.
|
||||||
|
:::
|
||||||
|
|
||||||
|
| Champ | Description | Requis |
|
||||||
|
|----------|------------------------------------------------------|:--------:|
|
||||||
|
| API user | L'utilisateur API tel que donné par le Fournisseur | Requis |
|
||||||
|
| API key | La clé API telle que donnée par le Fournisseur | Requis |
|
||||||
|
|
||||||
|
<LinkButton variant="secondary"
|
||||||
|
icon="external"
|
||||||
|
target="\_blank"
|
||||||
|
href="https://ap.www.namecheap.com/settings/tools/apiaccess/">
|
||||||
|
Récupérer mon token sur le site de Namecheap
|
||||||
|
</LinkButton>
|
||||||
|
|
||||||
|
## AutoDNS
|
||||||
|
|
||||||
|
:::caution
|
||||||
|
Ce fournisseur ne fournit pas de liste des TLD supportés. Merci de vérifier si le domaine que vous souhaitez enregistrer est supporté.
|
||||||
|
:::
|
||||||
|
|
||||||
|
| Champ | Description | Requis |
|
||||||
|
|---------------|--------------------------------------------------------------|:--------:|
|
||||||
|
| Username | Le nom d'utilisateur du compte | Requis |
|
||||||
|
| Password | Le mot de passe du compte | Requis |
|
||||||
|
| Owner consent | Consentement d'achat | Requis |
|
||||||
|
| Context | Le "contexte" tel que donné par le Fournisseur | Requis |
|
||||||
|
| Contact ID | ID de contact du titulaire des noms de domaine achetés | Requis |
|
||||||
|
|
||||||
|
<LinkButton variant="secondary"
|
||||||
|
icon="external"
|
||||||
|
target="\_blank"
|
||||||
|
href="https://en.autodns.com/domain-robot-api/">
|
||||||
|
Récupérer mon token sur le site d'AutoDNS
|
||||||
|
</LinkButton>
|
||||||
|
|
||||||
|
## Name.com
|
||||||
|
|
||||||
|
:::caution
|
||||||
|
Ce fournisseur ne fournit pas de liste des TLD supportés. Merci de vérifier si le domaine que vous souhaitez enregistrer est supporté.
|
||||||
|
:::
|
||||||
|
|
||||||
|
| Champ | Description | Requis |
|
||||||
|
|----------|---------------------------------------------|:--------:|
|
||||||
|
| Username | Le nom d'utilisateur du compte | Requis |
|
||||||
|
| Token | Le token d'authentification de votre compte | Requis |
|
||||||
|
|
||||||
|
<LinkButton variant="secondary"
|
||||||
|
icon="external"
|
||||||
|
target="\_blank"
|
||||||
|
href="https://www.name.com/account/settings/api">
|
||||||
|
Récupérer mon token sur le site de Name.com
|
||||||
|
</LinkButton>
|
||||||
|
|
||||||
|
## Serveur EPP personnalisé
|
||||||
|
|
||||||
|
Ce type de connecteur vous permet de lier directement votre instance à un registre via le protocole EPP.
|
||||||
|
Cela nécessite que vous ayez signé un contrat avec un registre ; vous êtes alors considéré comme un bureau d'enregistrement à part entière.
|
||||||
|
|
||||||
|
Actuellement, l'implémentation de cette fonctionnalité n'a pas été testée ; vos retours sont importants !
|
||||||
100
docs/src/content/docs/fr/features/index.mdx
Normal file
100
docs/src/content/docs/fr/features/index.mdx
Normal file
@ -0,0 +1,100 @@
|
|||||||
|
---
|
||||||
|
title: Premiers pas
|
||||||
|
description: Guide étape par étape pour créer un compte, rechercher des domaines, suivre les changements et activer l'achat automatique avec les Connecteurs.
|
||||||
|
---
|
||||||
|
|
||||||
|
import {LinkCard, Steps} from '@astrojs/starlight/components';
|
||||||
|
|
||||||
|
Sur cette page, vous trouverez un guide étape par étape pour débuter avec **Domain Watchdog** et explorer ses principales fonctionnalités.
|
||||||
|
Le menu latéral de gauche vous permet de naviguer rapidement entre toutes les sections.
|
||||||
|
|
||||||
|
:::note
|
||||||
|
Selon la configuration de l'instance sur laquelle vous effectuez ces actions, certaines options peuvent être limitées ou masquées.
|
||||||
|
:::
|
||||||
|
|
||||||
|
-----
|
||||||
|
|
||||||
|
## Créer un compte
|
||||||
|
|
||||||
|
Si votre instance autorise l'inscription des utilisateurs, vous pouvez créer un compte directement depuis l'interface.
|
||||||
|
|
||||||
|
<Steps>
|
||||||
|
1. Cliquez sur le bouton **S'inscrire**.
|
||||||
|
2. Saisissez votre **adresse email** et votre **mot de passe**.
|
||||||
|
3. Un email de confirmation sera envoyé pour vérifier votre adresse.
|
||||||
|
</Steps>
|
||||||
|
|
||||||
|
Après avoir confirmé votre email, vous pouvez vous connecter et commencer à utiliser toutes les fonctionnalités disponibles.
|
||||||
|
|
||||||
|
-----
|
||||||
|
|
||||||
|
## Rechercher un nom de domaine
|
||||||
|
|
||||||
|
Domain Watchdog utilise le **protocole RDAP**, en remplacement de WHOIS, pour récupérer des informations sur les noms de domaine.
|
||||||
|
|
||||||
|
:::tip[En savoir plus]
|
||||||
|
Pour lire la documentation relative à la recherche de noms de domaine, vous pouvez cliquer sur le lien ci-dessous.
|
||||||
|
|
||||||
|
<LinkCard title="Recherche de nom de domaine"
|
||||||
|
description="Obtenir les détails de l'enregistrement d'un nom de domaine et l'historique des événements observés"
|
||||||
|
href="/fr/features/search/domain-search"/>
|
||||||
|
:::
|
||||||
|
|
||||||
|
-----
|
||||||
|
|
||||||
|
## Créer une Watchlist
|
||||||
|
|
||||||
|
Une **Watchlist** est une collection de noms de domaine, de déclencheurs et optionnellement d'un Connecteur API.
|
||||||
|
Elle vous permet de :
|
||||||
|
|
||||||
|
- surveiller les changements d'état des domaines
|
||||||
|
- recevoir des notifications (email ou webhook : Slack, Mattermost, Discord, etc.)
|
||||||
|
- acheter automatiquement (optionnel) un domaine lorsqu'il expire
|
||||||
|
|
||||||
|
:::tip[En savoir plus]
|
||||||
|
Pour lire la documentation relative à la Watchlist, veuillez cliquer sur le lien ci-dessous.
|
||||||
|
|
||||||
|
<LinkCard title="Watchlist"
|
||||||
|
description="Ajouter des noms de domaine à une liste pour les suivre, être notifié de tout changement, et potentiellement les acheter quand ils expirent"
|
||||||
|
href="/fr/features/tracking/watchlist"/>
|
||||||
|
:::
|
||||||
|
|
||||||
|
### Notifications de la Watchlist
|
||||||
|
|
||||||
|
Lorsqu'un domaine change d'état, vous recevrez automatiquement une notification.
|
||||||
|
Vous pouvez également exporter les événements de domaine sous forme de flux **iCalendar**.
|
||||||
|
|
||||||
|
-----
|
||||||
|
|
||||||
|
## Créer un Connecteur
|
||||||
|
|
||||||
|
Un **Connecteur** est utilisé pour commander automatiquement (backorder) un nom de domaine en utilisant l'API de son fournisseur.
|
||||||
|
|
||||||
|
:::tip[En savoir plus]
|
||||||
|
Pour lire la documentation relative au Connecteur, vous pouvez cliquer sur le lien ci-dessous.
|
||||||
|
|
||||||
|
<LinkCard title="Connecteur"
|
||||||
|
description="Créer un Connecteur pour activer l'achat de noms de domaine en le liant à vos Listes de surveillance"
|
||||||
|
href="/fr/features/backorder/connector"/>
|
||||||
|
:::
|
||||||
|
|
||||||
|
### Liste des registrars supportés
|
||||||
|
|
||||||
|
<LinkCard title="Liste des registrars supportés"
|
||||||
|
description="Liste des bureaux d'enregistrement supportés par ce projet"
|
||||||
|
href="/fr/features/backorder/supported-registrar"/>
|
||||||
|
|
||||||
|
-----
|
||||||
|
|
||||||
|
### Tableau de suivi
|
||||||
|
|
||||||
|
La page du Tableau de suivi affiche une liste de tous les noms de domaine que vous surveillez via vos Watchlists.
|
||||||
|
Cette liste est ordonnée, ce qui signifie que les noms de domaine sont classés selon leur date de suppression estimée.
|
||||||
|
|
||||||
|
:::tip[En savoir plus]
|
||||||
|
Pour lire la documentation relative au Tableau de suivi, vous pouvez cliquer sur le lien ci-dessous.
|
||||||
|
|
||||||
|
<LinkCard title="Tableau de suivi"
|
||||||
|
description="Lister tous les domaines que vous surveillez dans votre Watchlist et suivre le statut de ces domaines"
|
||||||
|
href="/fr/features/tracking/tracking-table"/>
|
||||||
|
:::
|
||||||
@ -0,0 +1,4 @@
|
|||||||
|
---
|
||||||
|
title: Liste des registrars de l'ICANN
|
||||||
|
---
|
||||||
|
|
||||||
@ -0,0 +1,3 @@
|
|||||||
|
---
|
||||||
|
title: Liste des TLD
|
||||||
|
---
|
||||||
33
docs/src/content/docs/fr/features/search/domain-search.mdx
Normal file
33
docs/src/content/docs/fr/features/search/domain-search.mdx
Normal file
@ -0,0 +1,33 @@
|
|||||||
|
---
|
||||||
|
title: Recherche de noms de domaine
|
||||||
|
description: Aperçu de la fonctionnalité de recherche de domaine
|
||||||
|
---
|
||||||
|
|
||||||
|
import {Steps} from "@astrojs/starlight/components"
|
||||||
|
import {Kbd} from "starlight-kbd/components"
|
||||||
|
|
||||||
|
:::tip[Le saviez-vous ?]
|
||||||
|
Dans ce projet, tout est fait pour minimiser le nombre de requêtes vers les serveurs RDAP. Des limitations imposées aux utilisateurs finaux aident à contrôler le flux de requêtes RDAP.
|
||||||
|
Ces limitations peuvent être configurées pour chaque instance, dans les variables d'environnement.
|
||||||
|
:::
|
||||||
|
|
||||||
|
La fonctionnalité de recherche de domaine permet aux utilisateurs de consulter des informations sur un nom de domaine via l'interface utilisateur.
|
||||||
|
|
||||||
|
Pour rechercher un nom de domaine :
|
||||||
|
|
||||||
|
<Steps>
|
||||||
|
1. Saisissez le domaine dans la barre de recherche.
|
||||||
|
2. Appuyez sur <Kbd mac="Enter" generic="Enter" /> pour soumettre la requête.
|
||||||
|
</Steps>
|
||||||
|
|
||||||
|
Si l'extension que vous recherchez ne possède pas de serveur RDAP officiel, un message d'erreur vous informera qu'aucun serveur RDAP n'est disponible.
|
||||||
|
|
||||||
|
## Mise à jour forcée
|
||||||
|
|
||||||
|
Par défaut, si les informations du domaine stockées dans la base de données sont toujours considérées comme valides, le système renvoie l'enregistrement existant sans effectuer de requête RDAP.
|
||||||
|
|
||||||
|
Si vous devez forcer une mise à jour RDAP pour un domaine donné :
|
||||||
|
|
||||||
|
* Appuyez sur <Kbd mac="Shift+Enter" generic="Shift+Enter" /> lors de la recherche.
|
||||||
|
|
||||||
|
Cela déclenche une nouvelle requête auprès du serveur RDAP.
|
||||||
@ -0,0 +1,5 @@
|
|||||||
|
---
|
||||||
|
title: Tableau de suivi
|
||||||
|
---
|
||||||
|
|
||||||
|
|
||||||
31
docs/src/content/docs/fr/features/tracking/watchlist.mdx
Normal file
31
docs/src/content/docs/fr/features/tracking/watchlist.mdx
Normal file
@ -0,0 +1,31 @@
|
|||||||
|
---
|
||||||
|
title: Watchlist
|
||||||
|
description: Découvrez comment fonctionne une Watchlist de domaines, permettant aux utilisateurs de suivre des domaines et de recevoir des mises à jour sur les changements.
|
||||||
|
---
|
||||||
|
|
||||||
|
import {Steps} from '@astrojs/starlight/components';
|
||||||
|
|
||||||
|
Une Watchlist est une liste de noms de domaine, de déclencheurs et éventuellement d'un connecteur API.
|
||||||
|
Elles vous permettent de suivre le cycle de vie des noms de domaine listés et de vous envoyer une notification lorsqu'un changement a été détecté.
|
||||||
|
|
||||||
|
Si un domaine a expiré et qu'un connecteur est lié à la Watchlist, une tentative de commande sera alors effectuée via l'API du bureau d'enregistrement associé au Connecteur.
|
||||||
|
|
||||||
|
:::note
|
||||||
|
Si le même nom de domaine est présent sur plusieurs Watchlist, il n'est pas possible de prédire à l'avance quel utilisateur remportera le nom de domaine. Le choix est laissé au hasard...
|
||||||
|
:::
|
||||||
|
|
||||||
|
## Créer une Watchlist
|
||||||
|
|
||||||
|
<Steps>
|
||||||
|
1. Choisissez un nom pour votre Watchlist afin de la retrouver plus facilement.
|
||||||
|
2. Ajoutez les noms de domaine que vous souhaitez suivre.
|
||||||
|
3. Sélectionnez les événements pour lesquels vous souhaitez recevoir une notification par email.
|
||||||
|
4. Ajoutez optionnellement un connecteur pour tenter d'acheter automatiquement un nom de domaine qui devient disponible.
|
||||||
|
5. Cliquez sur le bouton pour créer votre Watchlist. **Félicitations 🎉**
|
||||||
|
</Steps>
|
||||||
|
|
||||||
|
Maintenant, c'est à votre tour de créer une Watchlist !
|
||||||
|
|
||||||
|
## Limitations
|
||||||
|
|
||||||
|
Selon la configuration de l'instance, il existe plusieurs limitations pour encadrer le comportement des utilisateurs.
|
||||||
17
docs/src/content/docs/fr/index.mdx
Normal file
17
docs/src/content/docs/fr/index.mdx
Normal file
@ -0,0 +1,17 @@
|
|||||||
|
---
|
||||||
|
title: Domain Watchdog
|
||||||
|
description: Une app qui utilise RDAP pour collecter les données publiques à propos des noms de domaines, les suivres et les acheter dès qu'ils deviennent disponibles
|
||||||
|
template: splash
|
||||||
|
hero:
|
||||||
|
tagline: Votre compagnon dans la quête de noms de domaines 🔍
|
||||||
|
image:
|
||||||
|
file: ../../../assets/logo.png
|
||||||
|
actions:
|
||||||
|
- text: Get started
|
||||||
|
link: /en/features
|
||||||
|
icon: right-arrow
|
||||||
|
- text: Demo
|
||||||
|
link: https://demo.domainwatchdog.eu
|
||||||
|
icon: external
|
||||||
|
variant: minimal
|
||||||
|
---
|
||||||
42
docs/src/content/docs/fr/install-config/configuration.mdx
Normal file
42
docs/src/content/docs/fr/install-config/configuration.mdx
Normal file
@ -0,0 +1,42 @@
|
|||||||
|
---
|
||||||
|
title: Configuration
|
||||||
|
description: Guide de configuration expliquant les variables d'environnement et les paramètres nécessaires pour lancer et personnaliser le projet.
|
||||||
|
---
|
||||||
|
|
||||||
|
import {LinkCard} from '@astrojs/starlight/components';
|
||||||
|
|
||||||
|
<LinkCard title="Installation avec Docker" href="/fr/install-config/install/docker-compose"/>
|
||||||
|
|
||||||
|
## Variables d'environnement
|
||||||
|
|
||||||
|
| Variable | Description | Défaut |
|
||||||
|
|--------------------------------|---------------------------------------------------------|:---------------------------:|
|
||||||
|
| `DATABASE_URL` | Lire la documentation Symfony | |
|
||||||
|
| `OUTGOING_IP` | IPv4 sortante, requise par certains fournisseurs | |
|
||||||
|
| `INFLUXDB_ENABLED` | Activer la connexion avec InfluxDB | `false` |
|
||||||
|
| `INFLUXDB_URL` | URL InfluxDB | `http://localhost:8086` |
|
||||||
|
| `INFLUXDB_TOKEN` | Jeton (Token) InfluxDB | |
|
||||||
|
| `INFLUXDB_BUCKET` | Nom du bucket InfluxDB | `domainwatchdog` |
|
||||||
|
| `INFLUXDB_ORG` | Organisation InfluxDB | `domainwatchdog` |
|
||||||
|
| `LIMITED_FEATURES` | Limiter certaines fonctionnalités pour les utilisateurs | `false` |
|
||||||
|
| `LIMIT_MAX_WATCHLIST` | Nombre max. de listes de surveillance par utilisateur | `0` |
|
||||||
|
| `LIMIT_MAX_WATCHLIST_DOMAINS` | Nombre max. de domaines par liste de surveillance | `0` |
|
||||||
|
| `LIMIT_MAX_WATCHLIST_WEBHOOKS` | Nombre max. de webhooks par liste de surveillance | `0` |
|
||||||
|
| `MAILER_SENDER_NAME` | Nom de l'expéditeur des e-mails | `Domain Watchdog` |
|
||||||
|
| `MAILER_SENDER_EMAIL` | Adresse e-mail de l'expéditeur | `notifications@example.com` |
|
||||||
|
| `REGISTRATION_ENABLED` | Activer l'inscription des utilisateurs | `true` |
|
||||||
|
| `REGISTRATION_VERIFY_EMAIL` | Vérifier les e-mails lors de l'inscription | `false` |
|
||||||
|
| `MAILER_DSN` | Lire la documentation Symfony | `null://null` |
|
||||||
|
| `OAUTH_CLIENT_ID` | ID Client (OAuth 2.0) pour le SSO externe | |
|
||||||
|
| `OAUTH_CLIENT_SECRET` | Secret Client (OAuth 2.0) | |
|
||||||
|
| `OAUTH_AUTHORIZATION_URL` | URL d'autorisation (OAuth 2.0) | |
|
||||||
|
| `OAUTH_TOKEN_URL` | URL de jeton (OAuth 2.0) | |
|
||||||
|
| `OAUTH_USERINFO_URL` | URL des informations utilisateur (OAuth 2.0) | |
|
||||||
|
| `OAUTH_SCOPE` | Scope (OAuth 2.0) | |
|
||||||
|
|
||||||
|
|
||||||
|
## Authentification
|
||||||
|
|
||||||
|
Actuellement, il n'est pas possible de supprimer votre compte, de réinitialiser votre mot de passe ou d'activer l'authentification multifacteur.
|
||||||
|
|
||||||
|
L'inscription directe des utilisateurs dans l'interface est recommandée pour les instances individuelles. Pour les environnements multi-utilisateurs, la méthode recommandée est d'utiliser un SSO externe via le protocole OAuth 2.0.
|
||||||
@ -0,0 +1,25 @@
|
|||||||
|
---
|
||||||
|
title: Installation Docker Compose
|
||||||
|
description: Guide pour installer le projet en utilisant Docker Compose, avec les étapes de configuration et les notes de déploiement.
|
||||||
|
---
|
||||||
|
|
||||||
|
import {LinkCard} from '@astrojs/starlight/components';
|
||||||
|
|
||||||
|
1. Téléchargez le fichier [docker-compose.yml](https://github.com/maelgangloff/domain-watchdog/blob/develop/docker-compose.yml) et modifiez-le selon vos besoins
|
||||||
|
2. Téléchargez le fichier [.env](https://github.com/maelgangloff/domain-watchdog/blob/develop/.env) et modifiez-le selon vos besoins
|
||||||
|
<LinkCard title="Configuration" description="Liste des variables d'environnement" href="/en/install-config/configuration/#environment-variables"/>
|
||||||
|
|
||||||
|
3. Ajoutez des fichiers statiques pour personnaliser votre instance (sous `public/content`)
|
||||||
|
4. Récupérez la dernière version de l'image Domain Watchdog depuis Docker Hub
|
||||||
|
|
||||||
|
```shell
|
||||||
|
docker compose pull
|
||||||
|
```
|
||||||
|
|
||||||
|
5. Démarrez le projet en environnement de production
|
||||||
|
|
||||||
|
```shell
|
||||||
|
docker compose up
|
||||||
|
```
|
||||||
|
|
||||||
|
Par défaut, le conteneur écoute sur http://localhost:8080, mais vous pouvez configurer cela dans les variables d'environnement.
|
||||||
@ -0,0 +1,86 @@
|
|||||||
|
---
|
||||||
|
title: Installation manuelle
|
||||||
|
description: Guide d'installation manuelle avec les prérequis système, les dépendances et les instructions étape par étape pour installer le projet depuis la source.
|
||||||
|
---
|
||||||
|
|
||||||
|
import {FileTree, LinkCard, Steps} from '@astrojs/starlight/components';
|
||||||
|
|
||||||
|
Pour déployer une instance Domain Watchdog, veuillez vous référer à la documentation Symfony sur [Comment déployer une application Symfony](https://symfony.com/doc/current/deployment.html).
|
||||||
|
|
||||||
|
## Prérequis
|
||||||
|
|
||||||
|
- PHP 8.4 ou supérieur
|
||||||
|
- PostgreSQL 16 ou supérieur
|
||||||
|
|
||||||
|
Afin de récupérer des informations sur les noms de domaine, Domain Watchdog interrogera le serveur RDAP responsable du TLD.
|
||||||
|
Il est crucial que l'instance Domain Watchdog soit placée dans un environnement propre à partir duquel ces serveurs peuvent être interrogés.
|
||||||
|
En particulier, les serveurs DNS et les certificats racines du système doivent être de confiance.
|
||||||
|
|
||||||
|
## Étapes
|
||||||
|
|
||||||
|
Cloner le dépôt :
|
||||||
|
|
||||||
|
```shell
|
||||||
|
git clone https://github.com/maelgangloff/domain-watchdog.git
|
||||||
|
```
|
||||||
|
|
||||||
|
### Backend
|
||||||
|
|
||||||
|
<Steps>
|
||||||
|
1. Installer les dépendances
|
||||||
|
```shell
|
||||||
|
composer install
|
||||||
|
```
|
||||||
|
2. Configurer les variables d'environnement
|
||||||
|
```shell
|
||||||
|
cp .env .env.local
|
||||||
|
```
|
||||||
|
<LinkCard title="Configuration" description="Liste des variables d'environnement" href="/fr/install-config/configuration"/>
|
||||||
|
|
||||||
|
3. Générer la paire de clés cryptographiques pour la signature JWT
|
||||||
|
```shell
|
||||||
|
php bin/console lexik:jwt:generate-keypair
|
||||||
|
```
|
||||||
|
4. Exécuter les migrations de base de données
|
||||||
|
```shell
|
||||||
|
php bin/console doctrine:migrations:migrate
|
||||||
|
```
|
||||||
|
5. Démarrer le serveur Symfony
|
||||||
|
```shell
|
||||||
|
symfony server:start
|
||||||
|
```
|
||||||
|
6. Construire les assets
|
||||||
|
```shell
|
||||||
|
php bin/console assets:install
|
||||||
|
```
|
||||||
|
7. N'oubliez pas de configurer les workers pour traiter la [file d'attente de messages](https://symfony.com/doc/current/messenger.html)
|
||||||
|
</Steps>
|
||||||
|
|
||||||
|
### Frontend
|
||||||
|
|
||||||
|
<Steps>
|
||||||
|
1. Installer les dépendances
|
||||||
|
```shell
|
||||||
|
yarn install
|
||||||
|
```
|
||||||
|
2. Générer les fichiers de langue
|
||||||
|
```shell
|
||||||
|
yarn run ttag:po2json
|
||||||
|
```
|
||||||
|
3. Effectuer le build final
|
||||||
|
```shell
|
||||||
|
yarn build
|
||||||
|
```
|
||||||
|
4. Ajoutez et modifiez les fichiers suivants si nécessaire
|
||||||
|
<FileTree>
|
||||||
|
- public
|
||||||
|
- content
|
||||||
|
- home.md
|
||||||
|
- privacy.md
|
||||||
|
- tos.md
|
||||||
|
- faq.md
|
||||||
|
- icons-512.png
|
||||||
|
- banner.png
|
||||||
|
- favicon.ico
|
||||||
|
</FileTree>
|
||||||
|
</Steps>
|
||||||
52
docs/src/content/docs/fr/install-config/upgrade.mdx
Normal file
52
docs/src/content/docs/fr/install-config/upgrade.mdx
Normal file
@ -0,0 +1,52 @@
|
|||||||
|
---
|
||||||
|
title: Mise à jour manuelle
|
||||||
|
description: Guide de mise à jour expliquant comment mettre à jour le projet en toute sécurité, incluant les migrations et les détails de version.
|
||||||
|
---
|
||||||
|
|
||||||
|
import {Steps} from "@astrojs/starlight/components";
|
||||||
|
|
||||||
|
**Toute mise à jour est sous votre responsabilité. Faites une sauvegarde des données si nécessaire.**
|
||||||
|
|
||||||
|
Récupérer les mises à jour depuis le dépôt distant :
|
||||||
|
|
||||||
|
```shell
|
||||||
|
git pull origin master
|
||||||
|
```
|
||||||
|
|
||||||
|
## Backend
|
||||||
|
|
||||||
|
<Steps>
|
||||||
|
1. Installer les dépendances
|
||||||
|
```shell
|
||||||
|
composer install
|
||||||
|
```
|
||||||
|
2. Exécuter les migrations de base de données
|
||||||
|
```shell
|
||||||
|
php bin/console doctrine:migrations:migrate
|
||||||
|
```
|
||||||
|
3. Vider le cache Symfony
|
||||||
|
```shell
|
||||||
|
php bin/console cache:clear
|
||||||
|
```
|
||||||
|
4. Construire les assets
|
||||||
|
```shell
|
||||||
|
php bin/console assets:install
|
||||||
|
```
|
||||||
|
</Steps>
|
||||||
|
|
||||||
|
## Frontend
|
||||||
|
|
||||||
|
<Steps>
|
||||||
|
1. Installer les dépendances
|
||||||
|
```shell
|
||||||
|
yarn install
|
||||||
|
```
|
||||||
|
2. Générer les fichiers de langue
|
||||||
|
```shell
|
||||||
|
yarn run ttag:po2json
|
||||||
|
```
|
||||||
|
3. Générer le build final
|
||||||
|
```shell
|
||||||
|
yarn build
|
||||||
|
```
|
||||||
|
</Steps>
|
||||||
File diff suppressed because it is too large
Load Diff
File diff suppressed because it is too large
Load Diff
Loading…
x
Reference in New Issue
Block a user