Deutsch English (United States) Français 日本語 한국어(대한민국) Polski (Polska) Português do Brasil

Artículos en esta sección

Configurar conectores de Miro para Okta Workflows

  • Actualización

Los conectores de Miro para Okta Workflows te permiten automatizar fácilmente tareas de admin repetitivas y de varios pasos en Miro. Aprende cómo configurar la automatización de flujos de trabajo y simplificar la gestión de usuarios y equipos.

Relevante para: plan Enterprise

Conector de gestión de usuarios de Miro

El conector de gestión de usuarios de Miro permite a los clientes empresariales de Miro con SCIM habilitado agregar usuarios a su organización y gestionar las licencias y los estados de los usuarios.

Autorización del conector de gestión de usuarios de Miro:

Cuando añadas una tarjeta de gestión de usuarios de Miro a un flujo por primera vez, te pediremos que configures una conexión para tu organización. Autorización.

Tarjetas de acción del conector de gestión de usuarios de Miro:

 Acción  Descripción
 Crear usuario  Crea un nuevo usuario.
 Obtener usuario  Buscar un usuario existente en una organización por correo electrónico.
 Actualizar el tipo de licencia de usuario a completa  Actualiza un recurso de usuario existente, cambiando su tipo de licencia de usuario a completa.
 Actualizar estado de usuario  Actualiza un recurso de usuario existente, cambiando su estado activo a verdadero o falso.El conector de gestión de usuarios de Miro funciona con tu token de SCIM. La gestión de usuarios de Miro solo está disponible para empresas con SSO y SCIM habilitados. 


Autorización

Puedes crear y administrar varias conexiones desde la página Conexiones.
Esto es útil si planeas operar con varias organizaciones. Cada conexión del conector de gestión de usuarios de Miro puede vincularse a una sola organización de Miro.

Para habilitar SCIM y obtener un nuevo token, o copiar un token existente, sigue las instrucciones en Cómo habilitar SCIM.
Para crear una nueva conexión desde una tarjeta de acción:

  1. Haz clic en Nueva conexión.
  2. Ingresa un Nombre de la conexión. Recomendamos usar un nombre que represente a la organización.
  3. Habilita el aprovisionamiento SCIM desde la página de integración de Enterprise de Miro, siguiendo las instrucciones.
    1. Copia URL de base desde Miro y pégala en el campo URL de base en la conexión
    2. Copia el token de API desde Miro y pégalo en el campo token de acceso en la conexión
  4. Haz clic en Crear. Esto guarda tu conexión y te devuelve a tu flujo.

Crear usuario

Crea un usuario dentro de la organización.
 

Entrada

 Campo  Definición  Tipo  Obligatorio 
 Detalles del usuario      
 Correo electrónico  La dirección de correo electrónico del usuario.   Cadena  VERDADERO
 Activo

 El estado del usuario.

  • Verdadero: el usuario está activo.
  • Falso: el usuario está inactivo.

 Cuando no se especifica, el valor predeterminado es false.

  Menú desplegable  FALSO
 Tipo de licencia de usuario

 El tipo de licencia del usuario.

  • Con acceso completo
  • Gratuita

 Cuando no se especifica, la licencia de usuario se establece de acuerdo con la lógica interna de Miro, que depende del plan de la organización.

  Desplegable  FALSO
 Rol

 El rol del usuario en la organización.

  • Miembro de la organización: miembro regular sin privilegios de admin.
  • Admin de la organización: usuario con privilegios de admin en toda la empresa.

 Cuando no se especifica, el valor predeterminado es Miembro   de la organización.

  Menú desplegable  FALSO
 Nombre      
 Apellido  El apellido del usuario.  Cadena  FALSO
 Nombre  El nombre del usuario.  Cadena  FALSO
 Nombre para mostrar  El nombre que se mostrará en Miro.  Cadena  FALSO

Salida

 Campo  Definición  Tipo
Usuario    
ID de usuario  El ID del nuevo usuario. String


Leer usuario

Buscar un usuario existente en una organización mediante correo electrónico

Entrada

 Campo  Definición  Tipo  Obligatorio 
Consulta      
 Correo electrónico La dirección de correo electrónico del usuario a buscar  Cadena  VERDADERO

