Configuración de Workplace desde Meta para el aprovisionamiento automático de usuarios con Microsoft Entra ID

En este artículo se describen los pasos que debe realizar en Workplace desde Meta y Microsoft Entra ID para configurar el aprovisionamiento automático de usuarios. Cuando se configura, Microsoft Entra ID aprovisiona y desaprovisiona automáticamente a los usuarios para Workplace desde Meta mediante el servicio de aprovisionamiento de Microsoft Entra. Para obtener información importante sobre lo que hace este servicio, cómo funciona y las preguntas más frecuentes, consulte Aprovisionamiento y desaprovisionamiento de usuarios deAutomate en aplicaciones SaaS con Microsoft Entra ID.

Capacidades soportadas

  • Creación de usuarios en Workplace desde Meta
  • Quitar usuarios de Workplace de Meta cuando ya no necesiten acceso
  • Mantener los atributos de usuario sincronizados entre Microsoft Entra ID y Workplace desde Meta
  • Inicio de sesión único en Workplace de Meta (recomendado)

Prerrequisitos

En el escenario descrito en este artículo se supone que ya tiene los siguientes requisitos previos:

Nota:

Para probar los pasos de este artículo, no se recomienda usar un entorno de producción.

Nota:

Esta integración también está disponible para su uso desde Microsoft Entra entorno de nube de la Administración Pública de EE. UU. Puede encontrar esta aplicación en la galería de aplicaciones en la nube de Microsoft Entra administración pública de EE. UU. y configurarla de la misma manera que lo hace desde la nube pública.

Para probar los pasos de este artículo, debe seguir estas recomendaciones:

  • No use el entorno de producción, a menos que sea necesario.
  • Si no tiene un entorno de prueba de Microsoft Entra, puede obtener una prueba de un mes here.

Paso 1: Planifica tu despliegue de aprovisionamiento

  1. Obtén información sobre cómo funciona el servicio de aprovisionamiento.
  2. Determina quién está incluido en el ámbito de aprovisionamiento.
  3. Decidir qué datos mapear entre Microsoft Entra ID y Workplace de Meta.

Paso 2: Configurar Workplace from Meta para admitir el aprovisionamiento con Microsoft Entra ID

Antes de configurar y habilitar el servicio de aprovisionamiento, debe decidir qué usuarios de Microsoft Entra ID representan a los usuarios que necesitan acceso a su área de trabajo desde la aplicación Meta. Una vez decidido, puede asignar estos usuarios a su área de trabajo desde la aplicación Meta siguiendo estas instrucciones:

  • Se recomienda asignar un solo Microsoft Entra usuario a Workplace desde Meta para probar la configuración de aprovisionamiento. Más usuarios se pueden asignar más adelante.

  • Al asignar un usuario a Workplace desde Meta, debe seleccionar un rol de usuario válido. El rol "Acceso predeterminado" no funciona para realizar el aprovisionamiento.

Agregue Workplace desde Meta desde la galería de aplicaciones de Microsoft Entra para empezar a administrar el aprovisionamiento en Workplace desde Meta. Si ha configurado previamente Workplace desde Meta para el inicio de sesión único (SSO, puede usar la misma aplicación). Sin embargo, se recomienda crear una aplicación independiente al probar inicialmente la integración. Obtenga más información sobre cómo agregar una aplicación desde la galería aquí.

Paso 4: Definir quién está en el ámbito de aprovisionamiento

El servicio de aprovisionamiento de Microsoft Entra permite definir el ámbito de quién se aprovisiona en función de la asignación a la aplicación o en función de los atributos del usuario o grupo. Si decide determinar quién tiene acceso a su aplicación en función de la asignación, puede usar los pasos para asignar usuarios y grupos a la aplicación. Si decide definir el ámbito del aprovisionamiento únicamente en función de los atributos del usuario o grupo, puede usar un filtro de delimitación.

  • Comience pequeño. Pruebe con un pequeño conjunto de usuarios y grupos antes de implementarlo en todos. Cuando el ámbito de aprovisionamiento se establece en usuarios y grupos asignados, puede controlarlo asignando uno o dos usuarios o grupos a la aplicación. Cuando el ámbito se establece en todos los usuarios y grupos, puede especificar un filtro de ámbito basado en atributos.

  • Si necesita roles adicionales, puede actualizar el manifiesto de la aplicación para agregar nuevos roles.

