# Import from Entra ID

This option allows you to import users directly from Azure's Entra ID (formerly Azure AD) into Power Embedded.

The system will display a list of existing users in your company's Entra ID.

You will select the users you want to import, and their emails will be automatically added to Power Embedded, where all users will be created with the **viewer** profile by default.

There is also an option at the bottom of this page to include ID groups. When this option is selected, all groups the user belongs to in the company's organization will be imported and associated with the user.

{% hint style="warning" %}
Note: If the user belongs to many groups, this action may create organizational difficulties in your Power Embedded environment, as many groups will be registered.
{% endhint %}

<figure><img src="/files/Tkn0I58XiFgFsjTS6Us8" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
If you want to automatically synchronize groups and their users instead of a one-time import, read the article [Sync Groups with Entra ID](https://github.com/dirceuresende/docs-power-embedded-english/blob/main/administration-portal/groups/sync-with-entra-id.md).

If you don't want to sync groups but only perform a one-time import of groups and their users, read the article [Import Groups from Entra ID](/administration-portal/groups/import-from-entra-id.md).
{% endhint %}

### Requirements for Entra ID Integration

To integrate Power Embedded with Azure AD (Entra ID) and import users and groups, go to the [App registrations](https://portal.azure.com/#view/Microsoft_AAD_IAM/ActiveDirectoryMenuBlade/~/RegisteredApps) screen.

Search for the Power Embedded application (PowerEmbedded-App), click "API permissions" and then "Add a Permission".

![](https://powerembedded.com.br/wp-content/uploads/2024/07/Permissoes-de-APIS.png)

On the next screen, select the "Microsoft Graph" option.

![](https://powerembedded.com.br/wp-content/uploads/2024/07/Permissoes-aplicativo.png)

Then select the "Application permissions" option.

![](https://powerembedded.com.br/wp-content/uploads/2024/07/Microsoft-Graph.png)

On the following tab, search for "Directory" and select the first option "Directory.Read.All", then click "Add permissions".

![](https://powerembedded.com.br/wp-content/uploads/2024/07/Directory-1.png)

If you want to use a less privileged permission, you can grant only the "User.Read.All" and "Group.Read.All" permissions.

To finish, grant admin consent by clicking "Grant admin consent for".

<figure><img src="https://powerembedded.com.br/wp-content/uploads/2024/07/Conssentimento-admin.png" alt=""><figcaption></figcaption></figure>

Done! Once you complete the next steps, you will be able to import users and groups from Azure AD (Entra ID) into Power Embedded.


---

# 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.powerembedded.com/administration-portal/users/import-from-entra-id.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.
