Capítulo 2: Glosario

Este capítulo consolida toda la terminología utilizada en el sistema FayID. La primera mitad se hereda del Glosario de requirements.md; la segunda mitad añade términos extendidos introducidos durante la fase de diseño.

Convención: cuando los capítulos posteriores de este blueprint utilicen cualquiera de los términos siguientes, las definiciones de este capítulo son las autoritativas. En caso de ambigüedad, las definiciones de requirements.md tienen precedencia final.


Entidades centrales

TérminoDefinición
Sistema FayIDEl sistema de identidad global definido por esta especificación, que comprende los componentes lógicos Issuer, Resolver, Auth Exchange, GMC Interface, Serializer, Parser, entre otros.
Human IDLa identidad raíz de una persona natural dentro del sistema FayID. Se deriva de un par de claves, va acompañada de un Mnemonic y la posee exclusivamente un único Human Prototype.
Human PrototypeLa persona natural real emparejada uno a uno con un Human ID.
iFay IDLa identidad de una persona digital iFay individual. Debe estar vinculada a exactamente un Human ID, aunque un mismo Human ID puede vincular múltiples iFay IDs.
coFay IDLa identidad de un rol público coFay. Debe ser propiedad de un Human ID o de un Organization ID.
Organization IDLa identidad de una organización dentro del sistema FayID. Se publica en texto plano y no requiere un Dynamic Code derivado.

Credenciales y derivados

TérminoDefinición
MnemonicLa frase mnemónica asociada a un Human ID; un respaldo legible por humanos de la clave privada del Human ID. Se devuelve al titular una sola vez en el momento de su generación y nunca se persiste en texto plano.
Dynamic CodeUna cadena de tiempo limitado derivada de un Human ID que puede transmitirse en texto plano. Se usa para referirse a un Human ID sin exponerlo.
Verification CodeUn código vinculado a un coFay ID, usado para verificar la autenticidad de un titular cuando se utiliza el coFay ID. Puede ser rotado por el propietario.
Authorization GrantUna credencial de autenticación de tiempo limitado emitida a un iFay ID o Human ID tras pasar por el Auth Exchange. Lleva un tiempo de expiración explícito y soporta revocación activa.

Componentes lógicos

TérminoDefinición
IssuerEl componente lógico dentro del sistema FayID responsable de generar, rotar y revocar identificadores y credenciales.
ResolverEl componente lógico que resuelve una credencial en texto plano (Dynamic Code, Verification Code o cadena de ID) hacia la entidad correspondiente.
Auth ExchangeEl componente lógico que intercambia entre FayID y los métodos de autenticación tradicionales (contraseña, certificado, autorización, token de acceso, contrato inteligente).
GMC InterfaceEl componente lógico de frontera a través del cual el sistema FayID interactúa con el Global Merit Chain. Expone únicamente métodos de solo lectura; las escrituras inversas de Human IDs o material de clave privada están prohibidas.
SerializerEl componente que codifica entidades FayID en cadenas transmisibles. Cada entidad lleva un prefijo de tipo reconocible.
ParserEl componente que decodifica una cadena transmisible de vuelta en una entidad FayID. Distingue los tipos de entidad por el prefijo de tipo.

Sistemas externos

TérminoDefinición
Global Merit ChainEl sistema de cadena externo del ecosistema iFay que registra la identidad y la reputación a largo plazo. FayID es su capa de identidad.
Legacy Auth SourceUn sistema externo que provee métodos de autenticación tradicionales como contraseña, certificado, autorización, token de acceso o contrato inteligente.
Target ResourceUn recurso externo protegido por un Authorization Grant, identificado por un resourceRef.

Términos extendidos (introducidos durante el diseño)

Los siguientes términos aparecen por primera vez en el documento de diseño y se utilizan para describir el comportamiento del protocolo con mayor precisión:

TérminoDefinición
opaqueRefUna cadena estable pero irreversible derivada de un Human ID por la GMC Interface. Se usa para asociar la reputación de una persona natural en el Global Merit Chain sin exponer el Human ID.
resourceRefUna cadena jerárquica en un Authorization Grant que identifica de forma única el recurso objetivo. Forma recomendada: <scheme>://<authority>/<path>.
proofOfHuman / proofOfOwnerMecanismos abstractos de prueba de titularidad (típicamente desafíos de firma en las implementaciones). La capa de protocolo solo requiere que sean verificables y que no requieran un Mnemonic en texto plano.
OwnerKindUn enum con valores HUMAN u ORGANIZATION, que identifica el tipo de propietario de un coFay ID.
LegacySourceKindUn enum con valores PASSWORD / CERTIFICATE / AUTHORIZATION / ACCESS_TOKEN / SMART_CONTRACT, que identifica la fuente desde la que se acuñó un Authorization Grant.
GrantStateUn enum con valores ACTIVE / EXPIRED / REVOKED, que identifica el estado actual de un Authorization Grant.
EntityKindUn enum que identifica el tipo de entidad al que pertenece una cadena FayID (HUMAN_ID / IFAY_ID / COFAY_ID / ORGANIZATION_ID / DYNAMIC_CODE / VERIFICATION_CODE / AUTHORIZATION_GRANT).
normalizeUna función que convierte una cadena FayID a su forma canónica: minúsculas + coincidencia de prefijo de tipo + filtro de caracteres por lista blanca.
derive_secretMaterial de clave que el Issuer mantiene internamente y que se deriva de un Human ID; se usa para generar Dynamic Codes. Nunca se expone externamente.
gmc_namespace_secretUna clave de espacio de nombres que mantiene el sistema FayID, usada para derivar opaqueRefs. La estrategia de rotación es una pregunta abierta.

Referencia rápida de prefijos de tipo

PrefijoEntidad¿Puede aparecer en público?
hid_Human IDProhibido (restricción de la capa de privacidad)
ifay_iFay IDPermitido
cofay_coFay IDPermitido
org_Organization IDPermitido
dyn_Dynamic CodePermitido
vrf_Verification CodeSolo emparejado con un coFay ID
grt_Authorization GrantPermitido

Consulta la sección "Identifier Format & Encoding" en design.md para los conjuntos de caracteres detallados, los límites de longitud y las reglas de normalización.