Salida

 Campo  Definición  Tipo
 Usuario    
 ID de usuario El ID del usuario. Número
 Tipo de licencia del usuario El tipo de licencia del usuario. Número
 Activo

El estado del usuario.

  • Verdadero: el usuario está activo.
  • Falso: el usuario está inactivo.
Número
 Nombre    
 Nombre de usuario La dirección de correo electrónico del usuario.  Número
 Apellido El apellido del usuario. Número
 Nombre El nombre del usuario. Número
 Nombre para mostrar El nombre que se muestra en Miro. Número


Actualizar el tipo de licencia de usuario a completa

Actualiza un recurso de usuario existente, cambiando su tipo de usuario (licencia) a completa.

Entrada

 Campo  Definición  Tipo  Obligatorio 
Usuario      
 ID de usuario  El ID del usuario. Cadena VERDADERO

Salida

 Campo  Definición  Tipo
Respuesta    
 Código de estado

 Estado HTTP de la solicitud.
 Códigos que indican una actualización de licencia exitosa:

  • 200: OK

 Códigos que indican una actualización de licencia no exitosa:

  • 400: Solicitud con formato incorrecto
  • 401: Sin autorización
  • 403: Prohibido
  • 404: No encontrado
  • 409: Conflicto
  • 429: demasiadas solicitudes
 Número  


Actualizar estado de usuario

Actualiza un recurso de usuario existente, cambiando su estado activo a un valor verdadero o falso.

Entrada

 Campo  Definición  Tipo  Obligatorio  
Usuario      
 ID de usuario  El ID del usuario.  Cadena  SÍ
 Activo

 El nuevo estado del usuario.

  • Verdadero: el usuario está activo.
  • Falso: el usuario está inactivo.

     
  Desplegable  VERDADERO

Salida

 Campo  Definición  Tipo
 Respuesta    
 Código de estado 

 Estado HTTP de la solicitud.
 Códigos que indican una actualización de estado activo exitosa:

  • 200: Listo

 Códigos que indican una actualización de estado activo incorrecta:

  • 400: solicitud con formato incorrecto
  • 401: sin autorización
  • 403: prohibido
  • 404: no encontrado
  • 409: conflicto
  • 429: demasiadas solicitudes
 Número


Conector de administración de Miro

El conector de administración de Miro permite a los clientes empresariales crear equipos y gestionar la configuración y los miembros de esos equipos.

Autorizar tu conector de administración de Miro:

Cuando añadas una tarjeta Miro a un flujo por primera vez, te pediremos que configures una conexión para tu organización. Consulta Autorización.

Tarjetas de acción del Conector de administración de Miro:

 Acción  Descripción
 Crear equipo  Crea un equipo nuevo en una organización existente.
 Buscar equipos Busca equipos existentes en una organización. Los primeros 10 registros coincidentes se seleccionan del conjunto de resultados.
 Agregar miembro al equipo  Añade un nuevo miembro a un equipo existente.
 Actualizar rol de miembro del equipo  Actualiza el rol de un miembro del equipo en un equipo existente.
 Obtener configuración del equipo  Recupera la configuración de un equipo existente.
 Actualizar la configuración de las políticas de uso compartido del equipo  Actualiza la configuración de la política de uso compartido de un equipo existente.
 Actualizar la configuración de invitación del equipo  Actualiza la configuración de la política de invitación de un equipo existente.
 Actualizar los ajustes de colaboración del equipo  Actualiza los ajustes de la política de colaboración de un   equipo existente.
 Actualizar los ajustes de descubrimiento del equipo  Actualiza los ajustes de la política de descubrimiento de un   equipo existente.
 Actualizar los ajustes de acceso de copia del equipo  Actualiza los ajustes de la política de acceso de copia de un   equipo existente.
Eliminación de sesiones de usuario (BETA) Elimina todas las sesiones de usuario para una dirección de correo electrónico determinada.

 

Autorización

El conector de administración de Miro funciona con el token de la API de OAuth. El conector de administración de Miro solo está disponible para los clientes del plan Enterprise. Para crear una nueva conexión, los usuarios deben tener los permisos necesarios para instalar aplicaciones con los alcances compatibles que se indican a continuación.

Puedes crear y administrar múltiples conexiones desde la Conexiones página.
Esto es útil si planeas operar con múltiples organizaciones. Cada conexión del conector de administración de Miro puede vincularse a una sola organización de Miro.

