La méthode d'intégration Azure Admin utilise un consentement d'administrateur unique pour accorder des autorisations à un groupe d'utilisateurs afin qu'ils utilisent l'application (par défaut, l'ensemble de l'organisation, dans le locataire Azure).

Lorsque la mise en œuvre globale du compte de service n'est pas appropriée ou approuvée par votre équipe, vous pouvez utiliser la méthode du consentement administrateur. Cette méthode peut s'avérer utile si votre organisation a des exigences légales ou de sécurité spécifiques interdisant l'utilisation des comptes de service, ou si vous ne souhaitez pas acquérir de licence pour un compte de service. Cette méthode ne permet pas l'envoi d'e-mails (pour les invitations de calendrier envoyées aux candidats et aux intervieweurs) depuis le compte connecté. Par conséquent, une fois le tenant connecté, les invitations de calendrier devront être envoyées soit depuis une adresse e-mail dédiée, connectée et authentifiée dans Paradox , soit depuis une adresse e-mail Paradox (par exemple : clientname@paradox.ai ).

Une fois le locataire connecté (c'est-à-dire Paradox connecté au niveau global), tous les utilisateurs seront automatiquement connectés grâce à leur adresse e-mail (tous les utilisateurs ayant la même adresse e-mail dans Azure ou Entra ID Active Directory, au sein d'un locataire auquel le compte de service a accès). Aucune action individuelle n'est requise ; l'adresse e-mail de connexion sera automatiquement renseignée 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 de configurer une autre connexion.

Prérequis

Si vous utilisez MS Teams, le compte devra disposer d'une licence complète permettant la création de réunions MS Teams.

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 les étapes nécessaires à la configuration de l'intégration du calendrier d'administration Azure M365 dans votre compte Paradox CEM .

Actions disponibles pour le locataire

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

• Consultez la disponibilité du calendrier – L’application vérifie les créneaux horaires libres/occupés pour la planification.
  • Synchronisation du fuseau horaire du calendrier – Synchronisez le fuseau horaire Paradox avec le fuseau horaire des heures de travail O365 à chaque accès au calendrier.
• 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 – Activez l’enregistrement et la transcription automatiques des réunions Teams. Ces fichiers multimédias sont accessibles à l’organisateur ou aux organisateurs de la réunion.
  • Participants en tant que co-organisateurs – Autoriser la désignation des intervieweurs comme co-organisateurs des réunions Teams.
  • Accès direct depuis la salle d'attente – Définissez qui est admis à la réunion et contournez la salle d'attente.
    • Organisateur
    • Organisation
    • Organisation et fédération
    • Tout le monde
    • Invité
    • Organisation excluant les invités

étendue des autorisations d'intégration

• Cette méthode utilise les autorisations de l'application.
  • Contrairement aux autorisations déléguées, les autorisations d'application permettent à Paradox d'accéder aux données de calendrier de tous les utilisateurs de l'organisation sans nécessiter leur consentement.
• 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 plus d'informations.
  • Calendars.ReadBasic.All
    • Nécessaire si la fonctionnalité « Lire la disponibilité du calendrier » est activée
    • Permet de consulter les données de disponibilité des utilisateurs de votre organisation. Il s'agit de l'autorisation minimale requise pour accéder aux données de disponibilité dans le calendrier.
    • Permet à l'application de lire les événements (n'inclut pas les propriétés telles que le corps, les pièces jointes et les extensions) de tous les calendriers sans utilisateur connecté.
    • Lien vers la documentation Microsoft
  • MailboxSettings.Read
    • Nécessaire pour la fonctionnalité « Lire la disponibilité du calendrier » activée
    • Utilisé pour identifier et définir le fuseau horaire approprié pour les utilisateurs de l'environnement Paradox .
    • Autorise l'application à lire les paramètres de la boîte mail des utilisateurs sans qu'un utilisateur soit connecté. N'inclut pas l'autorisation d'envoyer des mails.
    • Lien vers la documentation Microsoft
  • OnlineMeetings.ReadWrite.All
    • 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
  • Utilisateur.ReadBasic.All
    • Autorisation requise par défaut
    • Utilisé pour lire le profil du compte de service et donne accès à la sous-revendication.

Exemple de requête à l'API Microsoft Graph

• Si une requête API est envoyée au nom d'un autre utilisateur de votre locataire en dehors du compte de service, l'intégration renverra une erreur car Paradox ne dispose d'aucune autorisation API pour les utilisateurs situés en dehors du 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 l'appel API get free/busy pour obtenir les données de disponibilité des intervieweurs. L'action List calendarView permet d'obtenir les informations de disponibilité d'un utilisateur pour une période donnée.

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

    Exemple de requête : GET https://graph.microsoft.com/v1.0/me/calendar/calendarView?startDateTime=2017-01-01T19:00:00-08:00&endDateTime=2017-01-07T19:00:00-08:00

    Cette requête ne comporte pas de corps, mais elle comprendra des en-têtes incluant des jetons d'authentification Bearer pour l'utilisateur concerné.

    Exemple de réponse à l'appel GET précédent :

    {
      "value": [
        {
          "originalStartTimeZone": "originalStartTimeZone-value",
          "originalEndTimeZone": "originalEndTimeZone-value",
          "responseStatus": {
            "response": "response-value",
            "time": "datetime-value"
          },
          "iCalUId": "iCalUId-value",
          "reminderMinutesBeforeStart": 99,
          "isReminderOn": true
        }
      ]
    }

     

     
• Fuseau horaire de l'utilisateur
  • Lorsque l'application est connectée, Paradox appellera la fonction mailboxSettings pour identifier et mettre à jour les fuseaux horaires de l'utilisateur afin de correspondre à la configuration des paramètres de sa boîte aux lettres.

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

    Exemple de requête : GET https://graph.microsoft.com/v1.0/me/mailboxSettings

    Cette requête ne comporte pas de corps, mais elle comprendra des en-têtes incluant des jetons d'authentification Bearer pour l'utilisateur concerné.

    Exemple de réponse à l'appel GET précédent :

    {
        "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#Me/mailboxSettings",
        "automaticRepliesSetting": {
            "status": "Scheduled",
            "externalAudience": "All",
            "scheduledStartDateTime": {
                "dateTime": "2016-03-14T07:00:00.0000000",
                "timeZone": "UTC"
            },
            "scheduledEndDateTime": {
                "dateTime": "2016-03-28T07:00:00.0000000",
                "timeZone": "UTC"
            },
            "internalReplyMessage": "<html>\n<body>\n<p>I'm at our company's worldwide reunion and will respond to your message as soon as I return.<br>\n</p></body>\n</html>\n",
            "externalReplyMessage": "<html>\n<body>\n<p>I'm at the Contoso worldwide reunion and will respond to your message as soon as I return.<br>\n</p></body>\n</html>\n"
        },
        "timeZone":"UTC",
        "language":{
          "locale":"en-US",
          "displayName":"English (United States)"
        },
        "workingHours":{
            "daysOfWeek":[
                "monday",
                "tuesday",
                "wednesday",
                "thursday",
                "friday"
            ],
            "startTime": "08:00:00.0000000",
            "endTime": "17:00:00.0000000",
            "timeZone":{
                "name":"Pacific Standard Time"
            }
        },
        "dateFormat": "MM/dd/yyyy",
        "timeFormat": "hh:mm tt",
        "delegateMeetingMessageDeliveryOptions": "sendToDelegateOnly"
    }