Цю сторінку ще не перекладено — показано англійську версію.

Auth & Players

Вхід — це крок, який можна перевизначити, а не чорна скринька. Провайдери, сесії, прив’язка облікових записів, бани. Кожна точка сценарію — до і після входу, до і після прив’язки, до і після об’єднання, під час зміни статусу — оголошена як точка розширення певного виду. Це або перевірка, яка може відхилити крок, або спостерігач, який цього зробити не може.

Коли це потрібно

• Гравці (player) мають входити в гру: через пристрій, email, Apple, Google, Steam або власний провайдер. Щоб гравця створювало під час першого входу (sign-in), досить прапорця — окремий сценарій не потрібен.
• Гостьовий акаунт згодом треба перетворити на постійний: Link додає Steam і зберігає прогрес, а об’єднання (merge) зводить два акаунти в одного гравця.
• Правила мають виконуватися там, де їх не обійти: перевірка регіону перед входом, стартовий набір після того входу, що створив гравця.
• Модерація має діяти одразу: відкликати сесії, тимчасово блокувати, банити пристрій. Подію (event) banned чує кожна запущена система.
• Оголошений контекст (регіон, платформа, збірка) має доходити до кожного наступного хука, щоб жоден із них не перечитував гравця лише заради цього.
• Полегшеної альтернативи немає. Усі інші модулі визначають, хто їх викликає, саме через цей модуль, тому auth не вимкнути, поки хоч одному з них потрібен актор-гравець: конфігуратор модулів відмовить і назве модулі, які від нього залежать.

Хто що робить

Коротко

// client — one call per provider; create-on-first-sign-in is a flag
var session = await PlayServ.Auth.SignIn(Provider.Device, create: true);
await PlayServ.Auth.Link(Provider.Steam);          // one player, many identities

// client — one call per provider; create-on-first-sign-in is a flag
const session = await PlayServ.auth.signIn(Provider.Device, { create: true });
await PlayServ.auth.link(Provider.Steam);    // one player, many identities

# client — one call per provider; create-on-first-sign-in is a flag
session = await playserv.auth.sign_in(Provider.DEVICE, create=True)
await playserv.auth.link(Provider.STEAM)     # one player, many identities

// client — one call per provider; create-on-first-sign-in is a flag
Client->Auth->SignInWithProvider(FPSProviderId::Device, Credential,
    TPSOnResult<FPSSession>::CreateWeakLambda(this, [this](const TPSResult<FPSSession>& Result)
    {
        if (!Result.HasValue()) { return; }
        // one player, many identities — add Steam to the same account
        Client->Auth->Providers->Link(FPSProviderId::Steam, SteamCredential);
    }));
// co_await support ships later: a built-in SDK coroutine wrapper that respects Unreal's GC and threading.

// client — one call per provider; create-on-first-sign-in is a flag
var session = await PlayServ.Auth.SignIn(Provider.Device, create: true);
await PlayServ.Auth.Link(Provider.Steam);          // one player, many identities

Кожну точку налаштовують там, де її оголошено. Усі форми, яких може набувати обробник, зібрано на сторінці Extensibility:

[Before(Auth.SignIn)]                          // a gate: it may refuse, and it is fail-closed
public static Verdict GateRegion(SignInAttempt a) =>
    a.Region == "sanctioned"
        ? Hook.Reject(Problem.Forbidden, "region not served")
        : Hook.Continue(a);

[After(Auth.SignIn, created: true)]            // an observer: it watches, it cannot refuse
public static async Task GrantStarterPack(Player player)
{
    await player.Inventory.Grant("chest.gold", count: 1);
}

// a gate: it may refuse, and it is fail-closed
export const gateRegion = before(Auth.signIn, (a: SignInAttempt) =>
  a.region === 'sanctioned'
    ? Hook.reject(Problem.forbidden, 'region not served')
    : Hook.continue(a));

