# Configuring Parallels Browser Isolation

To configure Parallels Browser Isolation for the first time:

1. Read Cloud Solution Agreement, and if you agree to it, click **Accept**.
2. On the **Select location** card, click **Set Location**. The **Resource Location** category will open.&#x20;
3. In the **Region** drop-down menu, select the region where Parallels will host your data plane. It is highly recommended that you select the region closest to your users for best performance and minimum latency.

{% hint style="warning" %}
**Note:** You cannot change the region after you complete this step.
{% endhint %}

<figure><img src="https://1421284924-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5mooNgJeAuk6nMFZeon2%2Fuploads%2FFqaC7oB3WBRrbJvVMdG0%2Fset%20resource%20location.png?alt=media&#x26;token=4d75a1d8-502f-4c3a-8a90-f3a65008b860" alt="The Resource Location category"><figcaption></figcaption></figure>

4. Click **Save**. The **Configuration** category will open.
5. On the **Configure Domain & IdP** card, click **IdP Configuration**. The **Configuration** category will open.&#x20;
6. In the **Domain Configuration** section, enter your organization's domain in the **Domain** field.
7. In the **IdP Configuration** section, do the following:
   * In the **OpenID configuration URL** field, specify the URL of the discovery document of your OpenID Connect provider.
   * In the **Client ID** field, specify your client ID for connecting to the identity provider. For Auth0, the format of the Client ID is `https://<Domain_Name>/.well-known/openid-configuration`.
   * In the **Client secret** field, specify the secret for connecting to the identity provider.
   * In the **Username claim name** field, specify the ID token that holds the username claim name:
     * For Entra ID, specify **preferred\_username**
     * For Auth0, specify **name**
   * In the **Group claim name** field, specify the ID token that holds the group claim name.
   * Click the **Test Configuration** button to make sure that the specified settings are correct.
8. Click **Save**. The **Overview** category will open.
9. In the **Users** field, specify the email (UPN) of the user you want to add as an administrator and click **Add**. The email must be exactly the same as that used in your IdP. Do this multiple times if you want to add several users.

<figure><img src="https://1421284924-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5mooNgJeAuk6nMFZeon2%2Fuploads%2F5XUFsyobdFlWKat3vH6V%2Fusers%20pbi.png?alt=media&#x26;token=ef253ad6-6f66-48eb-aaad-75b1b896ebc9" alt="Users field"><figcaption></figcaption></figure>

9. In the **Groups** field, specify the group you want to add as an administrator group and click **Add**. The group name must be exactly the same as that used in your IdP. Do this multiple times if you want to add several groups.

<figure><img src="https://1421284924-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5mooNgJeAuk6nMFZeon2%2Fuploads%2F4m1o5n93b4b524BmdOFT%2Fgroups%20field.png?alt=media&#x26;token=c07995ba-2bbe-42c8-8f1e-de82734c3ac3" alt="groups field"><figcaption></figcaption></figure>

10. Click **Save**. The **Overview** category will open.
11. On the **Access Admin Portal** card, click **Admin Sign In**. You will be redirected to Parallels Browser Isolation Management Portal.

Next, you need to [add users and groups that will access you applications](https://docs.parallels.com/landing/pbi-guides/parallels-browser-isolation-administrators-guide/getting-started/adding-users).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.parallels.com/landing/pbi-guides/parallels-browser-isolation-administrators-guide/getting-started/configuring-parallels-browser-isolation.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
