Domeinen en adressen¶

Je organisatie kan OS openen op een eigen webadres, zoals ai.jansen.nl, en dan meteen in haar eigen huisstijl verschijnen, ook op de inlogpagina. Deze pagina laat zien hoe je een domein bewijst, een adres toevoegt, welke DNS-records je publiceert en wat elke status betekent. Je vindt het scherm onder Organisatiebeheer, Domeinen en adressen.

Wie wat mag¶

Een org-admin van de organisatie kan domeinen bewijzen en adressen toevoegen, opnieuw proberen en verwijderen (Rollen beheren). Wie alleen mag kijken, ziet de domeinen en adressen zonder knoppen. Een knop staat er alleen als OS het verzoek erachter ook zou toestaan.

Een domein bewijzen¶

Elk adres ligt onder een domein waarvan je organisatie heeft bewezen dat het van haar is.

1. Vul onder Bewezen domeinen het domein in, bijvoorbeeld jansen.nl, en kies Toevoegen.
2. Het scherm toont een TXT-record: een naam en een waarde. Kopieer ze en publiceer het record bij de DNS-provider van je domein.
3. Kies Controleren. Is het record nog niet te zien, dan zegt OS dat. DNS kan tot een dag duren; probeer het later opnieuw.

Een domein dat je organisatie al voor bedrijfslogin bewees, hoef je niet opnieuw te bewijzen. Kies je Domein opgeven, dan werken de adressen onder dat domein niet meer.

Wat een bewezen domein stuurt¶

Een bewezen domein kan ook bepalen hoe mensen inloggen. Hoort het bij de bedrijfslogin van je organisatie, dan stuurt de inlogpagina iedereen die een adres in dat domein invult, zoals anne@jansen.nl, naar jullie eigen identiteitsprovider. Een domein dat een andere organisatie al voor haar login gebruikt, kan niet nog eens zo'n login sturen.

Geef je het domein op, dan verdwijnt ook de bedrijfslogin die het stuurt: de leden houden hun account, maar loggen niet meer via jullie provider in.

Je standaardadres¶

Elke organisatie heeft een standaardadres: haar label voor een domein van een organisatie erboven, zoals noordwind.os.artific.nl. Het label kies je zelf: 3 tot 40 kleine letters, cijfers en streepjes. Een label dat al bezet is of dat OS voor zichzelf houdt (zoals www of login), weigert OS bij het veld. Het standaardadres kan worden uitgezet door de beheerder van de organisatie die het domein heeft.

Een eigen adres toevoegen¶

Vul onder Eigen adressen het adres in, bijvoorbeeld ai.jansen.nl, en kies Toevoegen. Het adres moet onder een bewezen domein liggen. Het domein zelf (jansen.nl) kan geen adres zijn; kies www of ai ervoor. Een organisatie heeft hoogstens vijf eigen adressen.

Daarna publiceer je één record: een CNAME van je adres naar edge.os.artific.nl. OS vraagt dan zelf een certificaat aan.

Een domein voor onderliggende organisaties¶

Een partner of een organisatie met afdelingen kan een bewezen domein aan alle organisaties eronder geven. Elke organisatie eronder krijgt dan een adres als noordwind.jansen.nl, zonder dat zij zelf iets hoeft te doen. Kies het domein onder Domeinen voor onderliggende organisaties en kies Toevoegen. Een organisatie heeft er hoogstens drie.

Je publiceert twee records: een CNAME van *.jansen.nl naar edge.os.artific.nl en een CNAME van _acme-challenge.jansen.nl naar de waarde die het scherm toont.

De records en hun status¶

Het scherm toont bij elk adres de records op volgorde, met bij elk of het in orde is of nog te doen, en noemt het eerste record dat nog te doen is met wat je moet veranderen:

• Publiceer dit record: OS ziet het nog niet.
• Het record is gepubliceerd maar nog niet zichtbaar: wacht; DNS kan tot een dag duren.
• Let's Encrypt kon niet valideren: controleer dat de CNAME naar de getoonde waarde wijst.

Het record * van een domein voor onderliggende organisaties wordt gecontroleerd zodra het certificaat is uitgegeven. Je eigen browser doet die controle: hij vraagt een willekeurige naam onder de * op en ziet of OS antwoordt. Lukt dat niet, dan staat het record bovenaan als volgende stap: wacht tot DNS bijgewerkt is, controleer dat de * naar edge.os.artific.nl wijst en kies Opnieuw controleren.

Het adres zelf heeft een status:

Automatisch instellen met Entri¶

Waar OS het aanbiedt, staat boven de records Automatisch instellen. Daarmee zet Entri, een dienst buiten OS, de records voor je klaar bij je DNS-provider: je logt in bij je provider en Entri schrijft de records. Entri ziet daarbij je domein, de records, je IP-adres en je login bij de provider. Het venster van Entri is Engels, Frans of Spaans; Nederlands kent Entri niet.

Het is een hulpmiddel, geen bewijs: ook na Entri leest OS zelf of de records in orde zijn. Lukt automatisch instellen niet, of wil je het niet, neem de records dan zelf over.

Elke wijziging komt in het auditlog.