1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
|
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['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 tartása tovább, ha már nem kell, akkor állítsd 0-ra.;
$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. )
|
