Domaines et adresses¶

Votre organisation peut ouvrir OS à une adresse web qui lui est propre, comme ai.jansen.fr, et apparaître aussitôt dans sa propre identité visuelle, page de connexion comprise. Cette page montre comment prouver un domaine, ajouter une adresse, quels enregistrements DNS publier et ce que signifie chaque statut. Vous trouvez l'écran sous Gestion de l'organisation, Domaines et adresses.

Qui peut faire quoi¶

Un org-admin de l'organisation peut prouver des domaines et ajouter, réessayer et supprimer des adresses (Gérer les rôles). Qui peut seulement consulter voit les domaines et les adresses sans boutons. Un bouton n'apparaît que si OS autoriserait aussi la demande qui se trouve derrière.

Prouver un domaine¶

Chaque adresse se trouve sous un domaine dont votre organisation a prouvé qu'il lui appartient.

Sous Domaines prouvés, saisissez le domaine, par exemple jansen.fr, et choisissez Ajouter.
L'écran affiche un enregistrement TXT : un nom et une valeur. Copiez-les et publiez l'enregistrement chez le fournisseur DNS de votre domaine.
Choisissez Vérifier. Si l'enregistrement n'est pas encore visible, OS le dit. Le DNS peut prendre jusqu'à un jour ; réessayez plus tard.

Un domaine que votre organisation a déjà prouvé pour la connexion d'entreprise n'a pas besoin d'être prouvé de nouveau. Si vous choisissez Abandonner le domaine, les adresses sous ce domaine cessent de fonctionner.

Un domaine prouvé peut aussi décider comment les personnes se connectent. S'il appartient à la connexion d'entreprise de votre organisation, la page de connexion envoie toute personne qui saisit une adresse de ce domaine, comme anne@jansen.fr, vers votre propre fournisseur d'identité. Un domaine qu'une autre organisation utilise déjà pour sa connexion ne peut pas en piloter une seconde.

Si vous abandonnez le domaine, la connexion d'entreprise qu'il pilote disparaît aussi : les membres gardent leur compte mais ne se connectent plus par votre fournisseur.

Votre adresse par défaut¶

Chaque organisation a une adresse par défaut : son libellé sous un domaine d'une organisation au-dessus, comme noordwind.os.artific.nl. Vous choisissez le libellé vous-même : 3 à 40 lettres minuscules, chiffres et tirets. Un libellé déjà pris ou que OS garde pour lui (comme www ou login) est refusé au niveau du champ. L'adresse par défaut peut être désactivée par l'administrateur de l'organisation qui détient le domaine.

Ajouter une adresse propre¶

Sous Adresses propres, saisissez l'adresse, par exemple ai.jansen.fr, et choisissez Ajouter. L'adresse doit se trouver sous un domaine prouvé. Le domaine lui-même (jansen.fr) ne peut pas être une adresse ; placez www ou ai devant. Une organisation a au plus cinq adresses propres.

Vous publiez ensuite un enregistrement : un CNAME de votre adresse vers edge.os.artific.nl. OS demande alors lui-même un certificat.

Un domaine pour les sous-organisations¶

Un partenaire, ou une organisation avec des services, peut donner un domaine prouvé à toutes les organisations en dessous. Chaque organisation en dessous reçoit alors une adresse comme noordwind.jansen.fr, sans rien faire elle-même. Choisissez le domaine sous Domaines pour les sous-organisations puis Ajouter. Une organisation en a au plus trois.

Vous publiez deux enregistrements : un CNAME de *.jansen.fr vers edge.os.artific.nl et un CNAME de _acme-challenge.jansen.fr vers la valeur affichée à l'écran.

Les enregistrements et leur statut¶

L'écran affiche les enregistrements de chaque adresse dans l'ordre, chacun fait ou à faire, et nomme le premier enregistrement encore à faire avec ce qu'il faut changer :

Publiez cet enregistrement : OS ne le voit pas encore.
L'enregistrement est publié mais pas encore visible : patientez ; le DNS peut prendre jusqu'à un jour.
Let's Encrypt n'a pas pu valider : vérifiez que le CNAME pointe vers la valeur affichée.

L'enregistrement * d'un domaine pour les sous-organisations est vérifié une fois le certificat émis. C'est votre propre navigateur qui vérifie : il demande un nom aléatoire sous le * et regarde si OS répond. Si ce n'est pas le cas, l'enregistrement apparaît comme étape suivante : attendez la mise à jour du DNS, vérifiez que le * pointe vers edge.os.artific.nl, puis choisissez Vérifier à nouveau.

L'adresse elle-même a un statut :

Statut	Signification
En attente des enregistrements	OS attend que les enregistrements soient visibles.
Certificat en cours de demande	Let's Encrypt vérifie les enregistrements et émet le certificat.
Active	L'adresse fonctionne.
Échec	Le certificat n'a pas été obtenu. Corrigez l'enregistrement et choisissez Réessayer.
Inactive	La preuve du domaine a disparu ; l'adresse ne fonctionne plus.

Configurer automatiquement avec Entri¶

Là où OS le propose, Configurer automatiquement se trouve au-dessus des enregistrements. Entri, un service extérieur à OS, inscrit alors les enregistrements pour vous chez votre fournisseur DNS : vous vous connectez chez votre fournisseur et Entri écrit les enregistrements. Entri voit votre domaine, les enregistrements, votre adresse IP et votre connexion chez le fournisseur. La fenêtre d'Entri est en français, en anglais ou en espagnol.

C'est une aide, pas une preuve : après Entri aussi, OS lit lui-même si les enregistrements sont en place. Si la configuration automatique ne fonctionne pas, ou si vous préférez ne pas l'utiliser, copiez les enregistrements vous-même.

Chaque modification entre dans le journal d'audit.