Le Panel MySQL Nobregas fournit une clé API pour l'accès programmatique à votre compte. Avec une clé API, vous pouvez intégrer les opérations du panel dans des scripts, des pipelines CI/CD et des applications personnalisées sans vous connecter via le navigateur.
Qu'est-ce qu'une Clé API ?
Une clé API est un jeton secret unique lié à votre compte. Elle fonctionne comme un mot de passe pour les systèmes automatisés — au lieu d'entrer votre email et mot de passe, votre script envoie la clé API avec chaque requête pour s'authentifier.
Générer Votre Clé API
- Connectez-vous sur mysql.nobregas.org.
- Cliquez sur votre avatar (icône utilisateur) dans le coin supérieur droit et sélectionnez Profile.
- Descendez jusqu'à la section API Key.
- Cliquez sur le bouton de régénération (icône de synchronisation) à côté du champ de la clé API.
- Une boîte de dialogue de confirmation apparaît avertissant que la clé actuelle sera invalidée.
- Cliquez sur Generate pour confirmer.
- Votre nouvelle clé API est affichée. Copiez-la immédiatement — pour des raisons de sécurité, elle pourrait ne plus être affichée en intégralité.
Si vous avez déjà une clé API et en générez une nouvelle, la clé précédente est révoquée et cesse de fonctionner. Une seule clé active existe à la fois.
Utiliser Votre Clé API
Incluez la clé API dans vos requêtes HTTP pour vous authentifier auprès des endpoints API du panel.
Exemple : cURL
curl -H "Authorization: Bearer YOUR_API_KEY" \
https://mysql.nobregas.org/api/databases
Exemple : 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);
Exemple : Python
import requests
headers = {'Authorization': 'Bearer YOUR_API_KEY'}
response = requests.get('https://mysql.nobregas.org/api/databases', headers=headers)
Exemple : Node.js
const response = await fetch('https://mysql.nobregas.org/api/databases', {
headers: { 'Authorization': 'Bearer YOUR_API_KEY' }
});
Ce Que Vous Pouvez Faire avec l'API
La clé API accorde les mêmes permissions que votre session connectée :
- Lister les bases de données et leurs détails.
- Créer et supprimer des bases de données.
- Gérer les utilisateurs de base de données et les privilèges.
- Exécuter des requêtes.
- Créer et gérer les sauvegardes.
- Gérer les listes blanches d'IPs.
Bonnes Pratiques de Sécurité
Stocker en Toute Sécurité
- Ne committez jamais les clés API dans Git ou tout système de contrôle de version.
- Utilisez des variables d'environnement pour stocker la clé :
export NOBREGAS_API_KEY="your_key_here" - Utilisez un gestionnaire de secrets en production (AWS Secrets Manager, Vault, etc.).
Rotation Régulière
Générez une nouvelle clé API périodiquement. Cela révoque l'ancienne clé et en émet une nouvelle, limitant la fenêtre d'exposition si une clé a été divulguée.
Limiter l'Exposition
- Ne partagez la clé API qu'avec les systèmes qui en ont besoin.
- Ne l'incluez jamais dans du code côté client (JavaScript navigateur).
- Ne l'envoyez jamais sur des canaux non chiffrés (utilisez toujours HTTPS).
Révoquer si Compromise
Si vous soupçonnez que votre clé API a été divulguée, générez-en immédiatement une nouvelle. L'ancienne clé est révoquée instantanément.
Régénérer Votre Clé API
Pour obtenir une nouvelle clé (et révoquer l'actuelle) :
- Allez dans Profile (via votre avatar dans le coin supérieur droit) et descendez jusqu'à la section API Key.
- Cliquez sur le bouton de régénération (icône de synchronisation) et confirmez.
- L'ancienne clé est révoquée et une nouvelle est émise.
- Mettez à jour tous les scripts et applications avec la nouvelle clé.
