Sie lesen die Dokumentation zu Icon Map Pro für Version 1.1.0.11, die noch nicht veröffentlicht wurde. Zur aktuellen Version (1.1.0.10).

Sicherheit und Zertifizierung

Diese Seite richtet sich an Administratoren und Sicherheitsprüfer. Sie erklärt, was innerhalb des Visuals bleibt, mit welchen Diensten sich Icon Map Pro verbindet und was es an diese sendet und warum das Visual nicht von Microsoft zertifiziert ist.

Zusammenfassung

Power BI übergibt die Felder, die Sie hinzufügen, an Icon Map Pro. Das Visual läuft in der Sandbox von Power BI und zeichnet Ihre Zeilen dort. Karten kommen von Icon Map-Diensten herein, und nur Kachelanfragen und die Lizenzprüfung gehen hinaus
Ihre Daten kommen aus Power BI, und Karten kommen von Icon Map
  • Icon Map Pro läuft in der Sandbox von Power BI für benutzerdefinierte Visuals, im Browser oder in Power BI Desktop. Power BI übergibt ihm nur die Felder, die Sie ihm hinzufügen.
  • Es zeichnet Ihre Daten innerhalb des Visuals. Nichts aus Ihren Berichtsdaten wird an Icon Map gesendet.
  • Es lädt Grundkarten und alle Ebenen, die Sie verlinken, von externen Diensten. Das braucht eine Karte, und es ist der Grund, warum das Visual nicht zertifiziert werden kann.
  • Ein Server, den Sie mit Ihren Daten verbinden, etwa eine damit verknüpfte ArcGIS-Ebene, erhält die Werte, die er für den Abgleich braucht. Diese Server wählen Sie selbst.
  • Es sendet Telemetrie zur Funktionsnutzung, die keine Berichtsdaten enthält und die Sie ausschalten können.
  • In der Engine Modern sind die verwendeten JavaScript-Bibliotheken im Visual enthalten. Zur Laufzeit wird keine davon aus dem Internet geladen.

Ihre Berichtsdaten

  • Icon Map Pro zeichnet Ihre Zeilen selbst, innerhalb des Visuals. Es gibt keinen Geocodierungsdienst, an den Ihre Zeilen gesendet werden: Sie liefern Koordinaten, Formen oder Werte, die zu Features passen.
  • Routen und Flusslinien werden innerhalb des Visuals berechnet.
  • Nichts aus Ihren Berichtsdaten wird an die Dienste von Icon Map gesendet: weder an die Grundkarten noch an die Lizenzprüfung, die Telemetrie oder den Icon Map-Katalog.
  • Das Steuerelement Suchen schlägt Orte in einem Index nach, den das Visual herunterlädt. Es sucht nach dem, was ein Leser eingibt, nicht nach Ihren Daten.
  • Wenn Sie einen ArcGIS-Feature-Layer über das Feld Feature-Referenz mit Ihren Daten verknüpfen, fragt das Visual diesen ArcGIS-Server nach den passenden Features. Die abzugleichenden Werte werden als Teil der Abfrage an diesen Server gesendet.
  • Ein Link, den Sie mit bedingter Formatierung aus Ihren Daten aufbauen, etwa ein Dateilink oder ein Filterwert, wird als Teil der Anfrage an den Server gesendet, auf den der Link zeigt.
  • QuickInfos, Auswahl und Kreuzfilterung laufen über die eigenen Schnittstellen von Power BI.

Was das Visual tun darf

Power BI führt jedes benutzerdefinierte Visual in einer Sandbox aus: einem separaten Frame, der weder die Berichtsseite noch die anderen Visuals darauf oder Ihre Power BI-Anmeldung lesen kann. Power BI übergibt dem Visual nur die Felder, die Sie ihm hinzufügen, und das Visual gibt Auswahlen und QuickInfos über Power BI zurück.

Power BI gewährt einem benutzerdefinierten Visual außerdem nur die Berechtigungen, die es deklariert. Icon Map Pro deklariert drei:

Berechtigung Warum
Webzugriff Um Grundkarten, Kacheln, Dateien und Dienste zu laden, Lizenzschlüssel zu prüfen und Telemetrie zu senden
Lokaler Speicher Optional. Um die ArcGIS-Anmeldung einer Person auf ihrem eigenen Gerät zu merken. Wird beachtet, wenn ein Administrator den lokalen Speicher für benutzerdefinierte Visuals ausschaltet
Microsoft Entra-Anmeldung für https://api.iconmap.ai Nur für Organisationen, die Icon Map for Fabric verwenden. Um Sie mit Ihrem Power BI-Konto beim Icon Map-Katalog Ihrer Organisation in Microsoft Fabric anzumelden