Paso 5: Configuración del aprovisionamiento automático de usuarios en Workplace desde Meta

Esta sección le guía por los pasos necesarios para configurar el servicio de aprovisionamiento de Microsoft Entra para crear, actualizar y deshabilitar usuarios en Workplace desde Meta App en función de las asignaciones de usuarios en Microsoft Entra ID.

  1. Inicie sesión en el Centro de administración Microsoft Entra como mínimo un Administrador de Aplicaciones de Nube.

  2. Vaya a Entra ID>Aplicaciones empresariales

    Captura de pantalla del panel de aplicaciones empresariales.

  3. En la lista de aplicaciones, seleccione Workplace en Meta.

    Captura de pantalla del vínculo Workplace from Meta (Área de trabajo desde Meta) en la lista de aplicaciones.

  4. Seleccione la pestaña Aprovisionamiento.

    Captura de pantalla de las opciones de administración con la opción Aprovisionamiento seleccionada.

  5. Seleccione + Nueva configuración.

    Captura de pantalla de la pestaña Aprovisionamiento automático.

  6. Asegúrese de que la sección "Url del inquilino" se rellena con el punto de conexión correcto: https://scim.workplace.com/. En la sección Credenciales de administrador , seleccione Autorizar. Se le redirige a Workplace desde la página de autorización de Meta. Ingrese su nombre de usuario de Workplace from Meta y seleccione el botón Continuar. Seleccione Test Connection para asegurarse de que Microsoft Entra ID puede conectarse a Workplace desde Meta. Si se produce un error en la conexión, asegúrese de que la cuenta de Workplace desde Meta tenga permisos de administrador e inténtelo de nuevo.

    Captura de pantalla que muestra el cuadro de diálogo Credenciales de administrador con una opción de autorización.

    Captura de pantalla de Authorize.

    Nota:

    Si no se cambia la dirección URL a https://scim.workplace.com/ se produce un error al intentar guardar la configuración.

  7. Seleccione Crear para crear la configuración.

  8. Seleccione Propiedades en la página Información general .

  9. Seleccione el icono Editar para editar las propiedades. Habilite los correos electrónicos de notificación y proporcione un correo electrónico para recibir notificaciones de cuarentena. Habilite la prevención de eliminaciones accidentales. Seleccione Aplicar para guardar los cambios.

    Captura de pantalla de las propiedades de aprovisionamiento.

  10. Seleccione Asignación de atributos en el panel izquierdo y seleccione usuarios.

  11. Revise los atributos de usuario que se sincronizan entre Microsoft Entra ID y Workplace desde Meta en la sección Attribute-Mapping. Los atributos seleccionados como propiedades de Coincidencia se usan para buscar coincidencias con las cuentas de usuario de Workplace de Meta con el objetivo de realizar operaciones de actualización. Si decide cambiar el atributo de destino coincidente, debe asegurarse de que Workplace from Meta API admite el filtrado de usuarios en función de ese atributo. Seleccione el botón Guardar para confirmar los cambios.

    Atributo Tipo
    nombre de usuario Cuerda
    displayName Cuerda
    activo Boolean
    título Boolean
    emails[type eq "work"].value Cuerda
    name.givenName Cuerda
    name.familyName Cuerda
    name.formatted Cuerda
    addresses[type eq "work"].formatted Cuerda
    addresses[type eq "work"].streetAddress Cuerda
    addresses[type eq "work"].locality Cuerda
    direcciones[tipo = "trabajo"].región Cuerda
    dirección[tipo igual a "trabajo"].país Cuerda
    addresses[type eq "work"].postalCode Cuerda
    addresses[type eq "other"].formatted Cuerda
    phoneNumbers[type eq "work"].value Cuerda
    phoneNumbers[type eq "mobile"].value Cuerda
    phoneNumbers[type eq "fax"].value Cuerda
    externalId Cuerda
    idiomaPreferido Cuerda
    urn:scim:schemas:extension:enterprise:1.0.manager Cuerda
    urn:scim:schemas:extension:enterprise:1.0.department Cuerda
    urn:scim:schemas:extension:enterprise:1.0.division Cuerda
    urn:scim:schemas:extension:enterprise:1.0.organization Cuerda
    urn:scim:schemas:extension:enterprise:1.0.costCenter Cuerda
    urn:scim:schemas:extension:enterprise:1.0.employeeNumber Cuerda
    urn:scim:schemas:extension:facebook:auth_method:1.0:auth_method Cuerda
    urn:scim:schemas:extension:facebook:frontline:1.0.is_frontline Boolean
    urn:scim:schemas:extension:facebook:starttermdates:1.0.startDate Entero
  12. Para configurar filtros de ámbito, consulte las instrucciones proporcionadas en el artículo sobre filtros de ámbito.

  13. Use el aprovisionamiento a petición para validar la sincronización con algunos usuarios antes de implementar más ampliamente en su organización.

  14. Cuando esté listo para aprovisionar, seleccione Iniciar aprovisionamiento en la página Información general .