Para crear una nueva conexión desde una tarjeta de acción:

  1. Haz clic en Nueva conexión.
  2. Ingresa un Nombre de la conexión. Recomendamos usar un nombre que represente a la organización.
  3. Obtén el ID de la organización y el token de acceso de la página de integración de Enterprise de Miro, siguiendo las instrucciones.
  4. Haz clic en Crear. Esto guarda tu conexión y te lleva de nuevo a tu flujo.

Alcances admitidos:

  • organizations:teams:write
  • organizations:teams:read

Crear equipo

Crea un equipo en una organización existente.

Entrada

Campo Definición Tipo   Requerido  
Equipo   
 Nombre del equipo   El nombre del equipo.    String  VERDADERO

Salida

 Campo  Definición  Tipo
Respuesta
 ID del equipo  El ID del nuevo equipo.  Cadena

 

Buscar equipos

Buscar equipos existentes en una organización. Los primeros 10 registros coincidentes se seleccionan del conjunto de resultados.

Entrada

 Campo  Definición  Tipo  Requerido  
Consulta    
Nombre del equipo Palabras que deben coincidir con el nombre del equipo. Cualquier equipo cuyo nombre contenga esas palabras exactas se mostrará como conjunto de resultados. Los equipos cuyo nombre coincida exactamente con la consulta aparecerán primero en los resultados.  Cadena  FALSO

Salida

 Campo  Definición   Tipo
Respuesta    
Equipos Lista con los primeros diez equipos encontrados. Cada equipo tiene los campos que se muestran a continuación.  Lista  
ID del equipo El ID del equipo  Cadena
Nombre Nombre del equipo  Cadena

 

Añadir un miembro al equipo

Añade un nuevo miembro a un equipo existente.

Entrada

  Campo  Definición  Tipo  Obligatorio  
Equipo    
 ID del equipo  El ID del equipo.  Cadena    VERDADERO
Miembro  
 Correo electrónico del usuario    El correo electrónico del usuario que quieres agregar al equipo.    String  TRUE

Salida

 Campo  Definición   Tipo
Respuesta    
 ID del miembro    El ID del nuevo miembro del equipo.   Cadena  


Actualizar rol de un miembro del equipo

Actualiza el rol de un miembro del equipo en un equipo existente.

Entrada

 Campo  Definición  Tipo  Obligatorio  
Equipo      
 ID del equipo  El ID del equipo.  Cadena  VERDADERO
Miembro    
 ID del miembro  El ID del miembro del equipo.  Cadena  TRUE
 Rol

 El nuevo rol del miembro en el equipo.

  • Miembro: miembro regular.
  • Admin: miembro con privilegios de admin en el equipo.
  • Invitado al equipo: invitado con privilegios limitados.

     
  Desplegable    VERDADERO

Resultado

 Campo  Definición  Tipo     
Respuesta    
 ID del miembro    El ID del miembro del equipo.  String
Rol

 El nuevo rol asignado al miembro del equipo.

  • member: miembro regular.
  • admin: miembro con privilegios de admin en el equipo.  
  • team_guest: invitado con privilegios limitados.
 String

 

Obtener ajustes de equipo

Recupera los ajustes de un equipo existente.

Entrada

Campo Definición Tipo  Obligatorio 
Equipo     
 ID del equipo   El ID del equipo.   Cadena  VERDADERO

Resultado

 Campo   Definición  Tipo
Configuración de las invitaciones del equipo    
 Quién puede invitar
  • only_org_admins: solo los admins de empresa pueden invitar colaboradores.
  • admins: los admins de empresa y los admins de equipo pueden invitar colaboradores.
  • all_members: todos los miembros del equipo pueden invitar colaboradores.
 String
 Invitar usuarios externos
  • allowed: se admiten colaboradores que no sean miembros del equipo.
  • Not_allowed: no se admiten colaboradores que no sean miembros del equipo.
 Cadena
