# Intégration SCIM de Microsoft Entra ID

Le système de gestion d'identité inter-domaines (SCIM) peut être utilisé pour provisionner et déprovisionner automatiquement les membres et les groupes dans votre organisation Bitwarden. 

> [!NOTE] SCIM vs. BWDC
> Les intégrations SCIM sont disponibles pour les **organisations d'Entreprise**. Les organisations d'Équipes, ou les clients n'utilisant pas un fournisseur d'identité compatible SCIM, peuvent envisager d'utiliser [Directory Connector](https://bitwarden.com/fr-fr/help/directory-sync-cli/) comme moyen alternatif de provisionnement.

Cet article vous aidera à configurer une intégration SCIM avec Azure. La configuration implique de travailler simultanément avec le coffre web Bitwarden et Azure Portal. Au fur et à mesure que vous avancez, nous vous recommandons d'avoir les deux facilement disponibles et de compléter les étapes dans l'ordre où elles sont documentées.

## Activer SCIM

> [!NOTE] Self-hosting SCIM
> **Hébergez-vous vous-même Bitwarden?** Si c'est le cas, terminez [ces étapes pour activer SCIM pour votre serveur](https://bitwarden.com/fr-fr/help/self-hosting-scim/) avant de continuer.

Pour commencer votre intégration SCIM, ouvrez la Console Admin et naviguez vers **Paramètres**→ **Provisionnement SCIM**: 

