Übermitteln von HAR-Debug-Dateien an Esri Support Services für die Problembehandlung und Überprüfung

Beschreibung

Debug-Dateien, die die Kommunikation zwischen einem Client-Computer und Server-Computern erfassen, wie z. B. zwischen dem Computer eines Benutzers und den ArcGIS Online-Servern, können eine maßgebliche Informationsquelle für das Lösen von Esri Support Cases darstellen.Während die Problembehandlung von Problemen in Bezug auf webbasierte Esri Anwendungen und Services über das Freigeben des Bildschirms und über das Telefon bevorzugt wird, erkennt Esri Support Services an, dass es in manchen komplexen oder dringenden Fällen erforderlich ist, dass Analysten Benutzer bitten, diese Debugdateien zur Problembehebung zur Verfügung zu stellen. Diese Debug-Dateien können entweder mit den Entwicklerwerkzeugen (DevTools) als HAR-Dateien im Webbrowser erfasst werden oder über ein Web-Erfassungs-Programm wie Fiddler von Telerik. 

Obwohl Debug-Dateien für das zügige Beheben von Problemen maßgeblich sein können, ist es wichtig, festzustellen, dass diese Dateien möglicherweise auch sensible Informationen enthalten können, unter anderem, aber nicht beschränkt auf:

• ArcGIS Autorisierungstoken
• Sensible URL-Abfrageparameter
• Sensible Informationen (Benutzernamen und Passwörter) im Anforderungstext
• Sensible Informationen (andere Abfrageparameter) im Anforderungstext
• Sensible Informationen in einem Antworttext
• Cookie-Details

Esri misst der Sicherheit und Privatsphäre der Daten seiner Kunden großen Wert bei und erkennt in diesem Hinblick die möglichen Sicherheits- und Datenschutz-Probleme im Zusammenhang mit der Freigabe von Debug-Dateien an. Zur Begrenzung dieser Risiken empfiehlt Esri das "Bereinigen" der Dateien (Anweisungen s. u.) vor dem Freigeben der Debug-Dateien von Kunden für den Esri Support.

Esri kann nicht zur Verantwortung gezogen werden, wenn dieser Hinweis ignoriert wird, und Esri kann die Debug-Dateien nicht für einen Kunden bereinigen. Auch wenn Esri Support Services gemäß der Richtlinie eine sichere Umgebung verwendet, um Kundendaten zu testen und Debug-Dateien von Kunden zu überprüfen, kann diese Umgebung notwendigerweise nicht vollständig isoliert werden und hat Zugriff auf:

• ArcGIS Online
• Von Esri verwaltete Services zum Übertragen von Dateien (schreibgeschütztes FTP zum Herunterladen der vom Kunden bereitgestellten Datasets)
• Esri Support-Case-Anlagen (schreibgeschütztes FTP zum Herunterladen der vom Kunden bereitgestellten Datasets)

Der Zugriff auf alle anderen Hosts wird verweigert.

Alle an Support Services gesendeten Dateien werden innerhalb von 90 Tagen gelöscht.

Wenn Zweifel hinsichtlich des Inhalts der Debug-Dateien oder hinsichtlich der von Esri bereitgestellten Verfahren zur Bereinigung von nachverfolgbaren Kundendaten bestehen, empfiehlt Esri, dass Benutzer NICHT die Freigabe von Debug-Dateien für Esri Support Services wählen, sondern mit den Support-Analysten über andere Methoden zusammenarbeiten, um das Problem zu beheben.

Lösung oder Problemumgehung

Erfassen von Debug-Dateien (HAR) im Browser

Die folgenden Anweisungen gelten für das Erfassen von Debug-Dateien mit üblichen Browsern. In jedem Fall ist es wichtig, nur den Datenverkehr zu erfassen, der während der problematischen Schritte auftritt, um die Erfassung unnötiger sicherer Informationen einzuschränken, die Dateigröße zu verkleinern und den nicht mit dem Problem in Verbindung stehenden Datenverkehr für die Problembehandlungsanalyse herauszufiltern.

Google Chrome

