Aller au contenu principal

Provisionnement SCIM avec Azure

Mise à jour

 

Cet article décrit les étapes à suivre afin de configurer le provisionnement automatique d'utilisateurs avec Azure AD.

Si votre organisation utilise Azure pour gérer l'accès de vos employés aux services tierces, vous pouvez profiter de sa fonctionnalité de provisionnement pour accorder l'accès à B12 à vos utilisateurs.

B12 Zendesk documentation - Frame 1 (1).jpg

Pour en savoir plus sur le fonctionnement de SCIM avec Azure, consultez la documentation officielle de Microsoft.

Avant de procéder, assurez vous d'avoir:

  • Une organization B12
  • Un tenant Azure AD
  • Un compte d'utilisateur dans Azure AD autorisé à configurer le provisionnement

Obtenir un jeton d'accès

Communiquez avec nous en spécifiant l'organisation B12 dans laquelle vous souhaitez synchroniser des utilisateurs. Nous vous ferons alors parvenir un jeton secret permettant d'accéder à l'API SCIM de B12.

 

Créer une application d'entreprise

  1. Connectez vous au portail d'Azure.
  2. Accédez à "Applications d'entreprise"
  3. Cliquez sur "Nouvelle application"
  4. "Créez votre propre application"
  5. Nommez l'application "B12 SCIM"
  6. Sélectionnez "Intégrer une autre application que vous ne trouvez pas dans la galerie (non galerie)"
  7. Cliquez sur "Créer"

Configurer les rôles B12

Afin d'assigner des rôles B12 à vos utilisateurs depuis Azure, il est nécessaire de déclarer les rôles possibles dans le manifeste de l'application.

  1. Connectez vous au portail d'Azure.
  2. Accédez à "Inscriptions d'applications"
  3. Cliquez sur "Toutes les applications"
  4. Cliquez sur "B12 SCIM"
  5. Accédez à "Rôles d'application"
  6. Désactivez tous les rôles existants
  7. Accédez à "Manifeste"
  8. Modifiez la propriété "appRoles" pour la valeur suivante:
  "appRoles":[
    {
      "allowedMemberTypes":["User"],
      "description":"Administrateur",
      "displayName":"Administrateur",
      "id":"4ecb2cd9-35be-4a52-8c6c-66765724713d",
      "isEnabled":true,
      "value":"ADMIN"
    },
    {
      "allowedMemberTypes":["User"],
      "description":"Concepteur",
      "displayName":"Concepteur",
      "id":"2c9f9dfc-c89c-4938-99ad-2fd3af53f127",
      "isEnabled":true,
      "value":"DESIGNER"
    },
    {
      "allowedMemberTypes":["User"],
      "description":"Formateur",
      "displayName":"Formateur",
      "id":"1d00e10d-fa3e-45f7-9857-357272e6f354",
      "isEnabled":true,
      "value":"TRAINER"
    },
    {
      "allowedMemberTypes":["User"],
      "description":"Gestionnaire",
      "displayName":"Gestionnaire",
      "id":"a0e41188-e8c9-479f-a458-52eeb55d0d12",
      "isEnabled":true,
      "value":"MANAGER"
    },
    {
      "allowedMemberTypes":["User"],
      "description":"Apprenant",
      "displayName":"Apprenant",
      "id":"05a44502-b6fc-476a-b27d-4bb89bb90333",
      "isEnabled":true,
      "value":"LEARNER"
    }
  ],

Configurer le provisionnement

  1. Connectez vous au portail d'Azure.
  2. Accédez à "Applications d'entreprise"
  3. Cliquez sur "B12 SCIM"
  4. Accédez à "Approvisionnement"
  5. Cliquez sur "Démarrer"
  6. Sélectionnez le mode d'approvisionnement: Automatique
  7. Entrez l'URL de locataire suivante: https://b12.apprentx.rocks/api/scim/v2
  8. Entrez le jeton secret fournis par notre équipe
  9. Cliquez sur "Test de la connexion"
  10. Appuyez sur "Enregistrer"

 

Créer et mapper l'attribut de rôles

