Magic

Conecta Magic (magic.link), un SDK de autenticación sin contraseñas, con Webflow para añadir a tu sitio funciones de OTP por correo electrónico, inicio de sesión social y monedero Web3.

→
↗
►
↓
←
↑
Instalar aplicación
→
↗
►
↓
←
↑
Ver sitio web
→
↗
►
↓
←
↑
Ver lección
→
↗
►
↓
←
↑
Configuración de registros A
→
↗
►
↓
←
↑
Configuración de registros CNAME
Magic

Los sitios de Webflow que requieren inicio de sesión, contenido restringido o acceso de membresía necesitan una capa de autenticación externa. Los sitios que necesitan inicio de sesión de usuario, contenido restringido o acceso de membresía no tienen una forma nativa de identificar a los visitantes o gestionar sesiones. Todo sitio de Webflow que requiera la identidad del usuario depende de una solución de terceros.

Magic ofrece autenticación sin contraseña mediante códigos de un solo uso por correo, inicio de sesión social y SMS. Al conectar Magic con Webflow, consigues un sistema de acceso donde los usuarios inician sesión sin crear ni recordar contraseñas, y cada usuario autenticado recibe automáticamente un monedero Web3 sin custodia. La integración funciona a través de las funciones de código personalizado de Webflow y, si necesitas validación de tokens en el servidor o escrituras en el CMS, una ligera capa de middleware.

Los desarrolladores y agencias que crean sitios de membresía, portales de contenido restringido, páginas de destino para dApps Web3 o paneles de control para clientes en Webflow suelen utilizar esta integración. Los gestores de producto que evalúan la experiencia de usuario sin contraseñas y los fundadores de proyectos Web3 que necesitan aprovisionamiento de monederos sin ventanas emergentes de MetaMask también encontrarán esto relevante.

Cómo integrar Magic con Webflow

¿Qué es Magic? Magic es una infraestructura y un SDK de monederos integrados que ofrece autenticación sin contraseña para aplicaciones web. Los usuarios inician sesión mediante un código OTP por correo, cuentas sociales (Google, Apple, Discord, GitHub y más) o SMS, y reciben automáticamente un monedero Web3 sin custodia al autenticarse. Magic es compatible con más de 30 redes blockchain y cuenta con las certificaciones SOC 2 Tipo 2, ISO 27001:2022, RGPD, CCPA e HIPAA.

Los equipos usan Magic con Webflow cuando necesitan añadir el inicio de sesión de usuarios a un sitio sin gestionar contraseñas ni crear una infraestructura de autenticación desde cero. Los escenarios comunes incluyen sitios de membresía de contenido, comunidades con acceso restringido por tokens y flujos de registro en SaaS donde es importante reducir los pasos de registro.

Puedes integrar Magic con Webflow de 2 maneras:

  • La integración con código personalizado gestiona la configuración de autenticación del lado del cliente, incluyendo el formulario de inicio de sesión, las comprobaciones de sesión y el cambio de interfaz, sin necesidad de un backend.
  • Las API de Webflow y Magic te dan control total sobre la validación de tokens en el servidor, la sincronización de usuarios en el CMS y los flujos de trabajo basados en webhooks, pero requieren una capa de middleware.

La mayoría de las implementaciones combinan ambos métodos. El código del lado del cliente gestiona la experiencia de inicio de sesión, mientras que una función serverless se encarga de la validación de tokens y las escrituras en el CMS.

Añade la autenticación de Magic con código personalizado

Magic no dispone de una app en el Marketplace de Webflow. Toda la integración se realiza mediante el código personalizado de Webflow: código en las etiquetas head y body para scripts globales, código a nivel de página para proteger rutas y elementos Code Embed para los formularios de acceso. Con esto resuelves el inicio de sesión básico sin contraseña, la persistencia de sesiones y la restricción de contenido en el cliente sin tocar un backend. Eso sí, necesitarás un plan de pago de Webflow, ya que el plan gratuito Starter no permite añadir código personalizado.

Configura tu cuenta de Magic y los dominios de tu sitio de Webflow antes de escribir código:

  1. Crea una cuenta de Magic en dashboard.magic.link/signup y pon en marcha una nueva app.
  2. Copia la clave API publicable (pk_live_...) desde el panel de control de Magic.
  3. Añade el dominio publicado de tu sitio de Webflow (y el de pruebas, si lo usas) a la Domain Allowlist en Settings > Allowed Origins & Redirects dentro del panel de Magic.

