Tus secretos son de solo escrituraEl material secreto (claves de firma y claves privadas) se acepta al registrarse y nunca
lo devuelve ningún endpoint. Se cifra con una clave KMS dedicada antes de almacenarse;
el texto sin cifrar existe solo en memoria mientras se firma una solicitud. Las lecturas devuelven únicamente
material no secreto: el identificador
x_login, o la huella (fingerprint) y el vencimiento del certificado.Precedencia: los encabezados por solicitud siempre prevalecen
Los encabezados de firma por solicitud (yuno-proxy-auth + yuno-proxy-auth-secret-key) siguen funcionando exactamente como antes. En cualquier
reenvío:
- Si la solicitud incluye encabezados
yuno-proxy-auth*, se usan esas credenciales. - De lo contrario, si el destino tiene un perfil guardado, el proxy lo usa.
- De lo contrario, la solicitud se reenvía sin autenticación, como una simple entrada de la lista de permitidos.
DLOCAL_HMAC guardado, el proxy establece los cuatro encabezados
(X-Login, X-Trans-Key, X-Date, Authorization) a partir del perfil: los valores que envíes para
esos encabezados en esa solicitud se reemplazan. Se presenta un certificado mTLS siempre que el
destino tenga un perfil MTLS, sin importar cómo se firme la solicitud.
Si el mismo nombre de host está registrado tanto a nivel de organización como para una cuenta específica, el
destino de la cuenta, y su autenticación, prevalece en las solicitudes que incluyen ese
yuno-account-id.
Registra un destino con autenticación
Agrega un arregloauthentication al registro del destino,
con como máximo una entrada por tipo:
422 INVALID_AUTHENTICATION: un type desconocido, un
type duplicado, un campo obligatorio ausente o vacío, un campo inesperado, un certificado o una clave que no
se puede analizar, una clave que no coincide con el certificado, o un certificado vencido.
Rota las credenciales
La rotación es un reemplazo completo de la autenticación del destino: envía la nueva configuración completa; no hay actualización parcial:200 con el destino y el resumen de su nueva autenticación. La sobrescritura es
idempotente y surte efecto de inmediato: el siguiente reenvío ya usa las nuevas credenciales.
Usa certificate_expires_at en tus lecturas para programar la rotación del certificado antes de que venza.
Elimina la autenticación
200. El destino sigue funcionando como una simple entrada de la lista de permitidos; los reenvíos a él
simplemente dejan de ser autenticados por el proxy. Eliminar el destino también elimina su
autenticación.
Cada cambio de autenticación se registra en el registro de auditoría del destino como AUTH_SET o
AUTH_REMOVED.