Admin-Handbuch

Admin-Handbuch für Organisationslizenzen

Eine Deckloud-Organisationslizenz ist bei api.deckloud.com an die Adresse Ihres Nextcloud-Servers gebunden. Auf dem Server wird nichts installiert.

Zuletzt aktualisiert

So funktioniert es

  1. Sie kaufen eine Lizenz, und wir senden den Lizenzschlüssel (DLK-…) an die beim Kauf angegebene E-Mail-Adresse.
  2. Ein Nextcloud-Admin verknüpft die Lizenz in der Deckloud-App oder auf der Verwaltungsseite mit der Serveradresse.
  3. Jede App liest Nutzer-ID und Gruppen von Ihrem Server und meldet ihren Nutzer als Platz-Hash an api.deckloud.com. Auf einem lizenzierten Server erhält sie ein signiertes Lizenz-Token und prüft es auf dem Gerät.

Was die Apps senden, steht vollständig auf der Sicherheitsseite.

Voraussetzungen

  • Nextcloud mit der App Nextcloud Deck und ein Konto in der Gruppe admin.
  • Nutzer mit der aktuellen Version von Deckloud für iPhone und iPad, Android oder den Desktop (Mac mit Apple Silicon, Windows 11, Linux).
  • Lizenzschlüssel: Verwaltungsseite, Deckloud für den Desktop oder die Android-App. iPhone und iPad zeigen nur den Lizenzstatus.
  • Für den Status ohne Schlüssel muss der Server per HTTPS aus dem Internet erreichbar sein. Andere Server nutzen den Schlüssel, siehe server_unreachable.
  • Die Geräte brauchen HTTPS-Zugriff auf api.deckloud.com oder eine Offline-Lizenz.

Lizenz kaufen

Wählen Sie auf der Seite für Organisationen die Zahl der Nutzer und bezahlen Sie per Karte bei Polar. Polar stellt eine Rechnung mit ausgewiesener USt. aus, und wir senden den Lizenzschlüssel an die beim Kauf angegebene E-Mail-Adresse.

Ohne den Schlüssel einzufügen geht es, wenn Sie sich zuerst als Admin des Servers bestätigen: Geben Sie auf der Verwaltungsseite die Serveradresse ein, mit der sich die Nutzer anmelden, und wählen Sie Als Server-Administrator bestätigen, oder öffnen Sie in Deckloud für den Desktop Einstellungen > Konto > Für Teams und wählen Sie Im Browser bestätigen. Bezahlen Sie innerhalb einer Stunde nach der Bestätigung, verknüpft der Kauf, den Sie dort starten, diesen Server, sobald die Zahlung eingegangen ist; sonst aktivieren Sie den Schlüssel aus der E-Mail.

api.deckloud.com prüft die Gruppe admin über Nextcloud Login Flow v2 und lässt Nextcloud danach das App-Passwort löschen. Ein fehlgeschlagenes Löschen wiederholt es bis zu 30 Tage lang.

Lizenzschlüssel aktivieren

Nach dem Kauf auf der Seite für Organisationen aktivieren Sie den Schlüssel aus der E-Mail an einer dieser Stellen:

  • Auf der Verwaltungsseite: Geben Sie Serveradresse und Schlüssel ein und wählen Sie Schlüssel für diesen Server aktivieren.
  • In Deckloud für den Desktop unter Einstellungen > Konto > Für Teams, als Admin angemeldet: Fügen Sie den Schlüssel ein und wählen Sie Für diesen Server aktivieren.

Bewahren Sie die E-Mail auf: Der Schlüssel wird nie wieder angezeigt, und nur mit ihm fügen Sie Server hinzu und öffnen das Polar-Kundenportal.

Lizenz verwalten

Die Verwaltungsseite und Einstellungen > Konto > Für Teams zeigen den Lizenzstatus. Ihre Rechte hängen davon ab, wie Sie die Lizenz öffnen:

AktionMit dem SchlüsselMit Admin-Bestätigung
Status, gemeldete Nutzer und Server ansehenGesamte LizenzStatus und nur eigener Server
Nextcloud-Gruppe und Analyse-Richtlinie festlegenJaNur Testphase
Server entfernenJeden Server der LizenzNur eigenen Server, von jeder Lizenz
Server hinzufügenJaNein
Polar-Kundenportal öffnenJaNein

