Il Nobregas MySQL Panel fornisce una API key per l'accesso programmatico al tuo account. Con una API key, puoi integrare le operazioni del pannello in script, pipeline CI/CD e applicazioni personalizzate senza accedere tramite il browser.
Cos'è una API Key?
Una API key è un token segreto univoco collegato al tuo account. Funziona come una password per sistemi automatizzati — invece di inserire email e password, il tuo script invia la API key con ogni richiesta per autenticarsi.
Generare la Tua API Key
- Accedi a mysql.nobregas.org.
- Clicca sul tuo avatar (icona utente) nell'angolo in alto a destra e seleziona Profile.
- Scorri alla sezione API Key.
- Clicca il pulsante di rigenerazione (icona sincronizzazione) accanto al campo API key.
- Appare una finestra di conferma che avverte che la chiave attuale verrà invalidata.
- Clicca Generate per confermare.
- La tua nuova API key viene mostrata. Copiala immediatamente — per motivi di sicurezza, potrebbe non essere mostrata nuovamente per intero.
Se hai già una API key e ne generi una nuova, la chiave precedente viene revocata e smette di funzionare. Esiste solo una chiave attiva alla volta.
Usare la Tua API Key
Includi la API key nelle tue richieste HTTP per autenticarti con gli endpoint API del pannello.
Esempio: cURL
curl -H "Authorization: Bearer YOUR_API_KEY" \
https://mysql.nobregas.org/api/databases
Esempio: PHP
$ch = curl_init('https://mysql.nobregas.org/api/databases');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'Authorization: Bearer YOUR_API_KEY'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
Esempio: Python
import requests
headers = {'Authorization': 'Bearer YOUR_API_KEY'}
response = requests.get('https://mysql.nobregas.org/api/databases', headers=headers)
Esempio: Node.js
const response = await fetch('https://mysql.nobregas.org/api/databases', {
headers: { 'Authorization': 'Bearer YOUR_API_KEY' }
});
Cosa Puoi Fare con l'API
La API key garantisce gli stessi permessi della sessione di accesso:
- Elencare database e i loro dettagli.
- Creare e eliminare database.
- Gestire utenti database e privilegi.
- Eseguire query.
- Creare e gestire backup.
- Gestire le whitelist IP.
Best Practice di Sicurezza
Conservazione Sicura
- Mai committare API key su Git o qualsiasi sistema di controllo versione.
- Usa variabili d'ambiente per memorizzare la chiave:
export NOBREGAS_API_KEY="your_key_here" - Usa un secrets manager in produzione (AWS Secrets Manager, Vault, ecc.).
Rotazione Regolare
Genera una nuova API key periodicamente. Questo revoca la vecchia chiave ed emette una nuova, limitando la finestra nel caso la chiave fosse stata esposta.
Limitare l'Esposizione
- Condividi la API key solo con i sistemi che ne hanno bisogno.
- Non includerla mai in codice lato client (JavaScript del browser).
- Non inviarla mai su canali non crittografati (usa sempre HTTPS).
Revocare se Compromessa
Se sospetti che la tua API key sia stata divulgata, genera immediatamente una nuova chiave. La vecchia chiave viene revocata istantaneamente.
Rigenerare la Tua API Key
Per ottenere una nuova chiave (e revocare quella attuale):
- Vai su Profile (tramite il tuo avatar nell'angolo in alto a destra) e scorri alla sezione API Key.
- Clicca il pulsante di rigenerazione (icona sincronizzazione) e conferma.
- La vecchia chiave viene revocata e ne viene emessa una nuova.
- Aggiorna tutti gli script e le applicazioni con la nuova chiave.
