Configuración de autenticación

​

Requisitos previos

• Todas las personas que necesiten acceder a tu documentación deben ser miembros de tu organización de Mintlify.

​

Configuración

​

Ejemplo

​

Requisitos previos

• Un servidor OAuth u OIDC que admita el flujo de código de autorización (Authorization Code Flow).
• Capacidad para crear un endpoint de API accesible mediante tokens de acceso OAuth (opcional, para habilitar el control de acceso basado en grupos).

​

Configuración

​

Ejemplo

• Authorization URL: https://auth.foo.com/authorization
• Client ID: ydybo4SD8PR73vzWWd6S0ObH
• Scopes: ['provider.users.docs']
• Token URL: https://auth.foo.com/exchange
• Info API URL: https://api.foo.com/docs/user-info
• Logout URL: https://auth.foo.com/logout?returnTo=https%3A%2F%2Ffoo.com%2Fdocs

{
  "groups": ["engineering", "admin"],
  "expiresAt": 1735689600
}

​

Requisitos previos

• Un sistema de autenticación que pueda generar y firmar JWT.
• Un servicio de backend que pueda crear URL de redirección.

​

Configuración

​

Ejemplo

• Genera un JWT con los datos del usuario en el formato de Mintlify.
• Firma el JWT y redirige a https://docs.foo.com/login/jwt-callback#{SIGNED_JWT}.

import * as jose from 'jose';
import { Request, Response } from 'express';

const TWO_WEEKS_IN_MS = 1000 * 60 * 60 * 24 * 7 * 2;

const signingKey = await jose.importPKCS8(process.env.MINTLIFY_PRIVATE_KEY, 'EdDSA');

export async function handleRequest(req: Request, res: Response) {
  const user = {
    expiresAt: Math.floor((Date.now() + TWO_WEEKS_IN_MS) / 1000), // vencimiento de la sesión de 2 semanas
    groups: res.locals.user.groups,
  };

  const jwt = await new jose.SignJWT(user)
    .setProtectedHeader({ alg: 'EdDSA' })
    .setExpirationTime('10 s') // vencimiento del JWT de 10 segundos
    .sign(signingKey);

  return res.redirect(`https://docs.foo.com/login/jwt-callback#${jwt}`);
}

​

Redirigir a usuarios no autenticados

1. El usuario intenta visitar una página protegida: https://docs.foo.com/quickstart.
2. Redirige a tu URL de inicio de sesión con un parámetro de consulta llamado redirect: https://foo.com/docs-login?redirect=%2Fquickstart.
3. Después de la autenticación, redirige a https://docs.foo.com/login/jwt-callback?redirect=%2Fquickstart#{SIGNED_JWT}.
4. El usuario llega a su destino original.