Licence du connecteur
En bref
Chaque connecteur est identifié par un code machine unique. La licence associée à ce code est gérée sur le portail SenSaaS : le connecteur la vérifie en ligne, garde la dernière réponse signée en cache pour tenir hors connexion, et se replie sur un fichier de licence local tant que la transition vers la licence en ligne n'est pas terminée. Une licence absente ou expirée n'arrête jamais le service : elle désactive les modules.
Le code machine
Le code machine est l'identifiant persistant du connecteur sur cette machine. Il est affiché dans l'outil de configuration, écran Licence, avec un bouton Copier le code.
C'est ce code que vous communiquez à votre revendeur, ou que le support vous demande, pour qu'une licence soit générée ou mise à jour. Il reste stable pour l'installation, et il n'est jamais repris d'une configuration importée depuis une autre machine.
Comment la licence est vérifiée
Le connecteur applique trois voies, dans cet ordre :
- En ligne : le connecteur interroge le portail SenSaaS avec son code machine et son jeton serveur. La réponse du portail est signée, et le connecteur vérifie qu'elle concerne bien sa machine ; c'est le mode nominal.
- Cache signé : si le portail est injoignable, la dernière réponse signée reçue est rejouée, tant qu'on reste dans sa période de grâce, fixée par le portail, et jamais au-delà de la date d'expiration de la licence. Le connecteur continue donc de fonctionner hors connexion.
- Fichier de licence local : repli transitoire sur un fichier
.licenseprésent dans le dossier d'installation, quand aucune licence en ligne n'existe encore pour ce connecteur.
Le connecteur distingue deux cas d'échec de la vérification en ligne :
- Refus du portail (jeton inconnu, code machine qui ne concorde pas, aucune licence pour ce connecteur) : le cache est ignoré, pour qu'une révocation s'applique tout de suite. Seul le repli sur le fichier local reste possible.
- Portail injoignable (pas de réponse, ou erreur du portail) : le cache signé prend le relais.
L'écran Licence affiche la provenance de l'état courant, ce qui permet de savoir immédiatement dans quel mode vous êtes :
| Provenance affichée | Signification |
|---|---|
| En ligne (portail SenSaaS), vérifiée le … | Mode nominal |
| Hors-ligne (cache signé), valable jusqu'au … | Portail injoignable, fonctionnement dans la grâce |
| Fichier de licence local (transition) | Aucune licence en ligne pour ce connecteur |
| Non vérifiée (aucune licence en ligne ni fichier) | Aucune licence exploitable |
Le repli par fichier est provisoire
Le fichier .license est un mode de transition, destiné à disparaître une fois tout le parc
passé à la licence en ligne. Prévoyez le basculement de vos installations vers la licence en
ligne.
Rythme des vérifications
La licence est vérifiée au démarrage, puis revérifiée en ligne au plus toutes les heures. Pendant une revérification, le connecteur sert l'état déjà connu : un portail lent ou indisponible ne bloque jamais les requêtes de l'API.
Le bouton Actualiser la licence de l'écran Licence force une vérification immédiate.
Deux garde-fous encadrent le cache :
- une révocation ou un refus explicite du portail l'emporte sur le cache : celui-ci est ignoré ;
- un cache dont la date d'émission est trop en avance (au-delà de 24 heures de tolérance) est ignoré : l'horloge de la machine a été reculée.
Obtenir le jeton serveur et activer la licence
L'activation se fait sur le portail SenSaaS. L'outil de configuration n'embarque plus d'outil d'activation, ni de mise à jour de licence par fichier.
Le connecteur reçoit son jeton serveur du portail, au cours d'une synchronisation réussie ; juste après la livraison, il revérifie sa licence. Le jeton est enregistré dans la configuration chiffrée et ne doit jamais être communiqué.
- L'étape Compte SenSaaS de l'assistant de premier lancement rattache le connecteur à votre société SenSaaS (email du compte, puis code reçu par mail).
- L'étape Accessibilité lance la synchronisation avec le portail, qui vérifie qu'il joint le connecteur et lui livre son jeton serveur.
- Le revendeur associe la licence à ce serveur sur le portail.
- Écran Licence, Actualiser la licence : la provenance doit passer à "En ligne".
- Relevez le code machine dans l'écran Licence.
- Faites déclarer ce code et la licence correspondante sur le portail (revendeur ou administrateur SenSaaS).
- Lancez une synchronisation depuis l'écran Utilisateurs ou Accès B2B : le connecteur déclare ses informations au portail et reçoit son jeton serveur.
- Revenez sur l'écran Licence et cliquez sur Actualiser la licence : la provenance doit passer à "En ligne".
Le connecteur doit être joignable
Le portail ne livre le jeton serveur qu'après avoir joint le connecteur. Tant que le connecteur n'est pas accessible (EasyConnect ou port ouvert), la licence reste "Non vérifiée". Voir Installer le connecteur.
Ce que porte la licence
| Information | Où la voir |
|---|---|
| Société titulaire | Écran Licence |
| Date limite | Écran Licence |
| Nombre d'utilisateurs autorisés | Écran Licence, et carte Licence de la barre latérale |
| Type de licence (Licence SenSaaS ou Licence Sage SenSaaS) | Écran Licence |
| Modules autorisés, et pour une licence SenSaaS le nombre d'utilisateurs de chaque module | Écran Licence |
| Modules de chaque utilisateur (sièges nominatifs, licence SenSaaS) | Portail SenSaaS |
| Nombre d'accès B2B autorisés | Écran Accès B2B, pastille "X / Y accès utilisés" |
Sièges et modules par utilisateur
Les droits d'un utilisateur sur les modules dépendent du type de licence :
| Licence | Utilisateur listé par la licence | Utilisateur absent de la licence |
|---|---|---|
| Licence SenSaaS (sièges nominatifs) | Les modules de son siège | Aucun module |
| Licence Sage SenSaaS | Les modules de son siège | Les modules de la licence |
Une licence sans liste d'utilisateurs donne à chacun les modules de la licence. Les options Microsoft 365 et Cadencier valent pour toute la licence.
Nombre d'utilisateurs actifs
L'écran Utilisateurs refuse d'activer un utilisateur au-delà de la licence :
- Licence Sage SenSaaS : nombre global d'utilisateurs actifs ;
- Licence SenSaaS : nombre d'utilisateurs du module qu'occupe le siège de l'utilisateur (les options Microsoft 365 et Cadencier ne comptent pas). Un utilisateur sans siège n'occupe aucun module : son activation n'est pas limitée, mais il n'a aucun droit.
Un utilisateur déjà actif n'est jamais bloqué. Les comptes B2B suivent leur propre quota (ci-dessous).
Module Cadencier
Le cadencier (routes /cadencier et /v2/cadencier) est réservé au module Cadencier : sans ce
module dans la licence, ou dans le siège de l'utilisateur pour une licence SenSaaS, le connecteur
refuse l'appel avec le code AUTH.FORBIDDEN (HTTP 403), par exemple "Accès refusé : le module
"Cadencier" n'est pas inclus dans le siège de cet utilisateur sur la licence SenSaaS.".
Quota B2B
Le nombre d'accès B2B accordés est comparé en permanence au quota de la licence. L'écran Accès B2B affiche le compteur en en-tête et le passe en avertissement lorsque plus de 80 % du quota est consommé. L'écran Accueil reprend le même compteur.
Si la licence expire ou manque
Le connecteur applique la licence de manière souple : une licence absente, expirée ou invalide n'arrête jamais le service. Concrètement :
- l'état passe à "Licence expirée", "Licence non valide" ou "Licence non lisible" dans l'écran Licence, et la bannière invite à se rapprocher du revendeur ;
- les modules autorisés tombent à zéro : les fonctionnalités qu'ils couvrent ne sont plus actives ;
- la carte Licence de la barre latérale de l'outil de configuration cesse d'afficher son résumé.
Cas particulier pendant la transition : si le portail répond qu'une licence en ligne existe mais qu'elle est expirée, le connecteur tente d'abord un repli sur un fichier de licence local valide.
Le code d'erreur renvoyé par le portail n'est pas affiché à l'écran : il est écrit dans les journaux du connecteur, avec le statut HTTP.
Questions fréquentes
Le connecteur fonctionne-t-il sans accès Internet ?
Oui, tant que le cache signé reste dans sa période de grâce et que la licence n'est pas expirée. Passé ce délai, la licence n'est plus considérée comme vérifiée. Rétablissez l'accès HTTPS sortant vers le portail avant la date affichée dans l'écran Licence.
J'ai renouvelé la licence, l'écran indique toujours "Licence expirée".
L'état est conservé jusqu'à une heure entre deux vérifications. Cliquez sur Actualiser la licence.
J'ai changé de machine, ma licence ne fonctionne plus.
Le code machine change avec la machine. Faites associer la licence au nouveau serveur sur le portail. Si vous reprenez la configuration par un export puis un import, le code machine et la licence restent ceux du nouveau serveur : voir Sécurité.
Où trouver le nombre d'accès B2B restants ?
Dans l'en-tête de l'écran Accès B2B : "X / Y accès utilisés".