# 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="https://923042080-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSQtMBBRVHWmFGBUzkAM3%2Fuploads%2FeBkKPNQQOIlH4uYGTmMg%2FScreenshot%202024-08-05%20150740.png?alt=media&#x26;token=3ab99180-aaad-464e-992b-46b0cdd5c2bf" 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="https://923042080-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSQtMBBRVHWmFGBUzkAM3%2Fuploads%2FkQTtLmohGJnYoaDtevn1%2FScreenshot%202024-08-05%20152832.png?alt=media&#x26;token=b283f53c-5e14-4f35-aa42-e038f8cbde51" 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="https://923042080-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSQtMBBRVHWmFGBUzkAM3%2Fuploads%2Frza6e2lyBjGVqn7eTFuU%2FScreenshot%202024-08-05%20153012.png?alt=media&#x26;token=6f985539-d419-4c45-8eee-75fe0540e1f9" 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](https://docs.becard.me/microsoft-entra-integration/data-synchronization/scim-provisioning), [SSO via SAML2](https://docs.becard.me/microsoft-entra-integration/authentification/single-sign-on-sso-via-saml2), or [Sign-In via Microsoft 365](https://docs.becard.me/microsoft-entra-integration/authentification/sign-in-via-microsoft-365) to set up the respective module.
{% endhint %}