README javítva

3 files changed, 240 insertions, 4 deletions

diff --git a/egyéb/nextcloud/README b/egyéb/nextcloud/README
index 922f2d41..85eb8da5 100644
--- a/egyéb/nextcloud/README
+++ b/egyéb/nextcloud/README
@@ -27,10 +27,12 @@ Beállítása az alábbiak szerint: (egy lehetséges elrendezés)
 -(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)
+        Majd töltsük ki a konfigurációs fájlt az alább felsorolt beállítások szerint!
 
 
 
--(III.) A fajl elején találhatóak a konfigurációs adatok, ezeket a következőképpen módosíthatjuk:
+
+-(III.) A "mayor-nextcloud.cfg.php" 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.
diff --git a/egyéb/nextcloud/mayor-nextcloud.cfg.php b/egyéb/nextcloud/mayor-nextcloud.cfg.php
index 4d7ff222..0343d3f2 100644
--- a/egyéb/nextcloud/mayor-nextcloud.cfg.php
+++ b/egyéb/nextcloud/mayor-nextcloud.cfg.php
@@ -1,6 +1,6 @@
 <?php 
 
-//////////////////////// Figyelem! Az alábbi config érvényes a Mayor-Nextcloud scripthez, nem a script fejléce!!  ////////////////////////////
+//////////////////////// Figyelem! Az alábbi config érvényes a Mayor-Nextcloud scripthez, nem a "mayor-nextcloud.php" fejléce!!  ////////////////////////////
 
 
 $db = array();
@@ -37,4 +37,238 @@ $occ_path = "/var/www/nextcloud/";
 $occ_user = "www-data";
 
 
+
+
+/*
+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)
+	Majd töltsük ki a konfigurációs fájlt az alább felsorolt beállítások szerint!
+
+
+
+-(III.) A "mayor-nextcloud.cfg.php" 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['min_osztalyok'] =  array( );                  //Ide lehet felsorolni az osztályokat, ha konkrét osztályokat akaruni importálni,
+                                                        // ez logikai (megengedő) VAGY kapcsolatban van a $m2n['min_evfolyam'] -mal.
+                                                        //  Tehát ha beállítunk egy minimális évfolyamot, a felsorolt osztályok akkor is importálódnak,
+                                                        //  ha a minimális évfolyamnál kisebb.   //pl:  array('9.a','11.a');
+
+    $m2n['csoportnev_hossz'] = 40;                      // Formázott kimenet: Kiegészíti "space"-kkel a kimenetet, ha rövidebb lenne a csoport neve.
+
+    $m2n['felhasznalo_hossz'] = 45;                     // Formázott kimenet: Kiegészíti "space"-kkel a kimenetet, ha rövidebb lenne a felhasználó valódi neve.
+
+    $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['zaras_tartas'] =  "2018-06-19";               //A jelölt napon befejezett, de nem lezárt tanév adatainak megtartása. (pl. szeptemberig) 
+							// Ha már nem kell, akkor állítsd "1970-01-01"-ra !;
+							
+    $m2n['verbose'] = 3                                 //Log bőbeszédűség      (A leg informatívabb(tömörebb), 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
+
+    $cfgfile  = ".mayor-nextcloud.cfg.php";             //Lehetőség van a konfig-fejléc exportálására egy külön fájlba, 
+                                                        // így a mayor-nextcloud scriptet nem kell szerkeszteni, ha frissítés érkezik hozzá.
+                                                        // Ez alapértelmezetten a maxor-nextcloud.php -val kell egy könyvtárba legyen.
+                                                        
+
+	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. )
+
+
+	
+
+*/
+
 ?>
+
diff --git a/egyéb/nextcloud/mayor-nextcloud.php b/egyéb/nextcloud/mayor-nextcloud.php
index 48496bc3..3b29e9c2 100644
--- a/egyéb/nextcloud/mayor-nextcloud.php
+++ b/egyéb/nextcloud/mayor-nextcloud.php
@@ -2,7 +2,7 @@
 <?php 
 $db = array();
 $m2n = array();
-////////////////////////////////////////////// Figyelem! az alábbi konfig külön fájból töltődik/töltődhet!! /////////////////////////////////
+////////////////////////////////////////////// Figyelem! az alábbi konfig automatikusan külön fájból töltődik, ha létezik a "mayor-nextcloud.cfg.php" fájl!! /////////////////////////////////
 $db['host'] = "localhost";
 $db['port'] = "3306";
 $db['user'] = "root";
@@ -27,7 +27,7 @@ $m2n['csoportnev_hossz'] = 40;
 $m2n['felhasznalo_hossz'] = 45;
 $m2n['default_lang']  = "hu";
 $m2n['mindenki_csop'] = "naplós_felhasználók";
-$m2n['zaras_tartas'] =  "2018-06-14";	// Ha nem kell, akkor állítsd át "1970-01-01"-re.
+$m2n['zaras_tartas'] =  "2018-06-14";	//A jelölt napon befejezett, de nem lezárt tanév adatainak megtartása. (pl. szeptemberig) Ha már nem kell, akkor állítsd "1970-01-01"-ra !;
 $m2n['verbose'] = 3 ;  
 
 $occ_path = "/var/www/nextcloud/";