{"canonical_url":"https://engineer.company/uk/glossary/oauth/","content_markdown":"# OAuth\n\n## Що це таке\n\nOAuth — це протокол, який дає змогу одному застосунку користуватися даними\nлюдини в іншому сервісі, з її згоди й у межах, які вона сама бачить, причому\nзастосунок так і не дізнається її пароля. Чинна версія — OAuth 2.0: IETF\nопублікувала її в жовтні 2012 року як RFC 6749, і її так само часто пишуть\nOAuth 2.0 чи OAuth2, як і просто OAuth. Вона замінила OAuth 1.0, і ці дві версії\nміж собою несумісні.\n\nСпецифікація визначає чотири ролі. Власник ресурсу — той, хто може надати\nдоступ, зазвичай людина. Сервер ресурсів зберігає захищені дані й відповідає на\nзапити, до яких додано токен. Клієнт — застосунок, якому потрібен доступ:\nвебзастосунок, мобільний застосунок, скрипт, ШІ-агент. Сервер авторизації\nперевіряє власника, просить його згоди й видає токени. У невеликому продукті ролі\nсервера ресурсів і сервера авторизації може виконувати одна система; у компанії частіше один постачальник\nідентичності стоїть перед багатьма API.\n\nКлієнт отримує токен доступу (access token) — рядок, що означає певний обсяг\nдоступу на певний час. Цей токен клієнт додає до кожного запиту до сервера\nресурсів. RFC називає такий рядок зазвичай непрозорим для клієнта: клієнт його\nпередає, але читати не мусить. Сервер авторизації може також видати токен\nоновлення (refresh token), який клієнт обмінює на новий токен доступу, коли\nстрок дії старого спливає, і людину вдруге не питають.\n\nПерший токен клієнт отримує через грант, тобто спосіб надання дозволу. RFC 6749\nвизначає чотири: authorization code, implicit, resource owner password\ncredentials і client credentials. Client credentials — для програми, що діє від\nвласного імені, без участі людини. Для всього іншого важить грант authorization\ncode, бо чинні рекомендації з безпеки вивели з ужитку implicit і password. В\nIETF ці рекомендації разом із Proof Key for Code Exchange (PKCE) і правилами\nдля bearer-токенів зводять в один документ, OAuth 2.1. У шістнадцятій редакції,\nдатованій 3 вересня 2026 року, це досі Internet-Draft, тобто робочий проєкт, а\nне стандарт.\n\nOAuth стосується авторизації, а не автентифікації. Токен повідомляє API, що\nклієнтові дозволено, а про те, хто ця людина, нічого певного клієнтові не\nговорить. Вхід користувачів поверх OAuth — завдання OpenID Connect, який додає\nтокен, призначений саме для того, щоб його читав клієнт.\n\n## Чому це важливо\n\nRFC 6749 починається з проблеми, яку мав розв'язати. Щоб сторонній застосунок\nотримав доступ до ваших даних, ви давали йому свій пароль. Застосунок мусив цей\nпароль зберігати, зазвичай відкритим текстом. Він діставав усе, до чого\nдіставав пароль, і стільки, скільки хотів. Відкликати доступ в одного\nзастосунку можна було, лише змінивши пароль, а це відрізало й усі інші. А коли\nзламували будь-який із них, разом із ним витікали пароль і все, що за ним\nстояло. OAuth прибирає кожну з цих проблем: застосунок ніколи не тримає пароля,\nтокен має обсяг і строк дії, а доступ можна відкликати в одного клієнта, не\nзачіпаючи решти.\n\nКоманда стикається з OAuth з обох боків. Якщо API належить вам, OAuth дає змогу\nпартнерам, інтеграціям і власним інструментам ваших клієнтів викликати його від\nімені користувача, і ніхто не зберігає чужих паролів. Якщо ви користуєтеся\nчужим API, то OAuth — це те, що пропонують календарі, поштові скриньки,\nбухгалтерські системи й файлові сховища, тож клієнтська половина — код, який\nваша команда пише й підтримує. ШІ-агенти, що діють від імені людини, займають те\nсаме місце, що й будь-який інший клієнт: їм належить мати токен, обмежений тим,\nщо людина дозволила, а не її облікові дані.\n\nОбсяги доступу (scopes) перетворюють принцип найменших привілеїв на правило,\nяке сервер може забезпечити. Токен, що дозволяє сервісу друку читати фото, не\nповинен дозволяти їх видаляти, а токен, виданий для одного API, має відхилити\nінший. Рекомендації IETF з безпеки 2025 року, RFC 9700, вимагають саме цього:\nпривілеї токена доступу мають бути мінімальними для конкретного випадку, а самі\nтокени — обмеженими сервером ресурсів, для якого їх видано.\n\n## Як це виглядає на практиці\n\nПриклад із самого RFC — сервіс друку, якому потрібні фото із сайту для обміну\nфотографіями. Ось цей обмін у вигляді гранту authorization code з PKCE — схеми,\nяку чинні рекомендації просять використовувати всіх клієнтів. Насамперед клієнт\nгенерує випадковий code verifier завдовжки від 43 до 128 символів і тримає його\nв себе. Він хешує verifier алгоритмом SHA-256, кодує результат у base64url і\nпереспрямовує браузер людини на сервер авторизації, передаючи цей результат як\ncode challenge:\n\n```http\nGET /authorize?response_type=code\u0026client_id=s6BhdRkqt3\u0026state=xyz\n    \u0026redirect_uri=https%3A%2F%2Fclient%2Eexample%2Ecom%2Fcb\n    \u0026code_challenge=E9Melhoa2OwvFrEMTJguCHaoeK1t8URWbuGJSstw-cM\n    \u0026code_challenge_method=S256 HTTP/1.1\nHost: server.example.com\n```\n\nСервер авторизації перевіряє людину, показує, чого просить сервіс друку, і,\nколи людина погоджується, повертає браузер назад із короткоживучим кодом\nавторизації. Клієнт перевіряє, що `state` — те саме значення, яке він\nнадсилав:\n\n```http\nHTTP/1.1 302 Found\nLocation: https://client.example.com/cb?code=SplxlOBeZQQYbYS6WxSbIA\n          \u0026state=xyz\n```\n\nСам собою код нічого не вартий. Клієнт обмінює його, надсилаючи HTTPS-запит\nдо кінцевої точки токенів сервера авторизації, і цього разу передає сам verifier:\n\n```http\nPOST /token HTTP/1.1\nHost: server.example.com\nContent-Type: application/x-www-form-urlencoded\n\ngrant_type=authorization_code\u0026code=SplxlOBeZQQYbYS6WxSbIA\n\u0026redirect_uri=https%3A%2F%2Fclient%2Eexample%2Ecom%2Fcb\n\u0026client_id=s6BhdRkqt3\n\u0026code_verifier=dBjftJeZ4CVP-mB92K27uhbUJU1p1r_wW1gFWFOEjXk\n```\n\nСервер хешує verifier, порівнює результат із challenge, який зберіг поряд із\nкодом, і лише коли вони збіглися, повертає токени з позначкою, що забороняє\nкешам їх зберігати:\n\n```http\nHTTP/1.1 200 OK\nContent-Type: application/json;charset=UTF-8\nCache-Control: no-store\nPragma: no-cache\n\n{\n  \"access_token\":\"2YotnFZFEjr1zCsicMWpAA\",\n  \"token_type\":\"Bearer\",\n  \"expires_in\":3600,\n  \"refresh_token\":\"tGzv3JOkF0XG5Qx2TlKWIA\"\n}\n```\n\nДалі клієнт надсилає `Authorization: Bearer 2YotnFZFEjr1zCsicMWpAA` з кожним\nвикликом до API фотографій. За годину строк дії токена спливає, API відповідає\n`401 Unauthorized` з `error=\"invalid_token\"` у заголовку `WWW-Authenticate`, і\nклієнт витрачає токен оновлення, щоб отримати новий. Запит до чогось поза\nнаданим обсягом доступу натомість отримує `403 Forbidden` і\n`insufficient_scope`. Сам verifier захищає від використання перехопленого коду. Код,\nскопійований з пристрою під час передавання, не зможе обміняти ніхто, хто не\nмає verifier: саме проти такої атаки спочатку розробили PKCE. Сам verifier\nне надсилали ні в запиті на авторизацію, ні під час переспрямування браузера.\n\nТе саме делегування дає програмам змогу працювати з агентами. На сторінці сайту\nпро те, як\n[перетворити програми компанії на інструменти для ШІ-агентів](/uk/ai-tools/),\nсказано, що OAuth забезпечує делегований доступ: агент діє від імені\nкористувача без передавання пароля і лише в межах прав цього користувача.\n\n## Де виникають проблеми\n\n**Нестрога перевірка адреси переспрямування віддає код чужому.** Сервер\nавторизації, що приймає будь-який redirect URI, який починається із\nзареєстрованого префікса чи підпадає під шаблон із символом підстановки, можна\nзмусити доставити код на сторінку, яку контролює зловмисник. RFC 9700 вимагає,\nщоб сервери авторизації порівнювали URI переспрямування із зареєстрованими за\nточним збігом рядків, з одним винятком для номерів портів на localhost у\nнативних застосунках, і забороняє як клієнтам, так і серверам мати відкриті\nредиректори, що пересилають браузер на довільну адресу з параметра запиту.\n\n**Клієнт приймає відповідь, якої не запитував.** Якщо клієнт бере будь-який\nкод, що прийшов на його redirect URI, зловмисник може протиснути власний код\nчерез браузер жертви, і жертва працюватиме в обліковому записі зловмисника. Це\nпідробка міжсайтових запитів (cross-site request forgery), націлена на\nпереспрямування. Клієнт може покластися на захист PKCE, якщо переконався, що\nсервер підтримує PKCE; інакше він надсилає одноразове значення `state`,\nприв'язане до сесії браузера людини, і відхиляє відповідь, яка його не\nповертає.\n\n**Токени подорожують в URL.** Грант implicit кладе токен доступу просто в\nпереспрямування, звідки історія браузера й заголовки `Referer` можуть рознести\nйого туди, куди він не мав потрапити, і ніщо не прив'язує його до клієнта, який\nйого запитував. RFC 9700 каже, що клієнтам не слід ним користуватися, а проєкт\nOAuth 2.1 його взагалі не містить. Те саме стосується API, що приймає токен у\nпараметрі запиту: за RFC 6750 bearer-токени не слід передавати в URL сторінок.\nВикористовуйте грант authorization code і надсилайте токени в заголовку\n`Authorization`.\n\n**Застосунок однаково просить пароль.** Грант resource owner password\ncredentials дає клієнтові змогу зібрати ім'я користувача й пароль людини та\nобміняти їх на токен, що зводить нанівець саму причину існування OAuth. RFC 9700\nпрямо каже, що його не можна використовувати: він відкриває облікові дані\nклієнтові, привчає людей вводити пароль деінде, крім сервера авторизації, і\nніколи не був розрахований на двофакторну автентифікацію чи вхід у кілька\nкроків. Відправляйте людей на сервер авторизації через грант authorization\ncode, а коли людини немає взагалі, використовуйте client credentials.\n\n**Викрадений токен працює на того, хто його тримає.** RFC 6750 визначає\nbearer-токен як такий, яким може скористатися будь-яка сторона, що ним володіє,\nбез додаткового доказу. Тримайте токени доступу короткоживучими, обмежуйте\nкожен тим API, для якого його видано, а там, де ставки це виправдовують,\nприв'язуйте токени до клієнта через взаємний TLS (RFC 8705) або DPoP\n(RFC 9449). Токени оновлення для публічних клієнтів, як-от мобільних і\nбраузерних застосунків, мають бути або прив'язані до клієнта, або ротуватися:\nкожне оновлення повертає новий токен і анулює старий. Якщо викрадену копію теж\nпустили в хід, одна зі сторін рано чи пізно пред'явить анульований токен, сервер\nвідкличе чинний, і атака припиниться ціною того, що справжньому клієнтові\nдоведеться знову просити в людини дозвіл.\n\n## Що почитати далі\n\n- [RFC 6749: The OAuth 2.0 Authorization Framework](https://www.rfc-editor.org/rfc/rfc6749)\n  — чотири ролі, чотири типи грантів і кінцеві точки в тому вигляді, в якому їх\n  опубліковано в жовтні 2012 року.\n- [RFC 7636: Proof Key for Code Exchange by OAuth Public Clients](https://www.rfc-editor.org/rfc/rfc7636)\n  — code verifier і code challenge, з прикладом S256, використаним вище.\n- [RFC 9700: Best Current Practice for OAuth 2.0 Security](https://www.rfc-editor.org/rfc/rfc9700)\n  — рекомендації січня 2025 року: точне порівняння адрес переспрямування, PKCE\n  для кожного клієнта і відмова від грантів implicit і password.\n- [RFC 6750: Bearer Token Usage](https://www.rfc-editor.org/rfc/rfc6750) — як\n  клієнт пред'являє токен доступу і як API повідомляє, що токена немає, що він\n  прострочений або що його обсяг завузький.\n- [The OAuth 2.1 Authorization Framework](https://datatracker.ietf.org/doc/draft-ietf-oauth-v2-1/)\n  — проєкт робочої групи, що зводить ці документи в один, досі Internet-Draft у\n  жовтні 2026 року.\n\n\u003chttps://engineer.company/uk/glossary/oauth/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"Як OAuth дає застосунку діяти від імені користувача без його пароля: чотири ролі, обмін кодом із PKCE крок за кроком і п'ять типових причин витоку даних.","formats":{"gemtext":"https://engineer.company/uk/glossary/oauth/index.gmi","gopher":"https://engineer.company/uk/glossary/oauth/gophermap","html":"https://engineer.company/uk/glossary/oauth/","json":"https://engineer.company/uk/glossary/oauth/index.json","markdown":"https://engineer.company/uk/glossary/oauth/index.md","pdf":"https://engineer.company/uk/glossary/oauth/index.pdf"},"kind":"page","language":"uk","title":"Що таке OAuth?","url":"https://engineer.company/uk/glossary/oauth/","version":1}