Англійська для розпізнавання Auth0

Auth0 розташовується між програмою і тим, як користувач насправді доводить, ким він є — паролем, соціальним входом, провайдером SSO для підприємства — і його словник відображає цю багатошарову роль, яка має значення при поясненні помилки входу комусь, хто не знайомий з платформою.

Ключовий словник

** Tenant ** — контейнер Auth0 верхнього рівня, який ізолює набір програм, користувачів і налаштувань від будь- якого іншого користувача, приблизно аналогічно до окремого облікового запису або робочого простору.

• “Ми використовуємо окремі клієнти для стадіонарного та виробничого режимів, отже, неправильно налаштоване правило у стадіонарному режимі ніколи не може випадково вплинути на реальні входи користувачів.” *

** З’ єднання ** — налаштоване джерело ідентифікації, за допомогою якого користувач здійснює розпізнавання (база даних електронної пошти і паролів, соціальний провайдер, на зразок Google, або провайдер корпоративних SAML/ OIDC), для якого програма може вказати одне або декілька джерел ідентифікації.

• “Ми увімкнули з’ єднання з Google разом з існуючим з’ єднанням з базою даних, щоб користувачі могли або зареєструватися за допомогою електронної пошти, або увійти за допомогою існуючого облікового запису Google.” *

** Action (дія після входу) ** — частина нетипового коду, який виконується у певній точці потоку розпізнавання (після входу, перед видачею токена) для додавання нетипової логіки, наприклад, збагачення токена додатковими заявами або блокування певних користувачів.

• “Ми додали дію після входу, яка перевіряє домен електронної пошти користувача і автоматично призначає заяву про роль, замість того, щоб кожна програма мала шукати її окремо.” *

** Правило (старе) ** — старий механізм для нетипової логіки потоку розпізнавання, функціонально схожий на дії, але використовується набагато рідше на користь новітньої, більш гнучкої структури дій. “Ця логіка все ще реалізована як старе правило — ми переносимо її до дії, оскільки правила застаріли і не підтримують нові точки розширення.”

** Ротація токенів оновлення ** — параметр безпеки, за якого кожне використання токену оновлення скасовує його дію і видає новий, обмежуючи шкоду, яку може завдати витік або перехоплення токена оновлення. “Ми ввімкнули поворот токенів оновлення на з’ єднанні мобільного додатка — навіть якщо токен був якось перехоплений, він стає безкорисливим після наступного оновлення законного клієнта.”

Звичайні фрази

• Чи є це проблемою з’єднання з базою даних, чи не працює соціальне з’єднання?
• Чи реалізована ця логіка як дія після входу, чи це все ще спадкове правило?»
• «Яка кімната в будинку, де відбувається це — стадіон чи виробництво?»
• Чи є у нас ввімкнена оновлення токенів для цього клієнта, або це прогалина?»
• Чи це твердження додається за допомогою дії, або воно надходить від постачальника ідентифікаційних даних безпосередньо?»

Приклади висловлювань

Діагностика помилки реєстрації: “Користувачі не можуть увійти через з’ єднання з Google, з’ єднання з базою даних працює нормально, тому це, схоже, проблема з налаштуванням соціального провайдера, а не з налаштуванням нашого клієнта в цілому.”

Пояснення міграції в PR:

• “Перенесено логіку присвоєння ролі на основі домену зі старого правила на дію після входу — така ж поведінка, але на платформі Auth0 підтримка продовжується.” *

Обговорення рішення щодо посилення безпеки: “Ми включаємо оновлення токена для всіх мобільних клієнтів цього кварталу - це значно зменшує радіус вибуху, якщо токен коли-небудь витікає з компрометованого пристрою.”

Професійні поради