La integración cubre entonces tres partes: cargar el SDK, crear el formulario de inicio de sesión y añadir comprobaciones de sesión.

Cargar el SDK de Magic

El SDK de JavaScript de Magic debe cargarse en todas las páginas donde la autenticación sea relevante. Añádelo como un script en todo el sitio para que esté disponible en tu proyecto de Webflow.

La documentación oficial del SDK de JavaScript de Magic describe la instalación mediante npm en lugar de una configuración de carga en navegador específica para Webflow. En proyectos de Webflow sin un paso de compilación, los equipos pueden usar una etiqueta de script en el código personalizado, pero ese enfoque de carga y la URL de entrega exacta deben verificarse con la documentación actual de Magic antes de la implementación.

El patrón de inicialización documentado de Magic es:

import { Magic } from 'magic-sdk';
const magic = new Magic('YOUR_PUBLISHABLE_KEY');

En Webflow, coloca la carga del SDK en la configuración del sitio (Site settings > Custom Code) para que esté disponible en todo el sitio, y luego inicializa Magic en el código del pie de página con tu clave API publicable una vez que el SDK esté disponible.

Solo la clave API publicable (pk_live_...) debe aparecer en el código personalizado de Webflow. La clave secreta nunca debe colocarse en ningún código del lado del cliente, ya que es visible en las herramientas de desarrollo del navegador. Una vez que el SDK se carga en todo el sitio, puedes usar la misma magic instancia en tus páginas de inicio de sesión y protegidas.

Crea el formulario de inicio de sesión

El formulario de inicio de sesión recopila el correo electrónico del usuario y activa la autenticación OTP de Magic. Puedes crearlo con un elemento de formulario nativo de Webflow o con un elemento de inserción de código (Code Embed) en tu página de inicio de sesión.

Para configurar el formulario de inicio de sesión:

  1. Añade un elemento de inserción de código (Code Embed) a tu página de inicio de sesión con el siguiente HTML:
<div id="magic-login">
  <input type="email" id="email-input" placeholder="Enter your email" />
  <button id="login-btn">Log in</button>
</div>
  1. Añade el controlador de autenticación en el campo de configuración de la página (Page Settings > Before </body> tag):
<script>
  document.getElementById('login-btn').addEventListener('click', async () => {
    const email = document.getElementById('email-input').value;
    try {
      await magic.auth.loginWithEmailOTP({ email });
      window.location.href = '/dashboard';
    } catch (err) {
      console.error('Login failed:', err);
    }
  });
</script>
  1. Publica el sitio y prueba el flujo con test+success@magic.link (un correo electrónico de prueba de Magic que simula una autenticación exitosa sin enviar un correo real).

loginWithEmailOTP()es el enfoque recomendado. Un método anterior llamado loginWithMagicLink() quedó obsoleto en el SDK v17.1.4 (mayo de 2023). Los tutoriales publicados antes de mediados de 2023, incluido el propio tutorial de Webflow de Magic, hacen referencia al método obsoleto. Usa loginWithEmailOTP() para todas las implementaciones nuevas.

Añade comprobaciones de sesión a las páginas protegidas

Webflow no aplica autenticación en ninguna página. El JavaScript del lado del cliente debe verificar la sesión del usuario en cada página que deba estar restringida y redirigir a los visitantes no autenticados.

Para proteger una página:

  1. Abre la configuración de la página en Webflow (panel Pages > icono de engranaje > Page Settings).
  2. Añade el siguiente script en el campo Before </body> tag:
<script>
  (async function() {
    const loggedIn = await magic.user.isLoggedIn();
    if (!loggedIn) {
      window.location.href = '/login';
    }
  })();
</script>
  1. Para el contenido que deseas ocultar hasta que se confirme la autenticación, asigna una clase CSS con display: none a esas secciones. Luego, actualiza el script para mostrarlas cuando la sesión sea válida:
<script>
  (async function() {
    const loggedIn = await magic.user.isLoggedIn();
    if (!loggedIn) {
      window.location.href = '/login';
    } else {
      document.querySelectorAll('.gated-content').forEach(el => {
        el.style.display = 'block';
      });
    }
  })();
