Глава 2. Глоссарий

В этой главе сводится воедино вся терминология, используемая в системе FayID. Первая половина унаследована от Глоссария requirements.md; вторая половина добавляет расширенные термины, введённые на этапе проектирования.

Соглашение: когда последующие главы этого blueprint используют какой-либо из перечисленных ниже терминов, авторитетными являются определения этой главы. В случае неоднозначности окончательный приоритет имеют определения в requirements.md.


Основные сущности

ТерминОпределение
FayID SystemОбщая идентификационная система, определяемая этой спецификацией, состоящая из логических компонентов Issuer, Resolver, Auth Exchange, GMC Interface, Serializer, Parser и других.
Human IDКорневая идентичность физического лица в системе FayID. Получается из пары ключей, сопровождается Mnemonic и принадлежит исключительно одному Human Prototype.
Human PrototypeРеальное физическое лицо, парно сопоставленное один к одному с Human ID.
iFay IDИдентичность отдельной цифровой персоны iFay. Должна быть привязана ровно к одному Human ID, хотя один Human ID может привязывать несколько iFay ID.
coFay IDИдентичность публичной роли coFay. Должна принадлежать либо Human ID, либо Organization ID.
Organization IDИдентичность организации в системе FayID. Публикуется в открытом виде и не требует производного Dynamic Code.

Учётные данные и производные

ТерминОпределение
MnemonicМнемоническая фраза, ассоциированная с Human ID; человекочитаемая резервная копия закрытого ключа Human ID. Возвращается держателю ровно один раз во время генерации и никогда не сохраняется в открытом виде.
Dynamic CodeОграниченная по времени строка, производная от Human ID, которая может передаваться в открытом виде. Используется для ссылки на Human ID без его раскрытия.
Verification CodeКод, привязанный к coFay ID, используемый для проверки подлинности держателя при использовании coFay ID. Может быть ротирован владельцем.
Authorization GrantОграниченные по времени учётные данные аутентификации, выпускаемые для iFay ID или Human ID после прохождения через Auth Exchange. Несут явное время истечения и поддерживают активный отзыв.

Логические компоненты

ТерминОпределение
IssuerЛогический компонент в системе FayID, отвечающий за генерацию, ротацию и отзыв идентификаторов и учётных данных.
ResolverЛогический компонент, который разрешает открытые учётные данные (Dynamic Code, Verification Code или ID-строку) обратно в соответствующую сущность.
Auth ExchangeЛогический компонент, выполняющий обмен между FayID и традиционными методами аутентификации (пароль, сертификат, авторизация, токен доступа, смарт-контракт).
GMC InterfaceЛогический граничный компонент, через который FayID System взаимодействует с Global Merit Chain. Предоставляет только методы только для чтения; обратные записи Human ID или материала закрытого ключа запрещены.
SerializerКомпонент, который кодирует сущности FayID в передаваемые строки. Каждая сущность несёт распознаваемый префикс типа.
ParserКомпонент, который декодирует передаваемую строку обратно в сущность FayID. Различает типы сущностей по префиксу типа.

Внешние системы

ТерминОпределение
Global Merit ChainВнешняя система цепочки в экосистеме iFay, которая длительно несёт записи идентичности и репутации. FayID является её идентификационным уровнем.
Legacy Auth SourceВнешняя система, предоставляющая традиционные методы аутентификации, такие как пароль, сертификат, авторизация, токен доступа или смарт-контракт.
Target ResourceВнешний ресурс, защищаемый Authorization Grant и идентифицируемый через resourceRef.

Расширенные термины (введены при проектировании)

Следующие термины впервые появляются в документе проектирования и используются для более точного описания поведения протокола:

ТерминОпределение
opaqueRefСтабильная, но необратимая строка, производная от Human ID и формируемая GMC Interface. Используется для ассоциации репутации физического лица в Global Merit Chain без раскрытия Human ID.
resourceRefИерархическая строка в Authorization Grant, уникально идентифицирующая целевой ресурс. Рекомендуемая форма: <scheme>://<authority>/<path>.
proofOfHuman / proofOfOwnerАбстрактные механизмы доказательства владения (обычно вызовы подписи в реализациях). Уровень протокола требует только их проверяемости и того, чтобы они не требовали открытого Mnemonic.
OwnerKindПеречисление со значениями HUMAN или ORGANIZATION, идентифицирующее вид владельца coFay ID.
LegacySourceKindПеречисление со значениями PASSWORD / CERTIFICATE / AUTHORIZATION / ACCESS_TOKEN / SMART_CONTRACT, идентифицирующее источник, из которого был выпущен Authorization Grant.
GrantStateПеречисление со значениями ACTIVE / EXPIRED / REVOKED, идентифицирующее текущее состояние Authorization Grant.
EntityKindПеречисление, идентифицирующее тип сущности, к которому принадлежит строка FayID (HUMAN_ID / IFAY_ID / COFAY_ID / ORGANIZATION_ID / DYNAMIC_CODE / VERIFICATION_CODE / AUTHORIZATION_GRANT).
normalizeФункция, преобразующая строку FayID в каноническую форму: нижний регистр + сопоставление префикса типа + фильтр символов по белому списку.
derive_secretКлючевой материал, удерживаемый внутри Issuer и производный от Human ID; используется для генерации Dynamic Code. Никогда не раскрывается наружу.
gmc_namespace_secretКлюч пространства имён, удерживаемый FayID System и используемый для производства opaqueRef. Стратегия ротации — открытый вопрос.

Краткий справочник по префиксам типов

ПрефиксСущностьМожет появляться публично
hid_Human IDЗапрещено (ограничение уровня конфиденциальности)
ifay_iFay IDРазрешено
cofay_coFay IDРазрешено
org_Organization IDРазрешено
dyn_Dynamic CodeРазрешено
vrf_Verification CodeТолько в паре с coFay ID
grt_Authorization GrantРазрешено

Подробные наборы символов, границы длины и правила нормализации см. в разделе «Identifier Format & Encoding» в design.md.