Անցնել բովանդակությանը

Ինչպես է այն աշխատում

Վահանակի հավաստագիր

Ինչպես է վահանակը 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-ն ուղղեք այս սերվերին, ավելացրեք կամ փոխեք տողը և վերագործարկեք վահանակը․

bash
Panel__HostName=panel.example.com

Ստուգման բլոկը 80 պորտի վրա

Վահանակի վեբ սերվերի կարգավորումն ունի մեկ բլոկ՝ 80 պորտի վրա, վահանակի հոսթի անվան համար։ Այն պատասխանում է միայն /.well-known/acme-challenge/-ին (ֆայլերը վերցնում է /var/lib/maran-acme-ից), իսկ մնացած ամեն ինչին վերադարձնում է 404։ Սա նոր պորտ չէ․ վեբ սերվերն արդեն լսում է 80-ը կայքերի համար, իսկ 80-ը հասանելի է թե ոչ, որոշում է ձեր firewall-ը՝ ճիշտ ինչպես կայքի հավաստագրի դեպքում։

Այս թողարկումից առաջ տեղադրված սերվերը դեռ չունի այդ բլոկը։ Այն ստանալու համար կրկին գործարկեք տեղադրիչը․ մինչ այդ թողարկումը ձախողվում է ստուգման փուլում։

Թարմացում

Օրական աշխատանքը թարմացնում է վահանակի վստահելի հավաստագիրը, երբ ժամկետի լրանալուն մնում է երեսուն օր կամ պակաս։ Եթե թարմացումը ձախողվում է, ընթացիկ, դեռ վավեր հավաստագիրը մնում է, և թարմացումը կրկնվում է հաջորդ օրը։

Երբ թողարկումը ձախողվում է

Ոչինչ չի փոխարինվում։ Հավաստագիրը, որով վահանակն աշխատում էր՝ ինքնաստորագրված թե վստահելի, մնում է տեղում։ Սովորական պատճառները․

  • հոսթի անունը չի ուղղված այս սերվերին․
  • 80 պորտը փակ է սերվերի առջևի firewall-ով․
  • հավաստագրման կենտրոնը մերժում է պատվերը․
  • սերվերի ազատ տարածքը շեմից ցածր է, կոդը՝ AgentBelowFreeSpaceFloor։
ԿոդԿարգավիճակՆշանակություն
PanelHostNameNotConfigured409Panel__HostName-ը սահմանված չէ։ Սահմանեք այն /etc/maran/panel.env-ում և վերագործարկեք վահանակը։
PanelCertificateNotIssued404Վստահելի հավաստագիր չի թողարկվել․ վահանակն աշխատում է ինքնաստորագրվածով։
PanelChallengeWriteFailed500Հոսթի անվան ստուգման ֆայլը չհաջողվեց գրել սերվերում։

Սահմանափակումներ

  • CLI հրաման դեռ չկա։ Պատվերը և թարմացումը կատարվում են միայն վահանակում․ եթե վահանակը հասանելի չէ, maran հրամանով հավաստագիր պատվիրել չի ստացվի։
  • Ինքնաստորագրվածին վերադառնալ հնարավոր չէ։ Վստահելի հավաստագիր տեղադրելուց հետո վահանակում չկա գործողություն, որը այն կհեռացնի և կվերադարձնի տեղադրիչի ինքնաստորագրված զույգը։
  • Վահանակը և սերվերի գործակալը պետք է թարմացվեն միասին․ այս հնարավորությանը երկուսն էլ պետք է լինեն նույն թողարկումից։