Ajustes de colaboración del equipo    
 Rol de copropietario
  • habilitado: se habilita el rol de copropietario en tableros y proyectos.
  • deshabilitado: se deshabilita el rol de copropietario en tableros y proyectos.
 Cadena
 Ajustes de nivel de acceso de copia del equipo    
 Nivel de acceso de copia
  • anyone: cualquier persona con acceso al tablero puede copiar el contenido existente del tablero a tableros recién creados.
    ADVERTENCIA: esta opción está disponible solo si Limitación del nivel de acceso de copia está establecida en anyone.
  • team_members: los miembros del equipo pueden copiar el contenido existente del tablero a tableros recién creados.
  • team_editors: los miembros del equipo con derechos de edición pueden copiar el contenido del tablero existente en tableros recién creados.
  • board_owner: solo los propietarios pueden copiar el contenido del tablero existente en tableros recién creados.
 String
 Limitación a nivel de acceso de copia
  • anyone: los miembros del equipo y los usuarios externos al equipo pueden obtener permiso para copiar el contenido del tablero.
  • team_members: solo los miembros del equipo pueden recibir permiso para copiar el contenido del tablero.
 String
Configuración de descubrimiento de equipos    
 Descubrimiento
  • hidden: solo los usuarios invitados pueden ver y acceder al equipo.
  • request: los miembros de la organización pueden encontrar el equipo y solicitar unirse al equipo con la aprobación del admin.
  • join: los miembros de la organización pueden encontrar y unirse al equipo.
 String
 Configuración de la política de uso compartido del equipo    
 Acceso predeterminado al tablero
  • privado: solo los propietarios pueden acceder a los tableros.
  • ver: cualquier miembro del equipo puede ver los tableros.
  • comentar: cualquier miembro del equipo puede añadir comentarios a los tableros.
  • editar: cualquier miembro del equipo puede editar los tableros.
 String
 Acceso predeterminado a la organización 
  • privado: solo los propietarios del tablero pueden acceder a los tableros.
  • ver: cualquier persona en la organización puede ver los tableros.
  • comentar: cualquier persona en la organización puede añadir comentarios a los tableros. 
  • editar: cualquier persona en la organización puede editar los tableros.
 Cadena 

 Compartir en   la organización

 
  •  
    • allowed: permite el uso compartido a nivel de la organización.
  • allowed_with_editing: permite el uso compartido con derechos de edición a nivel de la organización.
  • not_allowed: no permite el uso compartido a nivel de la organización.
 String
 Compartir en el equipo
  •  
    • allowed: permitir compartir a nivel de equipo.
  • allowed_with_editing: permitir compartir con derechos de edición a nivel de equipo.
  • not_allowed: no permitir compartir a nivel de equipo.
 String
 Compartir mediante enlace público   
  • allowed:permitir compartir mediante enlace público.
  • allowed_with_editing:permitir compartir con derechos de edición mediante enlace público.
  • not_allowed:no permitir compartir mediante enlace público.
 String
 Mover el tablero al equipo
  • allowed: se permite mover los tableros a un equipo diferente.
  • not_allowed: no se permite mover los tableros a un equipo diferente.
 String

 

Actualizar los ajustes de la política de uso compartido del equipo

Actualiza los ajustes para la política de uso compartido de un equipo existente.

Entrada

 Campo  Definición  Tipo  Obligatorio 
Equipo      
 ID del equipo  El ID del equipo.  Cadena  VERDADERO
 Acceso predeterminado   al tablero
  • Privado: solo los propietarios del tablero pueden acceder a los tableros.
  • Ver: cualquier persona en el equipo puede ver los tableros.
  • Comentar: cualquier persona en el equipo puede agregar  comentarios a los tableros.
  • Editar: cualquier persona en el equipo puede editar los tableros.
 Desplegable   FALSO
 Acceso predeterminado a la organización
  • Privado: solo los propietarios del tablero pueden acceder a los tableros.
  • Ver: cualquier persona en el equipo puede ver los tableros.
  • Comentario: cualquier persona en el equipo puede añadir comentarios a los tableros.
  • Editar: cualquier persona en el equipo puede editar los tableros.
 Desplegable  FALSO
 Compartir mediante enlace público   
  • Permitido: permitir compartir mediante enlace público.
  • Permitido con edición: permitir compartir con derechos de edición mediante enlace público.
  • No permitido: no permitir compartir mediante enlace público.
 Menú desplegable  FALSO
 Compartir en el equipo
  • Permitido: permitir el uso compartido a nivel del equipo.
  • Permitido con edición: permitir el uso compartido con derechos de edición a nivel del equipo.
  • No permitido: no se permite el uso compartido a nivel del equipo.
 Desplegable  FALSO

 Compartir en   la organización

 
  • Permitido: se permite el uso compartido a nivel de la organización.
  • Permitido con edición: se permite compartir con derechos de edición a nivel de la organización.
  • No permitido: no se permite el uso compartido a nivel de la organización.
 Menú desplegable  FALSO
 Mover el tablero al equipo
  • Permitido se permite mover tableros a un equipo diferente.
  • No permitido no se permite mover tableros a un equipo diferente.
 Desplegable  FALSO

