# HTTP auth

Source: https://www.storeframe.io/docs/hub/environments/settings/http-auth

Password-protect all or some of this environment's storefront domains with a username and password.

The HTTP Auth panel puts a browser login prompt in front of your storefront. Use it to keep a staging shop, or a store view that has not launched yet, away from visitors and search engines. Only people who know the username and password can open the protected domains.

## What the panel shows

* **Status** — *Off*, *On · All domains*, or *On* followed by the protected domains.
* **Username** with a copy button.
* **Password**, hidden by default. Click the eye icon to show it, or the copy icon to copy it to your clipboard.

The username and password stay visible here, so anyone in your organization can share them with testers or the people who need access.

## Turning it on or changing it

Click **Manage** to open the HTTP Auth window.

1. Enter a **username**, then type a **password** or click **Generate** for a strong random one.
2. Choose what to protect:
   * **All domains** protects every domain of this environment.
   * Or tick one or more domains from the list. The list shows the domains set up for this environment in [Custom domains](/docs/hub/environments/settings/custom-domains), plus the environment's own address. A ticked domain is protected with and without `www.`.
3. Click **Apply**.

The change takes about a minute. The panel updates once it is active. There is one username and password per environment: changing them replaces the previous login on every protected domain.

## Turning it off

Click **Manage**, then **Remove**, and confirm. The protected domains open to everyone again.

## Good to know

* **API clients and webhooks** (payment providers, ERP or marketplace integrations, mobile apps) cannot pass the login prompt. On protected domains they receive a `401` response. Protect only domains that do not need these, or remove the protection before you go live.
* **SSL certificates** keep renewing on protected domains.
* **Site tools** such as Mailpit and phpMyAdmin keep their own login and are not affected.
* HTTP auth is available on subscribed environments. On a trial the panel asks you to subscribe first.
