Saltar al contenido
Índice de Kit UI
Kit UI Componentes

Retorno OIDC.

Patrón canónico de retorno oidc para cuenta, admin, usaia, firmas y documentos.

Verlo por niveles

Primero el componente, después la variación de marca y finalmente su uso dentro de una página.

Nivel 1Componente canónico
Completando el acceso

Estamos validando tu inicio de sesión. En unos segundos vuelves al producto.

/auth/callbackVolver al producto
Nivel 2Círculo de Santiago · variación
No pudimos completar el acceso

La solicitud de acceso venció antes de volver. Inicia sesión otra vez.

/auth/callbackReintentar acceso
Nivel 3Dentro de una página
Sitio · sección
Completando el acceso

Estamos validando tu inicio de sesión. En unos segundos vuelves al producto.

/auth/callbackVolver al producto
Ver y copiar el código de este render
HTML del nivel canónico
<section class="ui-sample ui-auth-status ui-auth-status--progress" data-auth-source="cis-auth-authentik" data-auth-callback-status="true" role="status"><span class="ui-auth-status__symbol" aria-hidden="true">↻</span><div><strong>Completando el acceso</strong><p>Estamos validando tu inicio de sesión. En unos segundos vuelves al producto.</p><code>/auth/callback</code><a class="btn btn--quiet" href="#reintentar">Volver al producto</a></div></section>

Variaciones por marca y sitio

Cada cambio visible declara su autoridad; lo que permanece canónico no se vuelve a inventar en el producto.

innovacionsantiago.cl

Compañía de Innovación de Santiago

Autoridad: CONSTITUTION.md + LOGOS-CANONICOS.md
Completando el acceso

Estamos validando tu inicio de sesión. En unos segundos vuelves al producto.

/auth/callbackVolver al producto

Cambia en esta marca

  • Navegación y contenido propios del servicio
  • Acento reservado para acciones y datos

Permanece canónico

  • Mark CIS y namebrand de tres líneas
  • IBM Plex Sans, foco, espaciado y anatomía
circulodesantiago.cl

Círculo de Santiago

Autoridad: core-style/DECISIONES.md M10 y LOGOS-CANONICOS.md
No pudimos completar el acceso

La solicitud de acceso venció antes de volver. Inicia sesión otra vez.

/auth/callbackReintentar acceso

Cambia en esta marca

  • Mark circular y namebrand Círculo de Santiago en caja normal
  • Contenido societario y navegación propia

Permanece canónico

  • Misma estructura, orden de cuenta y footer
  • Tipografía, foco y comportamiento canónicos

Comparación histórica recuperable

Compara la propuesta con cortes reales del repositorio. La ausencia de una muestra se declara y nunca se reconstruye de memoria.

Estado actual
Retorno OIDC no tiene una implementación vigente demostrada; sus ejemplos son material candidato.
Cambio propuesto
Publicar en r19 el contrato de Retorno OIDC para Patrón canónico de retorno oidc para cuenta, admin, usaia, firmas y documentos.
Qué ocurre si respondes No
Retorno OIDC queda fuera de r19 y sus ejemplos siguen sólo como evidencia pendiente de reformulación.

Preparando comparación histórica…

Antes / r19

La comparación convierte una regla abstracta en una diferencia visible y verificable.

r19 · correctoContrato canónico renderizado
Completando el acceso

Estamos validando tu inicio de sesión. En unos segundos vuelves al producto.

/auth/callbackVolver al producto
  • Usa HTML semántico, foco visible y estados explícitos.
  • Conserva contenido útil a 320 px y sin JavaScript.
Antes · problema observadoAnti-ejemplo no interactivo
correo@ejemplo.cl!Algo salió mal
  • No agregues sombras, radios ni franjas laterales decorativas.
  • No uses color, placeholder o icono como única explicación.

Responsive

La misma anatomía debe conservar lectura, foco y acciones sin cortar contenido ni crear scroll horizontal en la página.

320 pxMóvil y zoom
Completando el acceso

Estamos validando tu inicio de sesión. En unos segundos vuelves al producto.

/auth/callbackVolver al producto
1280 pxEscritorio
No pudimos completar el acceso

La solicitud de acceso venció antes de volver. Inicia sesión otra vez.

/auth/callbackReintentar acceso

Cobertura

DimensiónContrato
Propietario canónicoSistema de diseño CIS y cis-auth · core/core-style
ConsumidoresCuenta, Admin, usaia, Firmas y Documentos
DependenciasHTML nativo, validación de servidor
Estadocandidato

Evidencia de adopción

Patrón propuesto. 0 implementaciones observadas en 0 repositorios.

La observación demuestra uso existente; la aceptación canónica sigue dependiendo de esta ficha y de su propietario.

DatoResultado
ClasificaciónPatrón propuesto
Implementaciones0 implementaciones observadas
RepositoriosNingún repositorio observado
Snapshotkit/componentes/componentes-observados.json

