API-Schlüssel und Bereiche
ClearScreen hat keinen Schlüssel mit konfigurierbaren Bereichen. Jede Schlüsselart hat genau eine Aufgabe.
| Schlüssel | Beginnt mit | Verwendet für |
|---|---|---|
| Registrierungsschlüssel | csk_ | Geräte mit clearscreen enroll registrieren. Einer pro Workspace, wird beim Erneuern einmal angezeigt. |
| Geräteschlüssel | csk_ | Einer pro Gerät. Der Agent verwendet ihn, um die Richtlinie abzurufen und Blockierungen zu melden. Er wird mit den Berechtigungen 0600 auf dem Gerät und als Hash auf dem Server gespeichert. |
| Export-Token | csat_ | Blockierereignisse und Prüfmeldungen für die Log-Weiterleitung lesen. Admins können sie über die Konsolen-API erstellen und widerrufen. |
Umgang mit Schlüsseln
- Behandeln Sie den Registrierungsschlüssel als Geheimnis. Das Erneuern beendet neue Registrierungen mit dem alten Schlüssel. Bereits registrierte Geräte funktionieren weiter.
- Wird derselbe Computername erneut registriert, wird ein neuer Geräteschlüssel ausgestellt, und der alte funktioniert nicht mehr.
- Nur Workspace-Admins können den Registrierungsschlüssel erneuern oder Export-Tokens verwalten.
- Geben Sie einen Schlüssel niemals in einem Ticket, Chat oder Screenshot an.
Eine Domain prüfen
Der öffentliche Prüfendpunkt antwortet für die gemeinsamen Feeds und Kategorien. Er benötigt keinen Schlüssel und ist ratenbegrenzt.
curl "https://clearscreen.spot-suite.com/v1/check?domain=example.org"