SDKs de Block-Auth
Block-Auth tiene SDKs para los dos lados de tu app: un widget de login para tu frontend y un cliente para tu backend. Juntos añaden login sin contraseñas sin que tu app tenga que fiarse nunca del navegador.
Qué SDK necesitas
| Dónde | Paquete | Qué usas en tu código |
|---|---|---|
| React | @block-auth.io/react | BlockAuthProvider, <FlowBlockAuth />, <LinkBlockAuth />, useBlockAuthUser() |
| Vue | @block-auth.io/vue | createBlockAuth(), <FlowBlockAuth />, <LinkBlockAuth />, useBlockAuthUser() |
| Angular | @block-auth.io/angular | provideBlockAuth(), <ba-flow-block-auth>, <ba-link-block-auth>, BlockAuthService |
| Node.js | @block-auth.io/node | BlockAuthRoutes, blockauthRouter(), AuthCodeClient |
| PHP | blockauth/sdk | BlockAuthRoutes, AuthCodeClient |
| Python | blockauth-sdk | BlockAuthRoutes, blockauth_blueprint() (Flask), blockauth_router() (FastAPI), AuthCodeClient |
| .NET | BlockAuth.Sdk.AspNetCore | AddBlockAuth(), MapBlockAuth(), AuthCodeClient |
| WordPress | Plugin Block-Auth Login | Botón de login, vinculación de cuentas, usuarios y roles |
Los tres paquetes de frontend comparten el mismo motor, @block-auth.io/core, y ofrecen los mismos componentes. Los paquetes de backend te dan BlockAuthRoutes, las rutas que llama el widget, listas para montar en tu servidor, y AuthCodeClient para el login por redirección. En .NET, BlockAuth.Sdk.AspNetCore trae BlockAuth.Sdk con él.
AuthCodeClient tiene los mismos métodos en todos los lenguajes: authorize, exchangeCode, signOut, revokeLink y verifyWebhook (en Python, exchange_code, sign_out…; en .NET, ExchangeCodeAsync, SignOutAsync…).
Dos formas de integrar
Las dos terminan igual: tu backend canjea un código de un solo uso con tu apiSecret y crea su propia sesión.
- Widget y tu backend. El botón de Block-Auth está en tu frontend y abre el login en un popup; tu backend canjea el código. Lo mejor para apps de una sola página en React, Vue o Angular. Sigue la guía rápida de los SDKs.
- Login por redirección. Tu frontend solo tiene un enlace; tu backend redirige al usuario a Block-Auth y lo recibe de vuelta. Lo mejor para apps renderizadas en el servidor. Consulta PHP, Python, .NET, Node.js.
La regla que importa
- La
apiKeyes pública: va en tu frontend. - El
apiSecretes privado: se queda en tu backend, nunca en el navegador. - Tu backend solo se fía del usuario que obtiene de
POST /api/auth/token, nunca de una dirección que envía el navegador.
¿Y ahora qué?
- Guía rápida de los SDKs: elige la guía de tu stack e intégralo de cero, paso a paso.
- Personaliza el widget: todas las props de los componentes de React, Vue y Angular.
- Roles: muestra u oculta partes de tu interfaz según el rol.