</script>
  1. Para añadir un botón de cierre de sesión, llama a magic.user.logout() y borra cualquier dato de sesión almacenado:
document.getElementById('logout-btn').addEventListener('click', async () => {
  await magic.user.logout();
  localStorage.removeItem('magicSession');
  window.location.href = '/login';
});

El control de acceso al contenido del lado del cliente tiene una limitación de seguridad: el contenido oculto sigue existiendo en el DOM de la página y puede ser inspeccionado por usuarios técnicamente avanzados. Para el contenido que debe estar realmente protegido (respuestas de API, archivos descargables, datos exclusivos para suscriptores), es necesaria la validación de tokens del lado del servidor a través de la ruta de integración de la API.

Una nota sobre la configuración: si la opción de carga asíncrona de JavaScript está activada en la configuración avanzada de publicación de Webflow, es posible que el SDK de Magic no se inicialice a tiempo. Envuelve la inicialización en un DOMContentLoaded listener o desactiva la opción asíncrona para evitar condiciones de carrera.

Crea con las API de Webflow y Magic

Para proyectos en producción que requieran validar tokens en el servidor, guardar datos de usuarios en Webflow CMS o ejecutar flujos con webhooks, ambas API se comunican a través de un middleware. Webflow es un hosting estático para frontend, así que no puede ejecutar código de backend (Node.js, Python). Una función serverless en Cloudflare Workers, Vercel o AWS Lambda se encarga de toda esa lógica interna.

Esta ruta utiliza estas API y SDK:

El token DID devuelto por el SDK de Magic tiene una vida útil predeterminada de 15 minutos. Tu middleware valida ese token utilizando el método magic.token.validate() del SDK de administración y, a continuación, emite su propio token de sesión (JWT o cookie) al navegador. Esa comprobación en el servidor diferencia este enfoque de una integración exclusiva del lado del cliente.

Valida tokens DID con middleware

Después de que un usuario se autentica en el frontend de Webflow, el navegador envía el token DID a tu middleware para su validación. El middleware devuelve entonces un token de sesión que el navegador almacena para las solicitudes posteriores.

Para implementar la validación de tokens:

  1. Instala el SDK de administración del lado del servidor de Magic en tu proyecto de middleware:
npm install @magic-sdk/admin
  1. Crea un /api/login endpoint que valide el token DID y recupere los metadatos del usuario:
const { Magic } = require('@magic-sdk/admin');
const magic = new Magic(process.env.MAGIC_SECRET_KEY);

async function handleLogin(req, res) {
  const didToken = req.headers.authorization.replace('Bearer ', '');
  magic.token.validate(didToken);
  const metadata = await magic.users.getMetadataByToken(didToken);
  // metadata contains: issuer, email, publicAddress
  // Issue your own session token here
  res.json({ user: metadata });
}
  1. En el frontend de Webflow, actualiza tu gestor de inicio de sesión para enviar el token DID al middleware:
const didToken = await magic.auth.loginWithEmailOTP({ email });
const response = await fetch('https://your-middleware.com/api/login', {
  method: 'POST',
  headers: { Authorization: `Bearer ${didToken}` }
});

Utiliza el campo issuer de la respuesta de metadatos como tu identificador único de usuario. El issuer es un ID persistente con el formato did:ethr:0x... que permanece constante entre sesiones. No utilices el token DID como clave de base de datos porque caduca a los 15 minutos. Esa distinción hace que la capa de middleware sea fiable para inicios de sesión repetidos y sincronizaciones posteriores.

Sincroniza usuarios autenticados con el CMS de Webflow

Una vez confirmada la identidad del usuario, tu middleware puede crear o actualizar su registro en una colección del CMS de Webflow. Así, los elementos de Collection List podrán mostrar datos específicos de cada miembro, insignias de nivel de acceso o historiales de actividad.

Para sincronizar usuarios con el CMS:

  1. Crea una colección CMS "Members" en Webflow con campos para email (texto plano), magic-issuer (texto plano), wallet-address (texto plano), membership-tier (opción), last-login (fecha) y access-granted (interruptor).
  2. En tu middleware, comprueba si el usuario ya existe y crea o actualiza según corresponda:
// Look up existing member by email
const existing = await fetch(
  `https://api.webflow.com/v2/collections/${COLLECTION_ID}/items/live`,
  { headers: { Authorization: `Bearer ${WEBFLOW_TOKEN}` } }
);

// If not found, create a new member record
await fetch(
  `https://api.webflow.com/v2/collections/${COLLECTION_ID}/items/live`,
  {
    method: 'POST',
    headers: {
      Authorization: `Bearer ${WEBFLOW_TOKEN}`,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      fieldData: {
        name: metadata.email,
        email: metadata.email,
        'magic-issuer': metadata.issuer,
        'wallet-address': metadata.publicAddress,
        'last-login': new Date().toISOString(),
        'access-granted': true
      }
    })
  }
);
  1. Registra un webhook de Webflow para activar acciones posteriores (correo de bienvenida, notificación en Slack) cuando se cree un nuevo registro de miembro:
await fetch(
  `https://api.webflow.com/v2/sites/${SITE_ID}/webhooks`,
  {
    method: 'POST',
    headers: {
      Authorization: `Bearer ${WEBFLOW_TOKEN}`,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      triggerType: 'collection_item_created',
      url: 'https://your-middleware.com/webhooks/new-member'
    })
  }
);

No es posible escribir en la API del CMS de Webflow directamente desde el navegador: las restricciones de CORS bloquean estas llamadas en producción. Todas las escrituras en el CMS deben pasar por tu middleware. Además, calcula bien el tamaño de tu colección de miembros según los límites de items CMS de tu plan de Webflow (consulta webflow.com/pricing para ver las cuotas actuales). En la práctica, el middleware es el responsable tanto de la seguridad como de la sincronización de datos.

Magic no publica webhooks de salida. El modelo de integración se basa en la extracción: tu middleware recupera los datos del usuario de Magic al momento de la autenticación y los envía al CMS de Webflow. Los webhooks de Webflow (, , ) activan entonces cualquier flujo de trabajo posterior cuando los registros del CMS cambian.collection_item_createdcollection_item_changedform_submission

Lo que puedes construir con la integración de Magic y Webflow

Integrar Magic con Webflow te permite añadir autenticación de usuario sin contraseña y experiencias restringidas a cualquier sitio de Webflow sin gestionar contraseñas ni crear una infraestructura de inicio de sesión desde cero.

  • Sitio de membresía con contenido exclusivo: diseña una plataforma de cursos o publicaciones donde los lectores inicien sesión con un código por correo para disfrutar de artículos premium guardados en el CMS de Webflow. Magic se encarga del acceso, tu middleware comprueba el nivel de suscripción y los elementos Collection List muestran el contenido exclusivo según los permisos del CMS.
  • Página de bienvenida para dApps Web3: aprovecha un sitio de marketing en Webflow como puerta de entrada a tu aplicación Web3. Los usuarios inician sesión con su correo o redes sociales, Magic les genera al instante un monedero sin custodia compatible con más de 30 blockchains, y los recién llegados se olvidan de ventanas emergentes de MetaMask o frases semilla.
  • Portal comunitario con acceso por tokens: restringe secciones enteras de tu sitio de Webflow verificando la posesión de NFTs. Tras autenticarse con Magic, tu middleware lee la dirección del monedero del usuario, consulta el saldo de tokens en la blockchain y actualiza el campo de acceso en el CMS para mostrar u ocultar el contenido de la comunidad.
  • Panel de clientes sin contraseñas de por medio: crea un portal para clientes o socios comerciales donde accedan con un código al correo, sin tener que restablecer contraseñas olvidadas. Las sesiones de Magic duran hasta 7 días (configurables hasta 90), ahorrando la molestia de iniciar sesión una y otra vez a quienes entran de forma ocasional.

Si necesitas más control sobre la gestión del ciclo de vida de los miembros, niveles de acceso basados en el CMS o respuestas de webhook en tiempo real a eventos de autenticación, la ruta de integración mediante API cubre esos casos con control total sobre dichos flujos de trabajo.