Paso 6: Supervisión de la implementación

Una vez configurado el aprovisionamiento, use los recursos siguientes para supervisar la implementación:

  1. Use los registros de aprovisionamiento de para determinar qué usuarios se aprovisionan correctamente o sin éxito
  2. Compruebe la barra de progreso para ver el estado del ciclo de aprovisionamiento y cómo se acerca a la finalización.
  3. Si la configuración de aprovisionamiento parece estar en un estado no saludable, la aplicación entra en cuarentena. Obtenga más información sobre los estados de cuarentena en el artículo estado de cuarentena de aprovisionamiento de aplicaciones .

Sugerencias de solución de problemas

  • Si ve que un usuario no se ha creado correctamente y hay un evento de registro de auditoría con el código "1789003", significa que el usuario procede de un dominio sin comprobar.
  • Hay casos en los que los usuarios obtienen el error "ERROR: Falta el campo de correo electrónico: debe proporcionar un correo electrónico Error devuelto desde Facebook: el procesamiento de la solicitud HTTP ha iniciado una excepción. Para obtener información detallada, consulte la respuesta HTTP que devolvió la propiedad "Response" de esta excepción. Esta operación se ha reintentado cero veces. La operación se reintenta de nuevo después de esta fecha. Este error se debe a que los clientes asignan el atributo mail, en lugar de userPrincipalName, al correo electrónico de Facebook, pero algunos usuarios no tienen un atributo mail. Para evitar los errores y aprovisionar correctamente los usuarios con errores en Workplace de Facebook, cambie la asignación de atributos al atributo email en Workplace de Facebook por Coalesce([mail],[userPrincipalName]), o bien anule la asignación del usuario de Workplace de Facebook, o bien aprovisione una dirección de correo electrónico para el usuario.
  • Hay una opción en Workplace, que permite la existencia de usuarios sin direcciones de correo electrónico. Si esta opción está activada en workplace, el aprovisionamiento en el lado Azure debe reiniciarse para que los usuarios sin correos electrónicos se creen correctamente en Workplace.

Actualización de una aplicación Workplace de Meta para usar el punto de conexión SCIM 2.0 de Workplace de Meta

En diciembre de 2021, Facebook publicó un conector SCIM 2.0. Completar los pasos indicados permitirá actualizar las aplicaciones configuradas para que usen el extremo SCIM 1.0 y pasen a utilizar el extremo SCIM 2.0. Estos pasos quitan las personalizaciones realizadas anteriormente en Workplace desde la aplicación Meta, entre las que se incluyen:

  • Detalles de la autenticación
  • Filtros de ámbito
  • Asignaciones de atributos personalizados

