---
title: "Onboarding a Britive Connector"
slug: "onboarding-a-britive-connector"
updated: 2026-04-16T05:02:36Z
published: 2026-04-29T10:51:57Z
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.britive.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Onboarding a Britive Connector

An administrator can create and configure the Britive connector using the following steps:

1. [Creating a Britive Connector](/v1/docs/onboarding-a-britive-connector#creating-a-britive-connector)
2. [Creating a Britive Profile](/v1/docs/onboarding-a-britive-connector#creating-a-britive-profile)

## Creating a Britive Connector

1. Log in to Britive with administrator privileges.
2. Click on **System admin** -> **Tenant Applications**.
3. Click **Create Application**from the **Tenant Applications** page.
4. Click the **Add (+)** sign inline to the Britive application on the **Add Application** page.
5. Enter the following values in the **Application**tab:
  1. Enter the **Britive Tenant Name**.
  2. Enter the **Description**, if required.
  3. Select the Email attribute for **Account Mapping**.
6. Click **Next**. The **Settings** tab is displayed.
7. Click **Save**.
8. Click the **Create Entity**button.
9. Enter the following details in the **Create Environment/Environment Group**page:
  1. Select **Environment** in the **Entity Type**.
  2. Enter **Entity Name**.
  3. Enter **Entity Description**.
  4. Click **Save**.
10. Click on the **Settings**tab and enter the following details:
  1. Click **Edit** to edit the **Connection Properties**.
  2. Edit the **Tenant base URL**.
  3. Enter the API token for a service identity. Create a service identity in Britive and add the service identity to the *TenantAdminPolicy* policy.
  4. **Profile Settings**: Configure the maximum session duration for profiles. You can select the duration between 15 minutes to 7 calendar days. This allows to setup expiration duration for each profile while creating/updating the profile up to this configured value. If existing profiles are created with more than 12 hours and the above setting is changed, then it cannot be lowered until all profiles are updated with a lower expiration duration.
  5. Click **Save**.
11. Click **Save and Test**.
12. A pop-up displays a success message if the environment is correctly configured. If any error message is displayed, review the error, correct the configuration, and test again.
13. Select the **Scans** tab after the configuration is complete.
14. Click on **Scan Environments**.
15. Select the environment and click on **Scan Selected(1)**.
16. Refresh the scan progress. Once the scan is completed, click on the **Data** tab to view the data. Note: Tags are presented as groups under the **Groups** tab. Also, we currently don’t support scanning policies, so this tab will be empty.

## Creating a Britive profile

After creating a Britive connector, you can create user profiles in Britive that can be used to gain access to Britive's administrative functions.

1. Create a Britive Tag that may be named 'Tenant Admin'. For more information, see [Creating Tags](/v1/docs/overview-useronboarding#creating-tags).
2. Add all members who need access to Britive administration to this tag.
3. Under **Role & Policy Management -> Policies**, go to the pre-existing **TenantAdminPolicy**, and add the newly created tag as a member to the policy.
4. Go to the Britive app created previously and create a profile for it.
5. On the Permissions tab of the profile, add the tag created in step 1.

Your Britive profile is now ready for use.