Licence

Elowen běží s licencí vázanou na Vaši instalaci. Bez použitelné licence zůstává démon uzamčený: webová aplikace zobrazí stránku Vyžadována licence a odpovídají jen licenční routy (GET /health, GET /setup, GET /licence, POST /licence/activate); vše ostatní vrací licence_locked, dokud licenci neaktivujete.

Aktivace

Tři způsoby, všechny rovnocenné:

• Při instalaci. Spusťte instalátor a zadejte klíč do jeho skrytého dotazu. <licence-server> nahraďte adresou licenčního serveru od svého poskytovatele:

  curl -fsSL https://<licence-server>/hooks/licensing/v1/install.sh | bash

  Pro instalace bez dozoru nastavte ELOWEN_LICENCE_KEY v prostředí z Vašeho úložiště tajemství a předejte instalační přepínače přes ELOWEN_INSTALL_ARGS. Klíč nikdy nedávejte na příkazový řádek, ani jako vložené KEY=value: unikne do historie shellu a seznamu procesů.
• Na uzamčené stránce. Otevřete webovou aplikaci, zadejte aktivační klíč a stiskněte Aktivovat. Démon se poté sám restartuje.
• V terminálu. Spusťte:

  elowen licence activate

  Klíč pochází z proměnné prostředí ELOWEN_LICENCE_KEY nebo ze skrytého dotazu. Nikdy ho nepředávejte jako argument příkazu: argumenty unikají do seznamu procesů i do historie shellu.

elowen licence bez argumentů ukáže aktuální stav: zákazníka, datum vypršení, pokryté pluginy a konec ochranné lhůty (viz níže). Když je licence uzamčená, ukáže místo toho důvod a ID instalace. Administrátoři vidí stav také v Nastavení → Systém na kartě Licence, mohou tam klíč nahradit volbou Nahradit aktivační klíč nebo stisknout Zkontrolovat teď a hned kontaktovat licenční server.

Kontrola vazby před instalací

Instalátor ověří klíč dřív, než na stroji cokoli změní. Pokud existuje licence.json, přečte z něj ID instalace (přeinstalace si své ID ponechá) a zeptá se licenčního serveru, zda tam klíč smí být použit. Neplatný, vypršelý nebo zrušený klíč, případně klíč už aktivovaný na jiném serveru, instalaci zastaví s vysvětlující zprávou a stroj zůstane nedotčený. Samotná kontrola klíč nikdy nezaváže. Teprve po jejím úspěchu instalace klíč aktivuje, čímž ho zaváže k tomuto stroji.

Proč se objeví uzamčená stránka

Stránka uvede důvod:

• Není nainstalovaná žádná licence. Aktivujte ji některým ze způsobů výše.
• Licence vypršela. Obnovte ji u svého poskytovatele a potom aktivujte nový klíč.
• Licenční server je příliš dlouho nedostupný. Instalace překročila svou 7denní ochrannou lhůtu (viz níže). Obnovte serveru přístup k internetu: démon se sám ozve a při uložené licenci se odemkne během několika minut, jinak aktivujte svým klíčem znovu.
• Licenční server tuto instalaci odmítl. Licence byla zrušena nebo přesunuta. Obraťte se na podporu.
• Tato licence byla vydána pro jiný server. Každá licence patří k jednomu ID instalace. Aktivujte klíč určený pro tento server.
• Licence na tomto serveru není platná. Strukturálně poškozený licence.json znemožňuje start i aktivaci: démon nenastartuje a zadání klíče soubor neopraví. Obnovte licence.json ze zálohy stejné instalace, nebo požádejte podporu o odpovídající záznam. Soubor nikdy nemažte: nový soubor nese nové ID instalace, takže klíč vázaný ke starému ID je pak odmítnut jako patřící jinému serveru.

Ochranná lhůta a kontroly

Elowen nepotřebuje trvalé spojení s licenčním serverem. Démon se hlásí zhruba každých 6 hodin a vždy, když stisknete Zkontrolovat teď. Každé úspěšné hlášení obnoví 7denní ochrannou lhůtu: pokud se server stane nedostupným, Elowen běží dál až do konce ochranné lhůty.

