Documentație

CyberPanel

CyberPanel este un panou de control open source pentru găzduire web. Provibr vorbește cu API-ul lui prin datele de acces ale administratorului principal și administrează site-urile de acolo: le creează, le suspendă și le reactivează, le mută în alt pachet și le șterge.

Activarea accesului la API

Pe un CyberPanel proaspăt instalat, API-ul este dezactivat, iar acest lucru este valabil și pentru administratorul principal. Îl activați în panou, la Users, API Access, pentru utilizatorul admin. Nu mai este nevoie de nimic altceva: Provibr se conectează cu datele de acces pe care le aveți deja.

Dacă îl lăsați dezactivat, fiecare apel se întoarce ca API Access Disabled, indiferent ce ați completat. CyberPanel verifică acest comutator înaintea parolei, așa că o parolă corectă dă exact același răspuns ca una greșită. Totul arată spre datele dumneavoastră de acces, deși problema se află cu o bifă mai departe.

Administratorul principal trebuie să se numească admin

O parte din API-ul CyberPanel respinge orice alt nume în afară de admin, iar aceea este tocmai partea care enumeră site-urile din panou și spune cât de departe a ajuns unul nou. Provibr are nevoie de amândouă, așa că acel cont completat mai jos este cel numit admin.

Aceasta nu este o setare, ci o condiție, și vine de la CyberPanel, nu de la noi: un administrator redenumit nu poate fi folosit pentru această integrare. Testul de conexiune vă spune acest lucru, ca să aflați înainte de prima comandă.

Ce cere Provibr

Patru câmpuri. Agentul le păstrează în seiful lui, pe gazda dumneavoastră; Provibr nu le poate citi înapoi.

Adresa panoului, cu port, de exemplu https://panel.example.com:8090. Fără port, Provibr completează 8090. Http-ul simplu este respins: portul acela vorbește doar TLS.
Numele administratorului principal, adică admin.
Parola acelui administrator.
Amprenta SHA-256 a certificatului, atât timp cât panoul îl folosește pe cel autosemnat.

CyberPanel nu are niciun token de API care să acopere aceste comenzi: în propriul API, calea prin token este activă sau nu, în funcție de endpoint, iar tocmai cele patru comenzi care creează, suspendă, schimbă pachetul și șterg un site cer parola. Aici stă deci parola completă a administratorului principal, aceeași situație ca la Webmin.

Certificatul

Orice CyberPanel proaspăt instalat prezintă același certificat autosemnat, emis pentru www.example.com și semnat de CyberPanel însuși. De aceea un browser îl numește incorect, nu autosemnat, iar lanțul nu se validează niciodată. Completați amprenta și agentul are încredere în acel singur certificat, în loc să oprească verificarea. O citiți de pe orice mașină care ajunge la panou:

shell

openssl s_client -connect <host>:8090 </dev/null 2>/dev/null | \
  openssl x509 -noout -fingerprint -sha256

Comenzile și ieșirea din terminal sunt în engleză peste tot, în panou și în aceste pagini. Un singur text, un singur adevăr: ce citiți aici este literalmente ce va afișa gazda dumneavoastră.

Dacă puneți un certificat propriu pe numele de gazdă al panoului, lanțul se validează singur și câmpul poate rămâne gol. Acolo aceasta este alegerea mai bună, fiindcă un astfel de certificat se înlocuiește din când în când, iar unul fixat ar trebui rescris aici de fiecare dată.

Pachete

CyberPanel descrie într-un pachet ce poate folosi un site. Provibr citește acea listă și se referă la un pachet după nume; pachetele în sine se creează și se modifică în CyberPanel, nu aici.

Un plan de găzduire web în Provibr indică un pachet dintr-o integrare. Asta comandă clientul dumneavoastră, iar prețul îl stabiliți singur.

Mutarea unui site în alt pachet schimbă evidența și nimic altceva. Măsurat din interiorul serverului, cu un pachet care avea alte limite: cota de disc a rămas cum era, iar configurația serverului web a păstrat valorile vechi. Panoul arată numele nou, așa că acel nume se citește ca evidență, nu ca o limită care s-ar fi mutat odată cu el.

Ce trimite o comandă

Un site din CyberPanel este indicat prin domeniul lui, iar acela este și identitatea lui în Provibr. O comandă duce patru lucruri:

Domeniul. Trebuie să fie liber în panou, iar tot ce face Provibr după aceea cu acest server îl indică pe el.
O adresă de contact pentru site.
Pachetul în care intră site-ul.
O parolă pentru accesul în panou pe care CyberPanel îl creează sub site.

Crearea durează pe CyberPanel cam cincizeci de secunde, dintre care vreo douăzeci și opt se duc pe o încercare SSL pe care panoul o face oricum. Provibr așteaptă rezultatul adevărat în loc să creadă primul răspuns: acela vine după vreo trei secunde și nu spune nimic, nici măcar dacă domeniul mai era liber.

Suspendare și reactivare

Amândouă au efect imediat: panoul întoarce starea nouă, iar lista lui o arată pe loc. Provibr suspendă un site când i se cere și când capacitatea este depășită.

Pe CyberPanel, suspendarea este un truc al serverului web, nu o blocare a contului. Site-ul devine inaccesibil, dar FTP-ul, poșta și bazele de date funcționează mai departe, iar utilizatorul unix nu este blocat. Acest lucru diferă de DirectAdmin și contează de îndată ce folosiți suspendarea ca mijloc de constrângere.

Spațiu pe disc și trafic

CyberPanel este singurul panou de control din Provibr fără grafice de consum, și nu integrarea le lasă deoparte: panoul nu le măsoară. Traficul este calculat și apoi aruncat, iar consumul de disc vine dintr-o memorie temporară care a rămas goală pe un site nou. Zeroul care iese de acolo nu se deosebește de un consum cu adevărat nul.

Un grafic care stă pentru totdeauna la zero arată ca o măsurătoare și tocmai de aceea nu există niciunul. Ce poate folosi un site scrie în pachetul lui, iar ce știe totuși CyberPanel rămâne în panoul propriu-zis.

Site-uri care există deja

Site-urile create în afara Provibr pot fi importate din pagina integrării: agentul enumeră ce se află în panou, iar dumneavoastră alegeți care dintre ele devin un server în Provibr.

Un site importat intră din acel moment în capacitatea dumneavoastră, ca orice alt server web.

Ce nu face

Provibr administrează site-uri, nu panoul: nu instalează CyberPanel, nu îl actualizează și nu schimbă setări de server. Nu există consolă, iar DNS-ul, cutiile poștale și bazele de date rămân neatinse. CyberPanel le poate face pe toate singur, iar Provibr nu îl comandă.

AnterioaraHestiaCP UrmătoareaCloudPanel