Los permisos de las claves API te permiten controlar exactamente lo qué puede hacer cada clave API en tu cuenta de Brevo. Otorgar a una integración solo el acceso que necesita significa que una clave comprometida o compartida no podrá utilizarse para nada más.
Información relevante
- Las claves creadas antes de que los permisos estuvieran disponibles conservan el acceso completo hasta que las edites.
- Los permisos se aplican únicamente a las claves API. Las claves SMTP no se ven afectadas. Para obtener más información, consulta nuestro artículo dedicado Crear y administrar claves SMTP.
Tipos de acceso
Cuando creas o editas una clave API, primero debes eligir a qué parte de tu cuenta puede acceder la clave:
- [Recomendado] Restricted (Restringido): tú eliges exactamente a qué puede acceder la clave. Todos los recursos comienzan con None (Ninguno), por lo que solo debes seleccionar un nivel de permiso para los recursos que la clave necesite.
- Full (Completo): la clave puede acceder a todos los recursos actuales y futuros.
Niveles de permiso
Para cada recurso de una clave Restricted (Restringida), debes elegir uno de los cuatro niveles de permiso. La siguiente tabla muestra lo que permite cada nivel:
| Nivel | Qué puede hacer la clave | Solicitudes API permitidas |
|---|---|---|
| Ninguno | No tiene acceso al recurso. | Ninguno |
| Lectura | Puede ver el recurso, pero no puede modificarlo. | GET |
| Lectura/escritura | Puede ver, crear y actualizar el recurso, pero no puede eliminarlo. | GET, POST y PUT |
| Todo | Tiene acceso completo al recurso, incluida la eliminación. | Todos los tipos de solicitudes |
Recursos disponibles
Puedes configurar permisos en 18 recursos. No todos los recursos ofrecen todos los niveles. La siguiente tabla muestra los niveles disponibles para cada recurso:
| Recurso | Niveles disponibles |
|---|---|
| Email transaccional | Ninguno, Lectura y Todo |
| SMS transaccionales | Ninguno, Lectura, Lectura/escritura y Todo |
| WhatsApp transaccional | Ninguno, Lectura, Lectura/escritura y Todo |
| Campañas de email | Ninguno, Lectura y Todo |
| Campañas SMS | Ninguno, Lectura y Todo |
| Campañas de WhatsApp | Ninguno, Lectura y Todo |
| Contactos | Ninguno, Lectura y Todo |
| Oportunidades | Ninguno, Lectura y Todo |
| Conversaciones | Ninguno, Lectura, Lectura/escritura y Todo |
| eCommerce | Ninguno, Lectura, Lectura/escritura y Todo |
| Fidelización | Ninguno, Lectura, Lectura/escritura y Todo |
| Eventos | Ninguno, Lectura, Lectura/escritura y Todo |
| Objetos | Ninguno, Lectura y Todo |
| Cuenta | Ninguno, Lectura, Lectura/escritura y Todo |
| Webhooks | Ninguno, Lectura, Lectura/escritura y Todo |
| Organización | Ninguno, Lectura y Todo |
| Wallet | Ninguno, Lectura, Lectura/escritura y Todo |
| Funciones de Brevo | Ninguno, Lectura, Lectura/escritura y Todo |
Establecer permisos para una clave API
Para establecer permisos en una clave nueva o editar los permisos de una clave existente, consulta nuestro artículo dedicado Crear y administrar claves API.
Qué ocurre cuando una clave no tiene el permiso necesario
Si una integración realiza una llamada que su clave no permite, Brevo bloquea la llamada y devuelve el error Access denied for resource (Acceso denegado al recurso). Para solucionarlo, consulta nuestro artículo dedicado Solución de problemas: problemas con las claves API.
⏭️ ¿Qué es lo siguiente?
- Crear y administrar claves API
- Solución de problemas: problemas con las claves API
- Autorizar y bloquear direcciones IP para la seguridad de las API y el SMTP
🤔 ¿Tiene alguna duda?
Si tiene alguna pregunta, no dude en ponerse en contacto con nuestro equipo de asistencia mediante la creación de un ticket desde su cuenta. Si todavía no tiene una cuenta, puede ponerse en contacto con nosotros aquí.
Si necesitas ayuda con un proyecto usando Brevo, podemos ponerte en contacto con la agencia partner de Brevo adecuada.