# Configuration Oauth SMTP Entra

## Création d'une application Entra

***

### Enregistrer une application Entra

* Connectez-vous à votre [portail Entra](https://entra.microsoft.com/)
* Dans la section **`Entra ID`**, rendez vous dans **`Inscription d'application`** > **`nouvelle application`**

{% hint style="danger" %}
Attention, ne passez pas à l'application d'entreprise, votre configuration tomberait en échec par la suite.

<img src="https://1227510999-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqmRzI15ndDbFHGd5BnM4%2Fuploads%2FW6uXEgHr6ZoY8aJkA7Zq%2Fapp-registration-entra.png?alt=media&#x26;token=69c9c843-9bef-438f-84dd-7e73b108546e" alt="" data-size="original">
{% endhint %}

* Entrez un nom d'application, puis dans URI de redirection, entrez **`web`**.
* Récupérez l'URL de redirection GLPI disponible dans **`configuration`** > **`notifications`** > **`configuration des notifications par email`**. Dans **`moyen d'envoi des emails`**, sélectionnez **`SMTP+OAUTH`**.

![Visualisation de l'URL de retour](https://1227510999-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqmRzI15ndDbFHGd5BnM4%2Fuploads%2Fgit-blob-a507e5fe012bfbd2f394d64cdb61567ff5032455%2Foauth-smtp-1.png?alt=media)

* Vous verrez l'URL de redirection dans le nouveau menu qui apparaît. Copiez cette URL

![Copie de l'URI](https://1227510999-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqmRzI15ndDbFHGd5BnM4%2Fuploads%2Fgit-blob-e68e2d80f11f8066905fb34e8233790d185e9bf3%2Foauth-smtp-2.png?alt=media)

* Ensuite, dans la redirection URI, sélectionnez **`web`** sur le portail EntraID
* Collez l'**`URL de rappel`** récupérée précédemment
* Cliquez sur **`Enregistrer`**.

***

### Création du secret

* Maintenant allez dans **`certificats et secrets`**.
* Cliquez sur **`nouveau secret client`**.
* Entrez un **`nom`** et une **`date d'expiration`**.
* Puis cliquez sur **`ajouter`**

<div align="left"><img src="https://1227510999-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqmRzI15ndDbFHGd5BnM4%2Fuploads%2Fgit-blob-5a83830d21fafcc621b70e1bd78d637bbde3e062%2Foauth-smtp-3.png?alt=media" alt="Durée du secret"></div>

* Une fois validé, la **`valeur`** du secret apparaît.

{% hint style="info" %}
**Point d'attention**

La **valeur** du secret doit être reflétée dans le secret client côté GLPI. Cette valeur n'est visible qu'une seule fois, n'oubliez pas de la sauvegarder dans un endroit sûr.
{% endhint %}

***

### Ajout des revendications

L'ajout des revendications est nécessaire pour que GLPI puisse utiliser le service SMTP via l'application Entra.

* Rendez-vous dans **`Authorisations d'API`**
* Dans l'onglet **`Revendications`**, cliquez sur votre application (dans ce cas Microsoft graph).

![Vérification des revendications via permissions API](https://1227510999-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqmRzI15ndDbFHGd5BnM4%2Fuploads%2Fgit-blob-bc5a9ad399b07c8185460da9fa6fe25de70d76b5%2Foauth-smtp-8.png?alt=media)

* Sur la partie droite de l'écran, recherchez **`SMTP`**.
* Sélectionnez-le puis cliquez sur **`mettre à jour les permissions`**.

![Ajout des revendications](https://1227510999-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqmRzI15ndDbFHGd5BnM4%2Fuploads%2Fgit-blob-c8c43fc48e06556b7fc6ffbb2b26dbba2032ee94%2Foauth-smtp-9.png?alt=media)

***

### Derniers paramètres GLPI

* Retournez dans le menu **`vue d'ensemble`** de l'application pour trouver les informations que vous devez entrer dans GLPI.
* Nous avons rempli la valeur du secret à l'étape précédente, il ne reste plus qu'à remplir l'**`ID d'application`** et l'ID d'annuaire.

![Information de l'application Entra](https://1227510999-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqmRzI15ndDbFHGd5BnM4%2Fuploads%2Fgit-blob-66f1e4286fbbb1cf55fbbafdb145e2dd2b55e529%2Foauth-smtp-4.png?alt=media)

![Configuration de GLPI](https://1227510999-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqmRzI15ndDbFHGd5BnM4%2Fuploads%2Fgit-blob-2af873e0bf66198b49b035d703cbdb8b19d41f31%2Foauth-smtp-5.png?alt=media)

* Quand vous cliquez sur **`enregistrer`**, vous serez redirigé vers le compte Microsoft pour être connecté.

{% hint style="warning" %}
**Point d'attention**

Le compte synchronisé avec Oauth SMTP doit également être celui qui envoie les emails. Ce compte est identifié dans l'email de l'expéditeur

<img src="https://1227510999-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqmRzI15ndDbFHGd5BnM4%2Fuploads%2Fgud7sa6EjDqlHVpXdWce%2Fsender_notifications.png?alt=media&#x26;token=7ce78268-080e-46e8-9a9e-0333dadcd923" alt="" data-size="original">
{% endhint %}

## Configuration SMTP authentifié

Pour que le compte utilisant les services SMTP soit autorisé à envoyer du courrier, il est impératif d'activer **`SMTP authentifié`** depuis le Tenant Entra.

* Connectez-vous à votre [tenant](https://admin.cloud.microsoft/)
* Allez dans **`utilisateurs`** puis **`utilisateurs actifs`** et cliquez sur le compte concerné
* Puis allez dans **`courrier > gérer les applications de messagerie`** et sélectionnez **`SMTP Authentifié`**

<div align="left"><img src="https://1227510999-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqmRzI15ndDbFHGd5BnM4%2Fuploads%2Fgit-blob-5492a81dccd8ec051919e8329d420d5973522805%2Foauth-smtp-10.png?alt=media" alt="SMTP Authentifié activé"></div>

## Envoi de test

* Une fois que vous avez entré les détails de votre compte Microsoft, vous devrez accepter les autorisations nécessaires. Il ne reste plus qu'à effectuer un envoi de test.

<div align="left"><img src="https://1227510999-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqmRzI15ndDbFHGd5BnM4%2Fuploads%2Fgit-blob-d8561c47071f2ce777149684aa069a88dbbed43d%2Foauth-smtp-7.png?alt=media" alt="Mail test envoyé avec succès"></div>

## Références

Documentation GLPI ["Configuration des suivis par email"](https://glpi-user-documentation.readthedocs.io/fr/latest/modules/configuration/notifications/email_notifications.html)
