Saltar al contenido principal
En lugar de enviar credenciales de firma en cada reenvío, puedes asociar la autenticación a un destino de la lista de permitidos una sola vez. A partir de ese momento, cualquier reenvío a ese host es autenticado por el proxy de forma automática: firmado con HMAC, con tu certificado de cliente mTLS, o ambos. Hoy se admiten dos tipos de autenticación, y se pueden combinar en un mismo destino:
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:
  1. Si la solicitud incluye encabezados yuno-proxy-auth*, se usan esas credenciales.
  2. De lo contrario, si el destino tiene un perfil guardado, el proxy lo usa.
  3. De lo contrario, la solicitud se reenvía sin autenticación, como una simple entrada de la lista de permitidos.
Cuando se aplica un perfil 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 arreglo authentication al registro del destino, con como máximo una entrada por tipo:
Una entrada mTLS incluye el certificado y su clave privada en formato PEM. El certificado puede incluir intermedios; la clave privada es de solo escritura:
La respuesta, como toda lectura del destino, devuelve únicamente material no secreto:
Una configuración no válida devuelve 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:
Devuelve 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

Devuelve 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.

Errores