1. Öffnen Sie Google Chrome, und gehen Sie zu der Seite, auf der das Problem auftritt. Führen Sie alle Schritte in dem Prozess vor demjenigen, der das Problem verursacht, aus.
2. Klicken Sie im Browser oben rechts auf die vertikale Ellipsenschaltfläche (), und klicken Sie im Dropdown-Menü auf Weitere Tools und dann auf Entwicklertools.
3. Zum Abdocken des Bereichs "DevTools" klicken Sie auf die vertikale Ellipsenschaltfläche () im Bereich "DevTools", und wählen Sie die erste Option zum Anzeigen in einem separaten Fenster () im Abschnitt Seitliche fixieren aus.
4. Klicken Sie auf die Registerkarte Netzwerk.
5. Suchen Sie eine runde Aufnahme-Schaltfläche (  ) in der oberen linken Ecke, und vergewissern Sie sich, dass sie rot ist. Wenn sie grau ist, dann klicken Sie einmal darauf, um die Aufzeichnung zu starten.
6. Wählen Sie das Kontrollkästchen Protokoll beibehalten aus.
7. Klicken Sie auf die Schaltfläche "Löschen" (  ), um alle aktuellen Netzwerkanfragen aus dem Netzwerkfenster zu löschen.
8. Reproduzieren Sie den Fehler bei geöffneten DevTools, während die Anfragen aufgezeichnet werden.
9. Wenn Sie das Problem reproduziert haben, klicken Sie in Chrome auf den Pfeil nach unten "HAR exportieren" () , um die Datei auf Ihren Computer herunterzuladen und dort zu speichern.

Weitere Informationen zum Erfassen einer HAR-Datei mit Chrome finden Sie unter Open Chrome DevTools auf der Google Developers-Website.

Microsoft Edge (Chromium)

1. Öffnen Sie Microsoft Edge, und gehen Sie zu der Seite, auf der das Problem auftritt. Führen Sie alle Schritte in dem Prozess vor demjenigen, der das Problem verursacht, aus.
2. Klicken Sie im Browser oben rechts auf die horizontale Ellipsenschaltfläche (), und klicken Sie im Dropdown-Menü auf Weitere Tools und dann auf Entwicklungstools.
3. Zum Abdocken des Bereichs "DevTools" klicken Sie auf die vertikale Ellipsenschaltfläche () im Bereich "DevTools", und wählen Sie die erste Option zum Ausdocken in ein separates Fenster () im Abschnitt Andockseite aus.
4. Klicken Sie auf die Registerkarte Netzwerk.
5. Suchen Sie eine Aufnahme-Schaltfläche ( ) in der oberen linken Ecke der Registerkarte, und vergewissern Sie sich, dass sie rot ist. Wenn sie grau ist, dann klicken Sie einmal darauf, um die Aufzeichnung zu starten.
6. Wählen Sie das Kontrollkästchen Protokoll beibehalten aus.
7. Klicken Sie auf die Schaltfläche "Löschen" ( ), um alle aktuellen Netzwerkanfragen aus dem Netzwerkfenster zu löschen.
8. Reproduzieren Sie den Fehler bei geöffneten DevTools, während die Anfragen aufgezeichnet werden.
9. Wenn Sie das Problem in Edge reproduziert haben, klicken Sie auf den Pfeil nach unten "HAR exportieren" (), um die Datei herunterzuladen. Speichern Sie sie dann auf Ihrem Computer. 

Weitere Informationen finden Sie auf der Referenzseite für Netzwerkanalyse auf der Microsoft Docs-Website unter Speichern aller Netzwerkanforderungen in einer HAR-Datei.

Mozilla Firefox

1. Öffnen Sie Mozilla Firefox, und gehen Sie zu der Seite, auf der das Problem auftritt. Führen Sie alle Schritte in dem Prozess vor demjenigen, der das Problem verursacht, aus.
2. Klicken Sie im Browser oben rechts auf die Hamburger-Menüschaltfläche (), und klicken Sie im Dropdown-Menü auf Weitere Werkzeuge und dann auf Werkzeuge für Webentwickler im zweiten Dropdown-Menü.
3. Zum Abdocken des Bereichs "DevTools" klicken Sie auf die vertikale Ellipsenschaltfläche () im Bereich "DevTools", und wählen Sie die Option Eigenes Fenster aus.
4. Wählen Sie oben die Registerkarte Netzwerkanalyse aus.
5. Suchen Sie nach einer runden Schaltfläche "Wiedergabe/Pause" in der oberen linken Ecke der Registerkarte, und vergewissern Sie sich, dass die Pause-Option angezeigt wird ( ). Wenn Sie stattdessen die Wiedergabe-Option () sehen, dann klicken Sie einmal darauf, um die Aufzeichnung zu starten.
6. Klicken Sie auf die Zahnrad-Schaltfläche () in der oberen rechten Ecke des Fensters, und klicken Sie auf die Option Logs nicht leeren, um diese zu aktivieren.
7. Reproduzieren Sie den Fehler bei geöffneten Entwicklerwerkzeugen, während die Anfragen aufgezeichnet werden.
8. Wenn Sie das Problem in Firefox reproduziert haben, klicken Sie mit der linken Maustaste auf eine der Anfragen, und wählen Sie Alles als HAR speichern aus, und speichern Sie die Datei auf Ihrem Computer.

Erfassen von Debug-Dateien (.HAR) für andere Programme

