Configurar la publicación y la inserción

Cuando publica un mapa para verlo fuera de Fabric, el visor insertado público lee los archivos publicados y congelados desde su OneLake. Para ello usa una entidad de servicio de inserción dedicada de Icon Map (Tekantis.IconMap-Embed): una identidad de solo lectura sin permisos de API propios.

Usted no concede a esta entidad de servicio acceso a su área de trabajo. La publicación escribe sus mapas publicados en un Lakehouse de su área de trabajo y concede a la entidad de servicio de inserción un rol de acceso a datos de OneLake de solo lectura únicamente sobre ese Lakehouse, de forma automática, con su propia identidad, como parte de la publicación. El resultado: el servicio de inserción puede leer lo que usted publica y nada más, sin acceso de escritura a su área de trabajo.

Complete primero la configuración del inquilino para la publicación. Para la mayoría de los mapas no hay que hacer nada más: publique y funciona.

Agregar la entidad de servicio de inserción a su inquilino (una vez)

La entidad de servicio de inserción debe existir en su inquilino de Microsoft Entra antes de que se pueda mostrar cualquier cosa publicada desde él. Un administrador de Entra (Administrador de aplicaciones en la nube o superior) la agrega una vez, por ejemplo en Azure Cloud Shell:

az ad sp create --id f702e4a2-fd42-4c03-b842-61ab0957836a

Si su administrador incorporó el inquilino con Onboard-IconMapTenant.ps1, esto ya está hecho. Esto no le concede nada por sí solo: no tiene permisos de API, y su único acceso es el rol de solo lectura que le otorga la publicación (más abajo). Mientras no se agregue, Icon Map se niega a publicar y explica el motivo. Un mapa publicado antes no se carga y, en su lugar, indica que su organización no ha agregado el servicio de inserción de Icon Map a su inquilino de Microsoft Entra: vuelva a publicarlo cuando la entidad de servicio ya exista.

Qué ocurre automáticamente

La primera vez que publica en un área de trabajo, Icon Map crea un Lakehouse llamado IconMap_Published para guardar los mapas publicados y añade la entidad de servicio de inserción a un rol de acceso a datos de solo lectura (IconMapEmbedReaders) sobre él. Todas las publicaciones posteriores los reutilizan. No se necesita ninguna acción de un administrador, siempre que el usuario que publica pueda crear elementos y administrar el acceso a datos de OneLake en el área de trabajo (un Miembro o un Administrador del área de trabajo pueden hacerlo).

Los conjuntos de teselas ráster grandes (PMTiles/COG) no se copian: se leen en su ubicación, desde su propio Lakehouse, para que sigan actualizados. La publicación también concede a la entidad de servicio de inserción permiso de lectura sobre esos Lakehouse de origen, de la misma forma.

Cuando tiene que intervenir otra persona

Capas compartidas de un catálogo organizativo. Si su mapa usa capas ráster de un catálogo organizativo cuyo Lakehouse usted no administra, no puede conceder allí permiso de lectura a la entidad de servicio de inserción. Lo hace una vez el propietario del catálogo (concede a Tekantis.IconMap-Embed un rol de acceso a datos de solo lectura sobre el Lakehouse del catálogo) y, a partir de ese momento, todos los mapas que usan ese catálogo funcionan sin más. Si no se ha hecho, el cuadro de diálogo de publicación le indica qué capa se ve afectada; el resto del mapa se publica igualmente.

Áreas de trabajo restringidas. Si su organización no permite a los usuarios crear elementos, un administrador puede crear de antemano el Lakehouse IconMap_Published y conceder una vez a la entidad de servicio de inserción permiso de lectura sobre él; después, los autores publican en él. En cualquier caso, el permiso es de solo lectura, nunca de Colaborador del área de trabajo.

Permisos adicionales para mapas con datos en directo

Una publicación de instantánea no necesita nada más. Si un mapa publicado sirve datos en directo, la entidad de servicio de inserción también necesita llegar a esos orígenes de consulta:

  • Eventhouse / KQL: conceda a la entidad de servicio el rol Espectador sobre la base de datos KQL concreta (Eventhouse → base de datos → Administrar permisos).
  • Modelos semánticos de Power BI: habilite Las entidades de servicio pueden usar las API de Power BI (en la configuración del inquilino).
  • Lakehouse / Warehouse: no se necesita ningún permiso adicional; el rol de acceso a datos de solo lectura anterior cubre las lecturas de tablas Delta.

Comprobar

Publique un mapa de prueba, abra el vínculo de inserción y confirme que se carga. Si falta una capa ráster, busque en el cuadro de diálogo de publicación una advertencia sobre la inserción del catálogo (véase más arriba). Si todo el mapa muestra "este mapa se tiene que volver a publicar", vuelva a publicarlo desde el editor actual. Los vínculos publicados se pueden revocar en cualquier momento desde la administración de publicaciones.

Pasos siguientes