Eine Admin-Bestätigung gilt 1 Stunde.

Was die Nutzer sehen

Die Nutzer melden sich wie gewohnt an, mehr ist nicht nötig. Unter Einstellungen > Konto > Für Teams steht dann, dass Ihre Organisation Pro auf diesem Server bereitstellt.

Pro der Organisation gilt nur, solange das Konto auf Ihrem Server in Deckloud aktiv ist. Andere Konten auf dem Gerät, etwa ein privates, erhalten es nicht. Private Pro-Käufe bleiben gültig.

Die Apps prüfen die Lizenz regelmäßig. Mit Erneut prüfen unter Für Teams prüfen Nutzer sofort.

Server und Adressen

Eine Lizenz ist an die genaue Serveradresse gebunden, die Nutzer in Deckloud eingeben. Eine Business-Lizenz verknüpft bis zu 2 Server, etwa Produktiv- und Testsystem. Provider-Lizenzen haben kein Serverlimit, siehe Provider-Tarif.

Eine zweite Adresse desselben Servers zählt als eigener Server, verknüpfen Sie also auch diese. Jede Adresse gehört immer nur zu einer aktiven Lizenz.

Zu einer neuen Serveradresse wechseln

Fügen Sie die neue Adresse mit dem Schlüssel hinzu und entfernen Sie danach die alte auf der Verwaltungsseite. Nutzer der alten Adresse wechseln bei der nächsten Lizenzprüfung zu Free; gelöscht wird nichts.

Lizenz auf eine Gruppe beschränken

Standardmäßig erhält jeder Nutzer Ihrer Server Pro. Zum Beschränken geben Sie in der App oder auf der Verwaltungsseite unter Nextcloud-Gruppe eine Gruppen-ID ein, nicht den Anzeigenamen.

Die Apps prüfen die Mitgliedschaft auf dem Gerät anhand der Nextcloud-Gruppen des Nutzers; Deckloud kennt nur die Gruppen-ID. Ein Gruppenwechsel startet die Zählung der gemeldeten Nutzer neu. Nutzer außerhalb der Gruppe sehen not_in_group.

Analyse-Richtlinie

Schalten Sie in der App oder auf der Verwaltungsseite Nutzungsanalyse ausschalten ein. Apps mit dem Lizenz-Token senden dann keine Nutzungsanalyse und zeigen die Einstellung als verwaltet an. Nutzer außerhalb der lizenzierten Gruppe erhalten kein Token; für sie gibt es den MDM-Schlüssel analytics. Details: Sicherheitsseite.

Plätze

Die Bedingungen verlangen einen Platz für jede Person, die Deckloud auf den Servern der Lizenz nutzt. Eine Nextcloud-Nutzer-ID auf Produktiv- und Testsystem braucht einen Platz. Konten, die Deckloud nie nutzen, brauchen keinen.

Neben den Plätzen zeigen Verwaltungsseite und App die in den letzten 30 Tagen gemeldeten Nutzer: mit dem Schlüssel. Nach 30 Tagen ohne Nutzung fällt ein Nutzer heraus, etwa bei einem deaktivierten Konto.

Ohne Zugriff auf Ihren Server kann Deckloud diese Meldungen nicht prüfen; die Zahl dient nur zur Information und entzieht nie Pro. Übersteigt sie die Plätze, sehen Sie over_limit.

Kündigung, Ablauf und Widerruf

Kündigen Sie im Polar-Kundenportal. Die Lizenz bleibt bis zum Ende des bezahlten Zeitraums aktiv. Danach enden Lizenz und Tokens, und die Apps wechseln zu Free.

Nach einer Erstattung oder einem Widerruf wechseln die Apps bei der nächsten Lizenzprüfung zu Free oder wenn ihr Token abläuft. Dabei wird nichts gelöscht, und wer Pro selbst gekauft hat, behält es.

Lizenzschlüssel verloren