![Provisionnement SCIM](https://bitwarden.com/assets/6sw1kuK7GuZ3dfQkkbs6rV/e665df6992fb880114fcef82e4e4c07c/SCIM_provisioning_URL_and_API_key.png)

Sélectionnez la case à cocher **Activer SCIM** et prenez note de votre **URL SCIM** et de votre **Clé API SCIM**. Vous devrez utiliser les deux valeurs dans une étape ultérieure.

## Créez une application d'entreprise

> [!TIP] SCIM if SSO already exists (Azure).
> Si vous utilisez déjà ce IdP pour l'identifiant avec SSO, ouvrez cette application d'entreprise existante et [passez à cette étape](https://bitwarden.com/fr-fr/help/microsoft-entra-id-scim-integration/#enable-provisioning/). Sinon, continuez avec cette section pour créer une nouvelle application

Dans le Portail Azure, naviguez jusqu'à **Microsoft Entra ID**et sélectionnez **Applications d'entreprise**à partir du menu de navigation :

![Enterprise applications ](https://bitwarden.com/assets/69h0vJlyvkF5J6tsKfQ7jd/4994ed3200bdce4b5faea87e1ac2de83/Enterprise_application.png)

Sélectionnez le bouton + **Nouvelle application** :

![Create new application ](https://bitwarden.com/assets/7f6vbFmJRpfwDXbjHNKp1i/c314ef0bcbb68306858fa0f76da1e369/new_application.png)

Sur l'écran de la galerie **Microsoft Entra ID**, sélectionnez le bouton + **Créez votre propre application** :

![Create your own application ](https://bitwarden.com/assets/6oF8nrPsl7riqg3jWFDk7N/5cf08062f5656e0aee44ea627a2071c5/Create_your_own_application.png)

Sur l'écran Créez votre propre application, donnez à l'application un nom unique spécifique à Bitwarden. Choisissez l'option **Non-galerie** puis sélectionnez le bouton **Créer**.

![Create Entra ID app](https://bitwarden.com/assets/2fCSl3wr0PPuTYBk9zisXd/0e8754a3163b6560d832306b4b88bb1b/create_entra_app.png)

### Activer la provision

Sélectionnez **Provisioning**dans la navigation et suivez les étapes suivantes:

![Select Provisioning](https://bitwarden.com/assets/3FNghuESyQaW6EB4WfANSy/f0a1ef6cae75ccc9412e5f0e1396b5f1/Select_Provisioning.png)

1. Sélectionnez le bouton **Commencer**.
2. Sélectionnez **Automatique**dans le menu déroulant **Mode de Provisionnement**.
3. Entrez votre URL SCIM ([en savoir plus](https://bitwarden.com/fr-fr/help/microsoft-entra-id-scim-integration/#enable-scim/)) dans le champ **URL du locataire**.
4. Entrez votre clé API SCIM ([en savoir plus](https://bitwarden.com/fr-fr/help/microsoft-entra-id-scim-integration/#enable-scim/)) dans le champ **Jeton Secret**.
5. Sélectionnez le bouton **Tester la Connexion**.
6. Si votre test de connexion réussit, sélectionnez le bouton **Enregistrer**.

### Cartographies

Bitwarden utilise les noms d'attributs SCIM v2 standard, bien que ceux-ci puissent différer des noms d'attributs Microsoft Entra ID. Les mappages par défaut fonctionneront, mais vous pouvez utiliser cette section pour apporter des modifications si vous le souhaitez. Bitwarden utilisera les propriétés suivantes pour les utilisateurs et les groupes :

#### Cartographie utilisateur

| **Attribut Bitwarden** | **Attribut AAD par défaut** |
|------|------|
| `actif` | `Switch([IsSoftDeleted], , "Faux", "Vrai", "Vrai", "Faux")` |
| `courriels`ª ou `nom d'utilisateur` | `courrier `ou `nomPrincipalUtilisateur` |
| `nom d'affichage` | `nom d'affichage` |
| `identifiant externe` | `surnom de courrier` |

ª - Parce que SCIM permet aux utilisateurs d'avoir plusieurs adresses de courriel exprimées sous forme de tableau d'objets, Bitwarden utilisera la `valeur` de l'objet qui contient `"primary": true`.

#### Cartographie de groupe

| **Attribut Bitwarden** | **Attribut AAD par défaut** |
|------|------|
| `nom d'affichage` | `nom d'affichage` |
| `membres` | `membres` |
| `identifiant externe` | `identifiant d'objet` |

### Paramètres

Sous le menu déroulant des **Paramètres**, choisissez :

- Que ce soit pour envoyer une notification par courriel en cas d'échec, et si oui, à quelle adresse l'envoyer (recommandé).
- Que ce soit pour **synchroniser uniquement les utilisateurs et les groupes assignés** ou pour **synchroniser tous les utilisateurs et les groupes**. Si vous choisissez de synchroniser tous les utilisateurs et groupes, passez [à l'étape suivante](https://bitwarden.com/fr-fr/help/microsoft-entra-id-scim-integration/#assign-users-and-groups/).

## Attribuer des utilisateurs et des groupes

Terminez cette étape si vous avez choisi de **synchroniser uniquement les utilisateurs et les groupes assignés**à partir des paramètres de provisionnement. Sélectionnez **Utilisateurs et groupes**dans la navigation:

![Enterprise application users and groups](https://bitwarden.com/assets/5xXgCDxrB4wVlZmfsKmi2L/cad020d84786fa009a6636b01ce5d918/remove-name-2.png)

Sélectionnez le bouton + **Ajouter utilisateur/groupe**pour attribuer l'accès à l'application SCIM à un utilisateur ou à un niveau de groupe. Les sections suivantes décrivent comment la modification des utilisateurs et des groupes dans Azure aura un impact sur leurs homologues dans Bitwarden :

#### Utilisateurs

- Lorsqu'un nouvel utilisateur est assigné dans Azure, l'utilisateur est invité à rejoindre votre organisation Bitwarden.
- Lorsqu'un utilisateur qui est déjà un membre de votre organisation est assigné dans Azure, l'utilisateur Bitwarden est lié à l'utilisateur Azure via leur valeur de `nom d'utilisateur`.

 - Les utilisateurs liés de cette manière sont toujours soumis aux autres flux de travail dans cette liste, cependant des valeurs comme `displayName` et `externalId/mailNickname` ne sont pas automatiquement modifiées dans Bitwarden.
- Lorsqu'un utilisateur assigné est suspendu dans Azure, l'utilisateur se voit [révoquer](https://bitwarden.com/fr-fr/help/about-scim/#member-status/) son accès à l'organisation.
- Lorsqu'un utilisateur assigné est supprimé dans Azure, l'utilisateur est retiré de l'organisation.
- Lorsqu'un utilisateur assigné est retiré d'un groupe dans Azure, l'utilisateur est retiré de ce groupe dans Bitwarden mais reste un membre de l'organisation.

#### Groupes

- Lorsqu'un nouveau groupe est attribué dans Azure, le groupe est créé dans Bitwarden. 

 - Les membres du groupe qui sont déjà membres de votre organisation Bitwarden sont ajoutés au groupe.
 - Les membres du groupe qui ne sont pas déjà membres de votre organisation Bitwarden sont invités à rejoindre.
- Lorsqu'un groupe qui existe déjà dans votre organisation Bitwarden est assigné dans Azure, le groupe Bitwarden est lié à Azure par le biais des valeurs `displayName` et `externalId`/`objectId`.

 - Les groupes liés de cette manière auront leurs membres synchronisés à partir d'Azure.
- Lorsqu'un groupe est renommé dans Azure, il sera mis à jour dans Bitwarden tant que la synchronisation initiale a été effectuée.

 - Lorsqu'un groupe est renommé dans Bitwarden, il sera remis à ce qu'il est nommé dans Azure. Changez toujours les noms de groupe du côté Azure.

## Commencez la provision

Une fois l'application entièrement configurée, commencez la provision en sélectionnant le bouton [play] **Commencer la provision** sur la page de **Provision** de l'application d'entreprise :

![Start provisioning](https://bitwarden.com/assets/1oJcKq2shIBPxySuKjaZLV/61bbe111c6e1a140698103ae00874d14/Start_provisioning_.png)

## Terminez l'intégration de l'utilisateur

Maintenant que vos utilisateurs ont été provisionnés, ils recevront des invitations pour rejoindre l'organisation. Demandez à vos utilisateurs d'[accepter l'invitation](https://bitwarden.com/fr-fr/help/managing-users/#accept/) et, une fois qu'ils l'ont fait, [confirmez-les à l'organisation](https://bitwarden.com/fr-fr/help/managing-users/#confirm/).

> [!NOTE] Invite/Accept/Confirm
> Le flux de travail Inviter → Accepter → Confirmer facilite la poignée de main de la clé de déchiffrement qui permet aux utilisateurs d'accéder en toute sécurité aux données du coffre de l'organisation.