El método de integración de Azure Admin utiliza un único consentimiento de administrador para otorgar permisos a un grupo de usuarios para usar la aplicación (por defecto, se aplica a toda la organización, en el inquilino de Azure).

Cuando la implementación global de la cuenta de servicio no sea apropiada o no esté aprobada por su equipo, puede utilizar el método de consentimiento del administrador. Su equipo podría preferir este método si existen requisitos legales o de seguridad específicos que impidan el uso de cuentas de servicio en su organización, o si no desea adquirir una licencia para la cuenta de servicio. Este método no permite la generación de correos electrónicos (para invitaciones de calendario enviadas a candidatos y entrevistadores) desde la cuenta conectada. Esto significa que, una vez conectado el inquilino, las invitaciones de calendario deberán enviarse desde una dirección de correo electrónico dedicada que se haya conectado a Paradox y se haya autenticado, o bien desde una dirección de correo electrónico Paradox (por ejemplo, clientname@paradox.ai ).

Una vez conectado un inquilino (es decir, cuando Paradox se conecta a nivel global), todos los usuarios se conectarán automáticamente según sus direcciones de correo electrónico (todos los usuarios que existan con la misma dirección de correo electrónico en Azure o Entra ID Active Directory, en un inquilino al que tenga acceso la cuenta de servicio). No es necesario realizar ninguna acción individual; la dirección de correo electrónico conectada se completará automáticamente en páginas como Roles y permisos y Mi calendario. Es posible desconectar usuarios individuales o permitirles configurar una conexión individual diferente.

Requisitos previos

Si se utiliza Microsoft Teams, la cuenta necesitará una licencia completa que permita la creación de reuniones de Microsoft Teams.

Aplicación Paradox Azure

La integración de Paradox con el calendario de O365 utiliza una aplicación empresarial configurada en Azure. Un administrador global de Azure otorga el consentimiento de administrador para conectar la aplicación a su inquilino. Una vez otorgado el consentimiento, la aplicación actúa en nombre del administrador de Azure designado, utilizando el contexto de identidad de ese usuario específico para ejecutar llamadas a la API de Microsoft Graph mediante permisos de aplicación OAuth 2.0.

Existen dos maneras de crear y administrar la aplicación Paradox dentro de su entorno Azure: 1) Aplicación predeterminada Paradox , 2) Aplicación administrada.

• Aplicación predeterminada Paradox
  • Mediante el proceso de consentimiento de la aplicación, podemos conectar su inquilino a la aplicación Paradox Default. Esta es una aplicación preconfigurada que se puede agregar a su inquilino mediante el consentimiento OAuth del usuario de la cuenta de servicio.
  • Normalmente, esto requiere que un administrador global de Azure dé su consentimiento para agregar la aplicación al entorno.
• Aplicación administrada (registro de una aplicación en Azure)
  • Si prefiere administrar su propia aplicación en su entorno, es posible hacerlo. Para administrar una aplicación personalizada, registre una aplicación empresarial en Azure.
  • Deberá proporcionar a Paradox los siguientes datos de la solicitud registrada (ejemplo):
    • ID de la aplicación : 1a058ccb-060a-432c-****-************
    • ID de inquilino : 99bbf8d0-600c-4b78-****-************
    • Valor secreto : yiX4Omm~6~Mu6I********************
    • Fecha de caducidad de la clave secreta

Diagrama de configuración

Haga clic aquí para conocer los pasos necesarios para configurar la integración del calendario de administración de Azure de M365 en su cuenta Paradox CEM .

Acciones disponibles para el inquilino

El inquilino conectado puede habilitarse para la siguiente funcionalidad:

• Consulta la disponibilidad del calendario : la aplicación comprueba los horarios libres y ocupados para programar citas.
  • Sincronización de la zona horaria del calendario : sincronice la zona horaria Paradox con la zona horaria de Horario Laboral de O365 cada vez que acceda al calendario.
• Reuniones de Microsoft Teams : Teams se utiliza como tecnología virtual, lo que significa que se crean enlaces de reuniones de Teams para cada entrevista virtual programada.
  • Grabación y transcripción : Permite la grabación y transcripción automáticas de las reuniones de Teams. El organizador o los organizadores de la reunión tendrán acceso a este material.
  • Participantes como coorganizadores : Permite que los entrevistadores sean designados como coorganizadores de las reuniones de Teams.
  • Acceso directo a la sala de espera : configure quién tiene acceso a la reunión y evite la sala de espera.
    • Organizador
    • Organización
    • Organización y Federación
    • Todos
    • Invitado
    • Organización sin invitados

