Saltar al contenido principal
Para instalar o personalizar plugins, debes usar un sitio de WordPress.org autoalojado. Los sitios de WordPress.com no permiten instalar plugins. Para obtener más información sobre las diferencias, consulta WordPress.com y WordPress.org en WordPress.com.
Este plugin se puede añadir a tu sitio de WordPress desde la pantalla de Plugins en wp-admin:
  1. Inicia sesión en un sitio de WordPress existente como administrador.
  2. Ve a Plugins > Add New en el menú de administración de la izquierda.
  3. Busca “Login by Auth0”
  4. En el plugin Login by Auth0, haz clic en Install Now y luego en Activate.
Para obtener más información sobre este proceso, consulta WordPress.com y WordPress.org en WordPress.com. En cuanto actives el plugin, se te redirigirá al inicio del Asistente de configuración. Si todavía no tienes una cuenta de Auth0, regístrate gratis para crear una antes de continuar.
Auth0 no reemplazará tus formularios de inicio de sesión hasta que se hayan añadido Domain, Client ID y Client Secret en la pestaña Basic de la página de configuración.

Configuración multisitio

El plugin Login by Auth0 es compatible con las redes multisitio de WordPress. Puede activarse en toda la red para proteger automáticamente los sitios de la red (una vez completada la configuración) o activarse solo en una parte de la red. Hay varias formas de configurar una red de sitios en Auth0:
  1. Todos los sitios pueden compartir tanto una aplicación como una conexión de base de datos
    1. Complete todos los pasos del Asistente de configuración para el sitio principal.
    2. Configure manualmente todos los demás sitios usando el Domain, el Client ID y el Client Secret del sitio principal en la pestaña Basic de la página de configuración de Auth0.
    3. Actualice las Allowed Callback URLs, Allowed Web Origins y Allowed Logout URLs de la aplicación para incluir cada sitio (se pueden usar comodines si su red utiliza subdominios).
  2. Cada sitio puede tener su propia aplicación y compartir una conexión de base de datos
    1. Complete todos los pasos del Asistente de configuración para el sitio principal.
    2. Luego, cree manualmente una aplicación para cada sitio y agregue cada una a la conexión de base de datos creada anteriormente.
    3. Agregue los valores de Domain, Client ID y Client Secret en la pestaña Basic de la página de configuración de Auth0 para cada sitio.
  3. Cada sitio puede tener su propia aplicación y su propia conexión de base de datos. En este caso, complete todos los pasos del Asistente de configuración para cada sitio.
Cada una de las opciones anteriores implica ciertas ventajas e inconvenientes. La opción 1 tiene la menor cantidad de entidades distintas que administrar en Auth0, pero, si su red tiene cientos de sitios y no usa subdominios, podría encontrarse con limitaciones en la cantidad de URL de callback. La opción 2 requerirá administrar muchas aplicaciones distintas, pero le permitirá configurar la aplicación de cada sitio de forma diferente. Como siempre, si tiene alguna pregunta sobre este proceso de configuración, cree una publicación en nuestra Community y etiquétela con “wordpress”.

Asistente de configuración

El Asistente de configuración intentará crear todos los componentes necesarios para usar Auth0 en tu sitio de WordPress. Si ya tienes una aplicación o una conexión de base de datos que quieres usar, consulta los pasos de configuración manual que aparecen a continuación.

Opción 1: Configuración estándar

