¿Qué son los esquemas de seguridad?#
Los esquemas de seguridad son una forma de definir cómo se autentican sus endpoints, siguiendo la Especificación OpenAPI (OAS). En lugar de configurar la autenticación para cada endpoint de forma individual, puede crear una plantilla reutilizable (un esquema de seguridad) que separe los métodos de autenticación de las credenciales reales. Esto facilita que los equipos gestionen, actualicen y reutilicen la configuración de autenticación de manera más flexible.¿Por qué usar esquemas de seguridad?#
Definir una vez, usar en todas partes: Cree un esquema de seguridad una vez y reutilícelo en múltiples endpoints o carpetas.
Combinaciones flexibles: Un endpoint puede usar más de un tipo de esquema de seguridad.
Separación de plantilla y valor: Mantenga las reglas de autenticación (plantilla) separadas de los valores reales (credenciales), lo que facilita el mantenimiento.
Evita la filtración de credenciales: Al probar endpoints con esquemas de seguridad en la documentación en línea, las credenciales deben introducirse manualmente.
Hereda automáticamente: Los endpoints pueden heredar esquemas de seguridad de sus carpetas principales, lo que reduce la configuración repetitiva.
Admite todos los métodos de autenticación principales: Incluidos API Key, Bearer Token, Basic Auth, OAuth 2.0 y más.
Compatible con OpenAPI: Totalmente compatible con la especificación de esquemas de seguridad de OpenAPI 3.0.
¿Cuándo debería usarlo?#
Cuando varios endpoints comparten el mismo método de autenticación.
Cuando un único endpoint requiere múltiples tipos de autenticación.
Cuando necesita credenciales diferentes para distintos entornos.
Cuando los equipos trabajan juntos y necesitan una forma unificada de gestionar la autenticación.
Cuando desea incluir definiciones de seguridad claras y estandarizadas en su documentación de OpenAPI.
Modified at 2026-06-09 08:52:14
