EyeAuras Wiki
RU

Вход и лицензирование

Карта API EyeAuras для входа, входа по ключу, проекции лицензий и аренды сублицензий.

Карта логина и лицензирования

Опорная карта для сборки собственного UI логина, профиля и лицензирования в скриптах, Blazor-окнах, mini-apps и pack-продуктах.

Что обычно нужно сделать

  • Добавить стандартную кнопку логина EyeAuras в кастомное окно Blazor.
  • Собрать полностью кастомный экран входа с username/password и key login.
  • Показать текущий аккаунт, лицензию, срок действия, роль и состояние подключения к hub.
  • Дать уже вошедшему пользователю возможность активировать дополнительный ключ лицензии.
  • Ограничить доступ к платному pack или mini-app через современные sublicense leases.
  • Понять, как связаны ILicenseAccessor, IEyeHubService и ISublicenseManager.

Как это устроено

  • EyeAuras может работать в бесплатном режиме. Обычная лицензия EyeAuras не требуется просто для использования платформы.
  • Аккаунт EyeAuras может авторизоваться по username/password.
  • Key login — это сокращенный вариант для пользователей, у которых есть только лицензионный ключ. Клиент вызывает логин, передавая ключ и как username, и как password; сервер находит или создает аккаунт, привязанный к этому ключу.
  • Активация ключа в уже существующем аккаунте — это отдельный сценарий, не key login. Используйте ActivateLicenseKey(...) только после того, как пользователь уже вошел в систему.
  • ILicenseAccessor — это текущая локальная проекция активной подписанной лицензии и identity пользователя. Это правильный объект для UI профиля и статуса.
  • Sublicenses — это выдаваемые автором pack права доступа для конкретного share или mini-app. Современные платные packs должны запрашивать явный runtime lease через ISublicenseManager.Rent(...).
  • Наличие sublicense key в аккаунте — это не то же самое, что активная runtime-сессия. Решения о доступе нужно принимать по состоянию lease.

Контексты хоста и runtime

  • В Blazor-окнах продукта используйте LoginWidget, если достаточно стандартного popup логина EyeAuras.
  • В полностью кастомном UI на Blazor, ImGui, WPF или в скриптах внедряйте и используйте IEyeHubService для операций login/logout/activation key, а ILicenseAccessor — для живого отображения состояния.
  • В скриптах, которым нужен доступ к paid pack, получайте ISublicenseManager из script container и держите возвращенный ISublicenseLease живым столько, сколько эта логическая сессия должна потреблять доступ.
  • ISublicenseManager.Rent(...) предназначен для активного выполнения скрипта. Возвращенный lease привязывается EyeAuras к lifetime выполнения скрипта, но ваши подписки на WhenChanged() все равно нужно правильно привязать и освобождать.

Детали API

  • IEyeHubService (EyeAuras.Loader.Shared.Services) предоставляет: HubAddress, ActiveLicense, ConnectionState, connection timing, PerformLogin(username, password), PerformLogout(), RefreshToken() и ActivateLicenseKey(licenseKey).
  • ILicenseAccessor (EyeAuras.Loader.Shared.Api) реализует IUserLicense и INotifyPropertyChanged. Он предоставляет IsValid, Username, UserId, Roles, LicenseType, StartsAt, ExpiresAt, ProductFeatures, ShareSublicenses, GetAttribute(key) и совместимый только для compatibility ActiveLicense.
  • IUserLicense — это общая проекция лицензии, которая возвращается из hub-операций и доступна через IEyeHubService.ActiveLicense.
  • LoginWidget (EyeAuras.Blazor.Controls) — готовый Blazor-контрол, который открывает стандартный popup логина EyeAuras.
  • ISublicenseManager (EyeAuras.Loader.Shared.Api) создает живые runtime-intent для sublicense lease через Rent(AuraShareId shareId).
  • ISublicenseLease предоставляет LeaseId, ShareId, IsGranted, Status, Message, LastUpdatedAt и WhenChanged().

Частые сценарии

Готовый логин для Blazor

Используйте этот вариант, если вашему окну подходит стандартный popup логина EyeAuras:

<LoginWidget/>

Виджет отображает ILicenseAccessor.Username и открывает host UI логина.

Логин по username/password

csharp
var eyeHub = GetService<IEyeHubService>();
var licenseAccessor = GetService<ILicenseAccessor>();

var license = await eyeHub.PerformLogin(username.Trim(), password);
Log.Info($"Logged in as {licenseAccessor.Username}");

Key login

csharp
var eyeHub = GetService<IEyeHubService>();

var key = licenseKey.Trim();
var license = await eyeHub.PerformLogin(key, key);

Для key login ожидается, что одно и то же значение ключа передается в оба аргумента. На стороне сервера это распознается как вход по license key, после чего сервер находит или создает пользователя, привязанного к ключу. Не логируйте сырой ключ.

