Skip to content

Commit

Permalink
fix: multibrand docs (#1762)
Browse files Browse the repository at this point in the history
  • Loading branch information
vinckr committed Jun 20, 2024
1 parent 5448007 commit 3c99743
Showing 1 changed file with 17 additions and 7 deletions.
24 changes: 17 additions & 7 deletions docs/kratos/bring-your-own-ui/20_configure-ory-to-use-your-ui.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -36,13 +36,19 @@ SDK Configuration URL.
You can toggle the "Enable the Account Experience welcome page" setting to hide the default "welcome" screen that isn't intended
for end-users.

## Multiple custom domains setup
## Multiple custom domains

Ory Network projects starting with the Scale plan can have multiple custom domains registered. You can add a different custom UI
base URL of each of the custom domains registered in the project. This allows for a high degree of flexibility, where each of the
domains serves its own set of UI views that have a common path makeup but different base URL.
With the _Multibrand_ feature enabled for your workspace, you can add multiple custom domains to each Ory Network project. You can
add a different custom UI base URL of each of the custom domains registered in the project. This allows for a high degree of
flexibility, where each of the domains serves its own set of UI views that have a common path makeup but different base URL.

In the real world, this means that you can serve different UI views to customers that interact with different parts of your
:::info

Interested in the Multibrand feature for your Ory Network project? [We're here to help! ](https://www.ory.sh/contact)

:::

In practical terms, this means that you can serve different UI views to customers that interact with different parts of your
business, while still allowing them to conveniently use one account that's managed by your Ory Network project.

For example, the ACME Car Parts company has three online storefronts for three different types of automotive products:
Expand All @@ -59,8 +65,7 @@ influenced the base paths used for serving UI:
- carseats.com uses `carseats.com`
- wipers.com uses `wipers.com/self-service/`

Using their [Growth plan](https://www.ory.sh/pricing/) Ory Network project, ACME creates this setup using the **User Interface**
view in the Ory Console:
ACME creates this setup using the **User Interface** view in the Ory Console:

| Site | Domain | Base URL |
| ------------ | ----------------------------- | -------------------------- |
Expand All @@ -73,6 +78,11 @@ serves changes depending on the store the user visits which allows for consisten
ACME's brands. Since these stores are hosted on different domains, the users must sign in and get an Ory Session issued for the
store's domain when they switch between the storefronts.

It's important to note that while a user can use the same account across multiple domains, they will need to authenticate
separately on each domain. This is because cookies, including the session cookie issued by Ory, are isolated in the browser per
domain to prevent cross-site attacks. Therefore, there will be one session per domain. As an alternative for managing multiple
domains, you can use OpenID Connect. However, even with OpenID Connect, there will still be one session per domain.

## Development

When developing locally, you can configure Ory Network to use UI views hosted on local machine, for example
Expand Down

0 comments on commit 3c99743

Please sign in to comment.