Protected App — Integración de autenticación sin SDK

La Protected App está diseñada para eliminar la complejidad de las integraciones de SDK separando la capa de autenticación (Authentication) de tu aplicación. Nosotros gestionamos la autenticación, permitiéndote centrarte en tu funcionalidad principal. Una vez que un usuario está autenticado, la Protected App sirve el contenido desde tu servidor.

Cómo funciona Protected App

La Protected App, impulsada por Cloudflare, opera globalmente en redes edge, asegurando baja latencia y alta disponibilidad para tu aplicación.

La Protected App mantiene el estado de la sesión y la información del usuario. Si un usuario no está autenticado, la Protected App lo redirige a la página de inicio de sesión. Una vez autenticado, la Protected App envuelve la solicitud del usuario con la autenticación e información del usuario, y luego la reenvía al servidor de origen.

Este proceso se visualiza en el siguiente diagrama de flujo:

Protege tu servidor de origen

El servidor de origen, que puede ser un dispositivo físico o virtual que no pertenece a la Protected App de Logto, es donde reside el contenido de tu aplicación. Similar a un servidor de Content Delivery Network (CDN), la Protected App gestiona los procesos de autenticación y recupera el contenido de tu servidor de origen. Por lo tanto, si los usuarios obtienen acceso directo a tu servidor de origen, pueden eludir la autenticación y tu aplicación deja de estar protegida.

Por eso es importante asegurar las conexiones de origen, ya que previene que los atacantes descubran y accedan a tu servidor de origen sin autenticación. Hay varias formas de hacerlo:

1. Validación de cabecera HTTP
2. Validación de JSON Web Tokens (JWT)

Validación de cabecera HTTP

Proteger tu servidor de origen se puede lograr usando HTTP Basic Authentication para asegurar tu servidor de origen.

Cada solicitud desde la Protected App incluye la siguiente cabecera:

Authorization: Basic base64(appId:appSecret)

Al validar esta cabecera, puedes confirmar que la solicitud proviene de la Protected App y denegar cualquier solicitud que no incluya esta cabecera.

Si usas Nginx o Apache, puedes consultar las siguientes guías para implementar HTTP Basic Authentication en tu servidor de origen:

1. Nginx: Configuring HTTP Basic Authentication
2. Apache: Authentication and Authorization

Para comprobar las cabeceras dentro de tu aplicación, consulta el ejemplo de HTTP Basic Authentication proporcionado por Cloudflare para aprender cómo restringir el acceso usando el esquema HTTP Basic.

Validación de JSON Web Tokens (JWT)

Otra forma de proteger tu servidor de origen es usando JSON Web Tokens (JWT).

Cada solicitud autenticada desde la Protected App incluye la siguiente cabecera:

Logto-ID-Token: <JWT>

El JWT se llama Token de ID (ID Token), el cual está firmado por Logto y contiene información del usuario. Al validar este JWT, puedes confirmar que la solicitud proviene de la Protected App y denegar cualquier solicitud que no incluya esta cabecera.

El token está cifrado y firmado como un token JWS.

Los pasos de validación:

1. Validar un JWT
2. Validar la firma JWS
3. El emisor del token es https://<your-logto-domain>/oidc (emitido por tu servidor de autenticación Logto)

const express = require('express');
const jwksClient = require('jwks-rsa');
const jwt = require('jsonwebtoken');

const ISSUER = 'https://<your-logto-domain>/oidc';
const CERTS_URL = 'https://<your-logto-domain>/oidc/jwks';

const client = jwksClient({
  jwksUri: CERTS_URL,
});

const getKey = (header, callback) => {
  client.getSigningKey(header.kid, function (err, key) {
    callback(err, key?.getPublicKey());
  });
};

const verifyToken = (req, res, next) => {
  const token = req.headers['Logto-ID-Token'];

  // Asegúrate de que la solicitud entrante tenga nuestra cabecera de token
  if (!token) {
    return res
      .status(403)
      .send({ status: false, message: 'falta la cabecera requerida Logto-ID-Token' });
  }

  jwt.verify(token, getKey, { issuer: ISSUER }, (err, decoded) => {
    if (err) {
      return res.status(403).send({ status: false, message: 'token de ID inválido' });
    }

    req.user = decoded;
    next();
  });
};

