La méthode d'intégration par compte de service M365 utilise un compte unique (par exemple : olivia@clientname.com ) de votre locataire Azure pour se connecter à l'application. Ce compte est le compte de service. Grâce à ce compte, Paradox récupère la disponibilité de l'utilisateur dans son calendrier et peut, si nécessaire, créer et envoyer des invitations à des entrevues via l'adresse e-mail associée.

Cette approche d'intégration est la méthode la plus courante utilisée par Paradox pour s'intégrer à un environnement Office 365 ou Exchange Online. Le fait que l'application Olivia Scheduling soit limitée à un seul compte offre des protections efficaces, car les données ne sont exposées qu'à une seule boîte aux lettres. Un compte de service permet également de garantir que toutes les communications de planification proviennent d'un domaine spécifique.

Une fois le tenant connecté (c'est-à-dire que Paradox est connecté globalement), tous les utilisateurs sont automatiquement connectés en fonction de leur adresse e-mail (tous les utilisateurs ayant le même domaine de messagerie dans l'Active Directory d'Entra ID, au sein d'un tenant auquel le compte de service a accès). La « connexion » Paradox à ces e-mails se limite à la possibilité pour le compte de service de les consulter (les utilisateurs ne se sont pas authentifiés individuellement auprès de leurs e-mails dans Paradox ). Ainsi, si un utilisateur est connecté dans Paradox , nous vérifions activement ses données de disponibilité.

• Aucune action individuelle n'est nécessaire, l'adresse e-mail associée s'affichera automatiquement dans des pages telles que « Rôles et autorisations » et « Mon calendrier ».
• Il est possible de déconnecter des utilisateurs individuellement ou de leur permettre d'établir une connexion individuelle différente.
• Si de nombreux utilisateurs sont déjà associés au compte Paradox , la connexion automatique de leurs calendriers individuels s'effectuera par lots et progressivement. C'est pourquoi, lors de la mise en œuvre, nous recommandons de connecter d'abord le tenant dans Paradox CEM avant d'ajouter tous les utilisateurs au compte.

Application Paradox Azure

L'intégration du calendrier O365 de Paradox s'appuie sur une application d'entreprise configurée dans Azure. Un administrateur général Azure autorise la connexion de l'application à votre locataire. Une fois l'autorisation accordée, l'application agit pour le compte de l'administrateur Azure désigné, en utilisant son contexte d'identité pour exécuter des appels à l'API Microsoft Graph via les autorisations d'application OAuth 2.0.

Il existe deux manières de créer et de gérer l'application Paradox dans votre environnement Azure : 1) Application Paradox par défaut, 2) Application gérée.

• Application par défaut Paradox
  • Grâce au processus de consentement de l'application, nous pouvons connecter votre locataire à l'application Paradox Default. Il s'agit d'une application préconfigurée qui peut être ajoutée à votre locataire via le consentement OAuth de l'utilisateur du compte de service.
  • Cela nécessite généralement le consentement d'un administrateur global Azure pour ajouter l'application à l'environnement.