Externe Dienste

Was Icon Map Pro an jeden Dienst sendet, mit dem es sich verbindet, und was es zurückerhält. Zeilen und Werte aus Ihren Daten, Inhalte von QuickInfos und das, was Leser auswählen, werden nie an Icon Map gesendet
Was das Visual an jeden Dienst sendet und was es zurückerhält

Jeder Dienst wird nur kontaktiert, wenn die Funktion, die ihn nutzt, verwendet wird. Die Adressen sind für Firewallregeln unter Unterstützte Umgebungen und Grenzen aufgeführt.

Was Dienst Wann
Icon Map-Grundkarten: die Liste der Stile, die Stile, Kartenkacheln, Schriftarten, Schummerung und Gelände Icon Map (styles.iconmappro.com) Eine Icon Map-Grundkarte, Schummerung, Gelände oder Kartenbeschriftungen werden verwendet
Bilder der Symbolbibliothek Icon Map Symbole aus der Symbolbibliothek werden verwendet
Ortssuche Icon Map (styles.iconmappro.com) Das Steuerelement Suchen ist eingeschaltet. Es lädt einen Ortsindex herunter
Suche im Icon Map-Katalog: Datensätze finden und ihre Details lesen Icon Map (catalogapi.icon-map.com) Sie den Icon Map-Katalog durchsuchen oder seine Ebenen verwenden
Ebenen des Icon Map-Katalogs: Kacheln und Daten Icon Map (catalog.icon-map.com) Katalogebenen werden verwendet
Der Icon Map-Katalog Ihrer Organisation Icon Map (api.iconmap.ai) Nur mit Icon Map for Fabric, wenn Sie den Katalog Ihrer Organisation durchsuchen
Überprüfung von Lizenzschlüsseln Icon Map (validate.iconmappro.com, validate2.iconmappro.com) Der Bericht verwendet einen Lizenzschlüssel
Azure Maps, ArcGIS, Mappable, Ordnance Survey, Open Weather Map Der von Ihnen gewählte Anbieter Sie wählen diesen Anbieter aus. Ihr API-Schlüssel dafür wird an diesen Anbieter gesendet
Ihre eigenen Raster-, Vektor-, WMS-, WFS- und ArcGIS-Server Der Server in dem Link, den Sie eingeben Sie fügen eine Grundkarte oder Ebene über einen Link hinzu
Bilder, GeoJSON, KML und andere Dateien per Link Der Server im Link Sie fügen eine Bild- oder Dateiebene über einen Link hinzu
Der Icon Map-Proxy Icon Map (proxy.icon-map.com) Nur wenn ein Proxy-Schalter eingeschaltet ist. Siehe den nächsten Abschnitt
Telemetrie Azure Application Insights, UK South Sofern Telemetrie deaktivieren nicht eingeschaltet ist

Um jeden Aufruf von Icon Map-Diensten zu unterbinden, schalten Sie Airgap-Umgebung ein. Siehe Power BI Report Server (lokal).

Grundkarten und Funktionen, die zur Engine Legacy gehören, etwa Hintergründe von Google Maps, Mapbox und MapTiler, sind in der Dokumentation für 1.1.0.9 und früher beschrieben.

Der Proxy

Der Icon Map-Proxy ist standardmäßig ausgeschaltet. Wenn Sie ihn für einen Server einschalten, der Power BI das Lesen nicht erlaubt, laufen Anfragen an diesen Server unterwegs über ein von Icon Map betriebenes Relay, zusammen mit allen daran angehängten Anmeldeinformationen, und das Relay gibt die Antwort zurück. Seine Protokolle speichern die Website und den Pfad jeder Anfrage, nicht die Abfrage und nicht, was gesendet wurde.

API-Schlüssel, Authentifizierung und der Proxy beschreibt genau, wann der Proxy verwendet wird und was an ihn gesendet wird.

Anmeldeinformationen

  • API-Schlüssel von Anbietern und der Icon Map-Lizenzschlüssel werden als Einstellungen im Bericht gespeichert. Behandeln Sie einen Bericht, der sie enthält, entsprechend.
  • Ein geheimer ArcGIS-Clientschlüssel wird in geschützter Form gespeichert.
  • Persönliche ArcGIS-Anmeldungen werden im lokalen Speicher des Visuals auf dem Gerät des Lesers gehalten, nicht im Bericht.

Siehe API-Schlüssel, Authentifizierung und der Proxy und Mit ArcGIS verbinden.