• Po 24 hodinách bez kontaktu vidí administrátoři varování Licenční server je nedostupný s datem, do kterého instalace poběží.
• 14 dní před vypršením vidí administrátoři varování Licence brzy vyprší.
• Restart ochrannou lhůtu neprodlužuje: konec lhůty je součástí podepsané licence, nikoli místních hodin.

Pokud hlášení ukáže, že licence už nepokrývá plugin od vydavatele, který byl načten při startu, Elowen se restartuje, aby ho odstavil. Pluginů, které jste přidali sami, se to netýká.

Poznámky k hodinám

Licence nese čas podpisu ze serveru, který démon porovnává s místními hodinami. Udržujte hodiny serveru synchronizované (NTP). Malé rozdíly do 5 minut jsou tolerovány.

Démon také zaznamenává nejnovější čas, který kdy viděl, a tento záznam se nikdy nevrací zpět. Vrácení hodin nemůže oživit vypršelou ochrannou lhůtu. Stejný záznam funguje i opačně: hodiny nastavené daleko dopředu v záznamu zůstanou, takže ochranná lhůta může skončit dřív, než by měla, a instalace se může uzamknout i po opravě hodin. Pokud se to stane, zkontrolujte hodiny a licenci aktivujte nebo obnovte.

Kde licence žije

Licenční soubor je licence.json a leží ve složce instance (ve výchozím nastavení ~/.config/elowen/, případně ve složce, na kterou ukazuje ELOWEN_INSTANCE_ROOT). Obsahuje ID instalace a licenční token a číst ho může jen jeho vlastník.

Zálohujte a obnovujte společně: databázi PostgreSQL a složku instance s licence.json a klíčem tajemství pluginů plugin-secrets.key. Každá instalace má vlastní ID uložené v licence.json, proto na každém stroji aktivujte samostatný klíč, místo abyste soubor mezi nimi kopírovali.

Hlášení problémů

Hlášení problémů je vypnuté, dokud ho administrátor nezapne. Přepínačem je řádek Hlášení problémů v Nastavení → Systém a vidí ho jen administrátoři. Zapnutí vyžádá potvrzení. Vypnutí zastaví odesílání a vymaže dávku, která ještě nebyla odeslaná.

Dokud je zapnuté, posílá Elowen varování a chyby samotného démona provozovateli licenčního serveru Elowen. Záznamy, které Elowen označí jako pouze místní, se neodesílají nikdy. Problém, který přichází z hostitele a nikoli z kódu Elowen, například výpadek databáze nebo zaseknutí smyčky událostí vysvětlené naměřenou mezerou v plánování hostitele, se do hlášení dostane až po zopakování: tři výskyty během pěti minut a pak každý další, dokud se opakuje. Jeden nebo dva výskyty zůstanou v místním protokolu. Každé hlášení obsahuje:

• kódy problémů a kolikrát se každý vyskytl, s úrovní varování nebo chyby;
• názvy a verze všech nainstalovaných pluginů, včetně soukromých a nelicencovaných, a verzi Elowen;
• až tři ukázky textu zprávy u každého problému;
• u varování o zpomalení démona poslední měření hostitele: CPU, RAM, kapacitu disku, rychlosti diskového I/O a sítě, včetně času měření. Může být o minutu i víc starší než varování, pokud se vzorkování zpozdilo.

Než se ukázka uloží nebo odešle, zkrátí se na 500 znaků a odstraní se z ní klíče, tokeny, hesla, cookies, parametry URL, e-mailové adresy, IP adresy, identifikátory a cesty k adresářům. Zbylý text může stále obsahovat názvy poskytovatelů, modelů, částí pluginů, hostitelů nebo jména osob. Každá hlášená zpráva odesílá svůj redigovaný text, včetně zpráv, které mohou nést obsah konverzace nebo obchodní údaje.

Hlášení nesou licenční token, proto se doručují jen dokud je licence aktivní. Provozovatel je uchovává nejvýše 14 dní. Vypnutí hlášení nemůže odvolat data, která už byla přijata. Stavový řádek u položky hlášení ukazuje stav doručení: Připraveno, Doručeno, Opakování, Neplatná licence, Server nedostupný nebo Chyba úložiště.

Další: Konfigurace