Fordern Sie auf der Seite zur Wiederherstellung mit Bestell-E-Mail und Bestellnummer einen neuen Schlüssel an; wir senden ihn an die beim Kauf angegebene Adresse. Der alte Schlüssel gilt dann nicht mehr; bereits verknüpfte Server behalten die Lizenz.

Meldungen

Diese Meldungen zeigen die Deckloud-App und die Verwaltungsseite.

invalid_key: Der Lizenzschlüssel ist ungültig

Zu diesem Schlüssel gibt es keine Lizenz. Prüfen Sie ihn auf Tippfehler: Ein Schlüssel beginnt mit DLK- und hat 5 Gruppen zu je 5 Zeichen. Nach einer Wiederherstellung gilt nur der neue; Schlüssel wiederherstellen, falls nötig.

license_inactive: Die Lizenz ist beendet

Das Abonnement ist beendet oder wurde nicht bezahlt. Prüfen Sie es im Polar-Kundenportal und versuchen Sie es nach der Zahlung erneut.

license_revoked: Die Lizenz wurde widerrufen

Die Lizenz wurde erstattet oder widerrufen. Die Apps wechseln bei der nächsten Lizenzprüfung zu Free, gelöscht wird nichts. Halten Sie das für einen Fehler, schreiben Sie mit Ihrer Bestellnummer an partners@deckloud.com.

origin_limit: Das Serverlimit der Lizenz ist erreicht

Eine Business-Lizenz verknüpft bis zu 2 Server. Entfernen Sie auf der Verwaltungsseite einen Server, den Sie nicht mehr brauchen, und fügen Sie dann den neuen hinzu.

origin_taken: Der Server nutzt eine andere Lizenz

Diese Adresse ist schon mit einer anderen aktiven Lizenz verknüpft. Bestätigen Sie sich auf der Verwaltungsseite als Server-Administrator, entfernen Sie diese Lizenz und aktivieren Sie dann Ihren Schlüssel.

origin_shared: Die Serveradresse wird geteilt

Diese Adresse nutzen viele Netze: eine private IP-Adresse, ein einteiliger oder allgemeiner lokaler Name wie nextcloud.local oder ein Deckloud-Server. Ein Schlüssel bindet sie nicht, denn die Lizenz gälte für jeden Server mit dieser Adresse. Geben Sie Ihrem Server einen eigenen Namen oder schreiben Sie an partners@deckloud.com, falls er keinen hat.

verification_required: Auf dem Server läuft eine Testphase

Der Schlüssel würde die Testphase auf diesem Server beenden, und das darf nur dessen Admin. Bestätigen Sie sich auf derselben Seite als Admin; dann übernimmt der Schlüssel die Testphase, und die Nutzer behalten Pro.

trial_server: Eine Testphase bleibt auf ihrem Server

Eine Testphase bleibt bis zu ihrem Ende auf ihrem Server und lässt sich nicht entfernen. Aktivieren Sie einen gekauften Schlüssel für diesen Server, dann übernimmt er die Testphase.

trial_used: Keine Testphase verfügbar

Deckloud bietet keine Testphasen mehr an, und ältere App-Versionen zeigen diese Meldung, wenn Sie eine starten. Kaufen Sie eine Lizenz und aktivieren Sie sie; die Daten der Nutzer bleiben erhalten.

not_admin: Das Konto ist kein Server-Admin

Das im Browser angemeldete Konto ist nicht in der Nextcloud-Gruppe admin. Nutzen Sie ein Admin-Konto oder lassen Sie sich von einem Admin in die Gruppe aufnehmen.

server_unreachable: api.deckloud.com erreicht den Server nicht

Die Admin-Bestätigung braucht eine öffentliche HTTPS-Adresse. Prüfen Sie Adresse, TLS-Zertifikat und Firewall. Ist der Server nur im internen Netz erreichbar, aktivieren Sie die Lizenz mit ihrem Schlüssel. Zu privaten IP-Adressen und lokalen Namen siehe origin_shared.

origin_invalid: Die Adresse ist ungültig

Geben Sie die Serveradresse so ein, wie Nutzer sie in Deckloud eingeben, zum Beispiel https://cloud.example.com.

unauthorized: Die Bestätigung ist abgelaufen

