> ## Documentation Index
> Fetch the complete documentation index at: https://translations.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> Explica cómo instalar el plugin de Auth0 para WordPress

# Instalar Login by Auth0

<Callout icon="file-lines" color="#0EA5E9" iconType="regular">
  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](https://wordpress.com/support/com-vs-org/).
</Callout>

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](https://wordpress.com/support/com-vs-org/).

En cuanto actives el plugin, se te redirigirá al inicio del Asistente de configuración.

Si todavía no tienes una cuenta de Auth0, [r**egístrate gratis para crear una**](https://auth0.com/signup) antes de continuar.

<Callout icon="file-lines" color="#0EA5E9" iconType="regular">
  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.
</Callout>

<div id="multisite-setup">
  ## Configuración multisitio
</div>

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](/es/docs/customize/integrations/cms/wordpress-plugin/configure-login-by-auth0) 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"](https://community.auth0.com/tags/wordpress).

<div id="setup-wizard">
  ## Asistente de configuración
</div>

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.

<div id="option-1-standard-setup">
  ### Opción 1: Configuración estándar
</div>

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](https://auth0.com/docs/api/management/v2/get-access-tokens-for-test#get-access-tokens-manually). 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](/es/docs/get-started/auth0-overview/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](/es/docs/authenticate/database-connections/password-strength#password-policieslicies).

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 <Tooltip tip="Auth0 Dashboard: producto principal de Auth0 para configurar sus servicios." cta="Ver glosario" href="/es/docs/glossary?term=Auth0+Dashboard">Auth0 Dashboard</Tooltip>. En WordPress, vaya a **Auth0 > Settings > Basic**, elimine los campos Domain, <Tooltip tip="Client Secret: secreto que utiliza un cliente (aplicación) para autenticarse con el servidor de autorización; solo el cliente y el servidor de autorización deben conocerlo y debe ser lo suficientemente aleatorio como para que no se pueda adivinar." cta="Ver glosario" href="/es/docs/glossary?term=Client+ID">Client ID</Tooltip> y <Tooltip tip="Client ID: valor de identificación que Auth0 asigna a su recurso registrado." cta="Ver glosario" href="/es/docs/glossary?term=Client+Secret">Client Secret</Tooltip>, 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](https://community.auth0.com/tags/wordpress) con los mensajes de error que ve en el Error Log, y con gusto le ayudaremos.

<div id="option-2-user-migration-setup">
  ### Opción 2: Configuración de la migración de usuarios
</div>

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](/es/docs/customize/integrations/cms/wordpress-plugin/user-migration-in-login-by-auth0).

::: 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](/es/docs/customize/integrations/cms/wordpress-plugin/user-migration-in-login-by-auth0).
:::

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.

<div id="option-3-manual-setup">
  ### Opción 3: Configuración manual
</div>

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.

<div id="option-4-import-setup">
  ### Opción 4: Importar la configuración
</div>

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.

<div id="setup-complete">
  ## Configuración completada
</div>

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](/es/docs/customize/integrations/cms/wordpress-plugin/configure-login-by-auth0).

<div id="manual-setup">
  ## Configuración manual
</div>

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](https://manage.auth0.com/#) 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](/es/docs/customize/integrations/cms/wordpress-plugin/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.

<div id="learn-more">
  ## Más información
</div>

* [Integración con WordPress](/es/docs/customize/integrations/cms/wordpress-plugin/integrate-with-wordpress)
* [Configurar Login by Auth0](/es/docs/customize/integrations/cms/wordpress-plugin/configure-login-by-auth0)
* [Solucionar problemas del plugin Login by Auth0 para WordPress](/es/docs/customize/integrations/cms/wordpress-plugin/troubleshoot-login-by-auth0)
* [Ampliar el plugin Login by Auth0 para WordPress](/es/docs/customize/integrations/cms/wordpress-plugin/extend-login-by-auth0)