Der technische Support von Esri verwendet Fiddler Classic von Telerik, um Datenverkehr zu erfassen, der außerhalb des Browsers auftritt, wie bei der Problembehandlung von ArcGIS Pro. Wie bei der browserbasierten Erfassung ist es wichtig, nur den Datenverkehr zu erfassen, der während der problematischen Schritte auftritt.

Um eine .HAR-Datei mit Fiddler Classic zu erfassen, müssen Sie Folgendes tun:

1. Herunterladen von Fiddler Classic
2. Folgen Sie den Schritten 1 bis 8 aus dem Artikel How To: Verwenden von Fiddler zum Mitschneiden von HTTPS-Verbindungen und zum Entschlüsseln von HTTPS-Datenverkehr, und stoppen Sie vor dem Speichern der Datei.
3. Wenn Sie den Datenverkehr erfasst haben, öffnen Sie File dropdown > Export Session > All sessions. 
4. Wählen Sie im Pop-up-Dropdown-Menü HTTPArchive v1.2 aus, und klicken Sie auf Next.
5. Speichern Sie die Datei.

Wenn die HAR-Datei erfasst wurde,

müssen Sie sie in einem Text-Editor, wie z. B. Notepad, Notepad++ oder Sublime Text, untersuchen und alle sensiblen Informationen entfernen, indem Sie die folgenden Schritte ausführen.

1. Öffnen Sie die HAR-Datei in einem Text-Editor, klicken Sie mit der rechten Maustaste auf die Datei, wählen Sie Öffnen mit aus, und wählen Sie dann die Text-Editor-Anwendung aus.
2. Verwenden Sie die Werkzeuge des Text-Editors zum Suchen und Ersetzen, um alle in der HAR-Datei erfassten sensiblen Informationen zu identifizieren und zu ersetzen. Dazu gehören:
   • usernames
   • Kennwörter
   • API-Schlüssel – dabei handelt es sich um lange Zeichenfolgen von Buchstaben, Ziffern und Symbolen, die für den Zugriff auf benutzerdefinierte Anwendungen verwendet werden und folgendermaßen aussehen:

   AAPK5f9f39a988764653b27dd7d01fa14d35kfSLvKsiJoeoXX2oFBXE_021u_apQt1eAssZEfnmcri1hUhBmHEyxoOXJhaW9xgie

   • Autorisierungstoken – das sind lange Zeichenfolgen von Buchstaben, Ziffern und Symbolen, die API-Schlüsseln ähneln, aber in allen webbasierten Esri Anwendungen zum Authentifizieren des Benutzers verwendet werden. Token sehen folgendermaßen aus:

    VBQlHZ__ONCdOUPteoQPfEEPYTyrfy3XugMasrGO90rUmGiMa_tzvjfksFsZ57MtTE1gywBYtVhrldIKuPPu7MFt4u6ukauvDtH4r2kZePZtgbCFomXc0ThIuwF9cPK6LNTFOJ3Q850ilLO2zP6kzmaY0cfnsJBMcoPmFH9BOLamDQFig3628HwU53xis4gIiEJNkWhnI3ynb

   • • Suchen Sie nach "generateToken"-Aufrufen, und löschen Sie diese.
   • Alle anderen Teile sensibler Informationen (z. B. sollten Sie, wenn Ihre Daten ein Feld mit identifizierenden Informationen über medizinische Patienten enthalten, nach diesen Informationen suchen und sie ersetzen). Wenn Sie weitere Fragen darüber haben, ob es sich bei Ihren Daten um sensible Daten handelt, dann kontaktieren Sie die Besitzer des Datenschemas Ihrer Organisation und überprüfen Sie die Datenklassifizierung mit ihnen. Esri kann keine Leitlinien dazu bereitstellen, was jede Kundenorganisation als sensibel erachtet.

3. Speichern Sie die bearbeitete HAR-Datei, bei der die sensiblen Informationen entfernt wurden.
4. Stellen Sie die HAR-Datei für Esri Support Services zur Verfügung mit dem schriftlichen Hinweis, dass Sie:
   • diese Anweisungen gelesen haben
   • und das Debug-Archiv des Clients vor dem Bereitstellen für Esri Support Services bereinigt haben.

Wenn Sie nicht in der Lage sind, die entsprechenden Schritte zu unternehmen, um die HAR-Datei speziell von Token zu bereinigen, warten Sie bitte 30 Minuten ab dem Zeitpunkt, an dem der Netzwerkdatenverkehr erfasst wurde, um die Datei über den Support Case freizugeben.

• Damit soll sichergestellt werden, dass alle Token abgelaufen sind und nicht für unberechtigten Zugriff oder unberechtigte Autorisierung verwendet werden können.

Wenn Sie dazu weitere Fragen haben, erörtern Sie diese gerne mit Ihren Support Services-Analyst.