Gestione dei clienti
setItems("Dove nell'admin: Customers › Customers › List (
/customers), Deletion requests (/customers/requests), Service transfers (/customers/transfers) e API keys (/customers/apikeys)."),
Descrizione
setItems("L'area Clienti consente al personale di supporto di cercare un account, visualizzarne portafoglio, servizi, ticket e cronologia degli accessi, e intervenire: bloccare, sbloccare, verificare l'e-mail, reimpostare la password, aggiungere o rimuovere credito, impersonare, creare una VM o chiudere l'account."),
Requisiti
| Elemento | Requisito |
|---|---|
| Ruolo | setItems("Un amministratore. Ogni azione di scrittura richiede un motivo e viene registrata nel log di audit (System › Logs › Admin actions)."), |
| setItems("E-mail"), | setItems("Le e-mail di reset della password e di invito richiedono una SMTP configuration funzionante."), |
setItems("L'elenco dei clienti"),
setItems("Apri Customers › List. I clienti sono gli account del tuo sito principale; compaiono anche gli account dei rivenditori, filtrabili per sito."),
setItems("
"),
| setItems("Colonna"), | Significato |
|---|---|
| setItems("Email (e nome)"), | setItems("Clicca per aprire il cliente."), |
| setItems("State"), | setItems("Active, Locked o Deleted, oltre a e-mail verified o unverified. Passa il mouse su un tag di blocco per leggerne il motivo."), |
| setItems("Login"), | setItems("Metodi di accesso del cliente: password, Google, GitHub, passkey."), |
| setItems("Country"), | setItems("Bandiera e nome derivati dall'IP address: il paese dell'IP di registrazione o, se sconosciuto, dell'ultimo accesso. Il tooltip indica quale è stato usato."), |
| Origine referral | Referral con il link al referente e il codice di riferimento quando il cliente si è iscritto tramite un link di affiliazione; altrimenti "Non registrato". |
| Balance, VM | Saldo del portafoglio (valori negativi in rosso) e numero di VM attive. |
| IP registrato / ultimo | L'IP utilizzato durante la registrazione e all'ultimo accesso, con il paese a due lettere. Usalo per individuare più account da un unico indirizzo. |
| Tenant | L'ID tenant interno del cliente. |
| Creato, Ultimo accesso | Tempi relativi. |
| Site | Mostrato quando si dispone di rivenditori. |
Search accetta e-mail, nome o IP. Filtri: stato (tutti, attivi, bloccati, eliminati), metodo di accesso (qualsiasi, Google, GitHub, passkey, nessun password ancora) e sito. I filtri vengono mantenuti nell'URL, consentendo di aggiungere un elenco filtrato ai preferiti o di condividerlo con un collega.
L'ordinamento è globale. Facendo clic sull'intestazione di Email, State, Balance, VMs, Created o Last login viene ordinata l'intera base di clienti sul server e non solo la pagina visualizzata, e il numero di pagina torna a 1.
L'elenco si aggiorna automaticamente. Si aggiorna ogni pochi secondi mentre lo consulti (va in pausa se una finestra di dialogo è aperta o mentre scrivi), quindi le nuove registrazioni e le variazioni di saldo compaiono senza ricaricare la pagina. La pagina del cliente si aggiorna ogni 30 secondi circa quando è visibile; ogni scheda carica i propri dati alla prima apertura.
Crea un cliente
- Fai clic su Create customer.
- Inserisci l'e-mail, un display name opzionale, una password opzionale (vuota = il cliente la imposta tramite il link di invito) e scegli se send the invitation e-mail.
- Conferma. Un account creato manualmente viene considerato verificato quando invii l'invito.
La pagina di un cliente
Fai clic su una riga. La pagina presenta otto schede; la scheda selezionata viene mantenuta nell'URL per consentirti di aggiungerla ai preferiti. Le schede si caricano alla prima apertura e mantengono il loro stato quando passi a un'altra.
| Scheda | Contenuto |
|---|---|
| Overview | Identità, informazioni di registrazione e ultimo accesso, riepilogo del wallet e dei servizi |
| Services | Una tabella per i servizi del cliente, con filtri per tipo e stato, ricerca, ordinamento lato server e paginazione |
| Billing | Wallet e credito, registro contabile, fatture, pagamenti, rimborsi, metodo di pagamento salvato e ricarica automatica |
| Quota | Limiti di risorse e override; vedi Quote |
| Security | Sessioni, autenticazione, metodi di accesso, cronologia accessi e chiavi API; vedi Chiavi API |
| Support | Ticket recenti |
| Affiliate | Stato del programma di affiliazione |
| Log | Cronologia delle attività e di audit |
Pulsanti di azione nell'intestazione (nascosti per gli account eliminati):
| Pulsante | Descrizione |
|---|---|
| Lock account / Unlock | Blocca l'accesso e l'uso dell'API. Facoltativamente arresta anche tutte le VM (senza eliminarle). Vengono arrestati anche i servizi prepagati diversi dalle VM (Kubernetes, Private Cloud, VPN e così via). Le VM bloccate da un amministratore devono essere sbloccate separatamente nella pagina della VM. |
| Verify email | Contrassegna l'e-mail come verificata senza che il cliente debba fare clic su un link. |
| Send reset link | Invia via e-mail un link per la reimpostazione della password (valido 1 ora, monouso). Se l'SMTP non è configurato, il link viene mostrato una sola volta per poterlo inviare autonomamente. Un amministratore non vede mai la password. |
| Impersonate | Effettua l'accesso come cliente per un'ora. Vedi Log in as a customer. |
| Credit / debit | Aggiunge o rimuove fondi dal portafoglio tramite una rettifica contabile. Vedi Invoices and ledger. |
| Revoke sessions | Disconnette il cliente ovunque; i token dell'app smettono di funzionare. |
| Create VM | Crea una VM per il cliente. |
| Soft delete | Chiude l'account. È necessario digitare l'e-mail per confermare. |
Gestire un singolo servizio
Apri la scheda Services del cliente, individua un servizio per nome, ID, IP o configurazione e utilizza le azioni di riga. Le stesse azioni sono disponibili nell'elenco di amministrazione del servizio. La finestra di dialogo propone solo le azioni supportate da tale servizio e dal suo stato attuale.
| Action | Effetto |
|---|---|
| Lock | Arresta il servizio conservandone i dati. Il cliente lo vede come bloccato e non può gestirlo. L'esecuzione di una ricarica non rimuove il blocco applicato da un amministratore; il rinnovo automatico rimane bloccato per tutta la durata del blocco. |
| Unlock | Annulla il blocco impostato dall'amministratore. Non rimuove un blocco indipendente per abuso o per altre protezioni. |
| Cancel without refund | Annulla il servizio senza creare una voce di rimborso nel registro contabile. Il messaggio di conferma avverte che l'annullamento non può essere revocato. |
| Cancel and refund | Mostra i pagamenti originali, la loro ripartizione tra wallet e credito, i rimborsi precedenti e l'importo massimo rimborsabile. Verifica l'importo prima di confermare. |
Inserisci un motivo per ogni azione. Il motivo è riservato agli amministratori; il cliente riceve una notifica o un evento di servizio neutro. Il denaro rimborsato nel wallet torna nel wallet, mentre il credito o le allocazioni promozionali tornano al credito. Questa azione non restituisce denaro tramite Stripe, bonifico bancario o PayPal.
Per più servizi dello stesso tipo, seleziona fino a 50 righe e scegli un'azione massiva. Il risultato mostra l'esito positivo o negativo per ciascuna riga. I rimborsi massivi utilizzano l'importo suggerito di ciascun servizio; i servizi per cui il rimborso suggerito è pari a zero vengono ignorati in modalità di rimborso e richiedono una verifica individuale o la cancellazione senza rimborso.
DDoS Shield, dischi e backup sono qui righe di sola lettura. Gli add-on di larghezza di banda seguono il rispettivo servizio principale. L'accesso a AI Models può essere bloccato, ma non ha un abbonamento da annullare. Per bloccare un server Bare Metal noleggiato, intervieni sul relativo abbonamento anziché sull'ordine.
Chiusura di un account (soft delete)
L'account viene impostato come eliminato, bloccato, le sue sessioni vengono revocate e le commissioni di referral non ancora pagate vengono stornate. Fatture e registro contabile rimangono a fini contabili. L'azione viene rifiutata se il cliente possiede ancora qualsiasi servizio attivo (VM, Kubernetes, Private Cloud, Dedicated, VPN, proxy IPv6), un account S3 o un utilizzo S3 non saldato. Eliminali prima.
Richieste di eliminazione
Un cliente può richiedere l'eliminazione dalla pagina del proprio account. Le richieste compaiono in Customers › Deletion requests (filtro predefinito: in sospeso) con il cliente, il motivo, il numero di VM attive, il saldo e l'ora della richiesta.
- Approve deletion è possibile solo quando il cliente non ha alcuna VM attiva. Digita l'e-mail per confermare. L'account viene eliminato tramite soft delete; il saldo residuo del portafoglio non viene rimborsato automaticamente — crea prima un rimborso se è dovuto.
- Reject richiede una motivazione.
Trasferimenti di servizi
Customers › Service transfers elenca le richieste di spostamento di una VM o di un abbonamento VPN da un account a un altro sullo stesso sito.
- La schermata è di sola lettura e creazione: puoi creare una richiesta per conto di un cliente o annullarla. Deliberatamente non è presente alcun pulsante per approvarla da parte del proprietario o del destinatario.
- Flusso: il proprietario conferma tramite un link e-mail monouso (valido 30 minuti, con TOTP se abilitato), quindi il destinatario effettua l'accesso e accetta (il destinatario si assume gli obblighi di pagamento). Una richiesta non accettata entro 7 giorni scade.
- Regole: il servizio deve essere attivo, senza fatture non pagate e senza processi in esecuzione; il destinatario deve essere un cliente attivo con un'e-mail verificata sullo stesso sito. Il trasferimento di una VM rimuove la chiave SSH e disattiva il rinnovo automatico; il trasferimento di una VPN modifica le password di connessione.
- Le fatture già emesse rimangono al precedente proprietario; il nuovo proprietario può leggere la cronologia di fatturazione del servizio con i dati del precedente proprietario nascosti.
- I clienti possono creare le proprie richieste in Transfers nel portale (5 richieste all'ora e 3 aperte contemporaneamente).
Verifica
- Crea un cliente con un'e-mail di invito. Il nuovo account viene visualizzato in cima all'elenco nel giro di pochi secondi.
- Ordina per Balance: l'ordine copre tutti i clienti.
- Blocca il cliente: l'etichetta dello stato diventa Locked e il cliente non può più effettuare l'accesso. Sbloccalo.
Limiti e note
- La colonna del paese è un'indicazione basata sull'IP, non una prova di residenza. Gli indirizzi privati o sconosciuti non restituiscono alcun paese.
- Il blocco di un account non rimborsa nulla e non elimina le VM a meno che tu non decida anche di arrestarle.
- Lo sblocco dell'account non sblocca le VM bloccate da un amministratore; sbloccale separatamente nella pagina della VM.
Troubleshooting
| Sintomo | Causa | Soluzione |
|---|---|---|
| "Il cliente ha ancora servizi attivi... arresta/elimina prima" | Il cliente ha servizi attivi o un account S3 | Rimuovili, quindi procedi con l'eliminazione soft. |
| L'approvazione dell'eliminazione indica "N VMs alive" | Stesso motivo | Elimina prima le VM. |
| Viene mostrato il link di reset anziché "e-mail queued" | SMTP non configurato | Configura l'e-mail o invia il link tu stesso. |
Impossibile rimuovere un metodo di accesso (last_login_method) | È l'unico modo per il cliente di effettuare l'accesso | Aggiungi prima un altro metodo. |
| Il blocco non interrompe i servizi prepagati | Sono stati segnalati errori di arresto | Leggi il messaggio dopo il blocco; il sistema tenta nuovamente l'arresto in modo automatico. |
| Impossibile creare un trasferimento | Fattura non pagata, operazione in corso, destinatario su un altro sito o non verificato | Risolvi la condizione e riprova. |