Consumidores observados

El inventario conserva repositorio, archivo fuente y criterio de asociación. Observar una implementación no la convierte automáticamente en canónica.

Estados

Estado requerido
vacío
completo
inválido
disabled

Accesibilidad

  • Conserva nombre accesible, orden de lectura y foco visible.
  • Funciona a 320 px, con zoom de 200% y texto largo.
  • El color nunca es la única señal de estado o acción.
  • El contenido esencial permanece disponible sin JavaScript.

Código HTML

Copia el bloque completo; después cambia contenido y destinos, no su anatomía.

Código de referencia
<section class="ui-sample ui-auth-status ui-auth-status--progress" data-auth-source="cis-auth-authentik" data-auth-callback-status="true" role="status"><span class="ui-auth-status__symbol" aria-hidden="true">↻</span><div><strong>Completando el acceso</strong><p>Estamos validando tu inicio de sesión. En unos segundos vuelves al producto.</p><code>/auth/callback</code><a class="btn btn--quiet" href="#reintentar">Volver al producto</a></div></section>

Código TAILWIND

Copia el bloque completo; después cambia contenido y destinos, no su anatomía.

Código de referencia
<section class="ui-sample ui-auth-status ui-auth-status--progress border border-slate-300 bg-white p-4 text-slate-950 grid gap-3" data-auth-source="cis-auth-authentik" data-auth-callback-status="true" role="status"><span class="ui-auth-status__symbol" aria-hidden="true">↻</span><div><strong>Completando el acceso</strong><p>Estamos validando tu inicio de sesión. En unos segundos vuelves al producto.</p><code>/auth/callback</code><a class="btn btn--quiet underline underline-offset-4" href="#reintentar">Volver al producto</a></div></section>

Código REACT

Copia el bloque completo; después cambia contenido y destinos, no su anatomía.

Código de referencia
export type AuthCallbackStatusTone = "progress" | "success" | "warning" | "error";

/** Variante de botón del kit para el enlace. */
export type AuthCallbackStatusLinkVariant = "primary" | "secondary" | "quiet";

export interface AuthCallbackStatusProps {
  /** Tono del aviso: `progress` mientras se valida la respuesta, `error` si falló. Define el símbolo. */
  tone?: AuthCallbackStatusTone;
  title?: string;
  /** Qué se está haciendo o por qué falló. */
  description?: string;
  /** Dato técnico en monoespaciado; por defecto, la ruta de retorno de OIDC. */
  detail?: string;
  /** Texto del enlace: volver al producto o reintentar el acceso. */
  linkLabel?: string;
  /** Destino del enlace. */
  href?: string;
  /** Aspecto del enlace: por defecto `quiet` mientras se valida y `primary` en los demás tonos, donde es la acción que sigue. */
  linkVariant?: AuthCallbackStatusLinkVariant;
  className?: string;
}

const AUTH_CALLBACK_STATUS_SYMBOLS: Record<AuthCallbackStatusTone, string> = {
  progress: "↻",
  success: "✓",
  warning: "i",
  error: "!",
};

/**
 * Estado del retorno de OIDC desde cis-auth, para la página de callback mientras se valida el acceso o cuando falla.
 *
 * Usa `role="status"`. El símbolo sigue al tono; el título dice el estado en texto. El enlace es un botón del kit:
 * discreto mientras se valida y principal cuando hay que reintentar o continuar.
 *
 * @example <AuthCallbackStatus />
 * @example <AuthCallbackStatus tone="error" title="No pudimos completar el acceso" description="La solicitud de acceso venció antes de volver. Inicia sesión otra vez." linkLabel="Reintentar acceso" href="/auth/login" />
 */
export function AuthCallbackStatus({
  tone = "progress",
  title = "Completando el acceso",
  description = "Estamos validando tu inicio de sesión. En unos segundos vuelves al producto.",
  detail = "/auth/callback",
  linkLabel = "Volver al producto",
  href = "#reintentar",
  linkVariant,
  className,
}: AuthCallbackStatusProps) {
  const variante = linkVariant ?? (tone === "progress" ? "quiet" : "primary");
  return (
    <section
      className={["ui-auth-status", `ui-auth-status--${tone}`, className].filter(Boolean).join(" ")}
      data-auth-source="cis-auth-authentik"
      data-auth-callback-status
      role="status"
    >
      <span className="ui-auth-status__symbol" aria-hidden="true">{AUTH_CALLBACK_STATUS_SYMBOLS[tone]}</span>
      <div>
        <strong>{title}</strong>
        {description ? <p>{description}</p> : null}
        {detail ? <code>{detail}</code> : null}
        {linkLabel ? <a className={`btn btn--${variante}`} href={href}>{linkLabel}</a> : null}
      </div>
    </section>
  );
}