---
title: Connect a Parent Instance
slug: connect-a-parent-instance
docTags: 
createdAt: 2024-11-12T23:57:43.267Z
---

Let's get started on the first of two main steps that we will cover. First we will need to connect your main Domo instance (the primary Domo instance) to your **Admin Portal**.

## Open Up Your Admin Portal To Add A Credential

- To do this navigate to the menu option of `Settings` and then toggle to `Global Settings`.
- Scroll down to the **Authentication Credentials** section and click `Edit` to open the menu and click the `+ Add Credential` button.

![](https://api.archbee.com/api/optimize/kXX8wW2Q83jcfcYN8-FeX/fXwPVyqiP0CcQnCNADawZ_group-704.png)

Once we create this connection to Domo we will be able to create **infinite** sub-instances of **Domo Platform Embed**. 

In the next steps I will walk you through what value should go in each of these inputs.

## Open Up Your Main Domo Instance To Get Credentials

- In a new browser tab open up your Domo instance.
- Then navigate to the top menu option of `Admin` and then select to `Instance Manager` under the **Domo Everywhere** section.
- Open the section labeled `Embed` and toggle to `ROUTING`.

![](https://api.archbee.com/api/optimize/kXX8wW2Q83jcfcYN8-FeX/0iAMHsPXZfLzuCP75mIEX_group-705.png)

:::hint{type="info"}
**IMPORTANT STEP**

Before we start obtaining the necessary credentials, let's take a quick second and grant our user portal url(s) access by adding them to the "**Domain name**" list.


- Example if your users log in to **analytics.clearsquare.co**, 
  - Then you should enter in `https://analytics.clearsquare.co` 
  - You can use the wildcard start symbol "**\***" if you are unsure of what subdomain(s) you will use.
    - i.e.  `https://*.clearsquare.co` 
- If there are multiple subdomains/domains add them all here. Unlisted domains cannot host a JWT embedded environment.

![](https://api.archbee.com/api/optimize/kXX8wW2Q83jcfcYN8-FeX/1cq22iFoYhUzFAfHFOQ9d_group-712-2.png)
:::



### Get the "JWT Secret" 

- You are already on the `ROUTING` tab so select the **Authentication Method** of `JWT Secret` 
- Click the `GENERATE SECRET` button and copy the token to your **Admin Portal**.

![](https://api.archbee.com/api/optimize/kXX8wW2Q83jcfcYN8-FeX/hXJ74Z1sbTLU7z195OIjU_group-706.png)

### Get the "Embed URL"

- The next step is copying over the value of the "**Embed URL for identity broker**" to your **Admin Portal**.

![](https://api.archbee.com/api/optimize/kXX8wW2Q83jcfcYN8-FeX/9s1DDu0ymHvayk7rqcnVs_group-707-1.png)

### Get the "Key Attribute"

- For this input we will navigate to the tab `MAPPING`.
- You should see a value in "**Key attribute**" input.
  - Is this value blank for you? (See directions found below this image).

![](https://api.archbee.com/api/optimize/kXX8wW2Q83jcfcYN8-FeX/KEfBlw6QbvOPFXjnXc6CW_group-708.png)

:::hint{type="warning"}
If your  "**Key attribute**" input is blank then click the `EDIT` button in the top left.

- Enter in the label/name that distinquishes your different instances.
- Do you not know what to call this value? 
  - If this is the case, I would recommend "**keyAttribute**". 
    - This is the **default** option in your **Admin Portal** and means that you don't need to change anything in the form, *but* if you do have a value make sure to copy it over!

![](https://api.archbee.com/api/optimize/kXX8wW2Q83jcfcYN8-FeX/wh-yUjAV2F6Cx-O6v5eL-_group-710.png)
:::

###

### Submit The Create New Form

All the entries should be filled. Now all that's left to do is submit the form and it will allow you to use your main Domo Instance to create JWT embedded instances.

![](https://api.archbee.com/api/optimize/kXX8wW2Q83jcfcYN8-FeX/JEICgRPsNR396FGg0Yosh_group-712-1.png)