Активация дополнительного ключа для существующего пользователя

csharp
var eyeHub = GetService<IEyeHubService>();

var updatedLicense = await eyeHub.ActivateLicenseKey(extraLicenseKey.Trim());

Используйте активацию, когда пользователь уже вошел в систему и хочет привязать к этому аккаунту еще один ключ. Используйте key login, когда сам ключ является логин-учетными данными.

Отображение профиля и статуса

csharp
var licenseAccessor = GetService<ILicenseAccessor>();
var eyeHub = GetService<IEyeHubService>();

Log.Info($"User: {licenseAccessor.Username}");
Log.Info($"License: {licenseAccessor.LicenseType}, valid: {licenseAccessor.IsValid}");
Log.Info($"Expires: {licenseAccessor.ExpiresAt}");
Log.Info($"Hub: {eyeHub.ConnectionState}");

В реактивном UI отслеживайте ILicenseAccessor.PropertyChanged или используйте WhenAnyValue(...) для свойств ILicenseAccessor.

Lease доступа для paid pack / mini-app

csharp
var sublicenseManager = GetService<ISublicenseManager>();
var lease = sublicenseManager.Rent(new AuraShareId("S20260209165639iiQZB0NCruAb"));

lease.WhenChanged()
    .Subscribe(x =>
    {
        if (!x.IsGranted)
        {
            Log.Warn($"Sublicense is not granted: {x.Status} / {x.Message}");
            return;
        }

        Log.Info("Sublicense granted");
    })
    .AddTo(ExecutionAnchors);

Rent(...) работает неблокирующе. Начальное состояние обычно pending, а сам lease обновляется в фоне. Считайте доступ выданным только тогда, когда ISublicenseLease.IsGranted равен true.

Чеклист для кастомного UI логина

  • Отслеживайте busy state, чтобы повторные клики не запускали несколько login-запросов одновременно.
  • Проверяйте выбранный режим: username/password для входа в аккаунт, license key — для key login.
  • Вызывайте Trim() для usernames и keys. Для passwords этого делать не нужно, если только ваш собственный UX явно этого не требует.
  • Для key login вызывайте PerformLogin(key, key).
  • Очищайте поля password/key после успешного логина.
  • Показывайте ошибки операции логина в локальном UI.
  • Читайте профиль и отображение лицензии из ILicenseAccessor, а не из скопированного состояния формы логина.
  • Если продукт платный, запрашивайте sublicense lease после логина или при запуске продукта и основывайте доступ на lease.IsGranted.

Подсказки по assembly / package

  • EyeAuras.Loader.Shared содержит IEyeHubService, ILicenseAccessor, IUserLicense, ISublicenseManager и ISublicenseLease.
  • EyeAuras.Blazor.Controls содержит LoginWidget.
  • EyeAuras.Shared содержит AuraShareId.

Что предпочтительно

  • Используйте LoginWidget, если подходит стандартный host flow логина.
  • Используйте IEyeHubService.PerformLogin(key, key) для кастомных экранов key login.
  • Используйте IEyeHubService.ActivateLicenseKey(...), чтобы привязать дополнительный ключ к уже вошедшему аккаунту.
  • Используйте ILicenseAccessor для отображения текущего профиля и лицензии.
  • Используйте ISublicenseManager.Rent(...) для авторизации современных платных packs или mini-apps.

Чего стоит избегать

  • Не логируйте сырые license keys, passwords, signed licenses или bearer tokens.
  • Не используйте ILicenseAccessor.ActiveLicense как обычный публичный API. Это материал подписанной лицензии, оставленный только для compatibility.
  • Не используйте ILicenseAccessor.ShareSublicenses как основной механизм авторизации для новых платных packs. Используйте ISublicenseLease.
  • Не считайте, что успешная активация ключа автоматически означает выданную runtime sublicense session. Запрашивайте lease и проверяйте его состояние.
  • Не блокируйте запуск навсегда в ожидании lease; показывайте pending state и реагируйте на WhenChanged().

Опорные точки для изучения

  • IEyeHubService
  • ILicenseAccessor
  • IUserLicense
  • LoginWidget
  • ISublicenseManager
  • ISublicenseLease
  • AuraShareId
  • EyeLicenseType
  • SublicenseLeaseGrantStatus

Синонимы для поиска

  • login
  • custom login
  • key login
  • license key login
  • activate license key
  • account profile
  • current user
  • current license
  • license accessor
  • active license
  • sublicense
  • sublicense lease
  • rent license
  • paid pack access
  • mini-app licensing
  • semi-offline license

Смежные карты

  • core/deployment.md
  • core/blazor.md
  • core/app-runtime-contexts.md
  • scripting/runtime.md
  • scripting/reactive-lifetime.md
  • scripting/references-and-resources.md
  • ../../../features/keylogin.md
  • ../../../features/sublicenses.md