Protokollierung

Allgemeines

Cryptshare unterscheidet zwischen zwei Arten von Protokollen: dem Systemprotokoll und dem Transfer-Protokoll. Das Transfer-Protokoll ist eine Darstellung der Übertragungsdaten, die in der Datenbank gespeichert werden. Das Systemprotokoll ist ein reguläres Anwendungsprotokollierungssystem und protokolliert alle Systemereignisse wie Informationsmeldungen oder Systemfehler. Dazu gehören auch Benutzeraktionen wie Uploads und Downloads. Daher enthält das Systemprotokoll ebenfalls die gleichen Informationen wie das Übertragungsprotokoll, allerdings nur als textuellen Protokolleintrag. Der Inhalt der einzelnen Protokolle kann an folgenden Stellen eingesehen werden:

  • Übertragungsprotokoll

  • Systemprotokoll

    • Administrationsoberfläche → Systemstatus → Protokollansicht → Systemprotokoll

    • Im unteren Bereich der Administrationsoberfläche werden die neuesten Protokolleinträge aufgelistet

    • Protokolldateien im Unterverzeichnis „log“ des Cryptshare-Installationsverzeichnisses

Übertragungsprotokoll

Protokollierte Inhalte

Im Allgemeinen enthält das Transfer-Protokoll alle Informationen zu einem Transfer. Dazu gehören die folgenden Angaben:

  • Transfer-Details

    • Für den Transfer verwendetes Produkt

    • Eindeutige ID des Transfers (Tracking-ID)

    • Uhrzeit und Datum, zu denen der Transfer bereitgestellt wurde

    • Uhrzeit und Datum, zu denen der Transfer abläuft

  • Transfer-Inhalt

    • Verschlüsselte Dateinamen (Datei-IDs)

    • Datei-Prüfsummen

    • Dateigrößen

  • Übertragungsoptionen

    • Ob Dateien in E-Mail-Benachrichtigungen mit ihren ursprünglichen Namen aufgeführt werden ** Ob der Absender per E-Mail benachrichtigt wird, nachdem der Transfer erfolgreich bereitgestellt wurde

    • Ob der Absender jedes Mal eine E-Mail-Benachrichtigung erhält, wenn ein Empfänger eine der Dateien im Transfer abruft

  • Absenderinformationen

    • E-Mail-Adresse des Absenders

    • IP-Adresse des Absenders

  • Empfängerinformationen

    • Eindeutige ID pro Empfänger (Transfer-ID)

    • E-Mail-Adressen der Empfänger

    • Download-Informationen

      • IP-Adressen der Empfänger pro Download

      • Uhrzeit und Datum, zu denen Dateien angesehen oder heruntergeladen wurden

Zusätzliche Inhalte

Zusätzlich zu den im obigen Kapitel aufgeführten Inhalten eines Transfer-Protokolls können weitere Inhalte im Transfer-Protokoll gespeichert werden, wenn der Administrator die entsprechende Option aktiviert.

Standardeinstellung für Policy-Regeln

Bitte beachten Sie, dass es sich hierbei nur um Standardeinstellungen für neue Policy-Regeln handelt. Um die Einstellungen zu aktivieren, müssen sie auch in der Richtlinie aktiviert werden.
Option Zweck

Nachrichten und Betreff

Für die Benachrichtigung des Empfängers verfasste Nachrichten werden einschließlich des Betreffs protokolliert. Wenn der Betreff nicht protokolliert wird, erscheint er nicht in den Protokollen der Transfers. Bitte beachten Sie jedoch , dass die Nachricht und der Betreff weiterhin in der Datenbank gespeichert sind. Wenn die Protokollierung von Nachrichten und Betreffzeilen nicht aktiviert ist, werden diese Daten aus der Datenbank gelöscht, sobald der Transfer abgelaufen ist oder ein Antrag auf Löschung personenbezogener Daten gestellt wird.

Dateinamen

Die ursprünglichen Dateinamen werden protokolliert. Wenn das Kontrollkästchen nicht aktiviert ist, werden nur die verschlüsselten Dateinamen protokolliert.

ZIP-Inhalt

Der Inhalt von ZIP-Dateien wird protokolliert.

Bitte beachten Sie, dass der ZIP-Inhalt nur protokolliert wird, wenn die Einstellung „ Dateinamen protokollieren“ ebenfalls aktiviert wurde.

