Guías · Empezar

Autenticación

Claves publicables y secretas, y desde dónde se puede usar cada una.

HTTP
Authorization: Bearer pk_...
ClaveDónde se usaRestricción
pk_ publicableNavegadorSolo desde los orígenes autorizados de la tienda. Origin ausente o no autorizado: 403 ORIGIN_NOT_ALLOWED.
sk_ secretaServidor a servidorNunca en un navegador. Con encabezado Origin: 403 SECRET_KEY_IN_BROWSER.

Tiendy solo guarda el hash de las dos clases, así que una clave se ve una sola vez, al crearla. El comercio las crea y revoca en el panel, en Configuración → API, y ahí mismo registra los orígenes. Hace falta el permiso de configuración (ver para leer, editar para crear, revocar o cambiar orígenes) y el plan con la API.

Orígenes. Coincidencia exacta de esquema, host y puerto: https://landing.example.com no autoriza https://www.landing.example.com ni https://landing.example.com:8443. Sin comodines. https obligatorio, salvo localhost, 127.0.0.1 y [::1] para desarrollo. Origin: null nunca está autorizado.

Una clave pk_ más el chequeo de origen no es un límite de seguridad. La clave es visible en el navegador y un cliente fuera de él puede falsificar Origin. Lo que protege a la tienda son las reglas del servidor y los límites de frecuencia, que se aplican siempre.

CORS. Un preflight OPTIONS no lleva Authorization, por lo que no puede saber de qué tienda se trata: responde 204 a cualquier origen, lo refleja en Access-Control-Allow-Origin con Vary: Origin y permite Authorization, Content-Type e Idempotency-Key. Un preflight exitoso no significa que el origen esté autorizado: eso se decide en el request real. Un ORIGIN_NOT_ALLOWED no lleva encabezados CORS, así que el navegador no deja leerlo; toda otra respuesta sí se puede leer y expone Retry-After e Idempotency-Replayed. No se usan cookies.