BlockAuth Logo
ES

WordPress

Sigue esta guía si tu web funciona con WordPress. No escribes código: el plugin Block-Auth Login hace toda la integración.

1. Qué obtienes

  • Un botón de Block-Auth en el login de WordPress, o un login sin contraseñas.
  • Cada login se verifica en tu servidor con tu API secret antes de que WordPress cree la sesión.
  • Los usuarios de WordPress se crean o se encuentran automáticamente, con el rol que elijas.
  • Las sesiones se cierran en WordPress cuando el usuario cierra sesión en Block-Auth o desvincula tu web.

2. Prepara tu app

  1. En el Dashboard, crea tu aplicación con el dominio de tu web y valídalo siguiendo la guía rápida de integración.
  2. Copia la apiKey y el apiSecret desde Aplicaciones » Ver claves.

3. Instala el plugin

En WordPress, ve a Plugins › Añadir nuevo › Subir plugin, sube el zip de Block-Auth Login y actívalo. Necesita WordPress 6.0 y PHP 7.4 o superior.

4. Conéctalo

Ve a Ajustes › Block-Auth Login, pega la API key y el API secret y pulsa Test connection. El secret se guarda cifrado. Si lo prefieres, define las claves en wp-config.php:

wp-config.php

define( 'BLOCKAUTH_API_KEY', 'your_api_key' );
define( 'BLOCKAUTH_API_SECRET', 'your_api_secret' );

5. Elige el login

En la misma página de ajustes, elige cómo se ve el login:

  • Junto al formulario clásico: los usuarios pueden entrar con su contraseña o con Block-Auth.
  • Sustituyendo el formulario: tu web no tiene contraseñas.

Para colocar el botón en cualquier página, usa el shortcode [blockauth_login]. Los formularios de login de WooCommerce son compatibles.

6. Configura el webhook

Copia la URL de callback de cierre de sesión que muestran los ajustes del plugin:

Callback URL

https://your-site.com/wp-json/blockauth/v1/signout-callback

En el Dashboard, abre tu aplicación y ve a Autenticación. En el tercer campo de URL, que aparece como «Cuando falla el inicio de sesión», escribe solo la ruta /wp-json/blockauth/v1/signout-callback (tu dominio ya viene puesto). Cuando un usuario cierra sesión en Block-Auth o desvincula tu web, WordPress cierra sus sesiones.

Los usuarios que ya tienen cuenta de WordPress pueden vincularla a su identidad de Block-Auth desde su perfil, desde WooCommerce › Mi cuenta o donde coloques el shortcode [blockauth_link]. La vinculación pide un login en WordPress de los últimos 10 minutos. A partir de ahí, iniciar sesión con Block-Auth abre esa misma cuenta de WordPress.

Puedes desactivar la vinculación con la opción Let signed-in users link their account to Block-Auth de los ajustes.

8. Roles e interruptor de rescate

Los usuarios nuevos reciben el rol por defecto que elijas, y en los ajustes puedes mapear roles de Block-Auth a roles de WordPress. Si alguna vez te quedas fuera, añade esta línea a wp-config.php para recuperar el login clásico:

wp-config.php

define( 'BLOCKAUTH_DISABLE', true );