• Application gérée (enregistrement d'une application dans Azure)
  • Si vous préférez gérer votre propre application dans votre environnement, c'est tout à fait possible. Pour gérer une application personnalisée, enregistrez une application d'entreprise dans Azure.
  • Vous devrez fournir à Paradox les informations suivantes relatives à votre demande enregistrée (exemple) :
    • ID de l'application : 1a058ccb-060a-432c-****-************
    • Identifiant du locataire : 99bbf8d0-600c-4b78-****-************
    • Valeur secrète : yiX4Omm~6~Mu6I***********************
    • Date d'expiration de la clé secrète

Diagramme de configuration

Cliquez ici pour découvrir comment configurer l'intégration du calendrier M365.

Licence

• Le compte de service nécessite une boîte aux lettres active, car il s'agit essentiellement d'un compte utilisateur utilisé pour l'intégration.
• Si vous utilisez MS Teams, le compte devra disposer d'une licence complète permettant la création de réunions MS Teams.

Configuration de sécurité

• Il est recommandé de configurer la stratégie de partage dans Azure sur « Disponibilité uniquement » par défaut.
  • Cela permet au compte de service de voir uniquement la disponibilité d'un utilisateur, au lieu de recevoir tous les détails des événements de son calendrier. Dans le cas contraire, les appels API renverront les détails du calendrier. Paradox ne stocke jamais ces données, mais nous tenons à vous informer, par mesure de sécurité, qu'elles peuvent potentiellement être transférées vers notre système.
  • Paradox n'effectuera de requêtes que sur les calendriers des utilisateurs existants dans le CEM Paradox .
  • Les comptes de service doivent avoir tous les calendriers des autres locataires partagés avec eux par défaut.
  • Dans Azure, la seule autorisation accordée par défaut à tous les utilisateurs est la possibilité de consulter les données de disponibilité des autres utilisateurs (il s'agit du rôle AvailabilityOnly).
• L'authentification multifacteur (MFA) est prise en charge pour les comptes de service. Toutefois, Paradox recommande de ne pas l'activer pour les raisons suivantes :
  • La réinitialisation de l'authentification multifacteur ou les modifications de la politique de mot de passe effectuées après la configuration de l'intégration interrompront les clés d'intégration sans avertissement, ce qui peut entraîner des incohérences dans les actions d'intégration et de planification.
  • L’authentification multifacteur (MFA) exige que l’utilisateur soit propriétaire de l’appareil servant de deuxième méthode d’authentification. Cela crée un point de défaillance unique (SPoF) si cet utilisateur quitte l’organisation, change d’appareil ou est indisponible au moment de l’escalade.
  • L'ajout de l'authentification multifacteur après la création du compte de service peut également entraîner une interruption nécessitant une reconnexion.

Actions disponibles pour le locataire

Le locataire connecté peut être activé pour les fonctionnalités suivantes :

• Envoyer des invitations de calendrier – Le compte de service envoie des invitations à des entrevues aux candidats et aux intervieweurs.
• Consulter la disponibilité du calendrier – Le compte de service vérifie les créneaux horaires libres/occupés pour la planification.
  • Synchronisation du fuseau horaire du calendrier – Ceci permet au fuseau horaire de Paradox de se synchroniser avec le fuseau horaire des heures de travail d'O365 à chaque fois que le calendrier est consulté.
• Réunions Microsoft Teams – Teams est utilisé comme technologie virtuelle, ce qui signifie que des liens de réunion Teams sont créés pour chaque entrevue virtuel programmé.
  • Enregistrement et transcription – Permet l’enregistrement et la transcription automatiques des réunions Teams. Ces fichiers sont accessibles à l’organisateur ou aux organisateurs de la réunion.
  • Participants en tant que co-organisateurs – Permet de désigner les intervieweurs comme co-organisateurs des réunions Teams.
  • Accès direct à la salle d'attente – Définit qui est admis à la réunion et qui peut éviter de passer par la salle d'attente.
    • Organisateur
    • Organisation
    • Organisation et fédération
    • Tout le monde
    • Invité
    • Organisation excluant les invités

 

Étendue des autorisations

• Cette méthode utilise des autorisations déléguées.
  • Les autorisations déléguées dans Azure nécessitent que chaque utilisateur consente individuellement aux autorisations de l'application, ce qui signifie que le compte de service sera connecté et pourra confirmer les autorisations.
  • On s'inquiète souvent de l'étendue de l'accès dont Paradox dispose en accordant ces autorisations → les autorisations déléguées constituent le garde-fou à cet égard.
    • Étant donné que Paradox utilise des autorisations déléguées plutôt que des autorisations d'application à l'échelle du locataire, l'application n'accède qu'au compte qui s'authentifie.
    • Seul le compte de service est autorisé à s'authentifier. Paradox ne peut ni accéder aux détails complets du calendrier des autres utilisateurs du locataire, ni les consulter ; sa vue des agendas des utilisateurs standard se limite strictement à leur disponibilité (libre/occupé) conformément à la stratégie de partage par défaut d'Azure. Toutes les actions de calendrier et les invitations à des entrevues sont gérées de manière centralisée et exécutées exclusivement pour le compte du compte de service.

  • Seul le compte de service sera connecté à cette application et, par conséquent, les autorisations sont limitées à un seul compte.

     
• L'application Paradox Interview Scheduling utilise les autorisations suivantes. Les autorisations requises dépendent des fonctionnalités choisies pour l'intégration. Consultez la documentation Microsoft pour en savoir plus.
  • Calendars.ReadBasic 
    • Nécessaire si la fonctionnalité « Lire la disponibilité du calendrier » est activée
    • Utilisé pour lire les données de disponibilité des autres utilisateurs de votre locataire.
    • Du fait de la désignation « déléguée », l'autorisation de lecture ne concerne que le compte de service et ne donne pas accès en lecture aux calendriers des autres utilisateurs.
    • Lien vers la documentation Microsoft
  • Calendars.ReadWrite 
    • Nécessaire si la fonctionnalité « Envoyer des invitations de calendrier » est activée
    • Utilisé pour lire les données de disponibilité des autres utilisateurs de votre locataire et pour la création de l'événement de calendrier d'entrevue avec le compte de service comme propriétaire.
    • Du fait de la désignation « déléguée », l'autorisation de lecture/écriture ne concerne que le compte de service et ne donne pas accès en lecture/écriture aux calendriers des autres utilisateurs.
    • Lien vers la documentation Microsoft
  • Mail.read
    • Nécessaire si la fonctionnalité « Envoyer des invitations de calendrier » est activée
    • Ce système permet de consulter les e-mails dans la boîte de réception du compte de service afin de détecter les modifications apportées aux événements du calendrier. En fonction des réponses de l'invité, Paradox pourra prendre les mesures nécessaires concernant l'entrevue, notamment le reprogrammer ou l'annuler si besoin.
    • L'autorisation de lecture ne concerne que le compte de service et ne donne pas accès en lecture aux boîtes aux lettres des autres utilisateurs.
    • Lien vers la documentation Microsoft
  • OnlineMeetings.ReadWrite
    • Nécessaire pour que la fonctionnalité « Réunions Microsoft Teams » soit activée
    • Permet de créer et de gérer les URL Microsoft Teams pour tous les entrevues. Le compte de service fera office d'organisateur de la réunion lors de la création des URL Teams.
    • L'autorisation de lecture/écriture n'autorise que le compte de service et ne donne pas à Teams un accès en lecture/écriture aux comptes Teams d'autres utilisateurs.
    • Lien vers la documentation Microsoft
  • Offline_access
    • Autorisation requise par défaut
    • Utilisé pour maintenir l'accès aux données du compte de service même hors ligne.
  • User.read
    • Autorisation requise par défaut
    • Permet de lire le profil du compte de service et donne accès à la sous-revendication.
    • Lien vers la documentation Microsoft

Exemple de requête à l'API Microsoft Graph

• Paradox ne peut pas envoyer de requête API au nom d'un autre utilisateur de votre locataire car Paradox ne dispose d'aucune autorisation API pour un utilisateur extérieur au compte de service.
• Les exemples suivants illustrent une requête que Paradox CEM effectuerait au nom d'un compte de service de votre tenant O365. La requête est effectuée par le compte de service olivia@paradoxolivia.onmicrosoft.com avec l'adresse e-mail de l'intervieweur : test@paradoxolivia.onmicrosoft.com .
• Disponibilités du calendrier
  • Paradox utilisera ensuite l'appel API get free/busy pour obtenir les données de disponibilité du ou des intervieweurs.
  • Documentation : getSchedule
  • Pour obtenir les informations de disponibilité d'un intervieweur, nous ajoutons la valeur « test@paradoxolivia.onmicrosoft.com » au paramètre « Schedules » de la requête API. Le compte de service étant autorisé à consulter les informations de disponibilité de « test@paradoxolivia.onmicrosoft.com », la requête API renvoie une réponse.

  • Voir la requête et la réponse de l'API

    Exemple de requête : POST https://graph.microsoft.com/v1.0/me/calendar/getschedule

    {
      "schedules": ["recruiter@contoso.com"],
      "startTime": {
        "dateTime": "2025-01-01T09:00:00",
        "timeZone": "UTC"
      },
      "endTime": {
        "dateTime": "2025-01-01T10:00:00",
        "timeZone": "UTC"
      }
    }

    Exemple de réponse :

    {
      "value": [
        {
          "scheduleId": "recruiter@contoso.com",
          "scheduleItems": [
            {
              "status": "busy",
              "start": {
                "dateTime": "2025-01-01T09:00:00.0000000",
                "timeZone": "Pacific Standard Time"
              },
              "end": {
                "dateTime": "2025-01-01T10:00:00.0000000",
                "timeZone": "Pacific Standard Time"
              }
            }
          ],
          "workingHours": {
            "timeZone": {
              "name": "Pacific Standard Time"
            }
          }
        }
      ]
    }

     

     
• Création d'événements dans le calendrier
  • Une fois qu'un candidat a choisi un créneau horaire pour son entrevue, Paradox effectue une requête API afin de créer des invitations de calendrier distinctes à envoyer au candidat et aux recruteurs. Paradox envoie ces invitations séparément, ce qui Paradox permet de personnaliser le contenu en fonction du profil de chaque interlocuteur.
  • Documentation : Créer un événement

  • Voir la requête et la réponse de l'API

    Exemple de requête : POST https://graph.microsoft.com/v1.0/me/events

    {
      "subject": "New Team Meeting",
      "body": {
        "contentType": "text",
        "content": "Quarterly planning session"
      },
      "start": {
        "dateTime": "2025-01-20T10:00:00",
        "timeZone": "America/New_York"
      },
      "end": {
        "dateTime": "2025-01-20T11:00:00",
        "timeZone": "America/New_York"
      },
      "location": {
        "displayName": "Room 202",
        "address": null
      },
      "attendees": [
        {
          "type": "required",
          "emailAddress": {
            "address": "alice@example.com",
            "name": "Alice Smith"
          }
        },
        {
          "type": "optional",
          "emailAddress": {
            "address": "bob@example.com",
            "name": "Bob Jones"
          }
        }
      ],
      "sensitivity": "normal"
    }

    Exemple de réponse :

    Paradox lit la réponse :  id (obligatoire), iCalUId . Conserver subject , body , start , end , location , attendees et sensitivity , le cas échéant.

     

     

• MS Teams - Création de réunions
  • Documentation : Créer une réunion en ligne

  • Voir la requête et la réponse de l'API

    Exemple de requête : POST https://graph.microsoft.com/v1.0/me/onelineMeetings

    {
      "startDateTime": "2025-11-05T10:00:00Z",
      "endDateTime": "2025-11-05T11:00:00Z",
      "subject": "Interview meeting",
      "joinMeetingIdSettings": {
        "isPasscodeRequired": true
      }
    }

    Exemple de réponse :

    {
      "joinUrl": "https://teams.microsoft.com/l/meetup-join/...",
      "joinWebUrl": "https://teams.microsoft.com/l/meetup-join/...",
      "joinMeetingIdSettings": {
        "joinMeetingId": "123456789",
        "passcode": "abc123"
      },
      "audioConferencing": {
        "tollNumber": "+1 469-998-7681",
        "conferenceId": "129851622"
      }
    }