Resultado

 Campo  Definición  Tipo
 Ajustes de política de uso compartido del equipo  
 Acceso predeterminado al tablero
  • privado: solo los propietarios del tablero pueden acceder a los tableros.
  • ver: cualquier persona en el equipo puede ver los tableros.
  • comentario: cualquier persona en el equipo puede añadir comentarios a los tableros.
  • editar: cualquier persona en el equipo puede editar los tableros.
 Cadena  
 Acceso predeterminado a la organización
  • privado: solo los propietarios pueden acceder a los tableros.
  • ver: cualquier persona en la organización puede ver los tableros.
  • comentar: cualquier persona en la organización puede añadir comentarios a los tableros.
  • editar: cualquier persona en la organización puede editar los tableros.
 String

 Compartir en   la organización

 
  •  
    • permitido: permitir el uso compartido a nivel de la organización.
  • permitido con edición: permitir el uso compartido con derechos de edición a nivel de la organización.
  • no permitido: no permitir el uso compartido a nivel de la organización.
 String
 Compartir en el equipo
  •  
    • allowed: se permite el uso compartido a nivel del equipo.
  • allowed_with_editing: se permite el uso compartido con derechos de edición a nivel del equipo.
  • not_allowed: no se permite el uso compartido a nivel del equipo.
 String
 Compartir mediante enlace público   Link
  •  
    • allowed: permitir compartir mediante enlace público.
  • allowed_with_editing: permitir compartir con derechos de edición mediante enlace público.
  • not_allowed: no permitir compartir mediante enlace público.
 String
 Mover el tablero al equipo
  • allowed: permitir mover tableros a un equipo diferente.
  • not_allowed: no permitir mover tableros a un equipo diferente.
 String

 

Actualizar los ajustes de invitación del equipo

Actualiza los ajustes de la política de invitación de un equipo existente.

Entrada

 Campo  Definición  Tipo  Obligatorio 
Equipo      
 ID del equipo  El ID del equipo.  Cadena  VERDADERO
 Invitar usuarios externos
  • Permitido: admitir colaboradores que no sean miembros del equipo.
  • No permitido: no admitir colaboradores que no sean miembros del equipo.
 Desplegable   FALSO
 Quién puede invitar
  • Solo los admins de empresa: solo los admins de empresa pueden invitar colaboradores.
  • Admins: los admins de empresa y los admins de equipo pueden invitar colaboradores.
  • Todos los miembros: todos los miembros del equipo pueden invitar colaboradores.
 Menú desplegable  FALSO

Salida

 Campo  Definición  Tipo
Configuración de invitaciones del equipo    
 Invitar usuarios externos  
  • allowed: se admiten colaboradores que no sean miembros del equipo.
  • Not_allowed: no se admiten colaboradores que no sean miembros del equipo.
 Cadena  
 Quién puede invitar
  • only_org_admins: solo los admins de empresa pueden invitar colaboradores.
  • admins: los admins de empresa y los admins de equipo pueden invitar colaboradores.
  • all_members: todos los miembros del equipo pueden invitar colaboradores.
 Cadena

 

Actualizar los ajustes de acceso de copia del equipo

Actualiza los ajustes de la política de acceso de copia de un equipo existente.

Entrada

 Campo  Definición  Tipo  Obligatorio 
