Ինչպես է այն աշխատում
Վերականգնում և ախտորոշում
Ինչպես վերադարձնել մուտքը վահանակ, երբ ադմինիստրատորի գաղտնաբառը կամ նույնականացուցիչը կորել է, ստուգել սերվերի վիճակը և հավաքել աջակցության արխիվ։
maran հրամանը պետք է գալիս է այն ժամանակ, երբ վահանակ մուտք գործել հնարավոր չէ։
Այն տեղադրվում է վահանակի հետ, ոչ մի ծառայություն, պորտ կամ ցանցային հարցում չի ավելացնում և աշխատում
է միայն սերվերի վրա՝ shell-ից։
| Հրաման | Երբ օգտագործել |
|---|---|
maran admin-reset-password | Ադմինիստրատորը կորցրել է գաղտնաբառը կամ նույնականացուցիչը, իսկ վահանակը չի կարող վերականգնման նամակ ուղարկել։ |
maran status | Պետք է իմանալ, որ ծառայություններն աշխատում են, և ինչ է վահանակը հայտնում իր մասին, նույնիսկ երբ վահանակը չի պատասխանում։ |
maran collect-diagnostics | Պետք է աջակցության արխիվ ուղարկել ձեզ օգնող մարդուն։ |
Գործարկում root-ով
Հրամանը միտումնավոր հասանելի է միայն root-ին, քանի որ կարող է ադմինիստրատորի համար մուտքի տվյալ
թողարկել։ Գործարկեք այն լրիվ ուղիով, որ աշխատի ցանկացած PATH-ի դեպքում, որը պահպանում է ձեր
sudo-ն․
sudo /usr/local/sbin/maran status
Ոչ root օգտատերը ստանում է մեկ տողանոց մերժում և ուրիշ ոչինչ։
Վերականգնել ադմինիստրատորի գաղտնաբառը
sudo /usr/local/sbin/maran admin-reset-password admin@example.com
Նշեք ադմինիստրատորի էլ. փոստի հասցեն կամ օգտանունը։ Հրամանը հետո՝
- Ընդունում է միայն ակտիվ մուտք ունեցող ադմինիստրատորին։ Հաճախորդին, կասեցված ադմինիստրատորին և հրավիրված, բայց հրավերը չընդունած մուտքին հրամանը հստակ մերժում է․ հաճախորդի գոտին ունի իր սեփական վերականգնումը էլ. փոստով։
- Չեղարկում է նախկինում տրված վերականգնման հղումները, ուստի գործող հղումը միշտ մեկն է։
- Հանում է անհաջող մուտքերից առաջացած արգելափակումը և ավարտում է հաշվի բոլոր նիստերը։
- Տպում է վերականգնման հղումը մեկ անգամ, ձեր տերմինալում։ Այն վավեր է մեկ ժամ և աշխատում է
մեկ անգամ։ Հղումը երբեք չի գրվում ո՛չ մատյանում, ո՛չ աուդիտի գրառման մեջ, և հրամանը չի տպի այն
խողովակի կամ ֆայլի մեջ, եթե չեք ավելացրել
--allow-non-terminal։
Բացեք հղումը դիտարկիչում և ընտրեք նոր գաղտնաբառ։ Եթե վահանակի հանրային հասցեն կարգավորված չէ,
հրամանը կտպի /-ով սկսվող ուղի և կասի այդ մասին․ դրա դիմաց ավելացրեք ձեր վահանակի հասցեն։
Յուրաքանչյուր օգտագործում գրանցվում է վահանակի աուդիտի մատյանում և սերվերի նույնականացման մատյանում
(authpriv)՝ հաշվի և երկգործոն պաշտպանության հանվելու նշումով։ Օպերատորի անունը վերցվում է
SUDO_USER-ից․ այն հայտարարված է, չի ստուգված։
Եթե ադմինիստրատոր ընդհանրապես չկա, հրամանը կասի այդ մասին և ադմինիստրատոր ստեղծելու համար կուղարկի առաջին կարգավորման էջ։
Երբ նույնականացուցիչը նույնպես կորել է
sudo /usr/local/sbin/maran admin-reset-password admin@example.com --clear-two-factor
Սա լրացուցիչ հանում է ադմինիստրատորի երկգործոն կապակցումը, և հաջորդ մուտքի համար բավական կլինի նոր գաղտնաբառը։ Օգտագործեք միայն այն դեպքում, երբ նույնականացուցիչն իսկապես կորել է․ մինչև ադմինիստրատորը նորից կապակցի այն, հաշիվն ավելի թույլ է պաշտպանված, ուստի մուտք գործելուց անմիջապես հետո նորից միացրեք երկգործոն պաշտպանությունը։ Առանց այս դրոշի երկգործոն պաշտպանությանը երբեք չի դիպչում։
Երբ ճիշտ երկգործոն կոդերը մերժվում են
Նույնականացուցիչի կոդերը հաշվարկվում են ժամանակից, ուստի ժամացույցը շեղված սերվերը մերժում է ցանկացած ճիշտ կոդ։ Վահանակը հետևում է ժամացույցին․ եթե վերջին ստուգումը ցույց է տվել, որ ժամացույցը ժամանակի աղբյուրի հետ համաժամեցված չէ, կոդը մերժելիս վահանակը դա նշում է («Սերվերի ժամացույցը համաժամեցված չէ…») և չի սահմանափակվում «Կոդը սխալ է» հաղորդագրությամբ։ Գլխավոր էջի «Պահանջում է ուշադրություն» բաժնում հայտնվում է «Սերվերի ժամացույցը համաժամեցված չէ», իսկ «Մոնիտորինգ» էջում պատճառը ցույց է տալիս «Ժամացույց» քարտը։ Երբ ժամացույցը տասը ստուգում անընդմեջ մնում է չհամաժամեցված, օպերատորը նամակ է ստանում, և ևս մեկ նամակ, երբ այն վերականգնվում է։
Վահանակն ինքը ժամանակը չի փոխում։ Միացրեք ժամանակի համաժամեցման ծառայություն, որ կապվի ժամանակի սերվերի հետ․
sudo timedatectl set-ntp true # Debian և Ubuntu՝ systemd-timesyncd
sudo systemctl enable --now chronyd # AlmaLinux և Rocky Linux՝ chrony
timedatectl # փնտրեք «System clock synchronized: yes»
Վահանակը կարդում է միջուկի սեփական եզրակացությունը, իսկ միջուկը ժամացույցը համաժամեցված չի համարում, երբ սխալի իր գնահատականը գերազանցում է տասնվեց վայրկյանը։ Մի քանի վայրկյանով շեղված ժամացույցը, որը միջուկը դեռ համաժամեցված է համարում, չի նշվում։
Փոխել սեփական գաղտնաբառը
Վահանակ մուտք գործած յուրաքանչյուրը՝ ադմինիստրատոր թե հաճախորդ, կարող է փոխել իր գաղտնաբառը էլ. փոստով վերակայման հղման կարիքն ունենալու։ Բացեք ձեր անվան տակի ընտրացանկը, ընտրեք Պրոֆիլ և անվտանգություն և օգտվեք Գաղտնաբառ քարտից․ լրացրեք Ընթացիկ գաղտնաբառ, Նոր գաղտնաբառ և Հաստատեք գաղտնաբառը դաշտերը, ապա սեղմեք Փոխել գաղտնաբառը։
- Նոր գաղտնաբառը պետք է առնվազն այնքան երկար լինի, որքան անվտանգության քաղաքականությունը պահանջում է վերակայման և հրավերների համար․ ավելի կարճը մերժվում է։ Հաղորդագրությունը ներկայումս միշտ նշում է 12 նիշ՝ անկախ քաղաքականության նվազագույնից (#300 խնդիր)։
- Սխալ ընթացիկ գաղտնաբառը մերժվում է 400
CurrentPasswordIncorrect-ով՝ «Ընթացիկ գաղտնաբառը սխալ է։»։ Փորձը հաշվի արգելափակման հաշվարկում հաշվվում է այնպես, ինչպես ձախողված մուտքը, և քանի դեռ հաշիվն արգելափակված է, ցանկացած փորձ ստանում է նույն պատասխանը։ - Հաջողության դեպքում վահանակը հայտնում է «Գաղտնաբառը փոխվեց։ Մյուս բոլոր սարքերից դուրս եք եկել։»։ Սարքը, որում փոխել եք գաղտնաբառը, մնում է մուտք գործած․ մյուս բոլոր նիստերն ավարտվում են։
Վերջնակետը POST /api/v1/auth/change-password-ն է, և մուտքի հարցումների հաճախականության սահմանափակումը
նրա համար ընդհանուր է։ Յուրաքանչյուր փոփոխություն և մերժում գրանցվում է աուդիտի մատյանում որպես
«Գաղտնաբառը փոխվեց»՝ առանց գաղտնաբառի։ Մյուս սխալների կոդերը թվարկված են
API-ի սխալների կոդեր էջում։
Ստուգել սերվերի վիճակը
sudo /usr/local/sbin/maran status
Առաջին բաժինը ցույց է տալիս՝ վահանակը, գործակալը, PostgreSQL-ը և վեբ սերվերը ակտիվ և միացված են արդյոք (ֆայլերի փոխանցումը ներառվում է, երբ ադմինիստրատորը միացրել է այն)։ Երկրորդ բաժինը վահանակի սեփական հաշվետվությունն է․ տվյալների բազայի հասանելիությունը, կապը գործակալի հետ, սպասող միգրացիաները, տարբերակը, ադմինիստրատորների քանակը և առաջին կարգավորման պատուհանի՝ դեռ բաց լինելը։ Երկրորդ բաժինը կարող է ձախողվել, և դա առաջինը չի թաքցնում։ Ելքի կոդը 0 է, երբ ամեն ինչ առողջ է, հակառակ դեպքում՝ 1։ Գաղտնիք չի տպում։
Ազատ տեղի ստորին սահման
Գործակալը պահում է ազատ տեղի ստորին սահման՝ քանի MiB պետք է մնա ֆայլային համակարգում, որպեսզի
գործակալը այնտեղ գրող աշխատանք սկսի։ Այն 1 ԳիԲ է, եթե չեք փոխել /etc/maran/agent.env-ում․
MARAN_AGENT_FREE_SPACE_FLOOR_MIB=1024
Տեղադրիչը գրում է 1024 և կրկին գործարկելիս պահպանում է ձեր արժեքը։ Յունիթը այն
փոխանցում է գործակալին որպես --free-space-floor-mib․ առանց դրոշի գործակալը կիրառում է նույն
1024-ը։ Արժեքը պետք է լինի 1-ից սկսվող ամբողջ թիվ․ զրոյի կամ ցանկացած այլ արժեքի դեպքում
գործակալը չի գործարկվի, քանի որ սահմանը, որ չի կարդացվում, զրո սահման չէ։ Այն կարող է փոխել միայն
root-ը․ վահանակի ուղարկած ոչ մի բան սահմանը չի փոխում։
Քանի դեռ այն ֆայլային համակարգում, որտեղ գործողությունը պետք է գրի, սահմանից քիչ տեղ է մնացել, հետևյալները մերժվում են նախքան որևէ բան գրելը․
- հաշվի ստեղծում,
- պահուստային պատճենի ստեղծում,
- պահուստային պատճենի վերականգնում,
- վերբեռնման ընդունում։
Մերժումը AgentBelowFreeSpaceFloor սխալն է (HTTP 503)․ ձեր լեզվով այն երևում է որպես
«Սերվերում սկավառակի տեղը գրեթե սպառվել է…»՝ պատասխանում և որպես պահուստավորման կամ
վերականգնման առաջադրանքի ձախողման պատճառ։ Ֆայլային համակարգը, որի ազատ տեղը հնարավոր չէ չափել,
նույնպես մերժվում է։ Կասեցումը, ջնջումը և ցանկացած ընթերցում շարունակում են աշխատել,
ուստի տեղը կարելի է ազատել վահանակից։
Սահմանը ստուգվում է աշխատանքը սկսելուց առաջ, տեղը չի ամրագրվում․ ստուգումից հետո մեկ այլ գրող դեռ կարող է լցնել սկավառակը, և գրելու ուղիներն այդ դեպքի համար ունեն իրենց սեփական «ամբողջը կամ ոչինչ» մշակումը։
Սահմանին մոտենալու ազդանշան
Վահանակը նամակ է ուղարկում օպերատորին, երբ արմատային ֆայլային համակարգում տասը ստուգում անընդմեջ ազատ տեղը սահմանի կրկնապատիկից քիչ է եղել, ուստի նախազգուշացումը գալիս է մերժումներից առաջ։ Երկրորդ նամակը գալիս է, երբ ազատ տեղը կրկին բավարար է։ Եթե հաշիվների տնային պանակները առանձին ֆայլային համակարգում են, մերժումը շարունակում է հետևել դրան, բայց նախազգուշացումը դրան չի նախորդում․ այն հետևում է միայն արմատային ֆայլային համակարգին։
Հավաքել աջակցության արխիվ
sudo /usr/local/sbin/maran collect-diagnostics
Հրամանը maran-diagnostics-<ժամանակ>-<համար>.tar.gz ֆայլը գրում է /root-ում, և այն կարդալ կարող է
միայն root-ը։ Այլ պանակ ընտրելու համար օգտագործեք --out DIR (բացարձակ ուղի, որը պատկանում է root-ին
և մյուսների համար գրելու հասանելի չէ), իսկ մատյանները չներառելու համար՝ --no-logs։
Ինչ կա արխիվում․
- ծառայությունների հաշվետվությունը
maran status-ից, ներառյալ տվյալների բազայի և միգրացիաների տվյալները, - օպերացիոն համակարգի տարբերակը, վահանակի systemd միավորները և նրա ծառայությունների վիճակը,
- Maran-ի վեբ սերվերի երկու կարգավորման ֆայլերը,
- վահանակի կարգավորումների ԱՆՈՒՆՆԵՐԸ, բայց երբեք՝ արժեքները,
- վահանակի վկայականի սուբյեկտը, թողարկողը և վավերականության ժամկետը,
- firewall-ի կանոնները,
- եթե չկա
--no-logs, վահանակի, գործակալի և վեբ սերվերի մատյանները վերջին յոթ օրվա համար (չափով սահմանափակված) և վահանակի սեփական վերին մակարդակի մատյանների վերջը։
Ինչ հրամանը երբեք չի կարդում․ հաճախորդների ֆայլերն ու տան պանակները, կայքերի սեփական մատյանները,
պահուստային պատճենները, տվյալների բազայի աղբերը, փակ բանալիները և panel.env-ի արժեքները։
Յուրաքանչյուր տեքստից հանվում են հայտնի գաղտնիքները և գաղտնիքների տարածված ձևերը, ապա պատրաստի արխիվը բացվում և կրկին սկանավորվում է։ Եթե սկանավորումը որևէ բան գտնի, արխիվը ջնջվում է, իսկ հրամանը ձախողվում է, որպեսզի չմնա փաթեթ, որը կարող էիք ուղարկել։
Ուղարկելուց առաջ դիտեք արխիվը։ Մաքրումը հանում է միայն այն, ինչի մասին հայտնի է, որ այս սերվերը պահում է, և ապացուցել, որ ոչինչ չի մնացել, հնարավոր չէ։ IP հասցեները, հոսթերի անունները և հաճախորդների դոմեյնների անունները չեն հանվում։ Բացեք արխիվը, կարդացեք այն և ուղարկեք միայն նրանց, ում վստահում եք այդ տվյալները։
Կարդալ մատյանները և փոխել գրառման մակարդակը
Վահանակը և սերվերի գործակալը գրում են systemd-ի մատյանում․ կարդացեք դրանք journalctl -u maran-api
և journalctl -u maran-agent հրամաններով։ Դրանց չափը սահմանափակում է journald-ը։ /var/log/maran-ի
ֆայլերը պտտվում են տեղադրիչի /etc/logrotate.d/-ում դրած կանոններով․ տեղադրման
մատյանը՝ ամիսը մեկ (պահվում է տասներկուսը), վահանակի սեփական վեբ սերվերի մատյանները՝ ամեն օր
(երեսունը), կայքերի վեբ սերվերի մատյանները՝ ամեն օր (տասնչորսը), FTPS-ի մատյանը՝ շաբաթը մեկ
(չորսը)։ Արդեն տեղադրված սերվերում տեղադրման մատյանի կանոնն ստանալու համար նորից գործարկեք
տեղադրիչը։
Փոխեք վահանակի մատյանի մակարդակը առանց վերագործարկման։ Մոնիթորինգ → Վահանակի մատյանի մակարդակ էջը ցույց է տալիս, թե վահանակը ինչ մակարդակով է գրում մատյանը, և ադմինիստրատորին թույլ է տալիս ընտրել՝ մանրամասն, վրիպազերծում, տեղեկություն (սովորական մակարդակ), զգուշացում, սխալ կամ ճակատագրական։ Փոփոխությունը գործում է հաջորդ տողից, պահպանվում է վերագործարկումից հետո և գրանցվում է աուդիտի մատյանում՝ նախորդ և նոր մակարդակով։ Խնդիրը քննելիս բարձրացրեք մակարդակը, հետո վերադարձրեք։ Ոչ մի մակարդակի դեպքում վահանակը գաղտնաբառ, բանալի կամ թոքեն չի գրի։ Սերվերի գործակալի մակարդակն այս կերպ դեռ հնարավոր չէ փոխել։