Automatische Löschung abgelaufener Protokolleinträge

Standardmäßig speichert Cryptshare alle Daten der Transfers in der Datenbank, einschließlich der Daten abgelaufener Transfers. Wenn ein Administrator die Daten abgelaufener Transfers nach einer bestimmten Zeit löschen möchte , muss diese Option aktiviert werden. Ist sie aktiviert, ermöglicht ein zusätzliches Eingabefeld die Festlegung des Zeitraums, nach dessen Ablauf abgelaufene Transfers aus der Datenbank gelöscht werden.

Senden von Protokolldaten an den Administrator

Der Cryptshare-Server kann regelmäßig einen Protokollexport an die Administratoren senden. Diese Funktion ist standardmäßig deaktiviert.

Unverschlüsselte E-Mail

Bitte beachten Sie, dass der Protokollinhalt per E-Mail versendet wird und unverschlüsselt versendet wird.

Intervall

Das Intervall, in dem die Protokolldaten gesendet werden, kann von einem Mindestintervall von einer Stunde bis zu 2160 Stunden (90 Tage) geändert werden.

Erfasster Zeitraum

Der Zeitraum, der vom Protokollexport abgedeckt wird, kann auf zwei verschiedene Einstellungen geändert werden:

  • Zeitraum seit dem letzten Versand des Protokolls

  • Fester Zeitraum in Tagen

Als Cryptshare-Transfer senden

Normalerweise werden die Exportdaten per E-Mail an den Administrator gesendet. Dies ist jedoch unsicher, da der E-Mail-Inhalt nicht verschlüsselt ist. Aktivieren Sie das Kontrollkästchen, um die Daten als Cryptshare-Transfer zu senden, wenn Sie stattdessen einen Cryptshare-Transfer erhalten möchten. In diesem Fall können die Daten wie ein gewöhnlicher Cryptshare-Transfer mit dem angegebenen Passwort abgerufen werden.

Systemprotokoll

Verwenden Sie diese Konfigurationsseite, um die Einstellungen für die Protokollierung von Systemereignissen zu ändern. Cryptshare verwendet die Softwarebibliothek LogBack, um allgemeine Systeminformationen auszugeben. LogBack wird über eine XML-Datei konfiguriert, die unten bearbeitet werden kann. Standardmäßig werden Informationen gleichzeitig in die Standardausgabe (Konsole) sowie in die Dateien „cryptshare.log“ und „cryptshare\_error.log“ protokolliert. Täglich oder bei Überschreiten der maximalen Größe von 50 MB werden diese als ZIP-Archiv gespeichert und eine neue, leere Protokolldatei erstellt (Protokollrotation). Die Anzahl und die Gesamtgröße aller Archivdateien sind begrenzt. Bei Bedarf werden die ältesten Archive gelöscht. In den folgenden Abschnitten werden die grundlegenden Elemente und Konfigurationen beschrieben – weitere Details finden Sie im LogBack-Handbuch.

Allgemeine Struktur der Konfigurationsdatei

Grundsätzlich besteht die Logback-Konfigurationsdatei aus zwei Arten von Elementen: Appender und Logger. Appender sind Kanäle für die Protokollausgabe; sie legen fest, wohin die protokollierten Informationen geschrieben werden – zum Beispiel in das Konsolenausgabefenster oder in eine Datei. Mit Logger-Elementen lässt sich pro Anwendungsmodul der Detaillierungsgrad festlegen, der für die Protokollierung verwendet wird.

Konfigurierte Appender

Die Standardkonfiguration definiert drei verschiedene Appender zur Verarbeitung von Protokollinformationen:

  • CONSOLE\_DEFAULT – Ausgabe im Konsolenfenster (Standardausgabe)

  • FILE\_DEFAULT – Protokollierung aller Informationen in der Datei „cryptshare.log“, ohne Stacktrace.

  • FILE\_ERROR – Protokollierung aller Informationen in der Datei „cryptshare\_error.log“, einschließlich Stacktrace.

Es gibt eine Reihe weiterer möglicher Appender für LogBack. Weitere Informationen finden Sie unter im entsprechenden Abschnitt des LogBack-Handbuchs.

Ändern der Protokollstufe

Die Protokollstufe kann in fünf Stufen definiert werden:

  • trace – Informationen zum internen Programmablauf

  • debug – Detaillierte Informationen zur Fehleranalyse

  • info – Allgemeine Informationen

  • warn – Warnungen

  • error – Fehler