Nota:

Asegúrese de anotar los cambios realizados en la configuración que se muestra en la sección anterior antes de completar los pasos siguientes. Si no lo hace, se pierde la configuración personalizada.

  1. Inicie sesión en el Centro de administración Microsoft Entra como mínimo un Administrador de Aplicaciones de Nube.

  2. Vaya a Entra ID>Aplicaciones empresariales>Workplace desde Meta.

  3. En la sección Propiedades de la nueva aplicación personalizada, copie el id. de objeto.

    Captura de pantalla de Workplace desde la aplicación Meta en el portal de Azure

  4. En una nueva ventana del explorador web, vaya a https://developer.microsoft.com/graph/graph-explorer e inicie sesión como administrador para el inquilino de Microsoft Entra donde se agrega la aplicación.

    Captura de pantalla de la página de inicio de sesión del explorador de Microsoft Graph

  5. Compruebe que la cuenta que se usa dispone de los permisos correctos. El permiso "Directory.ReadWrite.All" es necesario para realizar este cambio.

    Captura de pantalla de la opción de configuración de Microsoft Graph

    Captura de pantalla de permisos de Microsoft Graph

  6. Con el ObjectID seleccionado anteriormente en la aplicación, ejecute el siguiente comando:

    GET https://graph.microsoft.com/beta/servicePrincipals/[object-id]/synchronization/jobs/
    
  7. Tomando el valor "id" del cuerpo de la respuesta de laGETsolicitud del ejemplo anterior, ejecute el siguiente comando, reemplazando "[job-id]" por el valor id de laGETsolicitud. El valor debe tener el formato siguiente: "FacebookAtWorkOutDelta.xxxxxxxxxxxxxxx.xxxxxxxxxxxxxxx":

    DELETE https://graph.microsoft.com/beta/servicePrincipals/[object-id]/synchronization/jobs/[job-id]
    
  8. En el explorador de Microsoft Graph, ejecute el siguiente comando. Reemplace "[object-id]" por el id. de la entidad de servicio (id. de objeto) que se copió en el tercer paso.

    POST https://graph.microsoft.com/beta/servicePrincipals/[object-id]/synchronization/jobs { "templateId": "FacebookWorkplace" }
    

    Captura de pantalla de solicitud de Microsoft Graph

  9. Vuelva a la primera ventana de explorador web y seleccione la pestaña Aprovisionamiento de la aplicación. La configuración se restablece. Para confirmar que la actualización se ha realizado correctamente, confirme que el id. de trabajo comienza por "FacebookWorkplace".

  10. Actualice la dirección URL del inquilino en la sección Credenciales de administrador a la siguiente dirección URL: https://scim.workplace.com/

    Captura de pantalla de las Credenciales de Administrador en el Entorno de Trabajo desde la aplicación Meta en el portal de Azure

  11. Restaure los cambios anteriores realizados en la aplicación (detalles de autenticación, filtros de ámbito, asignaciones de atributos personalizados) y vuelva a habilitar el aprovisionamiento.

    Nota:

    Si no se restaura la configuración anterior, es posible que los atributos (name.formatted) se actualicen inesperadamente en Workplace. Asegúrese de comprobar la configuración antes de habilitar el aprovisionamiento.

Registro de cambios

  • 10/09/2020: se ha agregado compatibilidad con los atributos empresariales "division", "organization", "costCenter" y "employeeNumber". Se ha agregado compatibilidad con los atributos personalizados "startDate", "auth_method" y "frontline".
  • 22/07/2021: se han actualizado las sugerencias de solución de problemas para los clientes con una asignación de correo electrónico al correo electrónico de Facebook, pero algunos usuarios no tienen un atributo de correo electrónico.

Más recursos