BlockAuth Logo
ES

Guía rápida de los SDKs

Cada guía te lleva de cero a producción, paso a paso. Elige la que encaja con tu app y sigue solo esa. Para terminar la integración, síguela hasta su última página.

Cómo se conectan las piezas

Elige tu stack y pasa el ratón por una pieza o un paso para seguirlo.

  • SDK de Block-Auth
  • Tu código
  • Lo aloja Block-Auth

Tu frontend

  • <BlockAuthProvider>SDK de Block-Auth. Config con tu apiKey pública.
  • <FlowBlockAuth />SDK de Block-Auth. Botón de login y, después, el menú de perfil.
  • <LinkBlockAuth />SDK de Block-Auth. Vincula al usuario de tu app que tiene sesión.
  • useBlockAuthUser()SDK de Block-Auth. Usuario y roles para tu UI, leídos del estado del SDK.

Tu backend

  • POST /codeTu código. Canjea el código y pone tu cookie httpOnly.
  • GET /me · POST /logoutTu código. Quién tiene sesión, comprobado al cargar y cada 60 s, y logout.
  • GET · POST /linkTu código. Envía tu id de usuario como linkExternalId.
  • WebhookTu código. Recibe signout y account.unlinked.

Block-Auth

  • DashboardLo aloja Block-Auth. Tu app, dominio, claves y roles.
  • auth.block-auth.ioLo aloja Block-Auth. Login alojado: identidad de Block-Auth (extensión o app móvil), Google, Microsoft, MetaMask, Phantom o WalletConnect.
  • BlockchainLo aloja Block-Auth. Cada sesión queda firmada on-chain.
  • Block-Auth APILo aloja Block-Auth. /api/auth/token, /signout y /link/revoke, con tu apiSecret.
  • IdentityLo aloja Block-Auth. Tus usuarios ven sus sesiones, dispositivos y apps vinculadas, y pueden cerrarlas o desvincularlas.

Widget en tu frontend y sesión en tu backend. Las rutas de tu backend cuelgan de /auth/blockauth, o de tu authEndpoint, y pueden usar el paquete de Block-Auth para Node.js, PHP, Python o .NET, o HTTP directo.

  1. 1Copias tu apiKey pública del Dashboard.
  2. 2Abre el login en un popup (PKCE).
  3. 3Devuelve un código de un solo uso.
  4. 4La sesión queda firmada on-chain.
  5. 5Envía el código a tu backend.
  6. 6Canjea código + apiSecret: recibe address y roles.
  7. 7Al cargar y cada 60 s (sessionCheckSeconds), pregunta a tu backend quién tiene sesión; el logout la cierra.
  8. 8Comparte el usuario y sus roles con el resto de tu UI.
  9. 9Opcional: abre el mismo popup de login para vincular a tu usuario existente.
  10. 10Consulta si ya está vinculado y envía el nuevo código.
  11. 11El usuario cierra una sesión o desvincula tu app en Identity.
  12. 12Webhook firmado si el usuario cierra sesión o desvincula.

Elige tu guía

3/4Último paso del recorridoCompleta tu guía y Block-Auth quedará integrado en tu app.

Por qué tu backend canjea el código

Tu backend nunca debe fiarse de una address de usuario enviada por el navegador. El navegador decide qué envía, y saber si una dirección tiene la sesión iniciada en tu app es un dato público on-chain: cualquiera podría enviar la dirección de otro usuario y quedarse con su sesión.

Por eso todas las guías terminan igual: Block-Auth da al navegador un código de un solo uso, inútil sin tu apiSecret, y tu backend lo canjea en POST /api/auth/token para obtener la dirección y los roles del usuario directamente de Block-Auth. Solo entonces crea su propia sesión.