Equipo      
 ID del equipo  El ID del equipo.  Cadena  SÍ
 Nivel de acceso de copia
  • cualquiera: cualquier persona con acceso al tablero puede copiar el contenido existente del tablero a tableros recién creados.
  • Miembros del equipo: los miembros del equipo pueden copiar el contenido existente del tablero a los tableros recién creados.
  • Editores del equipo: los miembros del equipo con derechos de edición pueden copiar el contenido existente del tablero a los tableros recién creados.
  • board_owner: solo los propietarios del tablero pueden copiar el contenido existente del tablero en tableros recién creados.
 Desplegable   FALSO
 Limitación a nivel de acceso de copia
  • Cualquier persona: los miembros del equipo y los usuarios externos al equipo pueden obtener permiso para copiar el contenido del tablero.
  • Miembros del equipo: solo los miembros del equipo pueden recibir permiso para copiar el contenido del tablero.
 Lista desplegable  FALSO

Resultado

 Campo  Definición  Tipo
Ajustes de acceso de copia del equipo    
 Nivel de acceso de copia
  • anyone: cualquier persona con acceso al tablero puede copiar el contenido existente del tablero a tableros recién creados.
  • team_members: los miembros del equipo pueden copiar el contenido existente del tablero a tableros recién creados.
  • team_editors: los miembros del equipo con derechos de edición pueden copiar el contenido existente del tablero a tableros recién creados.
  • board_owner: solo los propietarios del tablero pueden copiar el contenido existente en tableros recién creados.
 String
 Limitación a nivel de acceso de copia
  • anyone: los miembros del equipo y los usuarios externos al equipo pueden obtener permiso para copiar el contenido del tablero.
  • team_members: solo los miembros del equipo pueden recibir permiso para copiar el contenido del tablero.
 String

 

Actualizar los ajustes de colaboración del equipo

Actualiza la configuración de la política de colaboración de un equipo existente.

Entrada

 Campo  Definición  Tipo  Obligatorio 
Equipo      
 ID del equipo El ID del equipo. Cadena VERDADERO
 rol de copropietario
  • Habilitado: habilita el rol de copropietario en tableros y proyectos.
  • Deshabilitado: deshabilita el rol de copropietario en tableros y proyectos.
 Desplegable   FALSO

Salida

 Campo  Definición  Tipo
Ajustes de colaboración del equipo    
 Rol de copropietario
  • habilitado: se habilita el rol de copropietario en tableros y proyectos.
  • deshabilitado: se deshabilita el rol de copropietario en tableros y proyectos.
 String

 

Actualizar los ajustes de descubrimiento del equipo

Actualiza la configuración de la política de descubrimiento de un equipo existente.

Entrada

 Campo  Definición  Tipo  Obligatorio 
Equipo      
 ID del equipo  El ID del equipo.  Cadena  SÍ
 Descubrimiento
  • Oculto: solo los usuarios invitados pueden ver y acceder al equipo.
  • Solicitud: los miembros de la organización pueden encontrar y solicitar unirse al equipo con la aprobación del admin.
  • Unirse: los miembros de la organización pueden encontrar y unirse al equipo.
 Desplegable   FALSO

Salida

 Campo  Definición  Tipo
Configuración del descubrimiento de equipos    
 Descubrimiento
  • hidden: solo los usuarios invitados pueden ver y acceder al equipo.
  • request: los miembros de la organización pueden encontrar el equipo y solicitar unirse; se requiere la aprobación del admin.
  • join: los miembros de la organización pueden encontrar y unirse al equipo.
 Cadena

 

Eliminar sesiones de usuario

Elimina todas las sesiones de un usuario para una dirección de correo electrónico determinada.

Entrada

 Campo  Definición  Tipo  Requerido  
Detalles del usuario      
 Correo electrónico La dirección de correo electrónico del usuario cuyas sesiones se eliminarán.  Cadena  TRUE

Resultado

 Campo  Definición  Tipo
 Respuesta    
 Código de estado 

 Estado HTTP de la solicitud.
 Códigos que indican una actualización exitosa de eliminación de la sesión de usuario:

  • 200: Sesión de usuario eliminada

 Códigos que indican una actualización fallida de eliminación de la sesión de usuario:

  • 400: solicitud con formato incorrecto
  • 401: sin autorización
  • 403: prohibido
  • 404: no encontrado
  • 409: conflicto
  • 429: Demasiadas solicitudes
 Número 
¿Te resultó útil este artículo?
Sí, gracias No realmente
¡Lo lamentamos! ¿Por qué no te resultó útil el artículo?
If you would like to get a reply from the Miro Support team, please create a ticket here
Thank you for your feedback!
Error! Please try later...
Regresar al inicio

Artículos relacionados