Ինչպես է այն աշխատում
Վահանակի հավաստագիր
Ինչպես է վահանակը ACME-ով իր հոսթի անվան համար վստահելի հավաստագիր պատվիրում, ինչու է պետք 80 պորտը, ինչպես է թարմացումը և ինչ է լինում ձախողման դեպքում։
Նոր տեղադրումում վահանակը սպասարկվում է ինքնաստորագրված հավաստագրով, ուստի դիտարկիչը բացելուց առաջ զգուշացնում է։ Վահանակը կարող է այն փոխարինել իր հոսթի անվան վստահելի հավաստագրով և ինքն էլ թարմացնել այն։ Հավաստագիրը պատվիրվում է նույն ACME կենտրոնից, որից օգտվում են կայքերը։
Պատվիրել հավաստագիր
Ադմինիստրատորի իրավունքով բացեք Կարգավորումներ → Վահանակի հավաստագիր և սեղմեք Պահանջել
վստահելի հավաստագիր։ Վահանակը HTTP-ով, 80 պորտի վրա, ապացուցում է, որ իր հոսթի անունը իրենն է,
արդյունքը պահում է որպես /etc/maran/tls/panel.crt և /etc/maran/tls/panel.key և վերաբեռնում է վեբ
սերվերը։ Նոր հավաստագիրն օգտագործելու համար թարմացրեք էջը։
Էջը ցույց է տալիս հոսթի անունը, թողարկման և ժամկետի լրանալու ամսաթվերը։ Երբ հավաստագիրն արդեն տեղադրված է, Թարմացնել հիմա կոճակը անմիջապես նորն է պատվիրում։
Էջը և դրա API-ն (GET և POST /api/v1/panel-certificate) հասանելի են միայն ադմինիստրատորներին։
Հաճախորդը ոչ կարող է հավաստագիր պատվիրել, ոչ կարդալ այն։
Հոսթի անունը վերցվում է սերվերից
Անունը էջում երբեք չի մուտքագրվում։ Այն Panel__HostName-ն է /etc/maran/panel.env-ում, որը
տեղադրիչը գրում է մեքենայի սեփական անունից։ Եթե այդ անունը localhost է, դատարկ է կամ բաղկացած չէ
միայն տառերից, թվերից, կետերից և գծիկներից, տեղադրիչը ոչինչ չի գրում, և հավաստագիր պատվիրել
հնարավոր չէ։
Անունը ինքներդ սահմանելու համար անվան DNS-ն ուղղեք այս սերվերին, ավելացրեք կամ փոխեք տողը և վերագործարկեք վահանակը․
Panel__HostName=panel.example.com
Ստուգման բլոկը 80 պորտի վրա
Վահանակի վեբ սերվերի կարգավորումն ունի մեկ բլոկ՝ 80 պորտի վրա, վահանակի հոսթի անվան համար։ Այն
պատասխանում է միայն /.well-known/acme-challenge/-ին (ֆայլերը վերցնում է /var/lib/maran-acme-ից),
իսկ մնացած ամեն ինչին վերադարձնում է 404։ Սա նոր պորտ չէ․ վեբ սերվերն արդեն լսում է 80-ը կայքերի
համար, իսկ 80-ը հասանելի է թե ոչ, որոշում է ձեր firewall-ը՝ ճիշտ ինչպես կայքի հավաստագրի դեպքում։
Այս թողարկումից առաջ տեղադրված սերվերը դեռ չունի այդ բլոկը։ Այն ստանալու համար կրկին գործարկեք տեղադրիչը․ մինչ այդ թողարկումը ձախողվում է ստուգման փուլում։
Թարմացում
Օրական աշխատանքը թարմացնում է վահանակի վստահելի հավաստագիրը, երբ ժամկետի լրանալուն մնում է երեսուն օր կամ պակաս։ Եթե թարմացումը ձախողվում է, ընթացիկ, դեռ վավեր հավաստագիրը մնում է, և թարմացումը կրկնվում է հաջորդ օրը։
Երբ թողարկումը ձախողվում է
Ոչինչ չի փոխարինվում։ Հավաստագիրը, որով վահանակն աշխատում էր՝ ինքնաստորագրված թե վստահելի, մնում է տեղում։ Սովորական պատճառները․
- հոսթի անունը չի ուղղված այս սերվերին․
- 80 պորտը փակ է սերվերի առջևի firewall-ով․
- հավաստագրման կենտրոնը մերժում է պատվերը․
- սերվերի ազատ տարածքը շեմից ցածր է, կոդը՝
AgentBelowFreeSpaceFloor։
| Կոդ | Կարգավիճակ | Նշանակություն |
|---|---|---|
PanelHostNameNotConfigured | 409 | Panel__HostName-ը սահմանված չէ։ Սահմանեք այն /etc/maran/panel.env-ում և վերագործարկեք վահանակը։ |
PanelCertificateNotIssued | 404 | Վստահելի հավաստագիր չի թողարկվել․ վահանակն աշխատում է ինքնաստորագրվածով։ |
PanelChallengeWriteFailed | 500 | Հոսթի անվան ստուգման ֆայլը չհաջողվեց գրել սերվերում։ |
Սահմանափակումներ
- CLI հրաման դեռ չկա։ Պատվերը և թարմացումը կատարվում են միայն վահանակում․ եթե վահանակը հասանելի
չէ,
maranհրամանով հավաստագիր պատվիրել չի ստացվի։ - Ինքնաստորագրվածին վերադառնալ հնարավոր չէ։ Վստահելի հավաստագիր տեղադրելուց հետո վահանակում չկա գործողություն, որը այն կհեռացնի և կվերադարձնի տեղադրիչի ինքնաստորագրված զույգը։
- Վահանակը և սերվերի գործակալը պետք է թարմացվեն միասին․ այս հնարավորությանը երկուսն էլ պետք է լինեն նույն թողարկումից։