Cómo funciona la coincidencia
El proxy solo reenvía a los hosts que están registrados y habilitados en tu lista de permitidos. La coincidencia es exacta sobre el hostname:- Sin distinción entre mayúsculas y minúsculas:
API.Stripe.comyapi.stripe.comson el mismo host. - Sin comodines:
api.example.comno autorizasandbox.example.com. - Los subdominios se registran por separado.
DISABLED, se rechaza con
403 DESTINATION_NOT_ALLOWED antes de que se lea cualquier dato de tarjeta.
Registrar un destino
201 con la entrada creada, que comienza en el estado ENABLED. Un hostname que ya
está registrado devuelve 409 DESTINATION_EXISTS; un valor que no es un hostname público simple
(una URL, un host con puerto o ruta, una dirección IP o un comodín) devuelve 422 INVALID_HOSTNAME;
un account_id que no es una cuenta válida para tu organización devuelve 400 INVALID_ACCOUNT_ID.
account_id es opcional. Si se deja en null (el valor predeterminado), el destino se permite para todas las
cuentas de tu organización. Configúralo con el id de una cuenta específica para limitar el destino a
esa cuenta únicamente: el host solo se podrá usar entonces en las solicitudes al proxy realizadas bajo esa cuenta.
El objeto de destino devuelve id, hostname, purpose, account_id, status
(ENABLED / DISABLED), created_at y updated_at. Cuando llamas mediante la API, el actor
es tu clave de API, por lo que el objeto no incluye el email de un usuario.
Listar tus destinos
{"destinations": [ ... ]}. Sin el encabezado que se describe a continuación, devuelve solo los destinos
de toda la organización (account_id: null).
La llamada de reenvío usa un encabezado de cuenta distintoLos endpoints anteriores (listar, registrar, eliminar, habilitar, deshabilitar) usan
X-account-code. La
llamada del proxy de reenvío usa un
encabezado distinto, yuno-account-id; ambos llevan el mismo account_id. Si omites
yuno-account-id al reenviar a un destino limitado a una cuenta, obtienes el mismo
403 DESTINATION_NOT_ALLOWED que con un host no registrado.Eliminar un destino
204. Eliminar un destino surte efecto de inmediato: la siguiente solicitud al proxy hacia
ese host es rechazada.
Si el destino se registró con account_id definido, pasa X-account-code: {account_id} también en
esta llamada, igual que al listar tus destinos,
de lo contrario se trata como no encontrado.
Habilitar o deshabilitar un destino
En lugar de eliminar un host, puedes deshabilitarlo: el registro (y su historial de auditoría) se conserva, pero la ruta de reenvío deja de usarlo. Habilítalo de nuevo para volver a activarlo. Esto es útil para suspender temporalmente un destino sin perder su configuración.200 con el objeto de destino actualizado (con su status en DISABLED o
ENABLED). Solo los destinos ENABLED son usados por la ruta de reenvío; una solicitud a un host
DISABLED devuelve 403 DESTINATION_NOT_ALLOWED.
El mismo encabezado X-account-code: {account_id} aplica aquí: si el destino se registró
con account_id definido, inclúyelo o la llamada tratará el destino como no encontrado.
Un destino pasa por tres estados:
Registro de auditoría
Cada cambio en la lista de permitidos (agregar, eliminar, habilitar y deshabilitar) se escribe en un registro de auditoría de solo anexado que registra quién hizo el cambio, cuándo y qué hostname. El registro de auditoría persiste incluso después de eliminar un destino, de modo que una eliminación nunca es invisible: siempre puedes ver quién eliminó un host y cuándo. No hay forma de alterar o borrar estos registros de auditoría mediante la API.Toma en serio las alertas de nuevos destinos y eliminacionesAgregar o eliminar un destino es una acción sensible: cambia a dónde se pueden enviar tus tarjetas.
Yuno recomienda restringir quién puede gestionar la lista de permitidos, habilitar las notificaciones sobre los cambios
en la lista de permitidos y revisar cualquier adición o eliminación inesperada, ya que son la señal de alerta de una
cuenta de dashboard comprometida.