Lizenzprüfungen

  • Benutzerlizenzen werden von Power BI geprüft. Das Visual fragt Power BI, welche Icon Map-Pläne der angemeldete Benutzer hat. Dafür wird nichts an Icon Map gesendet.
  • Lizenzschlüssel werden online beim Icon Map-Lizenzierungsdienst überprüft. Ein per Schlüssel lizenziertes Visual zeichnet bei diesem Dienst außerdem die Nutzung auf, wenn es Daten lädt: den Schlüssel, die Umgebung, in der es ausgeführt wird, das Produkt, die optionale Referenz, die Instanz-ID des Visuals und eine Sitzungs-ID. Nutzungsbasierte Lizenzen werden auf diese Weise gemessen. Die Nutzung von Icon Map-Katalogebenen wird der Lizenz zugeordnet.

Telemetrie

Icon Map Pro sendet Telemetrie zur Funktionsnutzung an Azure Application Insights in der Region UK South. Sie dient dazu, zu verstehen, welche Funktionen genutzt werden, und Fehler zu diagnostizieren.

  • Was gesendet wird. Eine Liste der Funktionen, die eine Karte nutzt, nicht Ihre Daten: die Karten-Engine und Projektion, der Typ der Grundkarte und der Icon Map-Stil, ob die Schummerung eingeschaltet ist, welche Referenzebenen und Datenebenen eingeschaltet sind, die Bildquelle, die Anzahl der Formenstufen und bei Icon Map-Katalogebenen deren Name, ID, Zugriffstyp und Sichtbarkeit. Jedes Ereignis enthält außerdem die Instanz-ID des Visuals, seine Version, die Umgebung, in der es ausgeführt wird, und ob der Bericht bearbeitet oder gelesen wird.
  • Fehler. Fehler wie eine fehlgeschlagene Lizenzüberprüfung werden als Ausnahmen gesendet. Bevor ein Fehler gesendet wird, werden Text in Anführungszeichen, Zahlen und Webadressen aus seiner Meldung entfernt, sodass er keinen Wert aus Ihrem Bericht enthalten kann.
  • Was nicht erfasst wird. Die automatische Erfassung von Seitenaufrufen und Netzwerkanfragen ist ausgeschaltet. Es werden nur die oben genannten Ereignisse gesendet. Daten aus Ihrem Bericht sind nicht enthalten.
  • Abmelden. Schalten Sie Formatbereich > Icon Map Pro > Informationen für den Support > Telemetrie deaktivieren ein. Die Telemetrie startet erst, wenn das Visual diese Einstellung gelesen hat. Ein Bericht, der sich abmeldet, sendet also überhaupt nichts.
  • Detaillierte Telemetrie. Zusätzliche Diagnoseereignisse werden nur gesendet, solange Detaillierte Telemetrie für den Support eingeschaltet ist. Lassen Sie die Einstellung ausgeschaltet, sofern der Support nicht darum bittet.

Zertifizierung durch Microsoft

Icon Map Pro kann nicht von Microsoft zertifiziert werden. Eine der Anforderungen an ein zertifiziertes Visual ist, dass es nicht auf externe Dienste zugreift:

Accessing external services or resources. For example, no HTTP/S or WebSocket requests can go out of Power BI to any services.

Hintergrundkarten sind zu groß, um sie in einem Visual zu speichern. Sie müssen deshalb von einer externen Quelle bereitgestellt werden. Die vollständigen Kriterien finden Sie in der Microsoft-Dokumentation zu zertifizierten Visuals.

Nicht zertifizierte Visuals sind in meiner Organisation nicht erlaubt

Wenn Sie einen Bericht im Power BI-Dienst veröffentlichen, sehen Sie anstelle des Visuals möglicherweise diese Meldung:

Meldung von Power BI: Uncertified visuals from AppSource, or added from a file, are not available due to your admin settings
Die Meldung, die Power BI zeigt, wenn nicht zertifizierte Visuals blockiert sind

Sie bedeutet, dass nicht zertifizierte Visuals in Ihrem Power BI- oder Microsoft Fabric-Mandanten nicht erlaubt sind. Ein Administrator kann für ein bestimmtes Visual eine Ausnahme machen, indem er es als Organisationsvisual hinzufügt. Es kann dann in der gesamten Organisation verwendet werden. Siehe die Anleitung von Microsoft zu Organisationsvisuals.

Sicherheitsprüfungen des Codes

Wir unterstützen Sicherheitsprüfungen des Codes gern. Wir können den Quellcode unter einer Vertraulichkeitsvereinbarung (NDA) freigeben, damit das IT-Sicherheitsteam Ihrer Organisation ihn prüfen kann. Wenden Sie sich an support@icon-map.com.

Verwandte Themen