Idioma
Español

Inserción para su organización

Hay dos formas de insertar un Icon Map, y cada una se adapta a un público distinto.

Insertar mapas trata la primera: un mapa publicado, congelado y servido a usuarios que no tienen ningún acceso a Fabric. Esta página trata la segunda: un mapa en vivo dentro de su propia aplicación interna, donde cada usuario inicia sesión con su propia identidad.

Si conoce la inserción de Power BI, son los mismos dos modelos: "insertar para sus clientes" e "insertar para su organización".

Qué es

El mapa se inserta en su aplicación y se usa la propia identidad de Microsoft Entra de cada usuario para leer los datos. Esto significa que:

  • Los usuarios ven solo los datos que permiten sus propios permisos de Fabric, y la seguridad de nivel de fila se aplica automáticamente: la misma RLS que ya imponen sus modelos de Fabric y Power BI. No hay nada que configurar en Icon Map.
  • Los datos están en vivo: se leen en el momento en que se abre el mapa, no son una instantánea.
  • No hay ninguna entidad de servicio lectora ni ninguna copia publicada. Icon Map nunca puede acceder a nada que el usuario no pudiera abrir ya por sí mismo.

El mapa es de solo lectura: los usuarios pueden explorar, filtrar, usar marcadores de vista y rellenar formularios de reescritura, pero no hay creación ni forma de acceder al editor.

Cuándo usar cada modo

Insertar mapas Inserción para su organización
¿Los usuarios inician sesión? No Sí, con su propia cuenta profesional
Quién lee los datos Una identidad lectora El usuario
Seguridad de nivel de fila No por usuario RLS nativa de Fabric / Power BI, por usuario
Datos Instantánea, o consultas en vivo fijadas En vivo, como el usuario
Público Cualquiera: clientes, el público general Personas de su organización con acceso a los datos
Uso típico Un sitio público, un portal de clientes Un portal de operaciones, una intranet, una aplicación de línea de negocio

No hay que preocuparse por licencias por usuario: Fabric se factura por capacidad, así que el público son simplemente las personas de su directorio que tienen permiso para ver los datos subyacentes.

Este modo no se puede usar para compartir públicamente. Cada usuario inicia sesión, por lo que no existe un vínculo anónimo.

Qué necesita

  • Un Icon Map creado con el workload de Icon Map en un área de trabajo de Fabric, en una capacidad de Fabric (F o de prueba).
  • Usuarios con permiso de Fabric sobre el elemento de mapa y sobre los datos que hay detrás, concedido de la forma habitual: compartiendo el elemento o el área de trabajo.
  • Una aplicación de Entra que pueda emitir los tokens con los que lee el mapa. La aplicación depende de cómo gestione el inicio de sesión:
    • Su aplicación proporciona el token (la opción habitual): se usa su propia aplicación de Entra, y la aplicación de visor de Icon Map no interviene en absoluto. Su aplicación necesita estos permisos delegados, con consentimiento en su inquilino: Azure Storage user_impersonation, Fabric/Power BI Workspace.Read.All, Item.Read.All y Dataset.Read.All, y Azure Data Explorer user_impersonation si el mapa lee un Eventhouse.
    • El mapa inicia la sesión del usuario: un consentimiento del administrador único para la aplicación Icon Map Embed Viewer en su inquilino.

Agregarlo a su aplicación

Inserte el mapa con el SDK de JavaScript de Icon Map. Apúntelo al elemento de mapa e indíquele cómo obtener un token:

<div id="map" style="height: 600px"></div>

<script type="module">
  import { embedForOrganization } from "@iconmap/embed";

  embedForOrganization(document.getElementById("map"), {
    mapItem: {
      workspaceId: "00000000-0000-0000-0000-000000000000",
      itemId: "00000000-0000-0000-0000-000000000000",
    },
    // Your application already signed this user in - hand over a token for
    // the scopes the map asks for.
    getToken: (scopes) =>
      msalInstance
        .acquireTokenSilent({ scopes, account })
        .then((result) => result.accessToken),
    onError: (error) => console.error(error),
  });
</script>

Encontrará los id. del área de trabajo y del elemento en la URL de Fabric del mapa.

Dos formas de gestionar el inicio de sesión

Su aplicación proporciona el token (el ejemplo anterior y la opción habitual). Los usuarios inician sesión una sola vez, en su aplicación, y el mapa reutiliza esa sesión. No les aparece nada adicional.

El mapa pide un token para el recurso que va a leer (su almacenamiento de OneLake, la API de Fabric, un clúster de Eventhouse), así que devuelva un token para los scopes que recibe en lugar de un único token fijo.

Como los tokens proceden de su aplicación de Entra, la aplicación de visor propia de Icon Map nunca se usa en este escenario y no necesita consentimiento.

El mapa inicia la sesión del usuario. Omita getToken y el mapa gestionará el inicio de sesión por sí mismo, mostrando un botón de inicio de sesión la primera vez. Es lo más sencillo de integrar, pero sus usuarios iniciarán sesión dos veces: una en su aplicación y otra en el mapa.

Controlar la sesión

const handle = embedForOrganization(element, options);

handle.signOut();  // drop the viewer's session and cached tokens
handle.reload();   // re-read the map as the viewer
handle.destroy();  // remove the map from the page

Seguridad

  • Privilegios mínimos por diseño. No hay ninguna identidad del proveedor en la ruta de los datos. Un usuario solo puede ver lo que ya tiene permiso para ver, y un usuario que pierde el acceso a los datos deja de verlos de inmediato, sin necesidad de volver a publicar.
  • La seguridad de nivel de fila es la de Fabric, no la nuestra. No hay que volver a definir nada de su RLS en Icon Map, así que nada puede quedar desfasado.
  • No se copia nada. No existe en ninguna parte una instantánea congelada de sus datos.
  • El único riesgo residual es el habitual de este modelo: un token de acceso robado funciona hasta que caduca. Los tokens son de corta duración, exactamente como en el modo equivalente de Power BI.

Encontrará más detalles en el documento técnico de seguridad.

Información importante

  • Los usuarios invitados (B2B) funcionan en la medida en que Fabric les conceda acceso a los datos. Icon Map no puede ampliar los escenarios de invitados entre inquilinos.
  • Los mapas creados con una compilación de desarrollo del workload no se pueden insertar de esta forma. Use mapas creados con el workload de Icon Map publicado.
  • La capacidad del área de trabajo del mapa debe estar en ejecución: una capacidad en pausa significa que nadie obtiene datos.

Pasos siguientes