Die Admin-Bestätigung gilt 1 Stunde, und manche Aktionen brauchen den Schlüssel. Bestätigen Sie sich erneut oder öffnen Sie die Lizenz mit dem Schlüssel.

not_found: Keine Lizenz gefunden

Mit dieser Adresse ist keine Lizenz verknüpft, oder die Bestellung wurde nicht gefunden. Prüfen Sie, ob Nutzer genau diese Adresse in Deckloud eingeben. Aktivieren Sie dann einen Schlüssel oder kaufen Sie eine Lizenz.

invalid_request: Die Anfrage wurde nicht angenommen

api.deckloud.com hat die Anfrage abgelehnt, etwa weil ein Feld fehlte. Aktualisieren Sie Deckloud und versuchen Sie es erneut.

rate_limited: Zu viele Anfragen

Dieses Netz oder dieser Lizenzschlüssel hat zu viele Anfragen gesendet. Warten Sie eine Stunde und versuchen Sie es erneut.

unavailable: Organisationslizenzen sind gerade nicht verfügbar

api.deckloud.com ist ausgefallen, wird gewartet oder nimmt gerade keine neuen Bestätigungen an. Versuchen Sie es später erneut. Die Geräte behalten Pro bis zum Ablauf ihres Tokens, höchstens 30 Tage.

Netzwerkfehler: api.deckloud.com ist nicht erreichbar

Das Gerät hat api.deckloud.com nicht erreicht. Prüfen Sie Verbindung, Proxy und Firewall. Die Geräte behalten Pro bis zum Ablauf ihres Tokens, höchstens 30 Tage nach der letzten erfolgreichen Prüfung.

Die Synchronisierung mit diesem Nextcloud-Konto ist pausiert

Nextcloud hat das App-Passwort des Kontos abgelehnt oder Deckloud gebeten, langsamer zu werden. Deckloud pausiert dann alle Anfragen für dieses Konto, auch die Lizenzprüfung. Melden Sie sich erneut an oder versuchen Sie es in einigen Minuten erneut.

renewal_failed: Die Verlängerung ist fehlgeschlagen

Polar konnte die letzte Verlängerung nicht abbuchen und versucht es erneut. Aktualisieren Sie die Zahlungsmethode im Polar-Kundenportal. Die Lizenz bleibt bis 7 Tage nach Ende des bezahlten Zeitraums aktiv.

expires_soon: Die Lizenz endet bald

Die Lizenz endet innerhalb von 14 Tagen und verlängert sich nicht, meist nach einer Kündigung. Setzen Sie das Abonnement im Polar-Kundenportal fort, damit Ihre Nutzer Pro behalten.

over_limit: Mehr Nutzer als Plätze

Die Apps haben in den letzten 30 Tagen mehr Nutzer gemeldet, als die Lizenz Plätze hat. Alle behalten Pro, doch die Bedingungen verlangen mehr Plätze. Fügen Sie sie im Polar-Kundenportal hinzu oder beschränken Sie die Lizenz auf eine Gruppe.

trial_ends_soon: Die Testphase endet bald

Die Testphase endet innerhalb von 7 Tagen. Kaufen Sie eine Lizenz und aktivieren Sie den Schlüssel für den Server, damit Ihre Nutzer Pro ohne Unterbrechung behalten.

no_license: Dieser Server hat keine Lizenz

Für diese Serveradresse gibt es keine aktive Lizenz. Aktivieren Sie einen Schlüssel oder kaufen Sie eine Lizenz. Die Apps fragen nach 24 Stunden erneut oder sobald der Nutzer Erneut prüfen wählt.

not_in_group: Nutzer außerhalb der lizenzierten Gruppe

Die Lizenz ist auf eine Nextcloud-Gruppe beschränkt, in der dieser Nutzer nicht ist. Nehmen Sie ihn in die Gruppe auf, wählen Sie eine andere Gruppe oder heben Sie die Beschränkung auf. Die App übernimmt das bei der nächsten Lizenzprüfung.

Support

Schreiben Sie an partners@deckloud.com, auf Deutsch oder Englisch, mit der Serveradresse und der Lizenz-ID von der Verwaltungsseite. Wir antworten innerhalb von 2 Werktagen, ohne SLA und ohne Telefonsupport.