Het Nobregas MySQL Panel biedt een API-sleutel voor programmatische toegang tot je account. Met een API-sleutel kun je paneeloperaties integreren in scripts, CI/CD-pipelines en aangepaste applicaties zonder via de browser in te loggen.
Wat is een API-sleutel?
Een API-sleutel is een uniek geheim token dat gekoppeld is aan je account. Het werkt als een wachtwoord voor geautomatiseerde systemen — in plaats van je e-mailadres en wachtwoord in te voeren, stuurt je script de API-sleutel mee bij elk verzoek om te authenticeren.
Je API-sleutel genereren
- Log in op mysql.nobregas.org.
- Klik op je avatar (gebruikersicoon) in de rechterbovenhoek en selecteer Profile.
- Scroll naar de sectie API Key.
- Klik op de regenereerknop (sync-icoon) naast het API-sleutelveld.
- Er verschijnt een bevestigingsdialoog die waarschuwt dat de huidige sleutel ongeldig wordt gemaakt.
- Klik op Generate om te bevestigen.
- Je nieuwe API-sleutel wordt weergegeven. Kopieer deze onmiddellijk — om beveiligingsredenen wordt deze mogelijk niet opnieuw volledig getoond.
Als je al een API-sleutel hebt en een nieuwe genereert, wordt de vorige sleutel ingetrokken en stopt met werken. Er bestaat slechts één actieve sleutel tegelijkertijd.
Je API-sleutel gebruiken
Voeg de API-sleutel toe aan je HTTP-verzoeken om te authenticeren met de API-endpoints van het paneel.
Voorbeeld: cURL
curl -H "Authorization: Bearer YOUR_API_KEY" \
https://mysql.nobregas.org/api/databases
Voorbeeld: 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);
Voorbeeld: Python
import requests
headers = {'Authorization': 'Bearer YOUR_API_KEY'}
response = requests.get('https://mysql.nobregas.org/api/databases', headers=headers)
Voorbeeld: Node.js
const response = await fetch('https://mysql.nobregas.org/api/databases', {
headers: { 'Authorization': 'Bearer YOUR_API_KEY' }
});
Wat je kunt doen met de API
De API-sleutel verleent dezelfde rechten als je ingelogde sessie:
- Databases en hun details bekijken.
- Databases aanmaken en verwijderen.
- Databasegebruikers en rechten beheren.
- Queries uitvoeren.
- Back-ups aanmaken en beheren.
- IP-whitelists beheren.
Best practices voor beveiliging
Veilig opslaan
- Commit nooit API-sleutels naar Git of enig versiebeheersysteem.
- Gebruik omgevingsvariabelen om de sleutel op te slaan:
export NOBREGAS_API_KEY="your_key_here" - Gebruik een secrets manager in productie (AWS Secrets Manager, Vault, enz.).
Regelmatig roteren
Genereer periodiek een nieuwe API-sleutel. Dit trekt de oude sleutel in en geeft een nieuwe uit, waardoor het risicotijdvenster wordt beperkt als een sleutel ooit is blootgesteld.
Blootstelling beperken
- Deel de API-sleutel alleen met systemen die het nodig hebben.
- Neem het nooit op in client-side code (browser JavaScript).
- Stuur het nooit via onversleutelde kanalen (gebruik altijd HTTPS).
Intrekken als gecompromitteerd
Als je vermoedt dat je API-sleutel is gelekt, genereer onmiddellijk een nieuwe. De oude sleutel wordt direct ingetrokken.
Je API-sleutel opnieuw genereren
Om een nieuwe sleutel te krijgen (en de huidige in te trekken):
- Ga naar Profile (via je avatar in de rechterbovenhoek) en scroll naar de sectie API Key.
- Klik op de regenereerknop (sync-icoon) en bevestig.
- De oude sleutel wordt ingetrokken en een nieuwe wordt uitgegeven.
- Werk alle scripts en applicaties bij met de nieuwe sleutel.