// an observer: it watches, it cannot refuse
export const grantStarterPack = after(Auth.signIn, { created: true },
  async (player: Player) => {
    await player.inventory.grant('chest.gold', { count: 1 });
  });

@before(auth.sign_in)                          # a gate: it may refuse, and it is fail-closed
def gate_region(a: SignInAttempt) -> Verdict:
    if a.region == "sanctioned":
        return Hook.reject(Problem.FORBIDDEN, "region not served")
    return Hook.continue_(a)

@after(auth.sign_in, created=True)             # an observer: it watches, it cannot refuse
async def grant_starter_pack(player: Player):
    await player.inventory.grant("chest.gold", count=1)

Панель показує саме оголошену форму: для кожної точки видно її обробники, їхній вид і остаточний порядок виклику. Від виду залежить, що станеться, коли обробник упаде:

Модель

Гравець — це носій облікових записів, а не рядок у вашій схемі, а його ідентифікатор стабільний, і його ніколи не видають повторно — навіть після об’єднання: id об’єднаного гравця й далі веде до гравця, а не перетворюється на висяче посилання. Прив’язка — це трійка: провайдер · зовнішній суб’єкт · гравець.

Три машини станів.

Що оголошуєте ви.

Де налаштовують провайдера. На операторському рівні, а не в коді: обліковим даним магазину не місце в репозиторії. Те, що оголошено, видно в адмін-консолі лише для перегляду.

Що дає видача ролі. Ролі — справа не лише оператора. В інтерфейсі гравця є операції видачі й відкликання, тож гра може власним кодом підвищити гравця до офіцера гільдії або передати ведучому турніру його повноваження.

З чого складаються ролі й що вони відкривають, описано на сторінці Access & Roles.

Помилки

• Облікових даних немає або вони прострочені — відповідь not authenticated, і це виправляє оновлення. Відкликані облікові дані дають ту саму відповідь, але оновлення тут не допоможе — лише новий вхід.
• Облікові дані, які вже замінили під час ротації, пред’явили знову — це конфлікт. Саме завдяки цьому ротацію помічають, а не мовчки пропускають.
• Забанений або тимчасово заблокований гравець, а також забанений відбиток отримують forbidden, і повторювати спробу марно.
• Пара провайдер+суб’єкт зайнята — конфлікт; спробу можна повторити, коли оберете об’єднання. Другий акаунт того самого провайдера — конфлікт, який повтор не змінить.
• Спроба відв’язати останній спосіб входу — відмова валідації: після неї до акаунта ніхто не зможе дістатися.
• Об’єднати вже об’єднаного гравця не можна — це конфлікт, бо merged — кінцевий стан.
• Коли провайдер недоступний, відповідь — unavailable, і спробу варто повторювати зі зростаючою паузою (backoff). Коли провайдер відхиляє облікові дані, відповідь — not authenticated, і тут вистачить однієї повторної спроби, а не циклу.
• Перевищено частоту спроб входу — відповідь із категорії rate limit і час, після якого можна спробувати знову.

Обмеження

Конкретні числа з’являться разом із розділом про ліміти платформи, а що відбувається на кожній стелі, визначено вже зараз.

• Одночасні сесії на гравця: залежно від оголошеної політики — витіснення найстарішої з подією або відмова новій. Значення за замовчуванням немає.
• Спроби входу за період і спроби прив’язати зайняту пару: обмеження частоти з часом, після якого можна повторити, а лічильник спроб лишається в історії.
• Прив’язки на гравця: прив’язку ще одного провайдера платформа відхиляє як конфлікт.
• Строк дії облікових даних: not authenticated, повторити можна після оновлення. Строк дії облікових даних для оновлення: лише новий вхід.
• Зберігання (retention) анонімного гравця без жодного входу: видалення за оголошеною політикою, з подією. Політику оголошують явно, значення за замовчуванням немає.
• Записи в бан-списку відбитків: нове додавання платформа відхиляє, а старі записи ніколи не витісняє мовчки.