Jede der Protokollstufen umfasst die Ausgaben der „übergeordneten“ Protokollstufe. In der Protokollstufe „info“ werden beispielsweise auch Warnungen und Fehler protokolliert. Die Protokollstufe kann allgemein oder, falls erforderlich, pro Anwendungsmodul festgelegt werden. Die allgemeine Einstellung lässt sich durch die Konfiguration des sogenannten Root-Loggers festlegen:

<root level="error">

Diese allgemeine Einstellung kann durch spezifische Logger überschrieben werden, die den Paketnamen angeben. Beispielsweise werden Protokollmeldungen, die vom Cryptshare Server stammen, mit der Detailstufe „info“ protokolliert:

<logger name="com.cryptshare"
 level="info" />

Bitte beachten Sie, dass die Wahl der Protokollstufe erhebliche Auswirkungen auf die Systemleistung haben kann. Die Stufen „trace“ und „debug“ sollten nur aktiviert werden, wenn dies für die Fehleranalyse erforderlich ist.

Anpassung der Protokollarchivierung

Beide Appender FILE\_DEFAULT und FILE\_ERROR (siehe oben) sind so konfiguriert, dass sie eine automatische Archivierung mit Rotation verwenden. Nach einem bestimmten Zeitintervall oder nach Überschreiten einer bestimmten Größengrenze wird die aktuell aktive Protokolldatei „cryptshare.log“ oder „cryptshare\_error.log“ verschoben und als ZIP-Archiv gespeichert. Anschließend wird die Protokolldatei neu angelegt. Das Zeitintervall kann mithilfe des Elements „interval“ konfiguriert werden. Mögliche Werte sind: Jahr, Monat, Tag oder Stunde. Beispielsweise legt die Konfiguration

<interval>day</interval>
<maxFileSize>50MB</maxFileSize>

legt fest, dass eine neue Protokolldatei jeden neuen Tag erstellt wird oder sobald 50 MB überschritten werden, je nachdem, was zuerst eintritt. Zusätzlich kann festgelegt werden, unter welchen Bedingungen alte Archive entfernt werden. Das Element „maxHistory“ legt die Anzahl fest, „totalSizeCap“ die maximale Gesamtgröße aller Archive. Zum Beispiel:

<maxHistory>10</maxHistory>
<totalSizeCap>10MB</totalSizeCap>

Unabhängig von diesen Einstellungen wird mindestens ein Archiv aufbewahrt.

Remote-Protokollierung

Das Cryptshare for Outlook-Add-in schreibt Protokollinformationen in die JavaScript-Konsole des Browsers. Angesichts der voraussichtlich hohen Anzahl von Benutzern/Clients, die mit dem Add-in arbeiten, kann die Fehleranalyse auf diese Weise sehr zeitaufwendig und kompliziert werden. Um diesen Prozess für Administratoren und Benutzer zu vereinfachen, ist das Add-in mit einer sogenannten Remote-Logging-Funktion ausgestattet. Diese ermöglicht es Administratoren, Protokollinformationen von Clients an einem zentralen Ort, dem Cryptshare Server, zu empfangen.

Remote-Protokollierung aktivieren

Bei Problemen kann die Remote-Protokollierung für Cryptshare for Outlook -Add-Ins aktiviert werden. Der Cryptshare-Server schreibt dann alle Protokollmeldungen von Clients in ein spezielles Systemprotokoll. Es gibt 5 verschiedene Protokollstufen: Info, Warnung, Fehler, Debug und Trace. Um die Fernprotokollierung für ein Add-in zu aktivieren, geben Sie die entsprechende Client-ID, eine Beschreibung und die gewünschte Protokollstufe ein.

  1. Melden Sie sich als Administrator beim Cryptshare-Server an

  2. Navigieren Sie in der rechten Spalte nach oben zu „Systemeinstellungen“, dann in der linken Spalte zu „Protokolleinstellungen“ und schließlich zum Abschnitt „Fernprotokollierung“.

21 Remotelogging short EN

  1. Wählen Sie eine entsprechende Protokollstufe

  2. Geben Sie die Beschreibung ein

  3. Geben Sie die Client-ID ein

  4. Klicken Sie auf „Client hinzufügen“

  5. Klicken Sie auf „Änderungen speichern“