Esto creará y configurará una aplicación y una conexión de base de datos para este sitio. Primero, genere un token de la API de administración. Una vez generado, tome nota del nombre de dominio usado en el campo Identifier de la pestaña Settings. Por ejemplo, si su Identifier es https://tenant-name.auth0.com/api/v2/, el dominio del tenant es tenant-name.auth0.com. Para obtener más información sobre los dominios de tenant, consulte Create Tenants. De vuelta en el asistente de configuración del administrador de WordPress, haga clic en Standard. En la ventana modal que aparece, haga clic en Start Standard Setup. Ingrese el dominio del tenant y el token de API indicados anteriormente. Este token solo se utiliza durante el proceso de configuración y no se guardará en la base de datos. Si la primera parte de la configuración se completa correctamente, verá la pantalla “Configure your social connections”. Haga clic en Next para continuar con el proceso de configuración migrando su cuenta de administrador. Este paso vincula su usuario de WordPress con un usuario de Auth0 que le autoriza a iniciar sesión. Puede elegir la misma contraseña que usa en su cuenta de administrador o una distinta, pero asegúrese de que cumpla con las políticas de seguridad de contraseñas de la conexión de base de datos que se esté utilizando. Para obtener más información, consulte Password Strength in Auth0 Database Connections: Password Policies. El asistente de configuración debe ejecutarse hasta completarse para que su sitio quede configurado correctamente. Si el asistente falla por cualquier motivo antes de la pantalla “setup successful”, revise el registro de errores del plugin en wp-admin > Auth0 > Error Log y siga los pasos que aparecen a continuación para identificar el problema. Para reiniciar el proceso por completo, elimine cualquier aplicación o conexión de base de datos que se haya creado en el . En WordPress, vaya a Auth0 > Settings > Basic, elimine los campos Domain, y , y haga clic en Save. Luego, haga clic en Asistente de configuración en el menú de administración para volver a iniciar el proceso. Si aún no puede instalarlo, publique un hilo en nuestra Community con los mensajes de error que ve en el Error Log, y con gusto le ayudaremos.

Opción 2: Configuración de la migración de usuarios

Esto creará y configurará una aplicación y una conexión de base de datos, además de migrar datos desde tu base de datos de WordPress. Esto requiere una conexión entrante desde los servidores de Auth0 y no se puede cambiar más adelante sin perder datos. Para obtener más información, consulta User Migration in Login by Auth0 WordPress Plugin. ::: warning Si tienes más de una conexión de base de datos personalizada en Auth0, tendrás que asegurarte de que los ID de usuario incluyan un espacio de nombres para evitar conflictos. Esto se hace automáticamente en los sitios que instalan la versión 3.11.0 o posterior. Si tus conexiones se crean o se crearon con una versión anterior, consulta los pasos de solución de problemas en User Migration in Login by Auth0 WordPress Plugin. ::: Una vez completado el proceso de configuración, cierra sesión en tu sitio de WordPress e intenta volver a iniciarla usando tus credenciales actuales de WordPress en el formulario de inicio de sesión de Auth0. Esto debería crear un usuario de Auth0 vinculado a tu cuenta de WordPress.

Opción 3: Configuración manual

Esto omitirá la configuración automática y te permitirá crear y configurar tu propia aplicación y conexión de base de datos (consulta más abajo). Debes usar esta opción si quieres que este sitio utilice una aplicación o una conexión de base de datos ya existentes.

Opción 4: Importar la configuración

El sitio también se puede configurar importando la configuración de otro sitio. Esto resulta útil si estás migrando entre entornos o si tienes un sitio de WordPress similar que ya está configurado.

Configuración completada

Cuando veas la pantalla “Done”, Auth0 estará habilitado y listo para aceptar inicios de sesión y, si está configurado, registros. Este es un buen momento para confirmar que lo básico funciona en tu sitio antes de cambiar cualquiera de los ajustes predeterminados:
  1. Cierra sesión en WordPress y comprueba que el formulario de Auth0 aparece ahora en /wp-login.php.
  2. Inicia sesión con el usuario de Auth0 creado anteriormente.
  3. Cierra sesión e intenta crear una cuenta con otra dirección de correo electrónico (si tienes activada la opción “Anyone can register” en la configuración general de WordPress).
  4. Intenta iniciar sesión usando una conexión social (si las has activado).
Ahora ya estás listo para configurar la aplicación.

Configuración manual

El plugin puede configurarse con el Asistente de configuración integrado (que se describe a continuación) o manualmente, creando una Aplicación y asignando conexiones. El proceso de configuración completamente manual puede usarse si tienes problemas con el asistente, si ya has completado antes el proceso de configuración o si quieres compartir una conexión de base de datos entre Aplicaciones.
  1. Ve a Auth0 Dashboard > Applications > Applications y selecciona Create.
  2. Asigna a tu aplicación un nombre descriptivo, selecciona Regular Web Applications y, a continuación, Create.
  3. Configura la aplicación para tu instalación de WordPress. Para obtener información sobre cómo configurarla, lee Configure Login by Auth0 y sigue todas las secciones hasta “Update Auth0 settings in WordPress”.
Una vez completados los pasos anteriores, tu sitio estará configurado y listo para usar.

Más información