Alcance de los permisos de integración

• Este método utiliza permisos de aplicación.
  • A diferencia de los permisos delegados, los permisos de la aplicación otorgan a Paradox acceso a los datos del calendario de todos los usuarios de la organización sin necesidad de su consentimiento.
• La aplicación de programación de entrevistas Paradox utiliza los siguientes permisos. Los permisos necesarios dependen de la funcionalidad seleccionada para la integración. Consulte la documentación de Microsoft para obtener más información sobre estos permisos.
  • Calendars.ReadBasic.All
    • Necesario si la funcionalidad "Leer disponibilidad del calendario" está habilitada.
    • Se utiliza para leer la información de disponibilidad de los usuarios de su inquilino. Este permiso es el permiso de calendario con menos privilegios disponible para obtener datos de disponibilidad.
    • Permite que la aplicación lea los eventos (sin incluir propiedades como el cuerpo, los archivos adjuntos y las extensiones) de todos los calendarios sin necesidad de que el usuario haya iniciado sesión.
    • Enlace a la documentación de Microsoft
  • MailboxSettings.Read
    • Necesario para la funcionalidad: La opción "Leer disponibilidad del calendario" está habilitada.
    • Se utiliza para identificar y configurar la zona horaria adecuada para los usuarios del entorno Paradox .
    • Permite que la aplicación lea la configuración del buzón de correo de los usuarios sin que estos hayan iniciado sesión. No incluye permiso para enviar correos electrónicos.
    • Enlace a la documentación de Microsoft
  • OnlineMeetings.ReadWrite.All
    • Necesario para la funcionalidad: 'Microsoft Teams Meetings' está habilitado.
    • Se utiliza para crear y administrar las URL de Microsoft Teams para todas las entrevistas. La cuenta de servicio actuará como propietario de la reunión al crear las URL de Teams.
    • El permiso de lectura/escritura solo otorga permisos para la cuenta de servicio y no concede a Teams acceso de lectura/escritura a los equipos de otros usuarios.
    • Enlace a la documentación de Microsoft
  • Usuario.LeerBásico.Todo
    • Se requiere como permiso predeterminado
    • Se utiliza para leer el perfil de la cuenta de servicio y da acceso a la subreclamación.

Ejemplo de solicitud a la API de Microsoft Graph

• Si se envía una solicitud de API en nombre de cualquier otro usuario de su inquilino que no pertenezca a la cuenta de servicio, la integración generará un error, ya que Paradox no tiene permisos de API para ningún usuario que no pertenezca a la cuenta de servicio.
• Los siguientes ejemplos corresponden a una solicitud que Paradox CEM realizaría en nombre de una cuenta de servicio en su inquilino de O365. La solicitud la realiza la cuenta de servicio olivia@paradoxolivia.onmicrosoft.com con el correo electrónico del entrevistador: test@paradoxolivia.onmicrosoft.com .
• Disponibilidad del calendario
  • Paradox utilizará la llamada a la API get free/busy para obtener los datos de disponibilidad del/de los entrevistador/es. La acción List calendarView permite obtener la información de disponibilidad de un usuario para un período de tiempo específico.

  • Consulte la solicitud y respuesta de la API.

    Ejemplo de solicitud: 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

    Esta solicitud no tiene cuerpo, pero sí encabezados que incluyen tokens de autenticación Bearer para el usuario correspondiente.

    Ejemplo de respuesta a la llamada GET anterior:

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

     

     
• Zona horaria del usuario
  • Cuando la aplicación esté conectada, Paradox llamará a la función mailboxSettings para identificar y actualizar las zonas horarias del usuario de modo que coincidan con la configuración de su buzón de correo.

  • Consulte la solicitud y respuesta de la API.

    Ejemplo de solicitud: GET https://graph.microsoft.com/v1.0/me/mailboxSettings

    Esta solicitud no tiene cuerpo, pero sí encabezados que incluyen tokens de autenticación Bearer para el usuario correspondiente.

    Ejemplo de respuesta a la llamada GET anterior:

    {
        "@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"
    }