Utilizzare l'API di DirectAdmin: gestire il Suo pacchetto con script

DirectAdmin dispone di un'API: un modo per gestire il Suo pacchetto tramite uno script o un programma anziché con il mouse. Quasi tutto ciò che fa nel pannello può essere fatto anche tramite l'API. Pensi ad esempio ad aggiornare un record DNS quando il Suo indirizzo IP di casa cambia, creare caselle di posta dal Suo stesso software oppure richiedere ogni notte un elenco dei Suoi database.

Posso utilizzare l'API con il mio pacchetto?

Sì. L'API funziona con qualsiasi pacchetto che includa DirectAdmin: tutti i pacchetti di web hosting e anche i pacchetti e-mail. I reseller possono inoltre utilizzarla per gestire gli account dei propri clienti. Non deve richiedere nulla e non comporta costi aggiuntivi.

Uno script ha esattamente gli stessi diritti che ha Lei in DirectAdmin. Può quindi agire solo sul Suo pacchetto e solo per le operazioni che il Suo pacchetto consente.

Come funziona

• Indirizzo: comunica con l'API nello stesso punto in cui effettua l'accesso: https://nomeserver:2222. Trova il nome del server in Mio WebOké, presso il pacchetto, sotto Gestisci.
• Due tipi di comandi: la nuova API, con indirizzi che iniziano con /api/ e risposte in JSON, e la vecchia API con comandi come /CMD_API_.... Inizi dalla nuova API. Ciò che non è ancora presente lì, lo trova nella vecchia API. Aggiunga ?json=yes alla fine per ottenere una risposta in JSON.
• Accesso: ogni comando invia il Suo nome utente DA e una password (autenticazione HTTP Basic). Utilizzi preferibilmente una chiave di accesso (login key) e non la Sua vera password DA; veda di seguito.
• Documentazione nel Suo pannello: in DirectAdmin trova, sotto Support & Help, la API Documentation. Lì vede tutti i comandi della nuova API e può provarli subito con il Suo account.

Un esempio

Con questo comando richiede i database del Suo pacchetto. Sostituisca utente, chiave e nomeserver con i Suoi dati:

curl -u 'utente:chiave' https://nomeserver:2222/api/db-show/databases

Riceve un elenco in formato JSON. Allo stesso modo funziona da PHP, Python o qualsiasi altro linguaggio in grado di richiedere un indirizzo web.

Lavorare in sicurezza con una chiave di accesso

Non fornisca mai a uno script la Sua normale password DA. Crei in DirectAdmin, sotto Chiavi di accesso, una chiave separata. Una chiave di questo tipo può essere limitata:

• solo ai comandi di cui lo script ha realmente bisogno;
• solo dall'indirizzo IP del computer o del server su cui gira lo script;
• con una data di scadenza, se ha bisogno dell'accesso solo temporaneamente.

Escluda in ogni caso i comandi CMD_LOGIN_KEYS e CMD_PASSWD, in modo che la chiave non possa creare nuove chiavi né modificare la Sua password. Se la chiave venisse comunque compromessa, la elimini e ne crei una nuova, senza dover cambiare la Sua password.

Come creare una chiave è spiegato passo per passo nella guida di DirectAdmin: Chiavi di accesso: accedere per script e programmi.

Buono a sapersi

• Se uno script tenta spesso di accedere con una password o una chiave errata, il nostro firewall blocca tale indirizzo IP. Consulti Sono bloccato? se il Suo script perde improvvisamente la connessione.
• Siamo lieti di aiutarLa se l'API in sé non funziona, ma non scriviamo né verifichiamo script personalizzati. Per questo utilizzi la documentazione di DirectAdmin riportata di seguito.
• Preferisce gestire il Suo hosting con Claude, ChatGPT o Mistral, senza dover programmare Lei stesso? Consulti allora il nostro server MCP per IA.

Documentazione di DirectAdmin

La documentazione di DirectAdmin è in inglese:

• API Access: come funziona l'API, l'accesso e i diversi tipi di API.
• Examples: esempi con curl, Bash, PHP e Python.
• Legacy API: i comandi CMD_API più datati e le relative risposte.
• Panoramica dei comandi CMD_API: ricerca fra tutti i comandi più datati.
• Creating a login key: le chiavi di accesso secondo DirectAdmin.

Veda anche nella guida di DirectAdmin: Trovare il nome del server e il nome utente DA.