Aller au contenu

Signaux de présence et vérification hors ligne des licences

Les deux réglages sont dans les stratégies d’autorisation, mais distinguent la fréquence de contact en ligne et la durée d’usage sans réponse du serveur.

Intervalle : fréquence de vérification

Réglez Intervalle de heartbeat (secondes) sur 600, le SDK envoie une pulsation environ toutes les 10 minutes pendant son exécution. Chaque réussite récupère les dernières règles et actualise le cache local de licence.

Saisissez 600–86400 secondes. Saisissez 0 désactive les battements programmés. L’application peut toujours vérifier ou actualiser manuellement. Un délai aléatoire de 0–10 % est ajouté ; l’intervalle ne descend jamais sous 600 secondes.

Avec une licence liée à l’appareil et un cache valide, le démarrage rétablit l’accès puis vérifie en arrière-plan, même sans minuterie. Les licences en ligne uniquement et flottantes attendent la confirmation du serveur.

Hors ligne : durée d’usage sans serveur

Trois choix de mode hors ligne, sans modifier l’intervalle de heartbeat.

Autoriser pendant une durée définie
Avec 24 heures, le cache signé reste valable au maximum 24 heures après la dernière vérification en ligne réussie. Une coupure réseau ou une panne temporaire n’empêche pas l’usage pendant ce délai. Ensuite, une vérification en ligne doit réussir.
Repli hors ligne interdit
Le démarrage exige une réponse du serveur ; le cache disque ne contourne pas un échec. La signature courte reçue pendant l’exécution dure au maximum max(10, 心跳间隔) secondes ; l’application doit poursuivre les vérifications et les contrôles de droits.
Autoriser un accès hors ligne permanent
La signature locale peut servir durablement, même en cas de panne réseau. Une licence de 30 jours expire toujours au bout de 30 jours : le mode hors ligne permanent ne rend pas la licence perpétuelle.

L’API utilise offline_mode représente ces trois choix, dans l’ordre limited, none, permanent. Avec une durée hors ligne définie,offline_seconds vaut 1–31536000 secondes ; 0 pour les deux autres modes.

Comment fonctionnent ces combinaisons ?

Réglages heartbeat / hors ligneComportement réel
10 minutes / 24 heuresVérifiez toutes les 10 minutes en ligne. Hors ligne, utilisez jusqu’à 24 heures après la dernière vérification réussie
10 minutes / hors ligne permanentHeartbeat toutes les 10 minutes ; règles actualisées si réussi, signature valide si injoignable.
0 / hors ligne permanentAvec un cache valide, démarrez sans requêtes programmées. Vérification ou actualisation explicite contacte toujours le serveur
0 / 24 heuresPas de heartbeat programmé, mais le cache expire. L’application planifie la vérification ; désactiver ne prolonge pas le hors ligne.

Prévoyez une durée hors ligne supérieure à l’intervalle. Avec un heartbeat par heure mais une minute hors ligne, la signature expire avant le suivant : l’application doit vérifier séparément.

Une règle modifiée actualise-t-elle les licences existantes ?

Oui. L’enregistrement synchronise atomiquement limites, fonctions, quotas, modèle, maintenance et versions avec chaque licence liée non révoquée. Il n’est plus nécessaire de les sélectionner une par une.

La synchronisation conserve le type de durée, les jours, la première activation, l’expiration, le client, l’usage et l’extension de maintenance. Le type de la règle ne concerne que les futures licences et ne rend pas permanente une licence de 30 jours.

S’il reste des appareils ou sessions actifs lors du changement de modèle, ou si la nouvelle limite est sous l’usage actuel, l’enregistrement renvoie ACTIVE_DEVICES_CONFLICT, sans mise à jour partielle de la règle ni des licences liées. Libérez les appareils en conflit puis enregistrez de nouveau.

Après enregistrement, anciennes et nouvelles licences liées utilisent les règles à la prochaine activation, validation ou pulsation réussie. Le SDK remplace le cache signé. Un même Idempotency-Key renvoie toujours le résultat initial.

Un appareil hors ligne utilise ses règles signées existantes. La reconnexion seule ne change pas le cache : une requête doit réussir. L’application peut lancer une actualisation au retour du réseau.

Appliquer la règle garde une fonction.

Pour déplacer des licences vers une autre règle, sélectionnez-les puis prévisualisez avec Appliquer la règle. Pour modifier leur règle actuelle, enregistrez simplement pour synchroniser.

Actualisation en ligne à la demande

Ces méthodes contactent toujours le serveur, même en mode hors ligne permanent sans heartbeat. Le succès renouvelle la signature. Un échec réseau signale l’erreur et conserve un cache encore valable ; une révocation ou libération explicite l’efface.

LangueMéthode d’appel
Goclient.RefreshOnline(ctx)
Javaclient.refreshOnline()
Cln_refresh_online(client)
C++client.RefreshOnline()
C#await client.RefreshOnline()
Pythonclient.refresh_online()
JavaScriptawait client.refreshOnline()

Une actualisation réussie compte comme une activation API. Si la stratégie active les heartbeats auparavant désactivés, appelez StartHeartbeat pour démarrer leur planification. Hors ligne, l’appareil ne reçoit pas les révocations ou libérations.