Preguntas frecuentes

  • No. Magic se integra con Webflow exclusivamente a través de código personalizado y conexiones API.

  • Para flujos de acceso básicos (código OTP al correo, inicio con redes sociales, comprobación de sesión y alternancia de contenido en el cliente), no te hace falta ningún backend: el SDK de JavaScript de Magic se ejecuta enteramente en el navegador. En cambio, para validar tokens DID, registrar usuarios en el CMS de Webflow o emitir cookies de sesión seguras, sí lo necesitarás. Como Webflow solo aloja frontend estático y no ejecuta código de servidor, una función serverless en Vercel, Cloudflare Workers o AWS Lambda resuelve el middleware de forma perfecta.

  • La restricción en el lado del cliente (ocultar contenido con CSS y revelarlo después de que devuelva verdadero) no es segura frente a usuarios que inspeccionan el DOM de la página. El contenido oculto se carga en el navegador y puede verse a través de las herramientas de desarrollo. Para contenido realmente protegido, valida el token DID en el lado del servidor usando el Admin SDK de Magic y solo devuelve datos sensibles desde tu middleware una vez que la validación sea exitosa.magic.user.isLoggedIn()

  • Usa para todas las implementaciones nuevas. El método anterior fue declarado obsoleto en el SDK v17.1.4 (mayo de 2023). La OTP por correo electrónico también evita un problema entre navegadores donde las aplicaciones de correo móvil abren enlaces mágicos en un navegador integrado, rompiendo el estado de la sesión. Con OTP, los usuarios ingresan el código en la misma sesión de navegador donde iniciaron el proceso. Magic también admite inicio de sesión social/OAuth (Google, Apple, Discord, GitHub y otros 9 proveedores) y autenticación por SMS para opciones adicionales. Para nuevas implementaciones en Webflow, la OTP por correo es la opción predeterminada recomendada.magic.auth.loginWithEmailOTP()magic.auth.loginWithMagicLink()

Magic
Magic
Joined in

Descripción

Añade autenticación sin contraseñas y funciones de monedero Web3 a tus sitios de membresía en Webflow usando el SDK de JavaScript de Magic mediante la inserción de código personalizado y la gestión de usuarios basada en API.

→
↗
►
↓
←
↑
Instalar aplicación

Esta página de integración se ofrece únicamente con fines informativos y de conveniencia.


Other Herramientas de autenticación integrations

Other Herramientas de autenticación integrations

MetaMask

MetaMask

Añade la conexión de billetera MetaMask a las páginas de Webflow con código personalizado y, a continuación, verifica las firmas en tu propio servidor antes de restringir el acceso a contenido o escribir en el CMS.

Herramientas de autenticación
Más información
Salesforce Authenticator

Salesforce Authenticator

Utiliza Salesforce Authenticator como la aplicación de doble factor en tu cuenta de Webflow y como el aviso de MFA en los inicios de sesión de Salesforce que operan detrás de tus formularios de Webflow.

Herramientas de autenticación
Más información
Microsoft Authenticator

Microsoft Authenticator

Utiliza Microsoft Authenticator como segundo factor en tu cuenta de Webflow y añade MFA de Authenticator a los inicios de sesión de los visitantes del sitio a través de un proveedor de identidad.

Herramientas de autenticación
Más información
LastPass Authenticator

LastPass Authenticator

LastPass Authenticator te ofrece una experiencia única de verificación de contraseñas con un solo toque.

Herramientas de autenticación
Más información
Google Authenticator

Google Authenticator

Google Authenticator genera códigos de verificación en dos pasos de un solo uso en dispositivos móviles Android o Apple

Herramientas de autenticación
Más información
Firebase Authentication

Firebase Authentication

Conecta Firebase Authentication, un servicio de identidad respaldado por Google, con Webflow para añadir funciones de registro, inicio de sesión y gestión de sesiones de usuario mediante correo electrónico, teléfono o proveedores de inicio de sesión social.

Herramientas de autenticación
Más información
Authy

Authy

Utiliza la aplicación Authy para la autenticación en dos pasos (2FA) de tu cuenta de Webflow y añade códigos de Twilio Verify a tus formularios e inicios de sesión, ya que la API de Authy ya no acepta nuevos clientes.

Herramientas de autenticación
Más información

Integraciones relacionadas

No se encontraron elementos.

Empieza gratis

Prueba Webflow todo el tiempo que quieras con nuestro plan Starter gratuito. Compra un plan de sitio de pago para publicar, alojar y desbloquear funciones adicionales.

Empieza, es gratis