# Getting started

{% hint style="warning" %}
The connection to Microsoft Entra requires the Becard Enterprise license and can only be managed through the Business Manager.
{% endhint %}

Becard offers comprehensive support for Microsoft Entra (formerly Microsoft Active Directory). Each function can be set up and used independently. For example, a company can choose to only synchronize data from Microsoft without using Single Sign-On. It is also possible to combine all functions.

{% hint style="danger" %}
A **Microsoft** Entra **administrator** is required for the following steps
{% endhint %}

The connection can only be established by a user with administrative rights in both Becard and Microsoft Entra. First, an Enterprise application must be created.

**REQUIRED for all Modules: Microsoft Enterprise Application** 

Visit <https://entra.microsoft.com/> and navigate to "<mark style="color:blue;">`Applications`</mark>" -> "<mark style="color:blue;">`Enterprise applications`</mark>". Then, go to "<mark style="color:blue;">`All applications`</mark>" and create a new application by clicking the "<mark style="color:blue;">`New application`</mark>" button.

In the following window, click on the "<mark style="color:blue;">`Create your own application`</mark>" button and create an "<mark style="color:orange;">`Integrate any other application you don't find in the gallery (Non-gallery)`</mark>" application. The name can be freely chosen.

<figure><img src="/files/E5ZpOQW91P2dBS4OU60x" alt=""><figcaption><p>Becard x Microsoft Entera Intergration Enterprise Application</p></figcaption></figure>

**REQUIRED for all Modules: Becard User Directory**

{% hint style="danger" %}
A **Becard** Business Manager **administrator** is required for the following steps
{% endhint %}

To perform the following steps, a Becard account with administrative rights in the Business Manager is necessary, as well as an existing space with an Enterprise license. To set up the Microsoft integration, we first need to open the respective directory under "User Directory" to link the corresponding space (License Reference). If no "User Directory" exists, we can create one by selecting "Create User Directory".

<figure><img src="/files/QVhRzyLhthxSATYP2mdz" alt=""><figcaption><p>Becard - Create User Direcotry</p></figcaption></figure>

Before proceeding with the setup of the Microsoft integration, we ensure that the add-on is activated and enabled in Becard.

<figure><img src="/files/C9HuSqwObAqKC8viyOT4" alt=""><figcaption><p>Becard - Activate Microsoft Entra Add-On</p></figcaption></figure>

{% hint style="info" %}
We have successfully completed the preparation following these steps and can now proceed to the instructions for [SCIM provisioning](/microsoft-entra-integration/data-synchronization/scim-provisioning.md), [SSO via SAML2](/microsoft-entra-integration/authentification/single-sign-on-sso-via-saml2.md), or [Sign-In via Microsoft 365](/microsoft-entra-integration/authentification/sign-in-via-microsoft-365.md) to set up the respective module.
{% 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.becard.me/microsoft-entra-integration/first-steps/getting-started.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.