Okta domain terminology

[alexdahl-okta]

I'm not sure what the current behavior is exactly, but from other discussions it appears that the CLI uses the term org URL to refer to an org's Okta domain.

All of our touchpoints should use standard terminology: https://oktawiki.atlassian.net/wiki/spaces/UX/pages/470681125/

---

✅ Standard: "Okta domain".

• https://{yourOktaDomain}
• Always includes the top-level domain (.com, .eu, etc). An Okta domain is a fully-qualified domain name.
• Does not include the protocol (https). Protocols are part of specific URLs, but are separate from the domain.
• Can be customized, so might be dev-123456.oktapreview.com, company.okta.com, id.example.org, etc.
• "Okta domain" is preferred, but "domain" is acceptable if context ensures the meaning is unambiguous. (Customers may also interact with other types of "domains", such as Active Directory or websites they manage. Be specific.)
• A domain is an attribute of an Okta organization.

✅ Native apps: "scheme".

• {scheme}:/+expo-auth-session
• For native apps that use reverse DNS notation, "scheme" is the Okta domain in reverse order.
• Matches domain customization, so might be com.oktapreview.dev-123456, com.okta.company, org.example.id, etc.

ℹ️ Related: "organization".

• When speaking about concepts and architecture, "organization" and "org" are still used.
• An org is part of Okta's architecture, and represents a real-world organization using Okta.
• An org is persistent, while an org's domain may change over time.

❌ Avoid: "subdomain", "tenant", "org URL", "Okta URL", "org domain".

[bdemers]

I was going to update this, but it gets a little tricky, this value is listed in the developer console as "Org URL". and most developer configurations need the base URL. We may need a more general term for this 🤔

[alexdahl-okta]

The Developer Console is also using out of date terminology. 😬

I'd be open to adding something like base URL = protocol + domain into the mix, as long as we do so intentionally.

This probably isn't high priority; happy to connect any time!