Désenrôler un appareil

Désenrôler un appareil à distance et lancer le nettoyage.

Sommaire

• Lancer la commande

• Confirmation d'exécution

• Mise à jour manuelle du statut

Cette commande permet de déclencher le processus de désenrôlement sur l'appareil cible. L'appareil effectuera les actions suivantes :

1. Désactivation du mode Kiosk

2. Suppression des fichiers téléchargés

3. Désinstallation des applications gérées

4. Désinstallation du service MDM

Cette action est irréversible sur l'appareil. L'appareil devra être ré-enrôlé manuellement pour être géré à nouveau.

Note : L'entrée de l'appareil reste présente dans la base de données du serveur, permettant de conserver l'historique ou de le ré-associer plus tard.

API

Endpoint Serveur

Vous pouvez utiliser l'API du serveur pour envoyer cette commande :

• Méthode : POST

• URL : /devices/{deviceId}/unenroll

Exemple cURL

curl -X POST https://api.pulse-mdm.com/devices/60d5ec49f1b2c82a5c8b4567/unenroll \
  -H "Authorization: Bearer <VOTRE_TOKEN>"

Réponses possibles

• 200 OK : La commande a été envoyée (ou mise en attente) avec succès.

• 404 Not Found : L'ID de l'appareil est introuvable.

• 500 Internal Server Error : Erreur technique serveur.

Exemples de réponse

Succès (Appareil en ligne)

{
  "success": true,
  "data": {
    "message": "Device unenrolled"
  },
  "QUEUED_OFFLINE": false
}

Mise en file d'attente (Appareil hors ligne)

Si l'appareil est injoignable, la mesure est mise en attente (code 200) :

{
  "success": true,
  "data": {
    "message": "Device offline, unenrollment queued for next connection."
  },
  "QUEUED_OFFLINE": true
}

Suivi de statut (Offline Support)

Lors d'un unenroll, le serveur met à jour le statut dans l'objet device : unenrollmentStatus. Ce champ contient :

• status: 'pending' | 'success' | 'failed' | 'none'

• requestDate: Date de la demande

• executionDate: Date de confirmation

Exemple de structure JSON

"unenrollmentStatus": {
  "status": "pending",
  "requestDate": "2024-03-20T10:00:00.000Z",
  "executionDate": null
}

Si l'appareil est hors ligne, il recevra l'information lors de sa prochaine synchronisation.

Confirmation d'exécution

Lorsque l'appareil a terminé ses opérations de nettoyage, il doit appeler l'endpoint de confirmation :

• Méthode : POST

• URL : /devices/{deviceId}/unenroll/confirm

Cela passera le statut à success et enregistrera la date d'exécution.

Mise à jour manuelle du statut

Il est possible de modifier manuellement le statut de désenrôlement via l'API, ce qui mettra à jour automatiquement les dates correspondantes.

• Méthode : POST

• URL : /devices/{deviceId}/unenroll/status/{status}

Paramètres

• status (path) : Valeur parmi pending, success, failed, none.

Comportement des dates

• pending : Met à jour requestDate à l'heure actuelle, réinitialise executionDate à null.

• success / failed : Met à jour executionDate à l'heure actuelle, conserve requestDate.

• none : Réinitialise requestDate et executionDate à null.