Guide d’administration des licences d’organisation
Une licence d’organisation Deckloud est liée à l’adresse de votre serveur Nextcloud chez api.deckloud.com. Rien n’est installé sur le serveur.
Dernière mise à jour
Sur cette page
- Fonctionnement
- Prérequis
- Acheter une licence
- Activer une clé de licence
- Gérer la licence
- Ce que voient les utilisateurs
- Serveurs et adresses
- Passer à une nouvelle adresse de serveur
- Limiter la licence à un groupe
- Politique d’analyse
- Places
- Résiliation, expiration et révocation
- Clé de licence perdue
- Messages
- invalid_key : la clé de licence n’est pas valide
- license_inactive : la licence a pris fin
- license_revoked : la licence a été révoquée
- origin_limit : limite de serveurs atteinte
- origin_taken : le serveur utilise une autre licence
- origin_shared : l’adresse du serveur est partagée
- verification_required : essai en cours sur le serveur
- trial_server : un essai reste sur son serveur
- trial_used : aucun essai disponible
- not_admin : le compte n’administre pas le serveur
- server_unreachable : api.deckloud.com ne joint pas le serveur
- origin_invalid : l’adresse n’est pas valide
- unauthorized : la vérification a expiré
- not_found : aucune licence trouvée
- invalid_request : la requête n’a pas été acceptée
- rate_limited : trop de requêtes
- unavailable : licences d’organisation momentanément indisponibles
- Erreur réseau : api.deckloud.com est injoignable
- Synchronisation en pause pour ce compte Nextcloud
- renewal_failed : le paiement du renouvellement a échoué
- expires_soon : la licence prend fin bientôt
- over_limit : plus d’utilisateurs que de places
- trial_ends_soon : l’essai se termine bientôt
- no_license : ce serveur n’a pas de licence
- not_in_group : utilisateur hors du groupe sous licence
- Assistance
Fonctionnement
- Vous achetez une licence, et nous envoyons la clé de licence (
DLK-…) à l’adresse e-mail utilisée pour l’achat. - Un administrateur Nextcloud lie la licence à l’adresse du serveur, dans l’app Deckloud ou sur la page de gestion.
- Chaque app lit l’identifiant et les groupes de son utilisateur sur votre serveur, et le signale à api.deckloud.com par une empreinte de place. Sur un serveur sous licence, elle reçoit un jeton de licence signé et le vérifie sur l’appareil.
La page sécurité liste tout ce que les apps envoient.
Prérequis
- Nextcloud avec l’app Nextcloud Deck, et un compte du groupe
admin. - Des utilisateurs sur la version actuelle de Deckloud pour iPhone et iPad, Android ou ordinateur (Mac avec puce Apple, Windows 11, Linux).
- Clé de licence : la page de gestion, Deckloud pour ordinateur ou l’app Android. iPhone et iPad affichent seulement l’état de la licence.
- L’état de la licence sans la clé exige un serveur joignable depuis Internet en HTTPS. Les autres serveurs s’activent avec la clé ; voir server_unreachable.
- Les appareils ont besoin d’un accès HTTPS à
api.deckloud.com, ou d’une licence hors ligne.
Acheter une licence
Choisissez le nombre d’utilisateurs sur la page Organisations et payez par carte sur Polar. Polar émet une facture avec TVA, et nous envoyons la clé de licence à l’adresse e-mail de l’achat.
Pour ne pas avoir à coller la clé, confirmez d’abord que vous administrez le serveur : sur la page de gestion, saisissez l’adresse à laquelle les utilisateurs se connectent et choisissez Confirmer que vous administrez le serveur, ou dans Deckloud pour ordinateur, ouvrez Réglages > Compte > Pour les équipes et choisissez Confirmer dans le navigateur. Si vous payez dans l’heure qui suit la vérification, l’achat lancé à cet endroit lie ce serveur dès que le paiement est passé ; sinon, activez la clé reçue par e-mail.
api.deckloud.com vérifie le groupe admin via Nextcloud Login Flow v2, puis fait supprimer le mot de passe d’application par Nextcloud. En cas d’échec, il relance pendant 30 jours au plus.
Activer une clé de licence
Après l’achat sur la page organisations, activez la clé reçue par e-mail à l’un de ces deux endroits :
- Sur la page de gestion : saisissez l’adresse du serveur et la clé, puis choisissez Activer la clé pour ce serveur.
- Dans Deckloud pour ordinateur, connecté en administrateur : ouvrez Réglages > Compte > Pour les équipes, collez la clé et choisissez Activer pour ce serveur.
Conservez l’e-mail : la clé n’est plus jamais affichée, et elle seule permet d’ajouter des serveurs et d’ouvrir le portail client Polar.
Gérer la licence
La page de gestion et Réglages > Compte > Pour les équipes affichent l’état de la licence. Vos droits dépendent de la façon dont vous ouvrez la licence :
| Action | Avec la clé | Avec une vérification d’administrateur |
|---|---|---|
| Voir l’état, les utilisateurs signalés et les serveurs | Toute la licence | État et son serveur uniquement |
| Choisir le groupe Nextcloud et la politique d’analyse | Oui | Essai uniquement |
| Retirer un serveur | Tout serveur de la licence | Son serveur uniquement, de toute licence |
| Ajouter un serveur | Oui | Non |
| Ouvrir le portail client Polar | Oui | Non |
Une vérification d’administrateur est valable 1 heure.
Ce que voient les utilisateurs
Les utilisateurs se connectent simplement comme d’habitude. Réglages > Compte > Pour les équipes indique alors que Pro est fourni par votre organisation sur ce serveur.
Le Pro de l’organisation ne s’applique que tant que le compte de votre serveur est actif dans Deckloud. Les autres comptes de l’appareil, par exemple un compte personnel, ne l’obtiennent pas. Les achats Pro personnels restent valables.
Les apps vérifient la licence régulièrement, et tout de suite avec Vérifier à nouveau sous Pour les équipes.
Serveurs et adresses
Une licence est liée à l’adresse exacte que les utilisateurs saisissent dans Deckloud. Une licence Business lie jusqu’à 2 serveurs, par exemple production et préproduction. Les licences hébergeur n’ont pas de limite de serveurs ; voir l’offre hébergeur.
Une deuxième adresse pour le même serveur compte comme un autre serveur : liez-la aussi. Chaque adresse n’appartient qu’à une seule licence active à la fois.
Passer à une nouvelle adresse de serveur
Ajoutez la nouvelle adresse avec la clé, puis retirez l’ancienne sur la page de gestion. Les utilisateurs de l’ancienne adresse repassent en Free à la prochaine vérification de licence ; rien n’est supprimé.
Limiter la licence à un groupe
Par défaut, chaque utilisateur de vos serveurs obtient Pro. Pour limiter la licence, saisissez un identifiant de groupe (pas son nom d’affichage) sous Groupe Nextcloud, dans l’app ou sur la page de gestion.
Les apps vérifient l’appartenance sur l’appareil avec les groupes Nextcloud de l’utilisateur ; Deckloud ne connaît que l’identifiant du groupe. Changer de groupe remet à zéro le décompte des utilisateurs signalés. Les utilisateurs hors du groupe voient not_in_group.
Politique d’analyse
Activez Désactiver les statistiques d’utilisation dans l’app ou sur la page de gestion. Les apps qui ont le jeton de licence n’envoient alors aucune statistique d’utilisation et affichent ce réglage comme géré. Les utilisateurs hors du groupe sous licence n’ont pas de jeton ; pour eux, utilisez la clé MDM analytics. Détails sur la page sécurité.
Places
Les conditions exigent une place pour chaque personne qui utilise Deckloud sur les serveurs de la licence. Un même identifiant Nextcloud en production et en préproduction compte pour une place. Les comptes qui n’utilisent jamais Deckloud n’en ont pas besoin.
À côté des places, la page de gestion et l’app affichent les utilisateurs signalés au cours des 30 derniers jours. Vous les voyez avec la clé. Un utilisateur sort du décompte après 30 jours sans utilisation, par exemple si son compte est désactivé.
Sans accès à votre serveur, Deckloud ne peut pas vérifier ces signalements : le nombre sert uniquement d’information et ne retire jamais Pro. Au-delà des places, vous voyez over_limit.
Résiliation, expiration et révocation
Résiliez dans le portail client Polar. La licence reste active jusqu’à la fin de la période payée ; ensuite, la licence et ses jetons prennent fin, et les apps repassent en Free.
Après un remboursement ou une révocation, les apps repassent en Free à leur prochaine vérification de licence, ou à l’expiration de leur jeton. Le retour en Free ne supprime rien, et ceux qui ont acheté Pro eux-mêmes le conservent.
Clé de licence perdue
Demandez une nouvelle clé sur la page de récupération avec l’e-mail et le numéro de commande ; nous l’envoyons à l’adresse d’achat. L’ancienne clé cesse de fonctionner, et les serveurs déjà liés gardent la licence.
Messages
L’app Deckloud et la page de gestion affichent ces messages.
invalid_key : la clé de licence n’est pas valide
Aucune licence ne correspond à cette clé. Vérifiez les fautes de frappe : une clé commence par DLK- et compte 5 groupes de 5 caractères. Après une récupération, seule la nouvelle clé fonctionne ; récupérez une clé si nécessaire.
license_inactive : la licence a pris fin
L’abonnement a pris fin ou n’a pas été payé. Vérifiez-le dans le portail client Polar, puis réessayez après le paiement.
license_revoked : la licence a été révoquée
La licence a été remboursée ou révoquée. Les apps repassent en Free à leur prochaine vérification de licence, et rien n’est supprimé. En cas d’erreur, écrivez à partners@deckloud.com avec votre numéro de commande.
origin_limit : limite de serveurs atteinte
Une licence Business lie jusqu’à 2 serveurs. Retirez sur la page de gestion un serveur dont vous n’avez plus besoin, puis ajoutez le nouveau.
origin_taken : le serveur utilise une autre licence
Cette adresse est déjà liée à une autre licence active. Confirmez que vous administrez le serveur sur la page de gestion, retirez cette licence, puis activez votre clé.
verification_required : essai en cours sur le serveur
Activer la clé mettrait fin à l’essai en cours sur ce serveur, ce que seul son administrateur peut faire. Confirmez sur le même écran que vous l’administrez ; la clé reprend alors l’essai, et les utilisateurs gardent Pro.
trial_server : un essai reste sur son serveur
Un essai reste sur le serveur qui l’a démarré jusqu’à sa fin et ne peut pas être retiré. Activez une clé achetée pour ce serveur : elle reprend l’essai.
trial_used : aucun essai disponible
Deckloud ne propose plus d’essai, et les anciennes versions de l’app affichent ce message quand vous essayez d’en démarrer un. Achetez une licence et activez-la ; les utilisateurs gardent leurs données.
not_admin : le compte n’administre pas le serveur
Le compte connecté dans le navigateur ne fait pas partie du groupe Nextcloud admin. Utilisez un compte administrateur, ou demandez à un administrateur de vous ajouter.
server_unreachable : api.deckloud.com ne joint pas le serveur
La vérification d’administrateur exige une adresse HTTPS publique. Vérifiez l’adresse, le certificat TLS et le pare-feu. Pour un serveur interne, activez la licence avec sa clé. Pour les adresses IP privées et les noms locaux, voir origin_shared.
origin_invalid : l’adresse n’est pas valide
Saisissez l’adresse du serveur telle que les utilisateurs la saisissent dans Deckloud, par exemple https://cloud.example.com.
not_found : aucune licence trouvée
Aucune licence n’est liée à cette adresse, ou la commande est introuvable. Vérifiez que c’est l’adresse saisie par les utilisateurs dans Deckloud, puis activez une clé ou achetez une licence.
invalid_request : la requête n’a pas été acceptée
api.deckloud.com a refusé la requête, par exemple parce qu’un champ manquait. Mettez Deckloud à jour et réessayez.
rate_limited : trop de requêtes
Ce réseau ou cette clé de licence a envoyé trop de requêtes. Attendez une heure et réessayez.
Erreur réseau : api.deckloud.com est injoignable
L’appareil n’a pas pu joindre api.deckloud.com. Vérifiez la connexion, le proxy et le pare-feu. Les appareils gardent Pro jusqu’à l’expiration de leur jeton, au maximum 30 jours après la dernière vérification réussie.
Synchronisation en pause pour ce compte Nextcloud
Nextcloud a refusé le mot de passe d’application du compte, ou a demandé à Deckloud de ralentir. Deckloud a donc mis en pause toutes les requêtes de ce compte, vérification de licence comprise. Reconnectez-vous, ou réessayez dans quelques minutes.
renewal_failed : le paiement du renouvellement a échoué
Polar n’a pas pu prélever le dernier renouvellement et retente le paiement. Mettez à jour le moyen de paiement dans le portail client Polar. La licence reste active jusqu’à 7 jours après la fin de la période payée.
expires_soon : la licence prend fin bientôt
La licence prend fin dans les 14 jours et ne se renouvelle pas, en général après une résiliation. Reprenez l’abonnement dans le portail client Polar pour garder Pro.
over_limit : plus d’utilisateurs que de places
Les apps ont signalé plus d’utilisateurs au cours des 30 derniers jours que la licence ne compte de places. Tout le monde garde Pro, mais les conditions exigent plus de places. Ajoutez-en dans le portail client Polar, ou limitez la licence à un groupe.
trial_ends_soon : l’essai se termine bientôt
L’essai se termine dans les 7 jours. Achetez une licence et activez sa clé pour le serveur : vos utilisateurs gardent Pro sans interruption.
no_license : ce serveur n’a pas de licence
Aucune licence active n’existe pour cette adresse de serveur. Activez une clé ou achetez une licence. Les apps redemandent après 24 heures, ou quand l’utilisateur choisit Vérifier à nouveau.
not_in_group : utilisateur hors du groupe sous licence
La licence est limitée à un groupe Nextcloud dont cet utilisateur ne fait pas partie. Ajoutez-le au groupe, choisissez un autre groupe ou retirez la limite ; l’app en tient compte à sa prochaine vérification de licence.
Assistance
Écrivez à partners@deckloud.com en anglais ou en allemand, avec l’adresse du serveur et l’ID de licence affiché sur la page de gestion. Nous répondons sous 2 jours ouvrés, sans SLA ni assistance téléphonique.