Skip to main content

Configurazione del modulo registrar

Una volta installato il modulo, devi attivarlo in WHMCS e inserire le tue credenziali API HostMyServers.

Attivare il modulo​

  1. Accedi all'amministrazione WHMCS
  2. Vai su Configurazione → Sistema → Moduli registrar
  3. Individua HostMyServers nell'elenco
  4. Fai clic su Attiva

Il modulo è ora attivo. Appare un modulo di configurazione.

Impostazioni di connessione​

Dopo l'attivazione, compila i seguenti campi:

Chiave API (API Key)​

Una chiave API generata da hostmyservers.fr/user/api. Da questa pagina puoi creare una chiave, darle un nome (es. WHMCS Production) ed eliminarla in qualsiasi momento. Tratta questa chiave come una password: non condividerla mai e non inserirla mai in un repository Git.

Sicurezza della chiave API

Se ritieni che la tua chiave API sia stata compromessa, eliminala immediatamente da hostmyservers.fr/user/api e creane una nuova. Poi aggiorna la chiave nella configurazione del modulo WHMCS.

Per ottenere credenziali sandbox, contatta il supporto HostMyServers.

Contatto titolre predefinito (Owner Contact)​

Questo campo definisce il contatto titolare utilizzato per impostazione predefinita durante la registrazione di ogni dominio. Sono disponibili due opzioni:

Opzione 1 — Utilizzare il profilo dell'account HostMyServers

Seleziona Utilizza il titolare dell'account (use_account_owner: true). Le informazioni del profilo associato alla chiave API (nome, indirizzo, email, telefono) vengono automaticamente utilizzate come contatto Owner.

Opzione 2 — Utilizzare un contatto esistente

Inserisci un identificatore di contatto (contact_id) dalla tua rubrica contatti HostMyServers. Per recuperare l'elenco dei tuoi contatti disponibili, interroga l'endpoint:

GET /domains/contacts

La risposta elenca tutti i tuoi contatti con il loro id, che puoi copiare in questo campo.

Quando usare un contact_id?

Usa un contact_id se stai registrando domini per conto di un'entità diversa dal tuo profilo principale (es. una società separata, una filiale). Questo ti consente di avere un Owner coerente senza modificare le informazioni del tuo account.

Testare la connessione​

Dopo aver inserito le credenziali, fai clic su Salva poi sul pulsante Testa la connessione. WHMCS effettuerà una chiamata di test verso l'API HostMyServers e mostrerà il risultato:

  • Successo: "Connessione riuscita. Saldo account: XX.XX €" — la tua configurazione è operativa
  • Errore di autenticazione: verifica il tuo identificativo API e la chiave
  • Errore di connessione: verifica che il tuo server possa raggiungere l'API HostMyServers (firewall, cURL attivo)

Impostazioni avanzate​

Sincronizzazione automatica dei domini​

Questa impostazione attiva la sincronizzazione periodica degli stati e delle date di scadenza dei tuoi domini. È fortemente consigliato lasciarlo attivo per mantenere la coerenza tra WHMCS e HostMyServers.

Valore consigliato: Attivato

Ritardo di propagazione DNS (in ore)​

Durata visualizzata al cliente dopo una modifica dei nameserver, indicando il ritardo di propagazione stimato. Questo non ha alcun impatto tecnico.

Valore predefinito: 24

Mostra il saldo nel dashboard​

Se attivato, un widget mostra il tuo saldo HostMyServers nel pannello di amministrazione WHMCS.

Valore consigliato: Attivato (utile per anticipare le ricariche dell'account)

Una volta completata la configurazione e validato il test di connessione, il tuo modulo registrar HostMyServers è pronto. Passa al passo successivo: la gestione delle estensioni.