Si bien se puede acceder a los endpoints de la API de Sunra directamente desde el código del lado del cliente, almacenar las claves de la API en dichos entornos plantea riesgos de seguridad significativos. Para abordar esto, los desarrolladores suelen crear API personalizadas del lado del servidor que interactúan de forma segura con servicios de terceros como Sunra antes de devolver los resultados al cliente. Aunque es eficaz, este enfoque a menudo distrae a los equipos de centrarse en sus objetivos comerciales principales. Para agilizar este proceso, hemos desarrollado bibliotecas de cliente que admiten un modo de proxy. Esta función te permite utilizar las bibliotecas de cliente en tu código de frontend mientras mantienes las claves de la API de forma segura dentro de tu infraestructura del lado del servidor.

Soluciones de Proxy Prediseñadas

Ofrecemos soluciones de proxy prediseñadas para varios frameworks populares:
  • Node.js con Next.js: un manejador de rutas de API de Next.js que se puede usar en cualquier aplicación de Next.js. Admite tanto los enrutadores de Página como de Aplicación. Lo usamos nosotros mismos en todas nuestras aplicaciones en producción.
  • Node.js con Express: un manejador de rutas de Express que se puede usar en cualquier aplicación de Express. También puedes implementar lógica personalizada y componerla junto con tus propios manejadores.
Estamos comprometidos a expandir nuestras ofertas en función de los comentarios de la comunidad. Si tienes solicitudes o sugerencias específicas, contáctanos para compartir tus ideas.

Configuración del Proxy

Para integrar la funcionalidad de proxy, configura tu cliente especificando el proxyUrl en tu configuración:
import { sunra } from "@sunra/client";

sunra.config({
  proxyUrl: "/api/sunra/proxy",
});
Esta configuración garantiza que las llamadas a la API se enruten a través de tu servidor, mejorando la seguridad y simplificando el desarrollo.