# Identity providers

To securely access Axiad Mesh, add the identity providers (IdPs) that contain
your users' login and group role information.

Your first IdP is typically added during
[initial onboarding](../../getting-started/idp-setup.md), so the steps below
are needed only if you have multiple IdPs, or multiple domains whose user
logins you need to account for.

## Add an identity provider

1. From the homepage, select the **gear icon** to open the **Settings** page.

   ![Mesh homepage with the gear icon highlighted in the top navigation](/img/imported/identity-providers/settings-gear.png)

2. Select **Identity providers** in the left-side menu.
3. Review your existing IdPs and their status on the **Identity providers**
   page.
4. Select **+ Add identity provider**.

   ![Identity providers page listing existing IdPs, with the Add identity provider button](/img/imported/identity-providers/idp-list.png)

5. In the dialog, select the appropriate **Provider** to show the fields
   needed for the connection.

   ![Add identity provider dialog with the Provider selection list open](/img/imported/identity-providers/add-idp-provider.png)

   :::tip Custom provider

   If the IdP you want to add isn't listed, contact
   [Axiad Customer Success](mailto:customer.success@axiad.com) to request it
   as an enhancement.

   :::

6. Fill out the required fields, then select **Test Connection**.
7. After the connection test succeeds, select **Add & connect**.
8. The new IdP appears on your **Identity providers** page.

   ![Identity providers page showing the newly added IdP in the list](/img/imported/identity-providers/idp-added.png)

## Edit an identity provider

You can update an existing IdP connection from the **Identity providers**
page.

1. On the row of the IdP that you want to edit, select the three-dot menu,
   then select **Edit**.

   ![Identity providers page with the row menu open and Edit highlighted](/img/imported/identity-providers/edit-idp-menu.png)

2. In the **Edit identity provider** dialog, make any changes you want, then
   select **Test Connection**.

   ![Edit identity provider dialog showing the connection fields](/img/imported/identity-providers/edit-idp-dialog.png)

3. After the connection test succeeds, select **Save**. Your IdP settings are
   now updated.

## Disconnect an identity provider

You can remove an IdP connection from the **Identity providers** page.

1. On the row of the IdP that you want to remove, select the three-dot menu,
   then select **Disconnect**.

   ![Identity providers page with the row menu open and Disconnect highlighted](/img/imported/identity-providers/disconnect-idp-menu.png)

2. Confirm the removal by selecting **Disconnect** in the confirmation
   dialog.

   :::note

   To cancel the removal, select **Never mind** in the confirmation dialog.

   :::

   ![Disconnect confirmation dialog with Disconnect and Never mind buttons](/img/imported/identity-providers/disconnect-idp-confirm.png)

3. The IdP connection no longer appears on the **Identity providers** page.

## Provider-specific configuration

The pages in this section describe configuration steps for specific IdP
integrations that build on the generic processes above — for example,
[SailPoint](../../connectors/governance/sailpoint-integration.md),
[Okta](../../connectors/idp/okta.mdx), and
[Microsoft Entra ID](../../connectors/idp/microsoft-entra-id.mdx).