Domains
Your application answers at its Kedalia address, which “Open” opens from the Applications page; the icon next to it copies it. It can also answer under your own names, such
as hr.company.com or company.com, depending on your tier.
Add a name
Open the application's “Domains” tab, beside its name at the top of its pages, or “Domains” in the “…” menu of its line on the “Applications” page. Type the name in “Domain name”, then click “Add”. Kedalia answers “Name added: copy its two lines into your DNS zone, then verify.”, and the name appears with the state “DNS to set”.
The name must be yours. Kedalia refuses an IP address or one of its own names: “Name refused: enter a domain you own, such as hr.company.com or company.com, neither an IP address nor a Kedalia name.”
The two DNS lines
Under the name, two lines, with their “Name”, “Type” and “Value”. Copy them into your domain's DNS zone, wherever it is managed (often at the provider that sold it to you): the “Copy” button beside each name and each value copies it without a typo. On a phone, each line shows as a block, its name, type and value one under the other.
- The first, of type TXT, proves the name is yours. Its name starts with
_kedalia., and its value withkedalia-verification=. - The second leads the name to your application. For a subdomain such as
hr.company.com, it is a CNAME to the application's Kedalia address. For a bare domain such ascompany.com, it is an A record to the IP address shown: a bare domain cannot carry a CNAME. If your provider offers an ALIAS or ANAME record, prefer it, with the application's Kedalia address as its value: it will follow the addresses if they change.
Verify
Once both lines are in place, click “Verify”. A DNS change takes time to spread: if Kedalia cannot find the first line yet, the name's row shows “Last check at 7:01 PM: TXT line not found or different.” (the time is yours). That message stays under the name, with the two lines to copy, until the next check, another action or a reload of the page. Check both lines, wait a few minutes, then click “Verify” again.
Once verified, the name moves to “Being set up”, and the page updates by itself. The certificate that secures connections usually arrives within a minute. The application answers on this name once it has restarted: right away when its latest version passed its tests, otherwise when it is next published. Until then, opening the name shows a “page not found”: that is normal for these few minutes. Still nothing after a quarter of an hour: click “Retry the certificate”. The name is then “Active”.
Make main
On a verified name, “Make main” makes it the name the application's e-mail links use, from the next time it is published. It then carries the “Main” mark.
Sign-ins
Each name has its own sign-ins: a user signed in on one name signs in again on another. If your application signs in with Google, add each name to the authorised origins of its Google project.
Remove a name
Click “Remove” next to the name. Kedalia asks for confirmation: the application stops answering on this name. Then delete its two lines from your DNS zone: a name left pointing to Kedalia could be claimed again.