Skip to content

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 ​

  1. Add the domain. In Tara, click Add domain. From the terminal, run ph org domain add acme.com.
  2. Tara shows a TXT record. Create it at your DNS provider. The name is _aiforge-verify.acme.com and the value is aiforge-verify=<token>.
  3. Wait for DNS to update (usually minutes), then click Verify, or run ph org domain verify acme.com.
A new domain stays Pending until the TXT record is found; the page shows the record to add.

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.

bash
ph org domain auto-join acme.com member    # or viewer, or off
ph org domain                              # list domains, status, role, pending TXT records

After 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.

Further reading ​