# Open the portal under your brand

Put online the portal your tenants will see, and bring in the first one.

A **brand** is the website your tenants see: its name, its domain, its languages, its theme, its e-mails. You can have several, served by the same front instance.

## The steps

1. Open **Cloud services › Portals**, then fill in **Brand name**, **Identifier (lowercase)** and **Default language**. Click **Create as draft**.
2. On the brand's page, click **Add a domain**, for instance `cloud.your-brand.example`. The screen shows two DNS records to publish:
   - a **TXT**, which proves you own the domain;
   - a **CNAME**, to your front instance.
3. Once the domain is verified, click **Make primary**, then **Activate**. Naoshift checks domains every quarter of an hour, and the certificate follows: allow up to a few hours.
4. Under **Tenants served**, click **Serve** for each tenant who will sign in through this brand.
5. Add the **console** domain, such as `console.your-brand.example`. Without it, your tenants cannot open their machines' console: the screen says what to do.

## How your tenants sign in

- **Sign-in policy**: local accounts with a password, second factor required, or enforced single sign-on.
- **Identity providers**: plug in a tenant's OpenID Connect directory (Entra ID, Okta, Keycloak, Google…). A proven e-mail domain sends its addresses to that directory from the sign-in page.

Sign-in codes and notices always leave under your brand, never under Naoshift's.

## The theme

Under **Cloud services › Branding**, create a theme from a preset: colors, font, corners, light and dark modes, then your logos. Naoshift checks the contrast (WCAG AA) and suggests fixes. The preview shows the draft in the real portal pages. Publish, then apply the theme to the brand.

## A tenant's first user

1. On the tenant's page, open **Users**, then **Invite a user**.
2. Fill in the address, the role, the brand they will sign in through and the language of the e-mail. If needed, limit them to some VDCs.
3. Click **Send the invitation**. The link is valid for 72 hours.

A tenant's first account is usually a **Tenant administrator**: they then invite their colleagues from the portal. The other roles are **Tenant operator**, **Tenant viewer** and **Tenant billing**.

> To help a tenant, **Open the portal as** opens the portal as they see it, read-only unless you tick **Allow changes**. You must confirm your identity, and their administrators are notified.

### The brand stays inactive

Its primary domain is not verified yet. Check the published TXT, wait for the next check, then activate it.

### Cannot invite, or the invitation did not leave

A tenant can only be invited once an active brand serves it: serve it first. Without a verified primary domain on the brand, the invitation is saved but not sent, and the screen says so. Verify the domain, then **Resend**.

### A tenant sees more, or less, of their billing than expected

**Billing in the portal**, on the brand's page, sets what they see: amounts, quantities only or nothing. The most restrictive setting wins between yours, the brand's and the tenant's.
