El Panel MySQL de Nobregas proporciona una clave API para acceso programático a tu cuenta. Con una clave API, puedes integrar operaciones del panel en scripts, pipelines CI/CD y aplicaciones personalizadas sin iniciar sesión a través del navegador.
¿Qué Es una Clave API?
Una clave API es un token secreto único vinculado a tu cuenta. Funciona como una contraseña para sistemas automatizados — en lugar de ingresar tu email y contraseña, tu script envía la clave API con cada solicitud para autenticarse.
Generar Tu Clave API
- Inicia sesión en mysql.nobregas.org.
- Haz clic en tu avatar (icono de usuario) en la esquina superior derecha y selecciona Profile.
- Desplázate hasta la sección API Key.
- Haz clic en el botón de regenerar (icono de sincronización) junto al campo de la clave API.
- Aparece un diálogo de confirmación advirtiendo que la clave actual será invalidada.
- Haz clic en Generate para confirmar.
- Tu nueva clave API se muestra. Cópiala inmediatamente — por razones de seguridad, puede que no se muestre completa nuevamente.
Si ya tienes una clave API y generas una nueva, la clave anterior es revocada y deja de funcionar. Solo existe una clave activa a la vez.
Usar Tu Clave API
Incluye la clave API en tus solicitudes HTTP para autenticarte con los endpoints de la API del panel.
Ejemplo: cURL
curl -H "Authorization: Bearer TU_CLAVE_API" \
https://mysql.nobregas.org/api/databases
Ejemplo: PHP
$ch = curl_init('https://mysql.nobregas.org/api/databases');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'Authorization: Bearer TU_CLAVE_API'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
Ejemplo: Python
import requests
headers = {'Authorization': 'Bearer TU_CLAVE_API'}
response = requests.get('https://mysql.nobregas.org/api/databases', headers=headers)
Ejemplo: Node.js
const response = await fetch('https://mysql.nobregas.org/api/databases', {
headers: { 'Authorization': 'Bearer TU_CLAVE_API' }
});
Qué Puedes Hacer con la API
La clave API otorga los mismos permisos que tu sesión iniciada:
- Listar bases de datos y sus detalles.
- Crear y eliminar bases de datos.
- Gestionar usuarios de base de datos y privilegios.
- Ejecutar consultas.
- Crear y gestionar copias de seguridad.
- Gestionar listas blancas de IPs.
Mejores Prácticas de Seguridad
Almacenar de Forma Segura
- Nunca subas claves API a Git ni a ningún sistema de control de versiones.
- Usa variables de entorno para almacenar la clave:
export NOBREGAS_API_KEY="tu_clave_aqui" - Usa un gestor de secretos en producción (AWS Secrets Manager, Vault, etc.).
Rotar Regularmente
Genera una nueva clave API periódicamente. Esto revoca la clave antigua y emite una nueva, limitando la ventana de exposición si una clave fue comprometida.
Limitar la Exposición
- Solo comparte la clave API con sistemas que la necesiten.
- Nunca la incluyas en código del lado del cliente (JavaScript en el navegador).
- Nunca la envíes por canales no encriptados (siempre usa HTTPS).
Revocar Si Está Comprometida
Si sospechas que tu clave API ha sido filtrada, genera una nueva inmediatamente. La clave antigua se revoca al instante.
Regenerar Tu Clave API
Para obtener una nueva clave (y revocar la actual):
- Ve a Profile (a través de tu avatar en la esquina superior derecha) y desplázate hasta la sección API Key.
- Haz clic en el botón de regenerar (icono de sincronización) y confirma.
- La clave antigua se revoca y se emite una nueva.
- Actualiza todos los scripts y aplicaciones con la nueva clave.
