App-domeinen

Een app-domein is een eigen hostnaam waarop een van de apps van je workspace draait, met korte, nette adressen:

• Go Links antwoordt erop zonder /go: go.example.com/roadmap gaat naar waar roadmap heen wijst, en is dus het adres voor op posters en dia's.
• De evenementen van Dory staan op adressen als events.example.com/events/…, en de deelnamelinks en QR-codes die vanaf de hostnaam worden gedeeld, wijzen ernaar.
• Elke andere app werkt op dezelfde manier, met de pagina's ervan op de hostnaam.

Zodra een hostnaam is opgeslagen, geven e-mails, Slack-berichten, de REST API en AI-assistenten de adressen van de app erop door. Instellingen, facturering, de startpagina van de workspace en de andere apps blijven op het eigen adres van Taktoria. Elke app kan één hostnaam hebben.

Alleen een eigenaar of beheerder van de workspace kan een app een hostnaam geven.

1. Open Instellingen → App-domeinen.
2. Vul onder de app de Hostnaam in, zoals go.example.com, en kies Opslaan.
3. Voeg het DNS-record toe dat dan verschijnt, waar de DNS van je domein ook wordt beheerd (zie hieronder).
4. Geef het een paar minuten. De regel onder de hostnaam zegt hoe ver hij is, en Opnieuw controleren kijkt meteen.

Een hostnaam dient één app in één workspace: een hostnaam die al naar een andere workspace wijst, of al een andere app bedient, wordt geweigerd.

De hostnaam opslaan doet op zichzelf niets: het record dat ernaast staat, laat hem naar Taktoria wijzen. Het is een CNAME voor een hostnaam onder je domein, zoals go.example.com, en een A-record voor de root van een domein, zoals example.com. De naam staat er in de korte vorm waar de meeste DNS-providers om vragen, go, of @ voor de root, met de waarde ernaast.

Is de hostnaam al eens gebruikt bij onze hostingprovider, dan wordt ook om een TXT-record gevraagd, om te bewijzen dat je hem mag gebruiken.

Achter Cloudflare zet je het record op alleen DNS (de grijze wolk). Met proxy bereikt het verkeer Taktoria nooit en kan het certificaat niet worden uitgegeven.

Zodra het record er staat, wordt het certificaat voor de hostnaam automatisch uitgegeven: er valt niets te uploaden of te vernieuwen. De regel onder de hostnaam zegt dan dat hij werkt, en het record wordt niet meer getoond, al moet het in je DNS blijven staan.

Tot die tijd zegt de regel waar hij op wacht: dat het DNS-record bij ons aankomt, of dat het TXT-record de hostnaam verifieert. Zegt hij dat de hostnaam niet bij onze host is ingesteld, sla hem dan opnieuw op.

Mensen loggen in op de hostnaam en blijven daar. Wie al bij Taktoria is ingelogd, is ook op de hostnaam ingelogd zonder het opnieuw te hoeven doen, en wie bij een van beide uitlogt, is bij allebei uitgelogd.

De inlogpagina op de hostnaam toont de naam van je workspace, en het pictogram als er een is geüpload; met whitelabeling aan ook de koptekst. Hij biedt alleen de manieren die je workspace toestaat: alleen Google als die Google vereist, en single sign-on alleen als hij een provider heeft. Registreren kan daar niet: mensen worden lid van een workspace via een uitnodiging.

Sommige pagina's op een hostnaam zijn ook voor mensen buiten je workspace, die nooit een account nodig hebben:

• Go Links: elke link kiest wie hem mag volgen, onder Wie hem mag volgen in het formulier ervan. Mensen met bepaalde e-maildomeinen, de standaard, laat leden binnen en iedereen die met Doorgaan met Google of Mail me een code een adres bewijst bij een domein op de lijst van je workspace in Instellingen → Domeinen. Leden van deze workspace laat alleen leden binnen, en Iedereen met de link laat iedereen binnen, waar het formulier je voor waarschuwt. Zolang iemand geen adres heeft bewezen, ziet een link die hij niet mag volgen er precies zo uit als een link die niet bestaat.
• Dory: deelnemers doen mee aan een evenement op de hostnaam, en Wie mag meedoen ervan bepaalt wie erin komt, net als op het eigen adres van Taktoria. Een evenement voor Mensen met bepaalde e-maildomeinen vraagt bij de deur om een adres bij een ervan, en toont de titel alleen aan de mensen die het binnenlaat.

Een bewezen adres blijft 30 dagen geldig in die browser. Zie Go Links en Dory voor meer.

Om een app naar een andere hostnaam te verhuizen, sla je de nieuwe op in plaats van de oude: de oude bedient hem dan niet meer. Om er helemaal mee te stoppen, kies je in Instellingen → App-domeinen de knop onder de hostnaam waarmee die de app niet meer bedient.

De app is dan weer bereikbaar op het eigen adres van Taktoria, en de adressen op de oude hostnaam die zijn uitgedeeld, zoals go-links op posters en deelnamelinks van Dory, werken niet meer. Verwijder het DNS-record zodra je het niet meer nodig hebt.

• Hij wacht al lang op DNS: vergelijk de naam en de waarde van het record met de getoonde, en controleer dat het niet via een proxy loopt. Sommige DNS-providers doen er een paar uur over.
• Er ging een pagina open op het eigen adres van Taktoria: instellingen, facturering en de andere apps openen altijd daar; de eigen pagina's van de app blijven op de hostnaam.
• Een bezoeker moet inloggen in plaats van een adres te bewijzen: de link is voor Leden van deze workspace, of de lijst van je workspace in Instellingen → Domeinen is leeg.