Clés d'API et portées
ClearScreen n'a aucune clé dont les portées sont configurables. Chaque type de clé a un seul rôle.
| Clé | Commence par | Utilisée pour |
|---|---|---|
| Clé d'enrôlement | csk_ | Enrôler des appareils avec clearscreen enroll. Une par espace de travail, affichée une seule fois lors du renouvellement. |
| Clé d'appareil | csk_ | Une par appareil. L'agent l'utilise pour récupérer la politique et signaler les blocages. Elle est stockée avec les permissions 0600 sur l'appareil et sous forme de hachage sur le serveur. |
| Jeton d'export | csat_ | Lire les événements de blocage et les signalements de revue pour la transmission des journaux. Les administrateurs peuvent les créer et les révoquer via l'API de la console. |
Manipuler les clés
- Traitez la clé d'enrôlement comme un secret. Son renouvellement interrompt les nouveaux enrôlements avec l'ancienne clé. Les appareils déjà enrôlés continuent de fonctionner.
- Enrôler à nouveau le même nom d'ordinateur délivre une nouvelle clé d'appareil et l'ancienne cesse de fonctionner.
- Seuls les administrateurs de l'espace de travail peuvent renouveler la clé d'enrôlement ou gérer les jetons d'export.
- Ne mettez jamais une clé dans un ticket, une conversation ou une capture d'écran.
Vérifier un domaine
Le point de terminaison de vérification public répond pour les flux et catégories partagés. Il ne nécessite aucune clé et son débit est limité.
curl "https://clearscreen.spot-suite.com/v1/check?domain=example.org"