# Configure connector

With the Entra app registration in place, you can now configure the Microsoft 365 provider connector in Peig. This connects your workspace to Microsoft 365 and prepares it for identity synchronisation and authentication.

{% hint style="warning" %}
Do not assign this provider to any users until Step 5 (Federation) is complete. Assigning it prematurely requires removing and re-adding the provider, which causes all user group associations to be lost.
{% endhint %}

{% stepper %}
{% step %}

### Open Configuration

In your Peig workspace, open the **Configuration** app and click **Add New Provider**. Select the **Microsoft 365** template.
{% endstep %}

{% step %}

### General settings

Fill in the following fields:

**Display Name**\
The name used to identify this provider in the Peig admin interface. Choose something clear, such as `Microsoft 365`.

{% hint style="warning" %}
The Display Name cannot be changed once set.
{% endhint %}

**Pseudonym Link**\
Must be set to **User: UDI**. This is required for the Microsoft 365 integration to function correctly.

{% hint style="warning" %}
The Pseudonym Link cannot be changed once set.
{% endhint %}

**Domain**\
Enter your corporate domain — the same domain verified in Step 1. This is not your `.onmicrosoft.com` domain.

To find your domain:

1. Log in to [https://admin.microsoft.com](https://admin.microsoft.com/)
2. Navigate to **Settings → Domains**
3. Identify your verified corporate domain

**Tenant Name**\
The segment of your initial domain that appears before `.onmicrosoft.com`. For example, if your initial domain is `contoso.onmicrosoft.com`, your Tenant Name is `contoso`.

Once all fields are filled, click **Validate and Add**. Microsoft 365 will appear as an Active Provider.
{% endstep %}

{% step %}

### Authentication

1. In the Microsoft 365 Active Provider, click **Edit and Create** in the Authentication section
2. No additional parameters are required here
3. Click **Save**
   {% endstep %}

{% step %}

### Provisioning

1. In the Microsoft 365 Active Provider, click **Edit and Create** in the Provisioning section
2. Enter the following values from your `PeigUserManagerApp` registration in Entra:

**Client ID**\
Found in the **Overview** section of `PeigUserManagerApp`.\
Look for **Application (client) ID**.

**Tenant ID**\
Found in the **Overview** section of `PeigUserManagerApp`.\
Look for **Directory (tenant) ID**.

**Client Secret**\
Enter the client secret value you saved in Step 2.

3. Click **Validate and Add**
   {% endstep %}

{% step %}

### Confirm your setup

Before moving to Step 4, verify:

* [ ] Microsoft 365 appears as an Active Provider in Configuration
* [ ] General settings are saved — Display Name, Pseudonym Link, Domain, and Tenant Name
* [ ] Provisioning is configured with Client ID, Tenant ID, and Client Secret
* [ ] The provider has **not** been assigned to any users yet
  {% endstep %}
  {% endstepper %}

{% hint style="success" %}
Next: [Step 4 — User Migration](/welcome-to-peig-documentation/deployment-guides/microsoft-365/user-migration.md)
{% endhint %}


---

# 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.peig.io/welcome-to-peig-documentation/deployment-guides/microsoft-365/configure-connector.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.