Quicknode provides multiple authentication methods to secure your Moca endpoints. Choose the approach that best fits your application's security requirements and deployment environment.

i

Disponibilidad de la función de autenticación

Algunos de los métodos de autenticación que se describen a continuación requieren planes específicos:

• Plan de prueba gratuito: autenticación mediante token y limitación básica de la tasa de solicitudes
• Plan «Build» y superiores: todos los métodos de autenticación, incluidos JWT, lista blanca de referenciadores, limitación avanzada de frecuencia y enmascaramiento de dominios.

Visita nuestra página de tarifas para obtener más información

Autenticación basada en tokens

Cada punto final incluye un token de autenticación único integrado directamente en la URL:

https://your-endpoint-name.moca.quiknode.pro/your-auth-token/

Autenticación basada en encabezados

Como alternativa, puedes pasar x-token en el encabezado de la solicitud:

JSON-RPC Request:

curl https://your-endpoint-name.moca.quiknode.pro/ \
  -X POST \
  -H "x-token: your-auth-token" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"method_name","params":[],"id":1}'

REST API Request:

curl https://your-endpoint-name.moca.quiknode.pro/endpoint_path \
  -X GET \
  -H "x-token: your-auth-token" \
  -H "accept: application/json"

gRPC Request:

For gRPC requests, include the x-token in the metadata:

// Example: Using grpc-go
metadata := metadata.Pairs("x-token", "your-auth-token")
ctx := metadata.NewOutgoingContext(context.Background(), metadata)
// Use ctx for your gRPC calls

Para que se acepten, todas las solicitudes deben incluir un token válido. Puedes volver a generar tokens en cualquier momento desde tu panel de control; los tokens antiguos dejan de ser válidos inmediatamente tras la regeneración. Al rotar los tokens, crea primero uno nuevo, actualiza tus aplicaciones para que utilicen el nuevo token y, a continuación, elimina el antiguo para garantizar la disponibilidad continua del servicio.

Desactivación de la autenticación mediante token: Con fines de desarrollo o prueba, puedes desactivar por completo la autenticación mediante token en la configuración de seguridad de tu punto final, creando así un punto final de acceso público.

Lista blanca de sitios de referencia

Puedes restringir el acceso a tu punto final permitiendo únicamente el tráfico procedente de dominios específicos. Esto ayuda a evitar el uso no autorizado de tu punto final desde entornos basados en navegador.

• Solicitudes HTTP debe incluir un Referente encabezado
• Conexiones WebSocket debe incluir un Origen encabezado
• La coincidencia de dominios requiere una coincidencia exacta; no se admiten caracteres comodín.

Limitaciones de seguridad: Aunque la lista blanca de referenciadores mejora la seguridad, no es infalible. Los encabezados HTTP como «Referer» y «Origin» pueden ser falsificados o manipulados por los atacantes mediante clientes HTTP personalizados o scripts, como por ejemplo con «curl». Por ejemplo, alguien que conozca la URL de tu punto final y el dominio incluido en la lista blanca podría crear una solicitud con los encabezados correctos para eludir esta restricción. Para una protección más sólida, plantéate combinar la lista blanca de referenciadores con otras funciones de seguridad, como la limitación de frecuencia o los tokens de autenticación.

Más información: Para obtener instrucciones detalladas sobre la configuración, consulta nuestra Guía de configuración de la lista blanca de referencias.

Autenticación JWT

Los tokens web JSON (JWT) ofrecen seguridad de nivel empresarial mediante tokens de autenticación firmados criptográficamente. A diferencia de la autenticación básica mediante tokens, los JWT permiten incorporar permisos personalizados, información del usuario y plazos de caducidad directamente en el token.

Los JWT permiten una autenticación sin estado entre el usuario y su punto final, lo que los convierte en la opción ideal para aplicaciones que requieren un control de acceso detallado, la generación programática de tokens y sistemas de permisos complejos. Resultan especialmente útiles en arquitecturas de microservicios, en las que el almacenamiento de sesiones no resulta práctico.

Para obtener información detallada sobre la implementación y ejemplos de código, consulta nuestra Guía de implementación de JWT.

Varios tokens de autenticación

Por defecto, cada punto de conexión de Quicknode cuenta con un único token de autenticación. No obstante, puedes crear tokens adicionales para el mismo punto de conexión, lo que te permite tener un mayor control sobre la gestión del acceso y las medidas de seguridad.

Los tokens múltiples te permiten separar entornos (desarrollo, prueba, producción), aislar diferentes aplicaciones o servicios y rotar los tokens sin interrumpir el servicio. Este enfoque también permite supervisar el uso individual, lo que ofrece una mejor visión del consumo de la API.

Para obtener instrucciones paso a paso, consulta nuestra Guía de configuración de Multi-token.

Funciones de seguridad adicionales

Los planes «Build» y superiores ofrecen controles de seguridad avanzados para una protección de terminales de nivel empresarial:

• Límites de frecuencia: establece límites por segundo, por minuto o por día para llamadas específicas a la API con el fin de evitar abusos y gestionar el uso de los recursos.
• Enmascaramiento de dominio: sustituye las URL predeterminadas de Quicknode por tu propio dominio de marca para obtener puntos de acceso profesionales y una mayor seguridad

Recursos de seguridad

Implementación de la autenticación JWT

Descubre cómo implementar la autenticación mediante JSON Web Token en tus puntos de conexión de Quicknode con ejemplos paso a paso y buenas prácticas.

Configuración de la autenticación con varios tokens

Configura varios tokens de autenticación para mejorar la gestión de la seguridad, la rotación de tokens y el aislamiento de entornos.

Configuración de la lista blanca de referencias

Configura la lista blanca de fuentes de referencia para restringir el acceso a los puntos finales a dominios específicos y mejorar la seguridad de las aplicaciones basadas en navegador.

Buenas prácticas de seguridad en el front-end

Guía completa para proteger tus aplicaciones front-end cuando utilizas los puntos finales de Quicknode, incluyendo la gestión de claves y las estrategias de limitación de tráfico.

Limitación de la tasa de métodos y pruebas

Controla la frecuencia de llamadas específicas a la API con límites por segundo, por minuto o por día para mejorar la protección de los puntos finales.

Cómo configurar el enmascaramiento de dominios

Utiliza tu propio dominio de marca para las URL de los puntos finales, en lugar del formato predeterminado de Quicknode, para mejorar la imagen de marca y la seguridad.