const app = express();

app.use(verifyToken);

app.get('/', (req, res) => {
  res.send('¡Hola Mundo!');
});

app.listen(3000);

Obtener el estado de autenticación e información del usuario

Si necesitas obtener la autenticación y la información del usuario para tu aplicación, también puedes usar la cabecera Logto-ID-Token.

Si solo quieres decodificar el token, puedes usar el siguiente código:

const express = require('express');

const decodeIdToken = (req, res, next) => {
  const token = req.headers['Logto-ID-Token'];

  if (!token) {
    return res.status(403).send({
      status: false,
      message: 'falta la cabecera requerida Logto-ID-Token',
    });
  }

  const parts = token.split('.');
  if (parts.length !== 3) {
    throw new Error('Token de ID inválido');
  }

  const payload = parts[1];
  const decodedPayload = atob(payload.replace(/-/g, '+').replace(/_/g, '/'));
  const claims = JSON.parse(decodedPayload);

  req.user = claims;
  next();
};

const app = express();

app.use(decodeIdToken);

app.get('/', (req, res) => {
  res.json(req.user);
});

app.listen(3000);

Personalizar los reclamos del token de ID

Por defecto, la cabecera Logto-ID-Token incluye reclamos estándar de OIDC (por ejemplo, sub, name y email). Para incluir reclamos extendidos como roles o datos de organización, ambos de los siguientes deben estar configurados:

1. Conmutador del tenant: Habilita el reclamo en Consola > Custom JWT > Token de ID.
2. Alcances de Protected App: En la configuración de tu Protected App, selecciona el alcance correspondiente en Reclamos del token de ID > Alcances adicionales.

Los reclamos extendidos se incluyen en el token de ID reenviado solo cuando el reclamo está habilitado en Custom JWT y el alcance correspondiente está seleccionado para la Protected App. Consulta Token de ID personalizado para la lista completa de alcances y reclamos extendidos.

Alcance	Reclamos
custom_data	custom_data
identities	identities, sso_identities
roles	roles
urn:logto:scope:organizations	organizations, organization_data
urn:logto:scope:organization_roles	organization_roles

Obtener el host original

Si necesitas obtener el host original solicitado por el cliente, puedes usar la cabecera Logto-Host o x-forwarded-host.

Personalizar las reglas de autenticación

Por defecto, la Protected App protegerá todas las rutas. Si necesitas personalizar las reglas de autenticación, puedes establecer el campo "Reglas de autenticación personalizadas" en la Consola.

Soporta expresiones regulares, aquí tienes dos escenarios de ejemplo:

1. Para proteger solo las rutas /admin y /privacy con autenticación: ^/(admin|privacy)/.*
2. Para excluir imágenes JPG de la autenticación: ^(?!.*\.jpg$).*$

Desarrollo local

La Protected App está diseñada para funcionar con tu servidor de origen. Sin embargo, si tu servidor de origen no es accesible públicamente, puedes usar una herramienta como ngrok o Cloudflare Tunnels para exponer tu servidor local a internet.

Transición a integración con SDK

La Protected App está diseñada para simplificar el proceso de autenticación. Sin embargo, si decides pasar a la integración con SDK para un mayor control y personalización, puedes crear una nueva aplicación en Logto y configurar la integración con SDK. Y para una transición fluida, puedes reutilizar la configuración de la aplicación de la Protected App. La Protected App es en realidad una "Traditional Web App" en Logto, puedes encontrar el "AppId" y el "AppSecret" en la configuración de la aplicación. Una vez completada la transición, puedes eliminar la Protected App de tu aplicación.

Recursos relacionados

Protected App: Construye la autenticación de tu app en pocos clics. Sin código.

La motivación detrás de Protected App

La forma más rápida de construir un sistema de autenticación