Guida · Per i clienti

Team e API

Nella pagina Team e API inviti le persone che lavorano con te sui server, crei le chiavi API per i tuoi script e leggi chi ha fatto cosa. La vedi tu, titolare del conto, e gli amministratori del team.

I ruoli

Ruolo	Cosa può fare
Amministratore	tutto quello che fai tu: crea, cambia piano e cancella le VPS del pacchetto, invita tecnici e sola lettura, crea e cancella chiavi API, legge il registro. Non aggiunge, non cambia e non toglie gli altri amministratori e le chiavi da amministratore: quelli li gestisci solo tu.
Tecnico	lavora sulle VPS: le accende e le spegne, apre la console, reinstalla, cambia la password di root, fa e ripristina snapshot e backup, cambia firewall, dischi, reti private e DNS inverso. Non crea e non cancella VPS e non vede team, chiavi e registro.
Sola lettura	vede VPS, grafici, backup e consumi. Non cambia niente, non apre la console e non vede le password delle applicazioni.

Il ruolo nuovo vale subito, anche per chi è già dentro.

Invitare una persona

Premi Invita e scrivi email, nome e ruolo.
La persona riceve un'email con il link. Se il pannello non manda le email, ti mostra il link da mandarle tu.
Con il link sceglie la sua password ed entra. Poi entra dalla pagina di accesso, con la sua email e la sua password.

Il link vale 7 giorni e una volta sola. Ogni email entra in un solo conto: per lavorare su più conti servono indirizzi diversi. Si mandano al massimo 20 inviti al giorno, e uno al minuto alla stessa persona.

Se sei un rivenditore, il team lavora anche sulle VPS dei tuoi clienti, con il ruolo di ognuno. Nuovi clienti, VPS, accesso ai clienti e chiavi API per WHMCS restano a te e agli amministratori del team.

Accanto a ogni persona ci sono tre pulsanti:

Manda di nuovo l'invito (l'aereo di carta): serve se l'invito è scaduto o se ha perso la password. Con il link nuovo sceglie una password nuova; quella vecchia vale finché non lo usa.
Modifica (la matita): nome e ruolo.
Togli dal team (il cestino): esce subito da tutte le sessioni e non può più entrare.
Togli la verifica in due passaggi (lo scudo, c'è solo accanto a chi l'ha attiva, con il segno «2FA»): per chi ha perso il telefono e i codici di recupero. Esce da tutte le sessioni e al prossimo accesso entra con la sola password, poi la riattiva. Gli amministratori del team la tolgono a tecnici e sola lettura; agli amministratori la toglie solo il titolare.

Ognuno cambia la sua password e attiva la sua verifica in due passaggi in Il mio account: la tua non cambia, e le tue sessioni restano aperte.

Chiavi API

Le chiavi API servono ai tuoi script e programmi, per esempio per spegnere una VPS di notte, fare uno snapshot prima di un aggiornamento o leggere lo stato da un sistema di monitoraggio.

Premi Nuova chiave e dai un nome e un ruolo, gli stessi delle persone. Scegli il ruolo più piccolo che basta: per leggere lo stato basta la sola lettura.
Copia la chiave kvm_…: si vede una volta sola.
Mandala nell'intestazione Authorization: Bearer kvm_… di ogni richiesta all'indirizzo del pannello, seguito da /api.

curl -H "Authorization: Bearer kvm_…" https://pannello.esempio.it/api/vps

Le chiavi fanno quello che fa una persona con lo stesso ruolo: se il ruolo non basta, la risposta è 403. Le chiavi non gestiscono il team e le altre chiavi e non cambiano le password. Al massimo 600 richieste al minuto per chiave e 20 chiavi per conto.

Se cancelli una chiave, gli script che la usano smettono subito di funzionare. Le chiavi restano anche se chi le ha create esce dal team.

Le chiamate principali

Chiamata	Cosa fa
`GET /vps`	le tue VPS
`GET /vps/{id}`	stato e dettagli di una VPS
`GET /vps/{id}/metrics?hours=24`	grafici: CPU, RAM, disco e rete
`POST /vps/{id}/power`	`{"action": "start"}`, oppure `stop`, `restart`, `kill`
`POST /vps/{id}/reinstall`	reinstalla: `image_id`, `confirm` (il nome host), `password`, `ssh_key_ids`
`GET` e `POST /vps/{id}/snapshots`	elenco e nuovo snapshot (`label`)
`POST /vps/{id}/snapshots/{nome}/restore`, `DELETE /vps/{id}/snapshots/{nome}`	ripristina e cancella uno snapshot
`GET` e `POST /vps/{id}/backups`	elenco e nuovo backup
`GET` e `PUT /vps/{id}/firewall`	firewall: `enabled` e `rules`
`GET /images`, `GET /apps`	sistemi e applicazioni
`GET /account/ssh-keys`	le chiavi SSH salvate
`GET /self-service`	il tuo pacchetto: limiti, uso, piani, città
`POST /self-service/vps`	crea una VPS nel pacchetto: `plan_id`, `image_id`, `city`, `hostname`, `ssh_key_ids`, `user_script`
`POST /vps/{id}/plan`	cambia piano a una VPS del pacchetto: `plan_id`
`DELETE /vps/{id}?confirm={nome host}`	cancella una VPS del pacchetto
`GET /usage?month=AAAA-MM`	uso a ore del mese
`GET`, `POST /load-balancers`, `GET`, `PUT`, `DELETE /load-balancers/{id}`	load balancer (creare e cancellare: ruolo amministratore)

Crea, cambia piano e cancella VPS del pacchetto solo con una chiave con il ruolo di amministratore. Le risposte sono in JSON; gli errori hanno il campo error, con il motivo in italiano.

Registro delle attività

In fondo alla pagina c'è il registro del conto: gli accessi e le operazioni fatte da te, dalle persone del team e dalle chiavi API, con data e ora. Le chiavi compaiono con il loro nome, per esempio «API: Monitoraggio». Premi Mostra le precedenti per andare indietro nel tempo.