Verified domains and auto-join
If your company uses one email domain, such as acme.com, you can let anyone who signs in with a verified @acme.com address join your organization on their own. You first prove that you own the domain.
Owners and Admins can do this, from Settings › Domains or the terminal.
Verify a domain
- Add the domain. In Tara, click Add domain. From the terminal, run
ph org domain add acme.com. - Tara shows a TXT record. Create it at your DNS provider. The name is
_aiforge-verify.acme.comand the value isaiforge-verify=<token>. - Wait for DNS to update (usually minutes), then click Verify, or run
ph org domain verify acme.com.
Public mail providers, such as gmail.com and outlook.com, and their subdomains are refused. One organization owns a verified domain, so if another organization verified it first, you get domain_taken. An organization can have up to 20 domains.
Turn on auto-join
On a verified domain, choose a role: Viewer or Member. Never Admin or Owner.
ph org domain auto-join acme.com member # or viewer, or off
ph org domain # list domains, status, role, pending TXT recordsAfter that, a person who signs in with a verified email at that domain joins with that role. This holds for GitHub, Google, and email links, but not for SSO identities, whose email Tara doesn't treat as verified.
- The seat limit applies. When no seat is free, the person isn't added, and Tara records it in the audit log. Viewers take no seat.
- A person an Admin removed, or who left on their own, is not added again by auto-join.
- Auto-join works only on a domain that is verified. An unverified domain does nothing.
Remove a domain
ph org domain remove acme.com --yes. People who joined through it stay as members. Require SSO applies only to people at your verified domains, so keep at least one if you use it.