• Скажіть ** tenant **, коли обговорення буде спрямоване на стадію стадіонарного проти виробничого — зміна налаштувань, зроблена неправильним рентієром, є звичайним і уникнутим класом інциденту.
• Назвіть конкретне з’єднання, коли повідомляєте про проблему з входом — « входження пошкоджено » набагато менш корисно, ніж « з’єднання SAML для нашого корпоративного клієнта не працює. »
• Віддати перевагу ** діям ** перед ** правилами, що вже існують ** у новій роботі і позначати існуючі правила для перенесення — термінологія розрізнення сигналів, на яку систему має бути спрямовано виправлення.
• Явно згадайте про refresh token rotation у будь- якому перегляді безпеки налаштувань автентифікації клієнта — це важливе полегшення, яке легко ігнорувати, оскільки воно не впливає на звичайний процес реєстрації.

Практичні вправи

1. Напишіть речення, у якому пояснюється, що ізолює користувача.
2. Описати різницю між з’ єднанням і дією.
3. Пояснити, від чого захищає обертання токенів оновлення.

Переклади: «Переклад з німецької мови»

Будьмо чесними – технічний жаргон може здатися особливо відчуженим, коли ви намагаєтеся зрозуміти його через нову мову. «Тренерів», «з’єднання», навіть «правило» - ці терміни звучать точно, але їх наслідки і спосіб їх обговорення в команді розробників можуть швидко стати неясними. Це не просто про те, щоб знати * що * вони означають; це про розуміння * як * вони використовуються для передачі намірів, оцінки ризику, і, врешті-решт, забезпечення надійного потоку автентифікації. Багато розробників спочатку перекладають ці терміни буквально — «орендатор — це користувач» — що втрачає критичне архітектурне значення. Ключовим є визнання того, що технічна англійська сильно залежить від контексту і встановлених угод у межах певного домену (у цьому випадку, Auth0).

Наприклад, ви можете почути, як старший інженер каже молодшому розробнику: « Нам потрібно посилити правила щодо скасування паролів для цього користувача. Ми бачимо незвично велику кількість запитів, що надходять від потенційно скомпрометованих облікових записів.” Це не про звинувачення користувача; це про виявлення потенційної проблеми безпеки в * конфігурації * - ‘правилах’ - що регулюють доступ. Аналогічно, коли обговорюєте « з’ єднання », не думайте про них як про зовнішні служби; розгляньте їх вплив на авторизацію і керування сеансами. Чистий опис є ключовим для ефективного спілкування і співпраці. Наприклад, хороший опис PR може звучати так: « Впровадити розширений потік MFA через з’ єднання Google, забезпечуючи відповідність з правилами GDPR в цьому рентієрі ». Ця фраза негайно повідомляє про технічні дії * і * ширші бізнес- розрахунки.

Крім того, пам’ятайте, що розробники часто використовують трохи підвищену мову, коли описують проблеми або пропонують рішення - навмисні зусилля, щоб звучати досвідченими і точними. Такі фрази, як « залежності від попередніх версій » або « гранульне керування » є звичайними у контексті налаштування Auth0, навіть якщо вони здаються надто формальними на перший погляд. Метою є встановлення ясності і уникнення неоднозначності, особливо при документуванні змін або повідомленні про проблеми. Поширене повідомлення Slack може бути таким: «Дослідження потенційного вузького місця з’єднання з Facebook - давайте переглянемо правила обмеження для цього рентера»

І, нарешті, не вагайтеся попросити про пояснення. Краще визнати, що щось не розумієш, ніж робити припущення, які можуть призвести до помилок або порушень безпеки. Питання «Чи можете ви пояснити, що ви маєте на увазі під «примусовим обмеженням з’ єднання»? » є цілком прийнятним і демонструє прихильність до навчання.

Ось приклад того, як можна використовувати Auth0 auth0-cli для перевірки налаштувань користувача:

auth0-cli tenants list --output json

За допомогою цієї команди буде виведено опис JSON ваших користувачів Auth0, за допомогою якого ви зможете перевірити такі відомості, як ідентифікатор користувача і пов’ язані з ним налаштування з’ єднання. Це конкретний приклад того, як технічна англійська мова - опис команд і їх виводу - відіграє важливу роль в управлінні автентифікацією.