Afin de gérer les rôles de vos utilisateurs B12 depuis Azure, il vous faut configurer l'attributs "roles". Pour ce faire:

  1. Connectez vous au portail d'Azure.
  2. Accédez à "Applications d'entreprise"
  3. Cliquez sur "B12 SCIM"
  4. Accédez à "Approvisionnement"
  5. Cliquez sur "Modifier l'approvisionnement"
  6. Cliquez sur "Mappages"
  7. Cliquez sur "Provision Azure Active Directory Users"
  8. Cliquez sur "Afficher les options avancées"
  9. Cliquez sur "Modifier la liste d'attributs pour customappsso"
  10. Dans le bas de la liste, ajoutez un attribut:
    • Nom: roles
    • Type: String
    • Valeurs multiples: Oui
  11. Cliquez sur "Enregistrer"
  12. Ajoutez un nouveau mapping User
    • Mapping type: Expression
    • Expression: AppRoleAssignmentsComplex([appRoleAssignments])
    • Target attribute: roles
  13. Sauvegardez

 

Créer et mapper des attributs personnalisés

Si votre organisation B12 contient des champs personnalisés pour les utilisateurs (tel que le numéro d'employée, son titre, etc.), il vous est possible de les provisionner automatiquement en suivant ces étapes:

  1. Connectez vous à B12 en tant qu'administrateur
  2. Cliquez sur votre photo de profile en haut à droite
  3. Cliquez sur "Paramètres"
  4. Cliquez sur "Champs personnalisés"
  5. Sur le champ personnalisé, cliquez sur "Modifier"
  6. Copiez la valeur du champ "Attribut SCIM"
  7. Connectez vous au portail d'Azure.
  8. Accédez à "Applications d'entreprise"
  9. Cliquez sur "B12 SCIM"
  10. Accédez à "Approvisionnement"
  11. Cliquez sur "Modifier l'approvisionnement"
  12. Cliquez sur "Mappages"
  13. Cliquez sur "Provision Azure Active Directory Users"
  14. Cliquez sur "Afficher les options avancées"
  15. Cliquez sur "Modifier la liste d'attributs pour customappsso"
  16. Dans le bas de la liste, ajoutez un attribut:
    • Nom: La valeur copiée à l'étape 6 (similaire à: urn:ietf:params:scim:schemas:extension:customb12:2.0:User:[ATTRIBUTE_ID])
    • Type: String
  17. Cliquez sur "Enregistrer"
  18. Ajoutez un nouveau mapping User
    • Mapping type: Direct
    • Source attribute: L'attribut de votre choix
    • Target attribute: urn:ietf:params:scim:schemas:extension:customb12:2.0:User:[ATTRIBUTE_ID])
  19. Sauvegardez

À noter que B12 ne supporte que les attributs personnalisés de type String.

 

Assigner des utilisateurs et des groupes

Choisissez et assignez les utilisateurs et groupes que vous souhaitez provisionner dans votre organisation B12. Pour ce faire:

  1. Connectez vous au portail d'Azure.
  2. Accédez à "Applications d'entreprise"
  3. Cliquez sur "B12 SCIM"
  4. Accédez à "Utilisateurs et groupes"
  5. Cliquez sur "Ajouter un utilisateur/groupe"
  6. Sélectionnez un utilisateur
  7. Sélectionnez un rôle B12
  8. Appliquez en cliquant sur "Attribuer"

Démarrer le provisionnement

Une fois SCIM configuré, il ne reste qu'à démarrer le provisionnement:

  1. Connectez vous au portail d'Azure.
  2. Accédez à "Applications d'entreprise"
  3. Cliquez sur "B12 SCIM"
  4. Accédez à "Approvisionnement"
  5. Cliquez sur "Démarrer le provisionnement"

À noter que le provisionnement d'Azure s'effectue aux 40 minutes. Il est donc normal que les utilisateurs ne soient pas immédiatement synchronisés vers B12: https://learn.microsoft.com/en-us/azure/active-directory/app-provisioning/application-provisioning-when-will-provisioning-finish-specific-user#how-long-will-it-take-to-provision-users 

Articles associés

Réalisé par Zendesk