• Resumen
  • Configuración

Aplicaciones relacionadas

Miro

Optimizar la colaboración en equipo con la integración ADManager Plus-Miro

Aprovisionamiento de identidad

Miro es una plataforma de pizarra en línea que permite la colaboración en equipo en tiempo real proporcionando un espacio de trabajo visual para la lluvia de ideas, la planificación y la gestión de proyectos. La integración de Miro con ADManager Plus mejora la colaboración al permitir a los administradores de TI crear tableros en Miro y aplicar políticas de uso compartido directamente desde ADManager Plus.

 

Creación automatizada de tableros

Cree tableros en Miro con nombres específicos y políticas de uso compartido directamente desde ADManager Plus. Esto garantiza que los tableros tengan los ajustes y permisos de acceso correctos desde el principio, mejorando la eficiencia operativa.

 

Documento de configuración: Integrar Miro con ADManager Plus

Requisitos previos

Miro utiliza OAuth 2.0 para autorizar las solicitudes de API.

Requiere los parámetros client_id y client_secret para la autorización.

Privilegios

Para importar usuarios (acción de entrada): Asegúrese de que la cuenta de usuario utilizada para la autorización tiene permiso para leer todas las cuentas de usuario.

Para realizar cualquier acción o consulta en Miro (acción de salida): Asegúrese de que la cuenta utilizada para la autorización tiene permiso para realizar la acción deseada.

Nota: ADManager Plus viene con un conjunto de API preconfiguradas que ayudan a realizar acciones básicas con la integración. Si la acción que necesita no está disponible, recopile los detalles necesarios de la API en la documentación de la API de Miro para configurar webhooks entrantes o salientes que realicen las acciones requeridas.

Configuración de la autorización

  • Inicie sesión en ADManager Plus y vaya a Directorio/Ajustes de la aplicación.
  • Vaya a Integraciones de aplicaciones, luego busque y seleccione Miro.
  • Active el botón Habilitar integración con Miro.
  • En la página de configuración de Miro, haga clic en Autorización.
  • Realice los pasos para generar el client_id y el client_secret desde Miro, y péguelos en los campos de valor respectivos.
  • Haga clic en Configurar.

Configuración del webhook de entrada

Los webhooks de entrada le permiten obtener datos de usuario de Miro y enviarlos a ADManager Plus. La correlación de atributos configurada en esta sección se puede elegir como fuente de datos durante la configuración de la automatización. Para configurar un webhook de entrada para Miro:

  • En el Webhook de entrada, haga clic en Configuración del endpoint de Miro.
  • En la pestaña Configuración del endpoint, un endpoint (ENDPOINT DE USUARIOS de Miro) viene preconfigurado. Sin embargo, si desea utilizar un nuevo endpoint para importar usuarios, puede configurar uno utilizando el botón + Añadir endpoint de la API y llenando los campos necesarios según la documentación de la API de Miro. Haga clic aquí para saber cómo.

    • Nota:

    • El par clave-valor de la API está preconfigurado como cabecera para autenticar las solicitudes de la API, tal y como se configuró durante la configuración de la autorización.
    • Macros: Puede añadir macros a la configuración del endpoint para modificarlo dinámicamente, según sus necesidades, utilizando el componente selector de macros
    • Consulte la documentación de la API de Miro y configure cabeceras y parámetros adicionales, si es necesario. En la pestaña Ajustes, la opción Repetir llamada a este endpoint estará configurada para obtener 30 registros por llamada. Esto se repetirá hasta que ya no se reciba ningún token de página siguiente.
  • Una vez hecho esto, haga clic en Probar y guardar. Una ventana de respuesta mostrará todos los parámetros solicitados que se pueden obtener con la llamada a la API. Luego de comprobar si los parámetros solicitados han sido llamados a la acción, haga clic en Proceder .
    • Consulte la documentación de la API de Miro para conocer los parámetros que debe configurar para obtener sólo parámetros específicos.
    • Puede configurar varios endpoints para Miro utilizando el botón + Añadir endpoint de la API. Haga clic aquí para saber cómo.
  • Haga clic en Fuente de datos - Asignación de atributos LDAP para correlacionar endpoints y asignar atributos LDAP de AD con los atributos respectivos en Miro
  • Haga clic en + Añadir nueva configuración y haga lo siguiente:
    • Ingrese el Nombre de la configuración y la Descripción y seleccione la Categoría de automatización en el menú desplegable.
    • En el campo Seleccionar endpoint, seleccione el endpoint deseado y una Clave principal que sea exclusiva de un usuario (por ejemplo, employeeIdentifier).
      • Nota: Cuando se configuran varios endpoints, este atributo debe tener el mismo valor en todos ellos.
    • En el campo Asignación de atributos seleccione el atributo en el menú desplegable Nombre del atributo LDAP y asócielo con el atributo correspondiente en Miro. Si desea crear un nuevo formato personalizado, haga clic en Añadir nuevo formato.
    • Haga clic en Guardar.

Outbound webhook configuration

Outbound webhooks enable you to send changes made in AD to Miro, fetch data from Miro, and carry out tasks in Miro—all from ADManager Plus. The webhooks configured in this section can be included in Orchestration Templates, which in turn can be used during event-driven and scheduled automations. They can also be applied directly on desired users to perform a sequence of actions on them (Management > Advanced Management > Orchestration). To configure outbound webhooks for Miro:

  • Under Outbound Webhook, click Miro Webhook Configuration.
  • Click + Add Webhook.
  • Enter a name and description for this webhook.
  • Decide on the action that has to be performed and refer to Miro's API documentation for the API details, such as URL, headers, and parameters.
  • Select the HTTP method that will enable you to perform the desired action on the endpoint from the drop-down menu.
  • Enter the endpoint URL.
  • Configure the Headers, Parameters, and Message Typein the appropriate format based on the API call that you would like to perform.
  • Click Test and Save.
  • A pop-up window will then display a list of AD users and groups to test the configured API call. Select the desired user or group over which this API request has to be tested and click OK. This will make a real-time call to the endpoint URL, and the selected objects will be modified as per the configuration.
  • The webhook response and request details will then be displayed. Verify them for the expected API behavior and click Save.