Săriți la conținut

Documentație

ISPConfig

Provibr administrează conturile de găzduire ISPConfig prin API-ul remote al panoului. Agentul se conectează spre exterior către instalarea dumneavoastră ISPConfig, așa că nu există porturi de intrare și nici VPN. Această pagină descrie ce este diferit la ISPConfig și ce face integrarea.

Un cont este un site

ISPConfig separă clientul (clientul final, cu o autentificare și un set de limite) de web_domain (site-ul). Un cont de găzduire Provibr este un site, identificat prin domeniul lui. Pentru a crea un site este nevoie de un proprietar, așa că Provibr creează un client nou și un site sub el și le elimină pe amândouă când ștergeți contul. Agentul deduce autentificarea clientului din domeniu, așa că regăsește mereu proprietarul.

De ce are nevoie agentul

Patru câmpuri, completate o singură dată când conectați integrarea:

  • Adresa panoului: URL-ul https complet, cu tot cu port (8080 în mod implicit).
  • Un utilizator remote: creat la System → Remote Users, limitat la funcțiile de client și de site.
  • Parola acelui utilizator remote.
  • Amprenta TLS a panoului: recomandată, fiindcă o instalare nouă este autosemnată.
Utilizatorul remote este un cont separat, nu administratorul panoului dumneavoastră. ISPConfig vă lasă să îl limitați exact la funcțiile pe care le folosește Provibr, așa că datele de acces din seiful agentului pot fi restrânse la apelurile de client și de site și la nimic altceva.

Certificatul

ISPConfig ascultă pe portul 8080 prin TLS, iar o instalare nouă prezintă un certificat autosemnat. Fixați-i amprenta, ca agentul să fie sigur că ajunge la panoul dumneavoastră. O citiți cu o comandă de shell de pe orice mașină care ajunge la panou:

shell
openssl s_client -connect <host>:8080 </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 propriul certificat pe numele de gazdă al panoului (de exemplu cu Let's Encrypt), lanțul lui se validează și puteți lăsa amprenta goală. Acolo aceasta este alegerea mai bună, fiindcă un astfel de certificat se reînnoiește cu regularitate, iar unul fixat ar trebui înlocuit de fiecare dată.

Pachete

Un pachet ISPConfig este un șablon de client, același lucru la care se referă un plan Provibr. Stabilește limitele pe care le primește un client: câte site-uri, cât disc și trafic, ce servicii.

Alegeți un pachet după nume în formularul de comandă și îl schimbați ulterior fără întrerupere. Schimbarea lui mută limitele clientului dintr-o dată.

API-ul remote nu poate crea un șablon de client, așa că pachetele le construiți chiar dumneavoastră în panoul ISPConfig. Provibr se referă la ele doar după nume; un nume pe care nu îl recunoaște este respins înainte să se creeze ceva.

Ciclul de viață al contului

Crearea unui cont înseamnă doi pași în spatele unei singure comenzi: un client și un site sub el. De acolo încolo, contul se comportă ca orice alt cont de găzduire:

  • Creare: un client cu pachetul ales și un site cu domeniul și cota lui.
  • Suspendare și reactivare: site-ul iese offline și revine, reversibil.
  • Schimbarea pachetului: atribuirea unui alt șablon de client.
  • Ștergere: clientul și site-ul lui, curățate împreună.

Suspendarea

Suspendarea inversează indicatorul de activ al site-ului. Site-ul iese offline; autentificarea clientului rămâne. Provibr citește același indicator pe care îl scrie, așa că panoul și ceea ce vedeți nu se despart niciodată.

Indicatorul din baza de date se inversează pe loc, dar configurația serverului web este rescrisă de sarcina la minut a panoului. Ceea ce arată Provibr (indicatorul de activ) este coerent imediat.

Consum

ISPConfig raportează consumul: discul per site față de cota lui și traficul pentru luna curentă. Amândouă apar în grafice la fel ca pentru o mașină virtuală.

Consumul de disc se completează după ce a rulat sarcina de monitorizare a panoului, așa că pe un site nou nu există încă o citire, ceea ce nu este totuna cu zero. Traficul vine dintr-un apel pentru toate site-urile; discul, dintr-un apel per client.

Importul

Conturile pe care le-ați creat în ISPConfig în afara Provibr pot fi importate: integrarea enumeră site-urile pe care le cunoaște panoul, iar dumneavoastră alegeți pe care să le preluați. Conturile pe care nu le-ați creat prin Provibr rămân neatinse până când o faceți.