SSO con JWT

Si tu aplicacion ya sabe quien es el usuario, no deberias obligarlo a iniciar sesion de nuevo para dejar feedback. Con SSO por JWT tu backend firma un token de corta duracion que identifica al usuario; Feedjolt lo verifica en el servidor y lo inicia de forma transparente en el portal y en el widget integrado. El SSO por JWT esta disponible en todos los planes.

Como funciona

1. Configuras un secreto de firma y un algoritmo en Panel -> Desarrolladores -> SSO con JWT.
2. Cuando un usuario autenticado abre el feedback, tu backend genera un JWT con sus datos, firmado con ese secreto.
3. Le pasas el token a Feedjolt: en el widget mediante data-sso-token, o enviandolo por POST al endpoint de identificacion.
4. Feedjolt verifica la firma, crea o actualiza al usuario final correspondiente y establece una cookie de sesion en el servidor. Sin enlace magico, sin inicio de sesion adicional.

El secreto vive unicamente en tu servidor y en el de Feedjolt. El navegador solo ve el token resultante, nunca el secreto.

Aplicalo con un agente de codigo

1. Configura la clave, el algoritmo, el emisor y la audiencia en Panel -> Desarrolladores -> SSO con JWT. Usa el dado para generar una clave hexadecimal de 64 caracteres.
2. Guarda.
3. Copia el prompt de la columna derecha.
4. Pegalo en tu agente de codigo para que anada el codigo de firma y redireccion a tu app.

El prompt incluye tu clave. Pegalo solo en una herramienta de confianza. Los snippets manuales quedan plegados en Hazlo tu.

Configuracion

El SSO por JWT se configura por espacio de trabajo (solo el propietario) en Panel -> Desarrolladores -> SSO con JWT:

Solo se admiten algoritmos HMAC: no hay modo de clave publica (asimetrico). Ambas partes comparten el mismo secreto.

Claims del token

Genera un JWT estandar firmado con tu secreto. Estos claims son obligatorios: un token al que le falte cualquiera de ellos se rechaza.

Los claims opcionales enriquecen el perfil sincronizado:

Si configuraste un issuer o un audience, incluye tambien los claims iss / aud correspondientes; solo se verifican cuando estan configurados.

Claim de empresa

Pasa company como objeto para asociar al usuario a un registro de empresa (creado o actualizado al vuelo). Tambien se acepta companies (un array): se usa la primera entrada.

{
  "company": {
    "id": "org_123",
    "name": "Acme Inc",
    "plan": "enterprise",
    "mrr": 2400,
    "industry": "fintech",
    "employee_count": 120
  }
}

Para una empresa solo id y name son obligatorios; el resto es opcional.

Generar el token

Genera el JWT en tu backend, donde el secreto esta protegido. Manten exp corto. El token sigue siendo valido hasta exp: Feedjolt no lo trata como de un solo uso, asi que un token filtrado se puede reutilizar hasta que caduque.

// Node.js - npm i jsonwebtoken
import jwt from "jsonwebtoken";

const token = jwt.sign(
  {
    sub: user.id,
    email: user.email,
    name: user.fullName,
    avatar_url: user.avatarUrl,
    company: { id: user.orgId, name: user.orgName },
  },
  process.env.FEEDJOLT_JWT_SECRET,
  { algorithm: "HS256", expiresIn: "5m" },
);

# Python - pip install pyjwt
import datetime, jwt

now = datetime.datetime.now(datetime.timezone.utc)
token = jwt.encode(
    {
        "sub": user.id,
        "email": user.email,
        "name": user.full_name,
        "avatar_url": user.avatar_url,
        "company": {"id": user.org_id, "name": user.org_name},
        "iat": now,
        "exp": now + datetime.timedelta(minutes=5),
    },
    FEEDJOLT_JWT_SECRET,
    algorithm="HS256",
)

Entregar el token a Feedjolt

Widget: pasa el token en el atributo data-sso-token del loader (consulta Configuracion del widget). El widget lo reenvia como parametro ssoToken del iframe y el usuario queda autenticado dentro del panel.

Portal (redireccion): envia al usuario a tu portal con ?ssoToken= en la query:

https://www.feedjolt.com/{locale}/portal/{slug}?ssoToken={jwt}

El portal lee ssoToken, lo envia por POST al endpoint de identificacion y luego quita el parametro de la URL. El token en si sigue siendo valido hasta exp.

Portal / directo: envia el token por POST al endpoint de identificacion de tu espacio de trabajo:

curl -X POST https://api.feedjolt.com/api/workspaces/{workspace}/identify \
  -H "Content-Type: application/json" \
  -d '{"token": "TU_JWT_AQUI"}'

Si todo va bien, Feedjolt devuelve el usuario final sincronizado y establece una cookie de sesion en el servidor (httpOnly, secure, SameSite=Lax). Esa cookie, y no tu JWT, es la que mantiene la sesion despues, asi que solo generas un JWT nuevo de corta duracion al iniciar sesion.

Rotacion de claves

Rotar el secreto de firma no genera tiempo de inactividad. Cuando guardas un secreto nuevo, Feedjolt mantiene valido el anterior para que los tokens ya en circulacion sigan verificandose. Durante la transicion se aceptan hasta los ultimos 5 secretos; los mas antiguos se descartan automaticamente.

Para rotar: define el nuevo secreto en el panel, despliegalo en tu backend y deja que se agoten los tokens en circulacion. No hace falta un cambio coordinado.

Notas de seguridad

• La verificacion es del lado del servidor. Feedjolt valida la firma, la caducidad y (si estan definidos) el issuer/audience en sus propios servidores. Nunca confies en una identidad declarada por el navegador.
• El secreto nunca llega al navegador. Genera los tokens solo en tu backend. Trata el secreto como una contrasena.
• Manten exp corto. El JWT solo necesita durar lo justo para arrancar la cookie de sesion: con minutos basta.
• UPDATE_ONLY para sistemas cerrados. Si aprovisionas usuarios por otro medio y no quieres que el SSO cree nuevos, define sync_mode como UPDATE_ONLY.