ClearScreen-Dokumentation

Registrierung und Richtlinie

Ein Gerät ist geschützt, sobald der Agent läuft und bei Ihrem Workspace registriert ist. Registrierte Geräte laden Ihre Richtlinie und senden ihre Blockierereignisse an die Konsole.

1. Registrierungsschlüssel und Agent besorgen

  1. Öffnen Sie als Admin den Tab Enrollment.
  2. Wählen Sie Rotate enrollment key (Registrierungsschlüssel erneuern). Der Schlüssel beginnt mit csk_ und wird nur einmal angezeigt, kopieren Sie ihn also jetzt. Das Erneuern ersetzt den bisherigen Schlüssel.
  3. Wählen Sie Download Windows agent oder Download Linux agent. Ein macOS-Agent ist auf Anfrage erhältlich.

Der Windows-Agent ist nicht codesigniert. Installieren Sie ihn nur über den Download in der Konsole.

2. Unter Windows installieren und registrieren

Führen Sie dies in einer PowerShell mit erhöhten Rechten aus, in dem Ordner, der den Download enthält. Der Tab Enrollment zeigt dieselben Befehle mit eingetragenem Schlüssel.

$cs = "$env:ProgramFiles\ClearScreen\clearscreen.exe"
New-Item -ItemType Directory -Force (Split-Path $cs) | Out-Null
Copy-Item -Force .\clearscreen-windows-amd64.exe $cs
& $cs install
& $cs enroll "<enrollment key>"
& $cs start

3. Unter Linux installieren und registrieren

Führen Sie dies in dem Ordner aus, der den Download enthält. Es installiert einen systemd-Dienst.

sudo install -m 0755 clearscreen-linux-amd64 /usr/local/bin/clearscreen && sudo clearscreen install && sudo clearscreen enroll "<enrollment key>" && sudo clearscreen start

4. Das Gerät prüfen

Öffnen Sie den Tab Devices. Das Gerät erscheint mit seinem Computernamen und seiner Plattform. Wird derselbe Computername erneut registriert, ersetzt das den Schlüssel dieses Geräts, statt ein zweites Gerät anzulegen. Jeder Tarif hat ein Gerätelimit, und ein Gerät, das es überschreiten würde, wird abgelehnt.

Dienstbefehle auf dem Gerät:

clearscreen status
clearscreen stop
clearscreen start
clearscreen uninstall

5. Die Richtlinie festlegen

Öffnen Sie den Tab Policy. Ein Admin kann ändern:

Wählen Sie Save policy and branding (Richtlinie und Branding speichern). Registrierte Geräte laden die neue Richtlinie von der Konsole.

6. Eine Blockierung testen

Öffnen Sie auf dem Gerät eine Domain aus einer blockierten Kategorie. Die Domain wird zur lokalen Blockierseite aufgelöst, die Domain, Kategorie und Quelle anzeigt. Unter Windows zeigt eine Desktop-Benachrichtigung den Grund. Unter Linux zeigt eine blockierte HTTPS-Website statt der Blockierseite möglicherweise eine Zertifikatswarnung des Browsers.

Die Blockierseite hat die Schaltfläche Send review request (Prüfanfrage senden). Die Anfrage erscheint im Tab Reviews. Eine Meldung dort als erlaubt zu markieren, ändert nur ihren Status. Um die Domain zu erlauben, tragen Sie sie im Tab Policy in die Allowlist ein.

Standalone-Modus

Der Agent läuft auch ohne Konto, mit der Standardrichtlinie und dem öffentlichen signierten Bundle. Der Standalone-Modus meldet nie Blockierereignisse.

sudo clearscreen run --foreground