diff options
Diffstat (limited to 'egyéb/nextcloud/README')
| -rw-r--r-- | egyéb/nextcloud/README | 215 |
1 files changed, 215 insertions, 0 deletions
diff --git a/egyéb/nextcloud/README b/egyéb/nextcloud/README new file mode 100644 index 00000000..bb620cf5 --- /dev/null +++ b/egyéb/nextcloud/README @@ -0,0 +1,215 @@ + +Nextcloud(13) - Mayor script + +Ezen script segítségével a Mayor-naplóból tudunk felhasználókat és csoportokat importálni a Nextcloud felhőbe, +létrehozva ezzel a saját, iskolai felhőszolgáltatásunkat. + +Ez a script lényegében annyit csinál, hogy a mysql-ből lekérdezi a mayor diák-tankör-tanár kapcsolatokat, +majd a tankörök nevei alapján létrehozza a csoportokat és a felhasználókat a Nextcloud szerveren, +majd belépteti ezen csoportokba a diákokat, és tanárokat, megspórolva ezzel a kézi (egyesével történő) feltöltést, +és egy csomó időt az adminisztrátornak. + +Támogatja a külön, illetve az egy, közös szerverre történő telepítését a mayornak és a nextcloud-nak. **(lásd: Szeparációs lehetőségek rész.) +Egyelőre még csak a Nextcloud 13.x -mal tesztelt. + +FONTOS! + Legalább "php7.0" és "Apache 2.4" kell hozzá! + + + +Beállítása az alábbiak szerint: (egy lehetséges elrendezés) + +-(I.) Először telepítsünk föl egy Nextcloud(13+) szervert egy Debian 9+ szerverre, + szükség van e-mail küldés (smtp) szolgáltatásra is. (ez lehet külső, pl.: google) + Bővebb leírást a telepítésről a + https://docs.nextcloud.com/server/13/admin_manual/installation/index.html oldalon találunk. + +-(II.) Helyezzük el a "mayor-nextcloud.php"-t biztos, védett helyre,a nextcloud szerveren, akár a /etc/ mappába, akár a /root könyvtárba, + ezt később "root"-ként kell majd futtatnunk, és mysql jelszó is (lehet/) van benne, + ezért ennek megfelelően állítsuk be a tulajdonost, és vegyük el a jogosultságokat. (chown root; chmod 600) + + + +-(III.) A fajl elején találhatóak a konfigurációs adatok, ezeket a következőképpen módosíthatjuk: + + + $db['host'] = "localhost"; //Ez a nextcloud alatt futó mysql elérhetősége. + // (Csak localhost lehet, a scriptet a nextcloud-szerveren kell futtatnunk.) + + $db['port'] = "3306"; //nextcloud-mysql port + + $db['user'] = "root"; //nextcloud-mysql felhasználónév + // HA nem a root-ot használjuk, akkor, a használt felhasználónak írási-olvasási-törlési + // (insert,select,update,delete) joggal kell rendelkeznie a nextcloud adatbázis "..groups" tábláján, + // valamit saját kezűleg kell létrehozni a script saját, nyilvántartó adatbázisát, és a fenti jogokat beállítani rá. + // Ha a Debian-on alapértelmezett root-ot használjuk, akkor mindez automatikusan történik. + + $db['pass'] = ""; //A nextcloud-mysql jelszó (pl a "root" felhasználónévhez tartozó) + // érdemes a debian 9.x-en, a root-hoz alapértelmezett "unix_socket" bejelentkezési módot + // használnunk, ez biztonságosabb, mert nem jön létre "olvasható" jelszó. + + + + $db['nxt_dbname'] = "nextcloud"; //A Nextcloud által használt adatbázis neve. + $db['nxt_prefix'] = "oc_"; //A Nextcloud által használt adatbázisban a táblák prefix-je. (ha van) + + + $db['m2n_db'] = "mayor_to_nextcloud"; //A nyilvántartó adatbázis neve. + // Ennek az adatbázisnak a nextcloud-mysql szerveren kell lennie! + // + // Ebben az adatbázisban könyveli el a script által létrehozott felhasználókat, azért, + // hogy így meg tudja különböztetni, a saját maga által létrehozottakat, az Adminisztrátor + // által, külön létrehozott felhasználóktól. + + $db['m2n_prefix'] = "m2n_"; //A nyilvántartó adatbázisban használt prefix, ha van. (ha nincs, akkor "üres string"-re kell állítani) + + + //$db['mayor_host'] = ""; //Akkor használatos, ha a mayor alatti mysql szerver egy másik szerveren van. + //$db['mayor_port'] = ""; // ekkor ki kell venni kommentből, és ki kell tölteni a mayor-mysql serverre érvényes adatokkal. + //$db['mayor_user'] = ""; + //$db['mayor_pass'] = ""; //A kiválasztott felhaználónak olvasnia (GRANT SELECT) kell tudnia a mayor-mysql serveren a(z): + // intezmeny_xxx, mayor_parent, naplo_xxx_yyyy adatbázisokból. + + //Ha a mayor-mysql sezvere fizikailag (vagy virtuálisan) másik szerveren van, akkor érdemes egy "ssh-tunnel"-lel + // áthozni a portját a nextcloud-serverre. (ez a legbiztonságossabb) + + + $m2n['isk_rovidnev'] = "rovid"; //A mayor-ban használt "iskola rövidneve" megnevezés. + + $m2n['min_evfolyam'] = 10; //A minimális évfolyam, amelytől fölfelé engedélyezzük a felhő használatát a diákoknak. + + $m2n['csoport_prefix'] = "(tk) "; //A Nextcloud-ban ezzel az előtaggal jelennek majd meg mayor-ból importált csoportok, a jobb átláthatóság érdekében. + + + + $m2n['default_email'] = "rendszergazda@iskola.hu"; //Ha a mayor intezmeny_xxx.diak, vagy az intezmeny_xxx.tanar táblákban nincs kitöltve az + // e-mail, akkor ezt használja alapértelmezetten. + // (ide megy a jelszó-emlékeztető, amíg a felhasználó birtokba nem veszi a fiókját) + + $m2n['default_passw'] = "EHYmGktzrdfS7wxJR6DFqxjJ"; //Az induló jelszó a Nextcloud-ban a felhasználóknak. (érdemes erőset megadni, a botnet-ek miatt) + + $m2n['default_quota'] = "10GB"; //Az induló fájl-kvóta a Nextcloud-ban. + + $m2n['default_lang'] = "hu"; //Az alapértelmezett nyelv (később minden felhasználó átállíthatja magának) + + $m2n['mindenki_csop'] = "naplós_felhasználók"; //A Nextcloud "mindenki" csoportja + // ebbe a "mindenki" csoportba minden, a script által létrehozott felhasználó bekerül. + + $m2n['verbose'] = 3 //Log bőbeszédűség (A leg informatívabb, talán a 3-mas fokozat.) + // 0: csak fatális hibák, 1: fontosabbak, 2: csop./felh. elvétel, 3: csop./felh. hozzáadás, + // 4: csop./felh. tények, 5: részletesebben, 6: sql query + bash parancsok kiírása + + + $occ_path = "/var/www/nextcloud/"; //A Nextcloud-server fájljainak elérési útja. (DocumentRoot) + // Erre szükség van a nextcloud "occ" parancsának eléréséhez. + + $occ_user = "www-data"; //A Nextcloud-servert futtató (Apache) felhasználónév + + + + FONTOS!! + A Nextcloud szerver "occ" parancsa elérhető kell legyen a script számára! + Az "occ" parancs működését pl. az: (>>> sudo -u www-data php /var/www/nextcloud/occ ) kiadásával ellenőrizzük! + + Lehetőség van a scriptet a "--loglevel xx" kapcsolóval is indítani. (>>> php mayor-nextcloud.php --loglevel 3 ) + + + + További Információk: + + Lehetőség van egy-egy felhasználó letiltására, ezt a nyilvántartó adatbázisban tehetjük meg, a "register" tábla, + az adott felhasználónévhez tartozó "status" mezőjének "forbidden"-re állításával. + Ekkor a script nem fog foglalkozni, az adott felhasználóval a továbbiakban. + + + Esetleg érdemes lehet a scriptet betenni a "cron"-ba (éjszakára), így naponta lefut, és követi napló változásait. + (Ez esetben figyelni kell arra, hogy mayorban a tankör-diák, tankör-tanár összerendelések az év végén lejárhatnak, (pl. júni. 15-én) + így a script futtatása júni. 16-án kitörli, letiltja az összes létrehozott mayor-os csoportot, és felhasználót a nextcloud-ból, + amely csak a script szept. 1-je után történő futtatásával hozható vissza, + ezért érdemes lehet a script automatikus futtatását átmenetileg júni. 15. és szept. 1. között felfüggeszteni. ) + (pl: /etc/crontab -ban + 01 3 * * * root php -f /root/mayor-nextcloud.php ) + + + A mayor által ajánlott "Vezetéknév.Keresztnév" típusú felhasználónév formátum, bár hasznos, mert könnyen megjegyezhető, + viszont (sajnos) egyáltalán nem POSIX kompatibilis (amely csak az angol ABC betűit +pár kiegészítő karaktert engedélyez) + így a legtöbb rendszerrel nem hozható összhangba, ezért szükség van az ékezetes karakterek lecserélésére. + + A karakterek cseréje az alábbi módon történik: + + á --> aa Á --> Aa + ä --> ae Ä --> Aae + é --> ee É --> Ee Például: + í --> ii Í --> Ii Vezetéknév.Keresztnév --> Vezeteekneev.Keresztneev + ó --> oo Ó --> Oo Bőrönd.Ödön --> Booeroend.Oedoen + ö --> oe Ö --> Oe + ő --> ooe Ő --> Ooe Ha a mayor felhasználónév nem tartalmaz ékezetes betűt, + ú --> uu Ú --> Uu akkor nem történik csere, a felhasználónév marad az eredeti. + ü --> ue Ü --> Ue + ű --> uue Ű --> Uue + + Ezeket a karakter cseréket maga a script végzi, futás közben, a mayor felhasználónevekből, + a létrejövő Nextcloud felhasználónév már a lecserélt változat lesz. + + + + A mayor-nextcloud script működése néhány mondatban: + + Első lépésben lekérdezi a feltételeknek megfelelő tanköröket a mayorból, (tankör-osztály évfolyama, tankör aktív-e a dátumok apaján) + majd ez alapján ellenőrzi, hogy a Nextcloud-ban már szerepelnek-e ezen tankörneveknek megfelelő csoportok. + Ha új tankör van a mayorban, akkor azt a Nextcloud-ban is létrehozza, ha egy tankört töröltek a mayorból, akkor azt a csoportot Nextcloud-ból is törli. + Fontos! + A csoport prefix-szel, például: "(tk) "-val kezdődő csoportokat magáénak tekinti, és ha nem találja a mayorban, akkor automatikusan töröli! + + Második lépésben lekérdezi a felhasználókat a mayorból, (jogviszony státusz, évfolyam, kapcsolódó tankörök) + csak azokat a tanárokat, illetve diákokat veszi figyelembe, akinek a státusza nem "jogviszonya lezárva", vagy nem "felvételt nyert". + Ha az illető még nem rendelkezik felhasználónévvel a Nextcloud-ban, akkor létrehozza, + - ha a mayorban, az "intezmeny_xxx.diak", illetve az "intezmeny_xxx.tanar" táblákon van beállított e-mail címe, akkor azt használja, + - ha nincs, akkor az alapértelmezettet állítja be a Nextcloud-ba, valamint ekkor állítódik be az alapértelmezett qvóta, és a felhasználó valódi neve is. + (Ezeket később Rendszergazdai, és Felhasználói oldalról változtatni lehet, értelemszerűen.) + Ha az illető már rendelkezik felhasználónévvel, de az le volt tiltva, akkor újra engedélyezi. + + Ezután egyezteti a tankör-csoport összerendeléseket, ha az illető új tankörbe került be, akkor belépteti a megfelelő csportba, + ha kikerült egy tankörből, akkor a csoportból is kilépteti. + + Végül ellenőrzi a kiléptetndő felhasználókat. + Ha velekinek a státusza a mayorban "jogviszonya lezárva"-ra változott, vagy a felhasználónevét a mayorból törölték, akkor + - ha még nem lépett be soha a Nextcloudba, akkor a felhasználót fizikailag törli. + - ha már használta a fiókját, akkor csak letiltja, azért, hogy a fájljai ne vesszenek el automatikusan. + (Ez, utóbbi esetben a Rendszergazdának kell külön elvégezni a törlést.) + + + + + ** Szeparációs lehetőségek: + Biztonsági megfontolásokból nem javasolt a Nextcloud-ot és a mayort ugyanazon Apache szerver és ugyanazon "DocumentRoot" alól futtatni. + Szétválasztásukra többféle lehetőség van: + - külön fizikai szerver mindegyiknek + - külön virtuális szerver mindegyiknek + - külön "DOCKER konténer" mindegyiknek + - külön felhasználónévvel futtatott php + + Természetesen a legerősebb szeparációt az 1. megoldás jelenti, de ugyanakkor előjöhetnek ennek hátrányai is, például, hogy dupla + akkora adminisztrációs teher a rendszergazdának. + Ugyanakkor foglalkoznunk kell azzal a kérdéssel is, hogy ha az iskola vásárol egy komolyabb szervergépet, (ma már) több-tíz gigabájt RAM-mal, + ekkor felesleges pazarlás fizikailag is külön szervergépre telepíteni a kettőt, különösen, ha figyelembe vesszük a mayor (ma már kicsinek számító) + memória igényét is. + + Ekkor jöhet képbe a 2. és 3. lehetőség, amely már ugyanazon fizikai gépre is telepíthető egyszerre, ez már ésszerű elosztást biztosít. + Ám, ha tovább gondoljuk, akkor szóba jöhet az a kérdés is, hogy ekkora fizikai memória (RAM) esetén + miért futtassunk több, különálló mysql-szervert, ahelyett, hogy egy, központi mysql-serverünk lenne, + aminek kiosztunk néhányszor-tíz gigabájt ramot? + (Különösen annak fényében, hogy egy ilyen "felturbózott" mysql sokszorosára növeli a mayor-napló sebességét.) + + Erre a megoldásra születtek a "php külön felhasználónévvel futtatva" típusú lehetőségek. + Ezek közül is a legésszerűbb, és legbiztonságosabb az Apache2 mod_suexec és mod_fcgid segítségével futtatott php. + (Ekkor egy, közös Mysql és Apache2 szerver van, ahol az egyes weboldalak (apache virtualhost-ok) mind, + külön "rendszer felhasználónévvel" futnak, külön "DocumentRoot" könyvtárból, (és külön a www-data felhasználótól) + ahol a felhasználónév váltást a mod_suexec modul végzi, a php futtatását pedig a mod_fcgid. ) + (Természetesen vannak még más megoldások is, mint pl. a php_fpm, de azokat nem javaslom. ) + + + + + + |