{"id":479274,"date":"2026-05-11T06:45:10","date_gmt":"2026-05-11T06:45:10","guid":{"rendered":"https:\/\/savepearlharbor.com\/?p=479274"},"modified":"-0001-11-30T00:00:00","modified_gmt":"-0001-11-29T21:00:00","slug":"","status":"publish","type":"post","link":"https:\/\/savepearlharbor.com\/?p=479274","title":{"rendered":"\u041b\u043e\u0433\u0438\u043d \u0447\u0435\u0440\u0435\u0437 Telegram \u043f\u043e-\u043d\u043e\u0432\u043e\u043c\u0443: \u0440\u0430\u0437\u0431\u0438\u0440\u0430\u0435\u043c OIDC-\u0444\u043b\u043e\u0443 oauth.telegram.org \u0438 \u0441\u043e\u0431\u0438\u0440\u0430\u0435\u043c \u0435\u0433\u043e \u043d\u0430 Python"},"content":{"rendered":"<div xmlns=\"http:\/\/www.w3.org\/1999\/xhtml\">\n<p>\u042f \u043f\u0438\u043b\u0438\u043b \u043f\u0435\u0442-\u043f\u0440\u043e\u0435\u043a\u0442 \u2014 \u043d\u0435\u0431\u043e\u043b\u044c\u0448\u043e\u0439 \u0431\u044d\u043a\u0435\u043d\u0434 \u043d\u0430 Litestar \u2014 \u0438 \u0445\u043e\u0442\u0435\u043b \u043f\u0440\u0438\u043a\u0440\u0443\u0442\u0438\u0442\u044c \u043a \u043d\u0435\u043c\u0443 \u043b\u043e\u0433\u0438\u043d \u0447\u0435\u0440\u0435\u0437 Telegram. \u041e\u0442\u043a\u0440\u044b\u043b \u043f\u0435\u0440\u0432\u044b\u0439 \u043f\u043e\u043f\u0430\u0432\u0448\u0438\u0439\u0441\u044f \u0442\u0443\u0442\u043e\u0440\u0438\u0430\u043b \u043d\u0430 GitHub: HMAC \u043e\u0442 bot-token, <code>\/setdomain<\/code> \u0432 BotFather, \u0433\u043e\u043b\u044b\u0435 \u043f\u043e\u043b\u044f \u044e\u0437\u0435\u0440\u0430 \u0432 callback. \u041f\u043e\u0447\u0442\u0438 \u0432\u0441\u0451, \u0447\u0442\u043e \u044f \u043d\u0430\u0448\u0451\u043b, \u0431\u044b\u043b\u043e \u043f\u0440\u043e <strong>\u0441\u0442\u0430\u0440\u044b\u0439 \u0432\u0438\u0434\u0436\u0435\u0442<\/strong> <code>telegram.org\/js\/telegram-widget.js<\/code>.<\/p>\n<p>\u041e\u0442\u043a\u0440\u044b\u043b <a href=\"https:\/\/core.telegram.org\/bots\/telegram-login#openid-connect\" rel=\"noopener noreferrer nofollow\">\u043e\u0444\u0438\u0446\u0438\u0430\u043b\u044c\u043d\u0443\u044e \u0434\u043e\u043a\u0443<\/a> \u2014 \u0430 \u0442\u0430\u043c \u0443\u0436\u0435 \u043d\u0435 \u0432\u0438\u0434\u0436\u0435\u0442, \u0430 \u043f\u043e\u043b\u043d\u043e\u0446\u0435\u043d\u043d\u044b\u0439 OpenID Connect \u0447\u0435\u0440\u0435\u0437 <code>oauth.telegram.org<\/code>: JWKS, JWT, claims. \u0421\u0435\u043b \u0440\u0430\u0437\u0431\u0438\u0440\u0430\u0442\u044c\u0441\u044f. \u0412 \u0438\u0442\u043e\u0433\u0435 \u0441\u043e\u0431\u0440\u0430\u043b PoC \u2014 \u043e\u043d \u0443\u043c\u0435\u0435\u0442 \u043b\u043e\u0433\u0438\u043d\u0438\u0442\u044c \u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u0435\u043b\u044f \u0447\u0435\u0440\u0435\u0437 \u043d\u043e\u0432\u044b\u0439 OIDC, \u0434\u0435\u0440\u0436\u0438\u0442 cookie-\u0441\u0435\u0441\u0441\u0438\u044e \u0434\u043b\u044f HTML-\u0441\u0442\u0440\u0430\u043d\u0438\u0446 \u0438 \u043e\u0442\u0434\u0430\u0451\u0442 \u043f\u0430\u0440\u0443 <code>access<\/code> + <code>refresh<\/code> \u0442\u043e\u043a\u0435\u043d\u043e\u0432 \u0434\u043b\u044f JSON API.<\/p>\n<p>\u042d\u0442\u0430 \u0441\u0442\u0430\u0442\u044c\u044f \u2014 \u043f\u0435\u0440\u0435\u0441\u043a\u0430\u0437 \u0442\u043e\u0433\u043e, \u0447\u0442\u043e \u043c\u043d\u0435 \u0441\u0430\u043c\u043e\u043c\u0443 \u0445\u043e\u0442\u0435\u043b\u043e\u0441\u044c \u0431\u044b \u043f\u0440\u043e\u0447\u0438\u0442\u0430\u0442\u044c \u0432 \u043d\u0430\u0447\u0430\u043b\u0435: \u0433\u0434\u0435 \u0432 \u043f\u043e\u0442\u043e\u043a\u0435 \u0434\u0430\u043d\u043d\u044b\u0445 Telegram, \u0433\u0434\u0435 \u0431\u0440\u0430\u0443\u0437\u0435\u0440, \u0433\u0434\u0435 \u043d\u0430\u0448 \u0431\u044d\u043a, \u0438 \u043a\u0430\u043a\u0438\u0435 \u043a\u0443\u0441\u043a\u0438 \u043d\u0443\u0436\u043d\u043e \u0440\u0435\u0430\u043b\u044c\u043d\u043e \u043f\u0438\u0441\u0430\u0442\u044c \u0440\u0443\u043a\u0430\u043c\u0438. \u041f\u043e \u0445\u043e\u0434\u0443 \u2014 \u0442\u0443\u0442\u043e\u0440\u0438\u0430\u043b: \u043d\u0430\u0441\u0442\u0440\u043e\u0439\u043a\u0430 \u0431\u043e\u0442\u0430 \u0432 BotFather, \u043b\u043e\u043a\u0430\u043b\u044c\u043d\u044b\u0439 \u0442\u0435\u0441\u0442 \u0447\u0435\u0440\u0435\u0437 ngrok, \u0437\u0430\u043f\u0443\u0441\u043a.<\/p>\n<p>\u041a\u043e\u0434 \u043f\u0440\u0438\u043c\u0435\u0440\u043e\u0432 \u2014 \u0438\u0437 \u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u044f <a href=\"https:\/\/github.com\/andy-takker\/tg-auth\" rel=\"noopener noreferrer nofollow\">https:\/\/github.com\/andy-takker\/tg-auth<\/a>. \u0421\u0442\u0435\u043a: Python 3.13, Litestar, PyJWT, SQLAlchemy 2.0, aiosqlite. \u041d\u043e \u0441\u0430\u043c OIDC-\u0444\u043b\u043e\u0443 \u0441\u043e \u0441\u0442\u0435\u043a\u043e\u043c \u043d\u0435 \u0441\u0432\u044f\u0437\u0430\u043d \u2014 \u0442\u0435 \u0436\u0435 \u0448\u0430\u0433\u0438 \u043f\u043e\u0432\u0442\u043e\u0440\u044f\u044e\u0442\u0441\u044f \u043d\u0430 FastAPI, Django \u0438\u043b\u0438 \u0447\u0451\u043c \u0443\u0433\u043e\u0434\u043d\u043e \u0435\u0449\u0451.<\/p>\n<figure class=\"\"><img decoding=\"async\" src=\"https:\/\/habrastorage.org\/r\/w1560\/getpro\/habr\/\/post_images\/d75\/0a7\/1d9\/d750a71d916c5af7b0a0460fb2665122.jpg\" sizes=\"(max-width: 780px) 100vw, 50vw\" srcset=\"https:\/\/habrastorage.org\/r\/w780\/getpro\/habr\/\/post_images\/d75\/0a7\/1d9\/d750a71d916c5af7b0a0460fb2665122.jpg 780w,&#10;       https:\/\/habrastorage.org\/r\/w1560\/getpro\/habr\/\/post_images\/d75\/0a7\/1d9\/d750a71d916c5af7b0a0460fb2665122.jpg 781w\" loading=\"lazy\" decode=\"async\"\/><\/figure>\n<hr\/>\n<h3>\u0421\u0442\u0430\u0440\u044b\u0439 \u0432\u0438\u0434\u0436\u0435\u0442 \u2260 \u043d\u043e\u0432\u044b\u0439 OIDC<\/h3>\n<p>\u0415\u0441\u043b\u0438 \u0432\u044b \u043e\u0442\u043a\u0440\u044b\u0432\u0430\u043b\u0438 \u0441\u0442\u0430\u0440\u044b\u0435 \u0442\u0443\u0442\u043e\u0440\u0438\u0430\u043b\u044b \u043f\u0440\u043e Telegram Login \u2014 \u0437\u0430\u0431\u0443\u0434\u044c\u0442\u0435 \u0438\u0445 \u0441\u0440\u0430\u0437\u0443, \u043f\u043e\u0442\u043e\u043a\u0438 \u0440\u0430\u0437\u043d\u044b\u0435.<\/p>\n<p><strong>\u0421\u0442\u0430\u0440\u044b\u0439 \u0432\u0438\u0434\u0436\u0435\u0442<\/strong> (<code>telegram-widget.js<\/code>):<\/p>\n<ul>\n<li>\n<p>\u043a\u043d\u043e\u043f\u043a\u0430 \u0432\u0441\u0442\u0430\u0432\u043b\u044f\u0435\u0442\u0441\u044f \u043d\u0430 \u043b\u044e\u0431\u043e\u0439 <code>http:\/\/<\/code>-\u0441\u0430\u0439\u0442;<\/p>\n<\/li>\n<li>\n<p>Telegram \u0432\u043e\u0437\u0432\u0440\u0430\u0449\u0430\u0435\u0442 \u043f\u043e\u043b\u044f \u044e\u0437\u0435\u0440\u0430 \u043f\u0440\u044f\u043c\u043e \u0432 URL \u0438\u043b\u0438 \u0432 JS-callback;<\/p>\n<\/li>\n<li>\n<p>\u043f\u043e\u0434\u043b\u0438\u043d\u043d\u043e\u0441\u0442\u044c \u043f\u0440\u043e\u0432\u0435\u0440\u044f\u0435\u0442\u0441\u044f HMAC-SHA256 \u043e\u0442 \u0442\u043e\u043a\u0435\u043d\u0430 \u0431\u043e\u0442\u0430;<\/p>\n<\/li>\n<li>\n<p>\u0432 BotFather \u0432\u044b \u043f\u0440\u043e\u043f\u0438\u0441\u044b\u0432\u0430\u0435\u0442\u0435 \u0434\u043e\u043c\u0435\u043d \u0447\u0435\u0440\u0435\u0437 <code>\/setdomain<\/code>.<\/p>\n<\/li>\n<\/ul>\n<p>\u0415\u0441\u043b\u0438 \u0432 \u0442\u0443\u0442\u043e\u0440\u0438\u0430\u043b\u0435 \u0432\u0438\u0434\u0438\u0442\u0435 \u0447\u0442\u043e-\u0442\u043e \u0432\u0440\u043e\u0434\u0435 <code>hash = HMAC_SHA256(data_check_string, SHA256(bot_token))<\/code> \u0438 \u043f\u043e\u043b\u044f <code>id<\/code>, <code>first_name<\/code>, <code>auth_date<\/code>, <code>hash<\/code> \u2014 \u044d\u0442\u043e \u0438 \u0435\u0441\u0442\u044c legacy-\u0432\u0438\u0434\u0436\u0435\u0442, \u0437\u0430\u043a\u0440\u044b\u0432\u0430\u0439\u0442\u0435.<\/p>\n<p><strong>\u041d\u043e\u0432\u044b\u0439 OIDC-\u0444\u043b\u043e\u0443<\/strong> (<code>oauth.telegram.org<\/code>):<\/p>\n<ul>\n<li>\n<p>Telegram \u0441\u0442\u0430\u043b \u043f\u043e\u043b\u043d\u043e\u0446\u0435\u043d\u043d\u044b\u043c OpenID-\u043f\u0440\u043e\u0432\u0430\u0439\u0434\u0435\u0440\u043e\u043c;<\/p>\n<\/li>\n<li>\n<p>\u0435\u0441\u0442\u044c <code>\/.well-known\/openid-configuration<\/code>, \u0435\u0441\u0442\u044c JWKS;<\/p>\n<\/li>\n<li>\n<p>ID-\u0442\u043e\u043a\u0435\u043d \u2014 \u043d\u0430\u0441\u0442\u043e\u044f\u0449\u0438\u0439 JWT, \u043f\u043e\u0434\u043f\u0438\u0441\u0430\u043d\u043d\u044b\u0439 \u043f\u0443\u0431\u043b\u0438\u0447\u043d\u044b\u043c \u043a\u043b\u044e\u0447\u043e\u043c \u0438\u0437 JWKS Telegram;<\/p>\n<\/li>\n<li>\n<p>\u0431\u044d\u043a\u0435\u043d\u0434 \u043f\u0440\u043e\u0432\u0435\u0440\u044f\u0435\u0442 \u043f\u043e\u0434\u043f\u0438\u0441\u044c \u043f\u043e \u044d\u0442\u043e\u043c\u0443 \u043a\u043b\u044e\u0447\u0443, \u0430\u0443\u0434\u0438\u0442\u043e\u0440\u0438\u044e (<code>aud<\/code>), \u0438\u0437\u0434\u0430\u0442\u0435\u043b\u044f (<code>iss<\/code>), <code>exp<\/code>\/<code>iat<\/code>;<\/p>\n<\/li>\n<li>\n<p>bot-token \u043f\u0440\u0438 \u0430\u0432\u0442\u043e\u0440\u0438\u0437\u0430\u0446\u0438\u0438 <strong>\u043d\u0435 \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u0435\u0442\u0441\u044f<\/strong> \u2014 \u043e\u043d \u0442\u043e\u043b\u044c\u043a\u043e \u0434\u043b\u044f Bot API. \u041d\u0435 \u043f\u0443\u0442\u0430\u0442\u044c \u0435\u0433\u043e \u0441 <strong>Client Secret<\/strong>: BotFather \u0432 Web Login \u0432\u044b\u0434\u0430\u0451\u0442 \u043f\u0430\u0440\u0443 Client ID + Client Secret, \u0438 Client Secret \u043d\u0443\u0436\u0435\u043d \u0434\u043b\u044f manual OIDC code flow. \u0412 popup-\u0432\u0430\u0440\u0438\u0430\u043d\u0442\u0435 \u0431\u044d\u043a \u0435\u0433\u043e \u043d\u0435 \u0432\u0438\u0434\u0438\u0442, \u043d\u043e \u0432 \u043f\u043e\u043b\u043d\u043e\u043c flow \u043e\u043d \u0435\u0441\u0442\u044c.<\/p>\n<\/li>\n<\/ul>\n<p>\u041f\u043e\u043b\u044c\u0437\u0430 \u043e\u0442 \u043f\u0435\u0440\u0435\u0445\u043e\u0434\u0430 \u2014 \u0441\u0442\u0430\u043d\u0434\u0430\u0440\u0442\u043d\u044b\u0439 \u043f\u0440\u043e\u0442\u043e\u043a\u043e\u043b, \u043d\u0438\u043a\u0430\u043a\u043e\u0439 \u0440\u0443\u0447\u043d\u043e\u0439 HMAC-\u043f\u0440\u043e\u0432\u0435\u0440\u043a\u0438 legacy-\u043f\u043e\u043b\u0435\u0439 \u0438 \u0441\u043e\u0432\u043c\u0435\u0441\u0442\u0438\u043c\u043e\u0441\u0442\u044c \u0441 \u043b\u044e\u0431\u043e\u0439 OIDC-\u0431\u0438\u0431\u043b\u0438\u043e\u0442\u0435\u043a\u043e\u0439. \u0426\u0435\u043d\u0430 \u2014 \u0434\u0440\u0443\u0433\u043e\u0439 \u043d\u0430\u0431\u043e\u0440 \u043d\u0430\u0441\u0442\u0440\u043e\u0435\u043a \u0432 BotFather \u0438 \u043e\u0431\u044f\u0437\u0430\u0442\u0435\u043b\u044c\u043d\u044b\u0439 HTTPS \u043d\u0430 origin\u2019\u0435.<\/p>\n<p>\u0415\u0449\u0451 \u043e\u0434\u0438\u043d \u043d\u044e\u0430\u043d\u0441, \u043d\u0430 \u043a\u043e\u0442\u043e\u0440\u044b\u0439 \u044f \u043d\u0435 \u0441\u0440\u0430\u0437\u0443 \u043e\u0431\u0440\u0430\u0442\u0438\u043b \u0432\u043d\u0438\u043c\u0430\u043d\u0438\u0435. \u0423 \u043d\u043e\u0432\u043e\u0433\u043e Telegram Login \u043d\u0430 \u0441\u0430\u043c\u043e\u043c \u0434\u0435\u043b\u0435 <strong>\u0434\u0432\u0430 \u0440\u0435\u0436\u0438\u043c\u0430<\/strong>:<\/p>\n<ol>\n<li>\n<p><strong>Login library<\/strong> \u2014 \u0431\u0440\u0430\u0443\u0437\u0435\u0440\u043d\u044b\u0439 popup \u0447\u0435\u0440\u0435\u0437 <code>telegram-login.js<\/code>. Telegram \u0432\u043d\u0443\u0442\u0440\u0438 popup-\u0430 \u0441\u0430\u043c \u0434\u0435\u043b\u0430\u0435\u0442 Authorization Code Flow \u0441 PKCE \u0438 \u0432\u043e\u0437\u0432\u0440\u0430\u0449\u0430\u0435\u0442 \u043d\u0430\u043c \u0443\u0436\u0435 \u0433\u043e\u0442\u043e\u0432\u044b\u0439 <code>id_token<\/code> \u0447\u0435\u0440\u0435\u0437 <code>postMessage<\/code>. \u0411\u044d\u043a \u0442\u043e\u043b\u044c\u043a\u043e \u043f\u0440\u043e\u0432\u0435\u0440\u044f\u0435\u0442 JWT \u2014 \u043d\u0438\u043a\u0430\u043a\u043e\u0433\u043e Client Secret, \u043d\u0438\u043a\u0430\u043a\u043e\u0433\u043e PKCE \u043d\u0430 \u043d\u0430\u0448\u0435\u0439 \u0441\u0442\u043e\u0440\u043e\u043d\u0435.<\/p>\n<\/li>\n<li>\n<p><strong>Manual OIDC<\/strong> \u2014 \u043e\u0431\u044b\u0447\u043d\u044b\u0439 Authorization Code Flow: \u0432\u044b \u0441\u0430\u043c\u0438 \u0440\u0435\u0434\u0438\u0440\u0435\u043a\u0442\u0438\u0442\u0435 \u044e\u0437\u0435\u0440\u0430 \u043d\u0430 <code>oauth.telegram.org\/auth<\/code>, \u043b\u043e\u0432\u0438\u0442\u0435 <code>code<\/code> \u0432 \u0441\u0432\u043e\u0451\u043c callback\u2019\u0435 \u0438 \u043c\u0435\u043d\u044f\u0435\u0442\u0435 \u0435\u0433\u043e \u043d\u0430 \u0442\u043e\u043a\u0435\u043d\u044b \u0447\u0435\u0440\u0435\u0437 <code>\/token<\/code> (Basic Auth \u0441 Client ID + Client Secret).<\/p>\n<\/li>\n<\/ol>\n<p>\u0412 \u044d\u0442\u043e\u0439 \u0441\u0442\u0430\u0442\u044c\u0435 \u2014 \u043f\u0435\u0440\u0432\u044b\u0439 \u0432\u0430\u0440\u0438\u0430\u043d\u0442. \u041e\u043d \u043f\u0440\u043e\u0449\u0435 \u0438 \u0434\u043b\u044f \u0442\u0438\u043f\u043e\u0432\u043e\u0433\u043e \u0432\u0435\u0431\u0430 \u0435\u0433\u043e \u0434\u043e\u0441\u0442\u0430\u0442\u043e\u0447\u043d\u043e. Manual flow \u043d\u0443\u0436\u0435\u043d, \u0435\u0441\u043b\u0438 \u0443 \u0432\u0430\u0441 \u043d\u0430\u0442\u0438\u0432\u043d\u044b\u0439 \u043a\u043b\u0438\u0435\u043d\u0442 \u0431\u0435\u0437 \u0431\u0440\u0430\u0443\u0437\u0435\u0440\u0430 \u0438\u043b\u0438 \u0445\u043e\u0447\u0435\u0442\u0441\u044f \u0434\u0435\u0440\u0436\u0430\u0442\u044c \u0432\u0435\u0441\u044c OAuth-\u043e\u0431\u043c\u0435\u043d \u0432 \u0441\u0432\u043e\u0438\u0445 \u0440\u0443\u043a\u0430\u0445.<\/p>\n<hr\/>\n<h3>\u0427\u0442\u043e \u043c\u044b \u0441\u043e\u0431\u0435\u0440\u0451\u043c<\/h3>\n<p>\u041c\u0438\u043d\u0438\u043c\u0430\u043b\u044c\u043d\u044b\u0439 \u043d\u0430\u0431\u043e\u0440 \u043c\u0430\u0440\u0448\u0440\u0443\u0442\u043e\u0432:<\/p>\n<div>\n<div class=\"table\">\n<table>\n<tbody>\n<tr>\n<th>\n<p align=\"left\">\u041c\u0435\u0442\u043e\u0434<\/p>\n<\/th>\n<th>\n<p align=\"left\">\u041f\u0443\u0442\u044c<\/p>\n<\/th>\n<th>\n<p align=\"left\">\u0417\u0430\u0447\u0435\u043c<\/p>\n<\/th>\n<\/tr>\n<tr>\n<td>\n<p align=\"left\"><code>GET<\/code><\/p>\n<\/td>\n<td>\n<p align=\"left\"><code>\/<\/code><\/p>\n<\/td>\n<td>\n<p align=\"left\">\u0421\u0442\u0440\u0430\u043d\u0438\u0446\u0430 \u043b\u043e\u0433\u0438\u043d\u0430 \u0441 \u0432\u0438\u0434\u0436\u0435\u0442\u043e\u043c Telegram<\/p>\n<\/td>\n<\/tr>\n<tr>\n<td>\n<p align=\"left\"><code>POST<\/code><\/p>\n<\/td>\n<td>\n<p align=\"left\"><code>\/api\/v1\/auth\/telegram<\/code><\/p>\n<\/td>\n<td>\n<p align=\"left\">\u041f\u0440\u0438\u043d\u0438\u043c\u0430\u0435\u0442 <code>id_token<\/code>, \u0432\u0430\u043b\u0438\u0434\u0438\u0440\u0443\u0435\u0442, \u0430\u043f\u0441\u0435\u0440\u0442\u0438\u0442 \u044e\u0437\u0435\u0440\u0430, \u0441\u0442\u0430\u0432\u0438\u0442 cookie + \u043e\u0442\u0434\u0430\u0451\u0442 <code>access<\/code>\/<code>refresh<\/code><\/p>\n<\/td>\n<\/tr>\n<tr>\n<td>\n<p align=\"left\"><code>POST<\/code><\/p>\n<\/td>\n<td>\n<p align=\"left\"><code>\/api\/v1\/auth\/refresh<\/code><\/p>\n<\/td>\n<td>\n<p align=\"left\">\u041c\u0435\u043d\u044f\u0435\u0442 refresh \u043d\u0430 \u043d\u043e\u0432\u0443\u044e \u043f\u0430\u0440\u0443<\/p>\n<\/td>\n<\/tr>\n<tr>\n<td>\n<p align=\"left\"><code>POST<\/code><\/p>\n<\/td>\n<td>\n<p align=\"left\"><code>\/api\/v1\/auth\/logout<\/code><\/p>\n<\/td>\n<td>\n<p align=\"left\">\u0427\u0438\u0441\u0442\u0438\u0442 cookie<\/p>\n<\/td>\n<\/tr>\n<tr>\n<td>\n<p align=\"left\"><code>GET<\/code><\/p>\n<\/td>\n<td>\n<p align=\"left\"><code>\/app<\/code><\/p>\n<\/td>\n<td>\n<p align=\"left\">\u0417\u0430\u0449\u0438\u0449\u0451\u043d\u043d\u0430\u044f HTML-\u0441\u0442\u0440\u0430\u043d\u0438\u0446\u0430, \u0447\u0438\u0442\u0430\u0435\u0442 \u044e\u0437\u0435\u0440\u0430 \u043f\u043e cookie<\/p>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n<\/div>\n<p>Cookie-\u0441\u0435\u0441\u0441\u0438\u044f \u043d\u0443\u0436\u043d\u0430, \u0447\u0442\u043e\u0431\u044b HTML-\u0441\u0442\u0440\u0430\u043d\u0438\u0446\u044b \u00ab\u043f\u043e\u043c\u043d\u0438\u043b\u0438\u00bb \u044e\u0437\u0435\u0440\u0430 \u043c\u0435\u0436\u0434\u0443 \u0437\u0430\u043f\u0440\u043e\u0441\u0430\u043c\u0438. JWT-\u043f\u0430\u0440\u0430 \u2014 \u0434\u043b\u044f JSON API (\u043c\u043e\u0431\u0438\u043b\u043a\u0430\/SPA). \u041e\u0434\u0438\u043d \u043b\u043e\u0433\u0438\u043d \u0432\u044b\u0434\u0430\u0451\u0442 \u0441\u0440\u0430\u0437\u0443 \u043e\u0431\u0435 \u0432\u0435\u0449\u0438.<\/p>\n<blockquote>\n<p>\u26a0\ufe0f \u041f\u0440\u043e \u0441\u0430\u043c\u0438 JWT-\u0442\u043e\u043a\u0435\u043d\u044b \u0433\u043b\u0443\u0431\u043e\u043a\u043e \u043b\u0435\u0437\u0442\u044c \u0437\u0434\u0435\u0441\u044c \u043d\u0435 \u0431\u0443\u0434\u0443 \u2014 \u0432 PoC \u044d\u0442\u043e \u043f\u0440\u043e\u0441\u0442\u043e HS256 \u0431\u0435\u0437 \u0445\u0440\u0430\u043d\u0435\u043d\u0438\u044f \u0432 \u0411\u0414. \u041f\u043e\u043b\u043d\u043e\u0446\u0435\u043d\u043d\u044b\u0439 refresh-\u0444\u043b\u043e\u0443 \u0441 \u043e\u0434\u043d\u043e\u0440\u0430\u0437\u043e\u0432\u043e\u0441\u0442\u044c\u044e, family_id \u0438 \u043e\u0442\u0441\u043b\u0435\u0436\u0438\u0432\u0430\u043d\u0438\u0435\u043c \u0441\u0435\u0441\u0441\u0438\u0439 \u2014 \u0442\u0435\u043c\u0430 \u0431\u043e\u043b\u044c\u0448\u0430\u044f \u0438 \u0437\u0430\u0441\u043b\u0443\u0436\u0438\u0432\u0430\u0435\u0442 \u043e\u0442\u0434\u0435\u043b\u044c\u043d\u043e\u0439 \u0441\u0442\u0430\u0442\u044c\u0438. \u0417\u0434\u0435\u0441\u044c \u0443\u043f\u043e\u0440 \u043d\u0430 \u0441\u0430\u043c OIDC-\u043e\u0431\u043c\u0435\u043d.<\/p>\n<\/blockquote>\n<hr\/>\n<h3>\u041a\u0430\u0440\u0442\u0438\u043d\u043a\u0430 \u0446\u0435\u043b\u0438\u043a\u043e\u043c: \u043a\u0442\u043e \u0441 \u043a\u0435\u043c \u043e\u0431\u0449\u0430\u0435\u0442\u0441\u044f<\/h3>\n<p>\u041f\u0440\u0435\u0436\u0434\u0435 \u0447\u0435\u043c \u043d\u044b\u0440\u044f\u0442\u044c \u0432 \u043a\u043e\u0434, \u0443\u0434\u043e\u0431\u043d\u043e \u0434\u0435\u0440\u0436\u0430\u0442\u044c \u0432 \u0433\u043e\u043b\u043e\u0432\u0435 \u0440\u043e\u043b\u0435\u0432\u0443\u044e \u0441\u0445\u0435\u043c\u0443. \u0412\u043e\u0442 \u043a\u0442\u043e \u0443\u0447\u0430\u0441\u0442\u0432\u0443\u0435\u0442 \u0438 \u0437\u0430 \u0447\u0442\u043e \u043e\u0442\u0432\u0435\u0447\u0430\u0435\u0442:<\/p>\n<figure class=\"\"><img decoding=\"async\" src=\"https:\/\/habrastorage.org\/getpro\/habr\/\/post_images\/b3d\/15c\/465\/b3d15c4656cd5b74c9ff71274a83c969.svg\" sizes=\"(max-width: 780px) 100vw, 50vw\" srcset=\"https:\/\/habrastorage.org\/getpro\/habr\/\/post_images\/b3d\/15c\/465\/b3d15c4656cd5b74c9ff71274a83c969.svg 780w,&#10;       https:\/\/habrastorage.org\/getpro\/habr\/\/post_images\/b3d\/15c\/465\/b3d15c4656cd5b74c9ff71274a83c969.svg 781w\" loading=\"lazy\" decode=\"async\"\/><\/figure>\n<p>\u0413\u043b\u0430\u0432\u043d\u043e\u0435, \u0447\u0442\u043e \u0441\u0442\u043e\u0438\u0442 \u0443\u0432\u0438\u0434\u0435\u0442\u044c \u043d\u0430 \u044d\u0442\u043e\u0439 \u0441\u0445\u0435\u043c\u0435: <strong>\u043f\u043e\u043b\u043d\u044b\u0439 OAuth-\u043e\u0431\u043c\u0435\u043d <\/strong><code><strong>\/auth<\/strong><\/code><strong> \u2192 <\/strong><code><strong>\/token<\/strong><\/code><strong> \u043f\u0440\u043e\u0438\u0441\u0445\u043e\u0434\u0438\u0442 \u0432\u043d\u0443\u0442\u0440\u0438 popup-\u0430 Telegram<\/strong>. \u0411\u044d\u043a\u0435\u043d\u0434 \u043d\u0435 \u0434\u0435\u043b\u0430\u0435\u0442 \u043d\u0438 \u043e\u0434\u043d\u043e\u0433\u043e \u0437\u0430\u043f\u0440\u043e\u0441\u0430 \u043a <code>oauth.telegram.org\/token<\/code>, \u043d\u0435 \u0445\u0440\u0430\u043d\u0438\u0442 Client Secret, \u043d\u0435 \u0432\u043e\u0437\u0438\u0442\u0441\u044f \u0441 PKCE \u0438 redirect URI. \u041f\u043e\u043b\u0443\u0447\u0430\u0435\u0442 \u0443\u0436\u0435 \u0433\u043e\u0442\u043e\u0432\u044b\u0439 <code>id_token<\/code>, \u0438 \u0435\u0433\u043e \u043e\u0441\u0442\u0430\u0451\u0442\u0441\u044f \u0442\u043e\u043b\u044c\u043a\u043e \u043f\u0440\u043e\u0432\u0435\u0440\u0438\u0442\u044c.<\/p>\n<hr\/>\n<h3>\u0427\u0442\u043e \u043f\u0440\u043e\u0438\u0441\u0445\u043e\u0434\u0438\u0442 \u043f\u0440\u0438 \u043f\u0435\u0440\u0432\u043e\u043c \u043b\u043e\u0433\u0438\u043d\u0435: \u043f\u043e\u0448\u0430\u0433\u043e\u0432\u043e<\/h3>\n<p>\u0413\u043b\u0430\u0432\u043d\u0430\u044f sequence-\u0434\u0438\u0430\u0433\u0440\u0430\u043c\u043c\u0430 \u0441\u0442\u0430\u0442\u044c\u0438. \u041f\u043e\u0434\u0440\u043e\u0431\u043d\u043e \u2014 \u0447\u0442\u043e \u0438 \u0432 \u043a\u0430\u043a\u043e\u043c \u043f\u043e\u0440\u044f\u0434\u043a\u0435 \u043b\u0435\u0442\u0430\u0435\u0442 \u043f\u043e \u0441\u0435\u0442\u0438.<\/p>\n<figure class=\"\"><img decoding=\"async\" src=\"https:\/\/habrastorage.org\/getpro\/habr\/\/post_images\/cab\/c08\/b1f\/cabc08b1f9c19b9a7466c0e8aec03e81.svg\" sizes=\"(max-width: 780px) 100vw, 50vw\" srcset=\"https:\/\/habrastorage.org\/getpro\/habr\/\/post_images\/cab\/c08\/b1f\/cabc08b1f9c19b9a7466c0e8aec03e81.svg 780w,&#10;       https:\/\/habrastorage.org\/getpro\/habr\/\/post_images\/cab\/c08\/b1f\/cabc08b1f9c19b9a7466c0e8aec03e81.svg 781w\" loading=\"lazy\" decode=\"async\"\/><\/figure>\n<p>\u0427\u0442\u043e \u0437\u0434\u0435\u0441\u044c \u0432\u0430\u0436\u043d\u043e:<\/p>\n<p><strong>1. <\/strong><code><strong>id_token<\/strong><\/code><strong> \u043a \u043d\u0430\u043c \u043f\u0440\u0438\u0445\u043e\u0434\u0438\u0442 \u0447\u0435\u0440\u0435\u0437 <\/strong><code><strong>postMessage<\/strong><\/code><strong>, \u0430 \u043d\u0435 \u0447\u0435\u0440\u0435\u0437 redirect.<\/strong> \u041d\u0438\u043a\u0430\u043a\u0438\u0445 <code>?code=...<\/code> \u0432 URL, \u043d\u0438\u043a\u0430\u043a\u043e\u0433\u043e \u0440\u0435\u0434\u0438\u0440\u0435\u043a\u0442\u0430 \u043d\u0430 <code>\/callback<\/code>. Telegram-popup \u0432\u043d\u0443\u0442\u0440\u0438 \u0441\u0435\u0431\u044f \u043f\u0440\u043e\u0432\u043e\u0434\u0438\u0442 \u043f\u043e\u043b\u043d\u0443\u044e OAuth-\u0430\u0432\u0442\u043e\u0440\u0438\u0437\u0430\u0446\u0438\u044e \u0438 \u043e\u0442\u0434\u0430\u0451\u0442 \u043d\u0430\u043c \u0443\u0436\u0435 \u043f\u043e\u0434\u043f\u0438\u0441\u0430\u043d\u043d\u044b\u0439 JWT \u0447\u0435\u0440\u0435\u0437 <code>window.postMessage<\/code>. HTTPS \u043d\u0430 origin\u2019\u0435 \u043d\u0443\u0436\u0435\u043d \u043d\u0435 \u0438\u0437-\u0437\u0430 <code>postMessage<\/code> (\u043e\u043d \u043a\u0430\u043a \u0440\u0430\u0437 \u0434\u043b\u044f cross-origin \u043e\u0431\u0449\u0435\u043d\u0438\u044f \u0438 \u0441\u0434\u0435\u043b\u0430\u043d), \u0430 \u043f\u043e\u0442\u043e\u043c\u0443 \u0447\u0442\u043e Telegram \u043f\u0443\u0441\u043a\u0430\u0435\u0442 \u0432 Trusted Origins \u0442\u043e\u043b\u044c\u043a\u043e HTTPS-\u0441\u0445\u0435\u043c\u044b.<\/p>\n<p><strong>2. JWKS \u2014 \u044d\u0442\u043e \u043f\u0443\u0431\u043b\u0438\u0447\u043d\u044b\u0435 \u043a\u043b\u044e\u0447\u0438, \u043f\u043e \u043a\u043e\u0442\u043e\u0440\u044b\u043c \u043c\u044b \u043f\u0440\u043e\u0432\u0435\u0440\u044f\u0435\u043c \u043f\u043e\u0434\u043f\u0438\u0441\u044c JWT.<\/strong> \u041c\u044b \u0438\u0445 \u0437\u0430\u0431\u0438\u0440\u0430\u0435\u043c \u043e\u0434\u0438\u043d \u0440\u0430\u0437 \u0438 \u043a\u044d\u0448\u0438\u0440\u0443\u0435\u043c. <code>PyJWKClient<\/code> \u0438\u0437 <code>pyjwt<\/code> \u044d\u0442\u043e \u0443\u043c\u0435\u0435\u0442 \u0438\u0437 \u043a\u043e\u0440\u043e\u0431\u043a\u0438:<\/p>\n<pre><code class=\"python\">from jwt import PyJWKClientjwks_client = PyJWKClient(    \"https:\/\/oauth.telegram.org\/.well-known\/jwks.json\",    cache_keys=True,    lifespan=600,  # 10 \u043c\u0438\u043d\u0443\u0442)<\/code><div class=\"code-explainer\"><a href=\"https:\/\/sourcecraft.dev\/\" class=\"tm-button code-explainer__link\" style=\"visibility: hidden;\"><img style=\"width:87px;height:14px;object-fit:cover;object-position:left;\"\/><\/a><\/div><\/pre>\n<p>\u0412 \u043c\u043e\u0451\u043c \u043f\u0440\u0438\u043b\u043e\u0436\u0435\u043d\u0438\u0438 \u044d\u0442\u043e\u0442 \u043a\u043b\u0438\u0435\u043d\u0442 \u0441\u043e\u0437\u0434\u0430\u0451\u0442\u0441\u044f \u043e\u0434\u0438\u043d \u0440\u0430\u0437 \u043f\u0440\u0438 \u0441\u0442\u0430\u0440\u0442\u0435 \u0438 \u0438\u043d\u0436\u0435\u043a\u0442\u0438\u0442\u0441\u044f \u0432 use-case \u0447\u0435\u0440\u0435\u0437 DI.<\/p>\n<p><strong>3. \u0421\u0430\u043c\u0430 \u0432\u0430\u043b\u0438\u0434\u0430\u0446\u0438\u044f \u2014 \u044d\u0442\u043e \u043e\u0434\u0438\u043d \u0432\u044b\u0437\u043e\u0432 <\/strong><code><strong>jwt.decode<\/strong><\/code><strong> \u0441 \u043f\u0440\u0430\u0432\u0438\u043b\u044c\u043d\u044b\u043c\u0438 \u043f\u0430\u0440\u0430\u043c\u0435\u0442\u0440\u0430\u043c\u0438.<\/strong> \u041d\u0438\u043a\u0430\u043a\u043e\u0433\u043e \u0440\u0443\u0447\u043d\u043e\u0433\u043e HMAC-\u0430, \u043d\u0438\u043a\u0430\u043a\u0438\u0445 \u0441\u0440\u0430\u0432\u043d\u0435\u043d\u0438\u0439 \u0441\u0442\u0440\u043e\u043a:<\/p>\n<pre><code class=\"python\">def _verify_telegram_id_token(id_token: str, jwks_client, client_id, issuer):    if not id_token:        raise ValueError(\"Empty id_token\")    signing_key = jwks_client.get_signing_key_from_jwt(id_token).key    return jwt.decode(        id_token,        signing_key,        algorithms=[\"RS256\", \"ES256\"],        audience=client_id,                       # \u0432\u0430\u0448 Client ID \u0438\u0437 BotFather        issuer=issuer,                            # \"https:\/\/oauth.telegram.org\"        options={\"require\": [\"iss\", \"aud\", \"exp\", \"iat\", \"sub\"]},        leeway=30,                                # \u043d\u0430 \u0440\u0430\u0441\u0441\u0438\u043d\u0445\u0440\u043e\u043d \u0447\u0430\u0441\u043e\u0432    )<\/code><div class=\"code-explainer\"><a href=\"https:\/\/sourcecraft.dev\/\" class=\"tm-button code-explainer__link\" style=\"visibility: hidden;\"><img style=\"width:14px;height:14px;object-fit:cover;object-position:left;\"\/><\/a><\/div><\/pre>\n<p>\u0415\u0441\u043b\u0438 \u0445\u043e\u0442\u044c \u0447\u0442\u043e-\u0442\u043e \u043d\u0435 \u0441\u043e\u0448\u043b\u043e\u0441\u044c \u2014 \u043f\u043e\u0434\u043f\u0438\u0441\u044c, audience, \u0438\u0441\u0442\u0451\u043a\u0448\u0438\u0439 \u0441\u0440\u043e\u043a \u2014 <code>jwt.decode<\/code> \u0431\u0440\u043e\u0441\u0438\u0442 \u0438\u0441\u043a\u043b\u044e\u0447\u0435\u043d\u0438\u0435, \u043c\u044b \u043f\u0435\u0440\u0435\u0432\u043e\u0434\u0438\u043c \u0435\u0433\u043e \u0432 <code>401<\/code>. \u0412\u0441\u0451.<\/p>\n<p>\u0422\u0443\u0442 \u0443\u043c\u0435\u0441\u0442\u043d\u0430\u044f \u043e\u0433\u043e\u0432\u043e\u0440\u043a\u0430. \u0412 \u043a\u043e\u043c\u043c\u0435\u043d\u0442\u0430\u0440\u0438\u044f\u0445 \u043e\u0431\u044f\u0437\u0430\u0442\u0435\u043b\u044c\u043d\u043e \u0441\u043f\u0440\u043e\u0441\u044f\u0442: \u00ab\u0437\u0430\u0447\u0435\u043c \u0440\u0443\u043a\u0430\u043c\u0438 \u0447\u0435\u0440\u0435\u0437 PyJWT, \u043a\u043e\u0433\u0434\u0430 \u0435\u0441\u0442\u044c <a href=\"https:\/\/github.com\/authlib\/authlib\" rel=\"noopener noreferrer nofollow\">authlib<\/a>?\u00bb. \u0418 \u0434\u0430, \u0434\u043b\u044f \u043f\u0440\u043e\u0434\u0430 authlib \u0447\u0430\u0441\u0442\u043e \u043f\u0440\u0430\u0432\u0438\u043b\u044c\u043d\u044b\u0439 \u0432\u044b\u0431\u043e\u0440 \u2014 \u0443\u043c\u0435\u0435\u0442 \u043f\u043e\u043b\u043d\u043e\u0446\u0435\u043d\u043d\u044b\u0439 OAuth\/OIDC-\u043a\u043b\u0438\u0435\u043d\u0442 \u0441 \u043e\u0431\u043c\u0435\u043d\u043e\u043c <code>code \u2192 token<\/code>, \u043a\u044d\u0448\u0438\u0440\u0443\u0435\u0442 JWKS, \u043f\u0440\u043e\u0432\u0435\u0440\u044f\u0435\u0442 <code>nonce<\/code>, \u0434\u0440\u0443\u0436\u0438\u0442 \u0441\u043e Starlette\/FastAPI\/Flask\/Django. \u0415\u0441\u043b\u0438 \u0443 \u0432\u0430\u0441 \u0432 \u043f\u0440\u043e\u0435\u043a\u0442\u0435 \u0443\u0436\u0435 \u043d\u0435 \u043e\u0434\u0438\u043d OIDC-\u043f\u0440\u043e\u0432\u0430\u0439\u0434\u0435\u0440 \u0438\u043b\u0438 \u043f\u043b\u0430\u043d\u0438\u0440\u0443\u0435\u0442\u0441\u044f manual code flow \u0441 PKCE \u2014 \u0431\u0435\u0440\u0438\u0442\u0435 authlib, \u043d\u0435 \u043f\u0438\u0448\u0438\u0442\u0435 \u044d\u0442\u043e \u0440\u0443\u043a\u0430\u043c\u0438. \u0417\u0434\u0435\u0441\u044c \u044f \u0441\u043e\u0437\u043d\u0430\u0442\u0435\u043b\u044c\u043d\u043e \u043f\u043e\u0448\u0451\u043b \u0433\u043e\u043b\u044b\u043c PyJWT, \u0447\u0442\u043e\u0431\u044b \u0431\u044b\u043b\u043e \u0432\u0438\u0434\u043d\u043e, \u043a\u0430\u043a\u0438\u0435 \u0438\u043c\u0435\u043d\u043d\u043e claim\u2019\u044b \u0438 \u043a\u0430\u043a\u0438\u0435 \u043f\u0440\u043e\u0432\u0435\u0440\u043a\u0438 \u043f\u0440\u043e\u0438\u0441\u0445\u043e\u0434\u044f\u0442 \u2014 \u0438 \u043a\u0430\u043a\u0438\u0435 \u0438\u0437 \u043d\u0438\u0445 Telegram-\u0441\u043f\u0435\u0446\u0438\u0444\u0438\u0447\u043d\u044b\u0435 (\u043d\u0438\u043a\u0430\u043a\u0438\u0445).<\/p>\n<p>\u041e\u0434\u0438\u043d \u0432\u0430\u0436\u043d\u044b\u0439 \u043f\u0443\u043d\u043a\u0442, \u043a\u043e\u0442\u043e\u0440\u044b\u0439 \u0432 \u043c\u043e\u0451\u043c PoC \u043d\u0435 \u0440\u0435\u0430\u043b\u0438\u0437\u043e\u0432\u0430\u043d \u2014 \u043f\u0440\u043e\u0432\u0435\u0440\u043a\u0430 <code>nonce<\/code>. \u0412 \u043f\u0440\u043e\u0434\u0435 \u044d\u0442\u043e \u0434\u0435\u043b\u0430\u0435\u0442\u0441\u044f \u0442\u0430\u043a: \u0441\u0435\u0440\u0432\u0435\u0440 \u043f\u0435\u0440\u0435\u0434 \u043e\u0442\u043a\u0440\u044b\u0442\u0438\u0435\u043c popup-\u0430 \u0433\u0435\u043d\u0435\u0440\u0438\u0440\u0443\u0435\u0442 \u0441\u043b\u0443\u0447\u0430\u0439\u043d\u043e\u0435 \u0437\u043d\u0430\u0447\u0435\u043d\u0438\u0435, \u043a\u043b\u0430\u0434\u0451\u0442 \u0435\u0433\u043e \u0432 \u0441\u0432\u043e\u044e \u0441\u0435\u0441\u0441\u0438\u044e, \u043f\u0435\u0440\u0435\u0434\u0430\u0451\u0442 \u0432 <code>Telegram.Login.init(...)<\/code>, \u0430 \u043f\u043e\u0441\u043b\u0435 \u0432\u0430\u043b\u0438\u0434\u0430\u0446\u0438\u0438 <code>id_token<\/code> \u0441\u0432\u0435\u0440\u044f\u0435\u0442 claim <code>nonce<\/code> \u0441 \u0442\u0435\u043c, \u0447\u0442\u043e \u043b\u0435\u0436\u0438\u0442 \u0432 \u0441\u0435\u0441\u0441\u0438\u0438. \u042d\u0442\u043e \u0437\u0430\u0449\u0438\u0442\u0430 \u043e\u0442 replay: \u043f\u0435\u0440\u0435\u0445\u0432\u0430\u0447\u0435\u043d\u043d\u044b\u0439 \u043a\u043e\u0433\u0434\u0430-\u0442\u043e <code>id_token<\/code> \u043d\u0435 \u0441\u0440\u0430\u0431\u043e\u0442\u0430\u0435\u0442 \u043f\u043e\u0432\u0442\u043e\u0440\u043d\u043e. \u0415\u0441\u043b\u0438 \u0434\u0435\u043b\u0430\u0435\u0442\u0435 \u043f\u0440\u043e\u0434 \u2014 \u0434\u043e\u0431\u0430\u0432\u044c\u0442\u0435 \u0432 <code>options.require<\/code> \u0441\u0442\u0440\u043e\u043a\u0443 <code>\"nonce\"<\/code> \u0438 \u0441\u0440\u0430\u0432\u043d\u0438\u0432\u0430\u0439\u0442\u0435.<\/p>\n<p><strong>4. \u041f\u043e\u0441\u043b\u0435 \u0432\u0430\u043b\u0438\u0434\u0430\u0446\u0438\u0438 \u2014 \u0434\u0435\u043b\u0430\u0435\u043c upsert \u044e\u0437\u0435\u0440\u0430.<\/strong> \u0412 <code>id_token<\/code> \u043b\u0435\u0436\u0430\u0442 claim\u2019\u044b: <code>sub<\/code> (\u0441\u0442\u0430\u0431\u0438\u043b\u044c\u043d\u044b\u0439 OIDC-\u0438\u0434\u0435\u043d\u0442\u0438\u0444\u0438\u043a\u0430\u0442\u043e\u0440 \u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u0435\u043b\u044f \u0443 Telegram), <code>id<\/code> (\u0447\u0438\u0441\u043b\u043e\u0432\u043e\u0439 Telegram user id, \u043c\u043e\u0436\u0435\u0442 \u043f\u0440\u0438\u0441\u0443\u0442\u0441\u0442\u0432\u043e\u0432\u0430\u0442\u044c \u043e\u0442\u0434\u0435\u043b\u044c\u043d\u043e), <code>name<\/code>, <code>preferred_username<\/code>, <code>picture<\/code>, <code>phone_number<\/code> (\u0435\u0441\u043b\u0438 \u044e\u0437\u0435\u0440 \u0434\u0430\u043b scope <code>phone<\/code>). \u0412 \u043a\u043e\u0434\u0435 \u044f \u0431\u0435\u0440\u0443 <code>id<\/code>, \u0430 \u0435\u0441\u043b\u0438 \u0435\u0433\u043e \u043d\u0435\u0442 \u2014 \u0444\u043e\u043b\u0431\u044d\u043a \u043d\u0430 <code>sub<\/code>; \u0442\u0430\u043a \u0447\u0443\u0442\u044c \u043d\u0430\u0434\u0451\u0436\u043d\u0435\u0435, \u0447\u0435\u043c \u0437\u0430\u0432\u044f\u0437\u044b\u0432\u0430\u0442\u044c\u0441\u044f \u043d\u0430 \u043e\u0434\u0438\u043d \u0438\u0437 \u0434\u0432\u0443\u0445. \u0418\u0437 \u044d\u0442\u0438\u0445 \u043f\u043e\u043b\u0435\u0439 \u0441\u043e\u0431\u0438\u0440\u0430\u0435\u043c \u0437\u0430\u043f\u0438\u0441\u044c <code>TelegramAccount<\/code> \u0438 \u043b\u0438\u043d\u043a\u0443\u0435\u043c \u043a <code>User<\/code>. \u041b\u043e\u0433\u0438\u043a\u0430 \u0442\u0430\u043a\u0430\u044f:<\/p>\n<ol>\n<li>\n<p>\u0418\u0449\u0443 <code>TelegramAccount<\/code> \u043f\u043e <code>telegram_id<\/code> \u2192 \u0435\u0441\u043b\u0438 \u0435\u0441\u0442\u044c, \u043f\u0435\u0440\u0435\u0438\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u044e \u0435\u0433\u043e \u044e\u0437\u0435\u0440\u0430 \u0438 \u043e\u0431\u043d\u043e\u0432\u043b\u044f\u044e \u043c\u0443\u0442\u0430\u0431\u0435\u043b\u044c\u043d\u044b\u0435 \u043f\u043e\u043b\u044f.<\/p>\n<\/li>\n<li>\n<p>\u0418\u043d\u0430\u0447\u0435 \u0438\u0449\u0443 <code>User<\/code> \u043f\u043e <code>phone_number<\/code> \u2192 \u0435\u0441\u043b\u0438 \u0435\u0441\u0442\u044c, \u043f\u0440\u0438\u043a\u0440\u0435\u043f\u043b\u044f\u044e \u043d\u043e\u0432\u044b\u0439 <code>TelegramAccount<\/code> \u043a \u043d\u0435\u043c\u0443.<\/p>\n<\/li>\n<li>\n<p>\u0418\u043d\u0430\u0447\u0435 \u0441\u043e\u0437\u0434\u0430\u044e \u0438 <code>User<\/code>, \u0438 <code>TelegramAccount<\/code>.<\/p>\n<\/li>\n<\/ol>\n<p>\u0428\u0430\u0433 2 \u2014 \u044d\u0442\u043e \u0442\u043e, \u0447\u0442\u043e \u043f\u043e\u0437\u0432\u043e\u043b\u0438\u0442 \u043f\u043e\u0437\u0436\u0435 \u0434\u043e\u0431\u0430\u0432\u0438\u0442\u044c \u043b\u043e\u0433\u0438\u043d \u043f\u043e SMS \u0438 \u043d\u0435 \u043f\u043e\u043b\u0443\u0447\u0438\u0442\u044c \u0434\u0443\u0431\u043b\u0435\u0439 \u044e\u0437\u0435\u0440\u043e\u0432, \u0443 \u043a\u043e\u0442\u043e\u0440\u044b\u0445 \u043e\u0434\u0438\u043d \u0438 \u0442\u043e\u0442 \u0436\u0435 \u0442\u0435\u043b\u0435\u0444\u043e\u043d, \u043d\u043e \u0434\u0432\u0430 \u0430\u043a\u043a\u0430\u0443\u043d\u0442\u0430.<\/p>\n<hr\/>\n<h3>\u0422\u0443\u0442\u043e\u0440\u0438\u0430\u043b: \u0447\u0442\u043e \u043a\u0443\u0434\u0430 \u043d\u0430\u0436\u0438\u043c\u0430\u0442\u044c<\/h3>\n<p>\u0422\u0435\u043f\u0435\u0440\u044c \u043f\u043e\u0448\u0430\u0433\u043e\u0432\u043e \u2014 \u043a\u0430\u043a \u043f\u043e\u0434\u043d\u044f\u0442\u044c \u0432\u0441\u0451 \u044d\u0442\u043e \u043b\u043e\u043a\u0430\u043b\u044c\u043d\u043e.<\/p>\n<h4>\u0428\u0430\u0433 1. \u0421\u043e\u0437\u0434\u0430\u0442\u044c \u0431\u043e\u0442\u0430 \u0438 \u043d\u0430\u0441\u0442\u0440\u043e\u0438\u0442\u044c OIDC \u0432 BotFather<\/h4>\n<p>\u041e\u0442\u043a\u0440\u044b\u0432\u0430\u0435\u0442\u0435 <a href=\"https:\/\/t.me\/botfather\" rel=\"noopener noreferrer nofollow\">@BotFather<\/a>, \u0441\u043e\u0437\u0434\u0430\u0451\u0442\u0435 \u0431\u043e\u0442\u0430 \u0447\u0435\u0440\u0435\u0437 <code>\/newbot<\/code> (\u0438\u043b\u0438 \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u0435\u0442\u0435 \u0441\u0443\u0449\u0435\u0441\u0442\u0432\u0443\u044e\u0449\u0435\u0433\u043e).<\/p>\n<figure class=\"\"><img decoding=\"async\" src=\"https:\/\/habrastorage.org\/r\/w1560\/getpro\/habr\/\/post_images\/ac9\/7bd\/2a5\/ac97bd2a5bc2a459bad2b1bca3d678a8.jpg\" sizes=\"(max-width: 780px) 100vw, 50vw\" srcset=\"https:\/\/habrastorage.org\/r\/w780\/getpro\/habr\/\/post_images\/ac9\/7bd\/2a5\/ac97bd2a5bc2a459bad2b1bca3d678a8.jpg 780w,&#10;       https:\/\/habrastorage.org\/r\/w1560\/getpro\/habr\/\/post_images\/ac9\/7bd\/2a5\/ac97bd2a5bc2a459bad2b1bca3d678a8.jpg 781w\" loading=\"lazy\" decode=\"async\"\/><\/figure>\n<p>\u0414\u0430\u043b\u044c\u0448\u0435 \u2014 \u0441\u0430\u043c\u043e\u0435 \u043d\u0435\u043e\u0447\u0435\u0432\u0438\u0434\u043d\u043e\u0435. <strong>\u041d\u0430\u0441\u0442\u0440\u043e\u0439\u043a\u0438 OIDC \u0436\u0438\u0432\u0443\u0442 \u043d\u0435 \u0432 \u0447\u0430\u0442\u0435 \u0441 BotFather, \u0430 \u0432 \u0435\u0433\u043e mini-app.<\/strong> \u0412 \u0447\u0430\u0442\u0435 \u043d\u0430\u0436\u0438\u043c\u0430\u0435\u0442\u0435 \u043a\u043d\u043e\u043f\u043a\u0443 \u00abOpen\u00bb (\u0438\u043b\u0438 \u0438\u043a\u043e\u043d\u043a\u0443 \u043f\u0440\u0438\u043b\u043e\u0436\u0435\u043d\u0438\u044f), \u0432\u043d\u0443\u0442\u0440\u0438 \u043f\u0435\u0440\u0435\u0445\u043e\u0434\u0438\u0442\u0435 \u0432 <strong>Bot Settings \u2192 Web Login<\/strong>.<\/p>\n<p>\u0422\u0430\u043c \u0434\u0432\u0430 \u0432\u0430\u0436\u043d\u044b\u0445 \u043f\u043e\u043b\u044f:<\/p>\n<ul>\n<li>\n<p><strong>Trusted Origins<\/strong> \u2014 \u0434\u043e\u0431\u0430\u0432\u044c\u0442\u0435 \u0441\u044e\u0434\u0430 <code>https:\/\/&lt;\u0432\u0430\u0448-ngrok-\u0434\u043e\u043c\u0435\u043d&gt;.ngrok-free.app<\/code>. \u0422\u043e\u043b\u044c\u043a\u043e origin: \u043d\u0438 \u043f\u0443\u0442\u0438, \u043d\u0438 \u0441\u043b\u0435\u0448\u0430 \u043d\u0430 \u043a\u043e\u043d\u0446\u0435. Origin\u2019\u043e\u0432 \u043c\u043e\u0436\u043d\u043e \u043d\u0435\u0441\u043a\u043e\u043b\u044c\u043a\u043e (\u043d\u0430\u043f\u0440\u0438\u043c\u0435\u0440, <code>localhost<\/code> \u0447\u0435\u0440\u0435\u0437 \u043f\u0440\u043e\u043a\u0441\u0438 \u0438 \u043f\u0440\u043e\u0434).<\/p>\n<\/li>\n<li>\n<p><strong>Redirect URIs<\/strong> \u2014 \u0434\u043b\u044f \u043d\u0430\u0448\u0435\u0433\u043e \u0444\u043b\u043e\u0443 \u0447\u0435\u0440\u0435\u0437 <code>telegram-login.js<\/code> \u043e\u0441\u0442\u0430\u0432\u044c\u0442\u0435 \u043f\u0443\u0441\u0442\u044b\u043c. \u042d\u0442\u043e \u043f\u043e\u043b\u0435 \u043d\u0443\u0436\u043d\u043e \u0442\u043e\u043b\u044c\u043a\u043e \u0435\u0441\u043b\u0438 \u0432\u044b \u0441\u0430\u043c\u0438 \u0440\u0435\u0430\u043b\u0438\u0437\u0443\u0435\u0442\u0435 server-side \u043e\u0431\u043c\u0435\u043d <code>code \u2192 token<\/code>.<\/p>\n<\/li>\n<\/ul>\n<figure class=\"\"><img decoding=\"async\" src=\"https:\/\/habrastorage.org\/r\/w1560\/getpro\/habr\/\/post_images\/d0f\/0df\/aa2\/d0f0dfaa2bc090140c0af46b47ac09f8.jpg\" sizes=\"(max-width: 780px) 100vw, 50vw\" srcset=\"https:\/\/habrastorage.org\/r\/w780\/getpro\/habr\/\/post_images\/d0f\/0df\/aa2\/d0f0dfaa2bc090140c0af46b47ac09f8.jpg 780w,&#10;       https:\/\/habrastorage.org\/r\/w1560\/getpro\/habr\/\/post_images\/d0f\/0df\/aa2\/d0f0dfaa2bc090140c0af46b47ac09f8.jpg 781w\" loading=\"lazy\" decode=\"async\"\/><\/figure>\n<p>\u041a\u043e\u043c\u0430\u043d\u0434\u0430 <code>\/setdomain<\/code> \u2014 \u044d\u0442\u043e \u043e\u0442 \u0441\u0442\u0430\u0440\u043e\u0433\u043e \u0432\u0438\u0434\u0436\u0435\u0442\u0430. \u0414\u043b\u044f OIDC \u043e\u043d\u0430 \u043d\u0435 \u043d\u0443\u0436\u043d\u0430.<\/p>\n<h4>\u0428\u0430\u0433 2. ngrok (\u0438\u043b\u0438 \u043b\u044e\u0431\u043e\u0439 HTTPS-\u0442\u0443\u043d\u043d\u0435\u043b\u044c)<\/h4>\n<p>Telegram \u043f\u0443\u0441\u043a\u0430\u0435\u0442 \u0432 Trusted Origins \u0442\u043e\u043b\u044c\u043a\u043e HTTPS-\u0441\u0445\u0435\u043c\u044b, \u043f\u043e\u044d\u0442\u043e\u043c\u0443 <code>http:\/\/localhost:8000<\/code> \u043d\u0430\u043f\u0440\u044f\u043c\u0443\u044e \u043d\u0435 \u043f\u043e\u0434\u043e\u0439\u0434\u0451\u0442 \u2014 \u043d\u0443\u0436\u0435\u043d HTTPS-\u0442\u0443\u043d\u043d\u0435\u043b\u044c \u043d\u0430\u0440\u0443\u0436\u0443.<\/p>\n<p>\u0421\u0430\u043c\u043e\u0435 \u043f\u0440\u043e\u0441\u0442\u043e\u0435 \u2014 ngrok:<\/p>\n<pre><code class=\"bash\">ngrok http 8000<\/code><div class=\"code-explainer\"><a href=\"https:\/\/sourcecraft.dev\/\" class=\"tm-button code-explainer__link\" style=\"visibility: hidden;\"><img style=\"width:14px;height:14px;object-fit:cover;object-position:left;\"\/><\/a><\/div><\/pre>\n<p>\u041f\u043e\u043b\u0443\u0447\u0430\u0435\u0442\u0435 URL \u0432\u0438\u0434\u0430 <code>https:\/\/abcd-1234.ngrok-free.app<\/code>. \u042d\u0442\u043e\u0442 URL \u043a\u043b\u0430\u0434\u0451\u0442\u0435 \u0432 <strong>Trusted Origins<\/strong> \u0432 BotFather. \u041d\u0430 \u0431\u0435\u0441\u043f\u043b\u0430\u0442\u043d\u043e\u043c \u0442\u0430\u0440\u0438\u0444\u0435 ngrok \u0434\u043e\u043c\u0435\u043d \u043c\u0435\u043d\u044f\u0435\u0442\u0441\u044f \u043f\u0440\u0438 \u043a\u0430\u0436\u0434\u043e\u043c \u043f\u0435\u0440\u0435\u0437\u0430\u043f\u0443\u0441\u043a\u0435 \u2014 \u043f\u0440\u0438\u0434\u0451\u0442\u0441\u044f \u043e\u0431\u043d\u043e\u0432\u043b\u044f\u0442\u044c Trusted Origins \u043a\u0430\u0436\u0434\u044b\u0439 \u0440\u0430\u0437. \u0415\u0441\u043b\u0438 \u0438\u0433\u0440\u0430\u0435\u0442\u0435\u0441\u044c \u0447\u0430\u0441\u0442\u043e \u2014 \u0435\u0441\u0442\u044c \u0441\u043c\u044b\u0441\u043b \u043a\u0443\u043f\u0438\u0442\u044c \u0441\u0442\u0430\u0442\u0438\u0447\u0435\u0441\u043a\u0438\u0439 \u0434\u043e\u043c\u0435\u043d \u0438\u043b\u0438 \u0432\u0437\u044f\u0442\u044c Cloudflare Tunnel.<\/p>\n<figure class=\"\"><img decoding=\"async\" src=\"https:\/\/habrastorage.org\/r\/w1560\/getpro\/habr\/\/post_images\/6b2\/b13\/c9f\/6b2b13c9fc7f3253230f57f125134eca.jpg\" sizes=\"(max-width: 780px) 100vw, 50vw\" srcset=\"https:\/\/habrastorage.org\/r\/w780\/getpro\/habr\/\/post_images\/6b2\/b13\/c9f\/6b2b13c9fc7f3253230f57f125134eca.jpg 780w,&#10;       https:\/\/habrastorage.org\/r\/w1560\/getpro\/habr\/\/post_images\/6b2\/b13\/c9f\/6b2b13c9fc7f3253230f57f125134eca.jpg 781w\" loading=\"lazy\" decode=\"async\"\/><\/figure>\n<h4>\u0428\u0430\u0433 3. .env \u0438 client_id<\/h4>\n<p>\u0412 \u043a\u043e\u0440\u043d\u0435 \u043f\u0440\u043e\u0435\u043a\u0442\u0430 \u0435\u0441\u0442\u044c <code>.env.dev<\/code> \u2014 \u043a\u043e\u043f\u0438\u0440\u0443\u0435\u0442\u0435 \u0432 <code>.env<\/code> \u0438 \u0437\u0430\u043f\u043e\u043b\u043d\u044f\u0435\u0442\u0435:<\/p>\n<pre><code class=\"bash\">APP_TG_CLIENT_ID=8506301481      # \u0432\u0430\u0448 Client ID \u0438\u0437 BotFatherAPP_SECRET_KEY=&lt;32 hex-\u0441\u0438\u043c\u0432\u043e\u043b\u0430&gt;  # \u043a\u043b\u044e\u0447 AES \u0434\u043b\u044f \u043f\u043e\u0434\u043f\u0438\u0441\u0438 cookie-\u0441\u0435\u0441\u0441\u0438\u0438 (16\/24\/32 \u0441\u0438\u043c\u0432\u043e\u043b\u0430)APP_DB_URL=sqlite+aiosqlite:\/\/\/.\/tg_auth.db<\/code><div class=\"code-explainer\"><a href=\"https:\/\/sourcecraft.dev\/\" class=\"tm-button code-explainer__link\" style=\"visibility: hidden;\"><img style=\"width:14px;height:14px;object-fit:cover;object-position:left;\"\/><\/a><\/div><\/pre>\n<p>\u0421\u0435\u043a\u0440\u0435\u0442 \u0434\u043b\u044f cookie-\u0441\u0435\u0441\u0441\u0438\u0438 \u0443 \u043c\u0435\u043d\u044f \u0432 Litestar-\u043e\u0432\u0441\u043a\u043e\u043c <code>CookieBackendConfig<\/code> \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u0435\u0442\u0441\u044f \u043a\u0430\u043a \u043a\u043b\u044e\u0447 AES \u2014 \u0434\u043b\u0438\u043d\u0430 \u0441\u0442\u0440\u043e\u0433\u043e 16\/24\/32 \u0431\u0430\u0439\u0442\u0430. \u0421\u0433\u0435\u043d\u0435\u0440\u0438\u0440\u043e\u0432\u0430\u0442\u044c \u043f\u0440\u043e\u0441\u0442\u043e:<\/p>\n<pre><code class=\"bash\">python3 -c \"import secrets; print(secrets.token_hex(16))\"  # 32 hex-\u0441\u0438\u043c\u0432\u043e\u043b\u0430 = 32-\u0431\u0430\u0439\u0442\u043d\u0430\u044f \u0441\u0442\u0440\u043e\u043a\u0430 \u0434\u043b\u044f AES-\u043a\u043b\u044e\u0447\u0430<\/code><div class=\"code-explainer\"><a href=\"https:\/\/sourcecraft.dev\/\" class=\"tm-button code-explainer__link\" style=\"visibility: hidden;\"><img style=\"width:14px;height:14px;object-fit:cover;object-position:left;\"\/><\/a><\/div><\/pre>\n<p>\u0422\u043e\u0442 \u0436\u0435 <code>Client ID<\/code> \u043d\u0443\u0436\u043d\u043e \u043f\u0440\u043e\u043f\u0438\u0441\u0430\u0442\u044c \u0432 <code>data-client-id<\/code> \u0432 <code>tg_auth\/presentors\/rest\/templates\/index.html<\/code> \u2014 \u044d\u0442\u043e \u0430\u0442\u0440\u0438\u0431\u0443\u0442 \u0442\u0435\u0433\u0430 <code>&lt;script&gt;<\/code>, \u043a\u043e\u0442\u043e\u0440\u044b\u0439 \u0433\u0440\u0443\u0437\u0438\u0442 \u0432\u0438\u0434\u0436\u0435\u0442:<\/p>\n<pre><code>&lt;script async src=\"https:\/\/oauth.telegram.org\/js\/telegram-login.js?3\"        data-client-id=\"8506301481\"        data-onauth=\"onTelegramAuth(data)\"        data-request-access=\"write phone\"&gt;&lt;\/script&gt;&lt;button class=\"tg-auth-button\" data-style=\"shine\"&gt;Sign In with Telegram&lt;\/button&gt;<\/code><div class=\"code-explainer\"><a href=\"https:\/\/sourcecraft.dev\/\" class=\"tm-button code-explainer__link\" style=\"visibility: hidden;\"><img style=\"width:14px;height:14px;object-fit:cover;object-position:left;\"\/><\/a><\/div><\/pre>\n<p>\u0424\u0443\u043d\u043a\u0446\u0438\u044f <code>onTelegramAuth(data)<\/code> \u2014 \u043d\u0430\u0448 callback, \u0432 \u043d\u0435\u0451 Telegram \u043f\u0435\u0440\u0435\u0434\u0430\u0451\u0442 <code>{ id_token, user }<\/code>. \u0412\u0441\u0451, \u0447\u0442\u043e \u043e\u043d\u0430 \u0434\u0435\u043b\u0430\u0435\u0442:<\/p>\n<pre><code>async function onTelegramAuth(data) {  if (!data || data.error) return;  const res = await fetch(\"\/api\/v1\/auth\/telegram\", {    method: \"POST\",    headers: { \"Content-Type\": \"application\/json\" },    credentials: \"include\",    body: JSON.stringify({ id_token: data.id_token }),  });  if (res.ok) window.location.href = \"\/app\";}<\/code><div class=\"code-explainer\"><a href=\"https:\/\/sourcecraft.dev\/\" class=\"tm-button code-explainer__link\" style=\"visibility: hidden;\"><img style=\"width:14px;height:14px;object-fit:cover;object-position:left;\"\/><\/a><\/div><\/pre>\n<p>\u041d\u0438\u0447\u0435\u0433\u043e \u0431\u043e\u043b\u044c\u0448\u0435 \u2014 \u044d\u0442\u043e \u0432\u0435\u0441\u044c \u0444\u0440\u043e\u043d\u0442.<\/p>\n<p>\u26a0\ufe0f \u0412\u0430\u0436\u043d\u044b\u0439 \u043c\u043e\u043c\u0435\u043d\u0442: \u0432 <code>data<\/code> Telegram \u043a\u043b\u0430\u0434\u0451\u0442 \u0435\u0449\u0451 \u043f\u043e\u043b\u0435 <code>user<\/code> \u0441 \u0440\u0430\u0441\u043f\u0430\u043a\u043e\u0432\u0430\u043d\u043d\u044b\u043c\u0438 \u043f\u043e\u043b\u044f\u043c\u0438 (\u0438\u043c\u044f, \u0430\u0432\u0430\u0442\u0430\u0440\u043a\u0430, \u0438 \u0442\u0430\u043a \u0434\u0430\u043b\u0435\u0435). \u0423\u0434\u043e\u0431\u043d\u043e \u0434\u043b\u044f UI \u043d\u0430 \u0444\u0440\u043e\u043d\u0442\u0435, \u043d\u043e <strong>\u0434\u043e\u0432\u0435\u0440\u044f\u0442\u044c \u0438\u043c \u043d\u0435\u043b\u044c\u0437\u044f<\/strong> \u2014 \u044d\u0442\u043e \u0442\u0430 \u0436\u0435 \u0438\u043d\u0444\u043e\u0440\u043c\u0430\u0446\u0438\u044f, \u0447\u0442\u043e \u0438 \u0432 <code>id_token<\/code>, \u0442\u043e\u043b\u044c\u043a\u043e \u0431\u0435\u0437 \u043f\u043e\u0434\u043f\u0438\u0441\u0438. \u0418\u0441\u0442\u043e\u0447\u043d\u0438\u043a \u0438\u0441\u0442\u0438\u043d\u044b \u0434\u043b\u044f \u0431\u044d\u043a\u0430 \u2014 \u0442\u043e\u043b\u044c\u043a\u043e server-side \u043f\u0440\u043e\u0432\u0435\u0440\u0435\u043d\u043d\u044b\u0439 <code>id_token<\/code>. \u041d\u0430 \u0444\u0440\u043e\u043d\u0442\u0435 <code>data.user<\/code> \u043f\u043e\u043a\u0430\u0437\u044b\u0432\u0430\u0439\u0442\u0435, \u043d\u0430 \u0431\u044d\u043a\u0435 \u2014 \u0438\u0433\u043d\u043e\u0440\u0438\u0440\u0443\u0439\u0442\u0435.<\/p>\n<h4>\u0428\u0430\u0433 4. \u0417\u0430\u043f\u0443\u0441\u043a<\/h4>\n<pre><code class=\"bash\">make develop      # \u0441\u043e\u0437\u0434\u0430\u0451\u0442 .venv, \u0441\u0442\u0430\u0432\u0438\u0442 \u0437\u0430\u0432\u0438\u0441\u0438\u043c\u043e\u0441\u0442\u0438 \u0447\u0435\u0440\u0435\u0437 uvmake migrate      # \u043f\u0440\u0438\u043c\u0435\u043d\u044f\u0435\u0442 alembic-\u043c\u0438\u0433\u0440\u0430\u0446\u0438\u0438make run          # python -m tg_auth \u2192 uvicorn \u043d\u0430 :8000<\/code><div class=\"code-explainer\"><a href=\"https:\/\/sourcecraft.dev\/\" class=\"tm-button code-explainer__link\" style=\"visibility: hidden;\"><img style=\"width:14px;height:14px;object-fit:cover;object-position:left;\"\/><\/a><\/div><\/pre>\n<p>\u0412 \u043e\u0442\u0434\u0435\u043b\u044c\u043d\u043e\u043c \u0442\u0435\u0440\u043c\u0438\u043d\u0430\u043b\u0435 \u2014 <code>ngrok http 8000<\/code>. \u041e\u0442\u043a\u0440\u044b\u0432\u0430\u0435\u0442\u0435 https-URL ngrok\u2019\u0430, \u043a\u043b\u0438\u043a\u0430\u0435\u0442\u0435 \u00abSign In with Telegram\u00bb, \u043f\u043e\u0434\u0442\u0432\u0435\u0440\u0436\u0434\u0430\u0435\u0442\u0435 \u0432 Telegram-\u043f\u0440\u0438\u043b\u043e\u0436\u0435\u043d\u0438\u0438, \u0438 \u0434\u043e\u043b\u0436\u043d\u044b \u043f\u043e\u043f\u0430\u0441\u0442\u044c \u043d\u0430 <code>\/app<\/code> \u0441 \u0432\u0430\u0448\u0438\u043c \u0438\u043c\u0435\u043d\u0435\u043c.<\/p>\n<figure class=\"\"><img decoding=\"async\" src=\"https:\/\/habrastorage.org\/r\/w1560\/getpro\/habr\/\/post_images\/0c9\/5db\/2e0\/0c95db2e04f4c499d402eb6f66a0b625.jpg\" sizes=\"(max-width: 780px) 100vw, 50vw\" srcset=\"https:\/\/habrastorage.org\/r\/w780\/getpro\/habr\/\/post_images\/0c9\/5db\/2e0\/0c95db2e04f4c499d402eb6f66a0b625.jpg 780w,&#10;       https:\/\/habrastorage.org\/r\/w1560\/getpro\/habr\/\/post_images\/0c9\/5db\/2e0\/0c95db2e04f4c499d402eb6f66a0b625.jpg 781w\" loading=\"lazy\" decode=\"async\"\/><\/figure>\n<figure class=\"\"><img decoding=\"async\" src=\"https:\/\/habrastorage.org\/r\/w1560\/getpro\/habr\/\/post_images\/da2\/334\/833\/da2334833c4a9ae3efc64db2ae14b53b.jpg\" sizes=\"(max-width: 780px) 100vw, 50vw\" srcset=\"https:\/\/habrastorage.org\/r\/w780\/getpro\/habr\/\/post_images\/da2\/334\/833\/da2334833c4a9ae3efc64db2ae14b53b.jpg 780w,&#10;       https:\/\/habrastorage.org\/r\/w1560\/getpro\/habr\/\/post_images\/da2\/334\/833\/da2334833c4a9ae3efc64db2ae14b53b.jpg 781w\" loading=\"lazy\" decode=\"async\"\/><\/figure>\n<hr\/>\n<h3>\u0410 \u0447\u0442\u043e \u0432\u043e \u0432\u0442\u043e\u0440\u043e\u0439 \u0440\u0430\u0437?<\/h3>\n<p>\u0415\u0441\u043b\u0438 cookie \u0443\u0436\u0435 \u0441\u0442\u043e\u0438\u0442 \u0438 \u043e\u043d\u0430 \u0432\u0430\u043b\u0438\u0434\u043d\u0430\u044f \u2014 \u043c\u044b \u0432\u043e\u043e\u0431\u0449\u0435 \u043d\u0435 \u0434\u0451\u0440\u0433\u0430\u0435\u043c Telegram. \u041f\u043e\u0442\u043e\u043a \u0442\u0430\u043a\u043e\u0439:<\/p>\n<figure class=\"\"><img decoding=\"async\" src=\"https:\/\/habrastorage.org\/getpro\/habr\/\/post_images\/be1\/295\/133\/be1295133075ece0a04400c593d2fd5f.svg\" sizes=\"(max-width: 780px) 100vw, 50vw\" srcset=\"https:\/\/habrastorage.org\/getpro\/habr\/\/post_images\/be1\/295\/133\/be1295133075ece0a04400c593d2fd5f.svg 780w,&#10;       https:\/\/habrastorage.org\/getpro\/habr\/\/post_images\/be1\/295\/133\/be1295133075ece0a04400c593d2fd5f.svg 781w\" loading=\"lazy\" decode=\"async\"\/><\/figure>\n<p>\u042f \u0434\u0435\u0440\u0436\u0443 \u0432 \u0441\u0435\u0441\u0441\u0438\u0438 \u0431\u0443\u043a\u0432\u0430\u043b\u044c\u043d\u043e <code>{\"user\": {\"id\": \"&lt;uuid&gt;\"}}<\/code> \u2014 \u0431\u043e\u043b\u044c\u0448\u0435 \u043d\u0438\u0447\u0435\u0433\u043e. \u0418\u043c\u044f\/\u0442\u0435\u043b\u0435\u0444\u043e\u043d \u0442\u0430\u0449\u0443 \u0438\u0437 \u0411\u0414 \u043d\u0430 \u043a\u0430\u0436\u0434\u044b\u0439 \u0437\u0430\u043f\u0440\u043e\u0441 <code>\/app<\/code>. \u042d\u0442\u043e \u0434\u0430\u0451\u0442 \u043f\u0440\u0438\u044f\u0442\u043d\u044b\u0439 side-\u044d\u0444\u0444\u0435\u043a\u0442: \u0435\u0441\u043b\u0438 \u044e\u0437\u0435\u0440\u0430 \u0432 \u0411\u0414 \u0443\u0434\u0430\u043b\u0438\u043b\u0438, \u043a\u043e\u043d\u0442\u0440\u043e\u043b\u043b\u0435\u0440 <code>\/app<\/code> \u044d\u0442\u043e \u0432\u0438\u0434\u0438\u0442, \u0447\u0438\u0441\u0442\u0438\u0442 cookie \u0438 \u0440\u0435\u0434\u0438\u0440\u0435\u043a\u0442\u0438\u0442 \u043d\u0430 <code>\/<\/code>. \u0412 \u043a\u043e\u0434\u0435 \u2014 \u0431\u0443\u043a\u0432\u0430\u043b\u044c\u043d\u043e \u043f\u044f\u0442\u044c \u0441\u0442\u0440\u043e\u043a:<\/p>\n<pre><code class=\"python\">sess_user = request.session.get(\"user\")if not sess_user:    return Redirect(path=\"\/\")user = await fetch_user_by_id.execute(UserID(UUID(sess_user[\"id\"])))if user is None:    request.clear_session()  # self-heal    return Redirect(path=\"\/\")<\/code><div class=\"code-explainer\"><a href=\"https:\/\/sourcecraft.dev\/\" class=\"tm-button code-explainer__link\" style=\"visibility: hidden;\"><img style=\"width:14px;height:14px;object-fit:cover;object-position:left;\"\/><\/a><\/div><\/pre>\n<hr\/>\n<h3>Access\/refresh \u2014 \u043f\u0430\u0440\u0430 \u0441\u043b\u043e\u0432 \u0438 \u0442\u0438\u0437\u0435\u0440<\/h3>\n<p>\u0422\u043e\u0442 \u0436\u0435 <code>POST \/api\/v1\/auth\/telegram<\/code> \u043f\u043e\u0441\u043b\u0435 \u0443\u0441\u043f\u0435\u0448\u043d\u043e\u0433\u043e \u0430\u043f\u0441\u0435\u0440\u0442\u0430 \u0432\u043e\u0437\u0432\u0440\u0430\u0449\u0430\u0435\u0442 <strong>\u0438<\/strong> cookie, <strong>\u0438<\/strong> \u043f\u0430\u0440\u0443 JWT-\u0442\u043e\u043a\u0435\u043d\u043e\u0432:<\/p>\n<pre><code class=\"json\">{  \"user\": { \"id\": \"...\", \"name\": \"Jane\", \"phone_number\": \"+7...\" },  \"tokens\": {    \"access_token\": \"eyJ...\",    \"refresh_token\": \"eyJ...\",    \"token_type\": \"Bearer\",    \"expires_in\": 900  }}<\/code><div class=\"code-explainer\"><a href=\"https:\/\/sourcecraft.dev\/\" class=\"tm-button code-explainer__link\" style=\"visibility: hidden;\"><img style=\"width:14px;height:14px;object-fit:cover;object-position:left;\"\/><\/a><\/div><\/pre>\n<p>\u041f\u0430\u0440\u0430 \u043d\u0443\u0436\u043d\u0430 \u0434\u043b\u044f JSON API \u2014 \u043c\u043e\u0431\u0438\u043b\u044c\u043d\u043e\u0435 \u043f\u0440\u0438\u043b\u043e\u0436\u0435\u043d\u0438\u0435 \u0438\u043b\u0438 SPA \u043f\u043e\u043b\u043e\u0436\u0438\u0442 <code>access<\/code> \u0432 <code>Authorization: Bearer ...<\/code>, \u0430 \u043a\u043e\u0433\u0434\u0430 \u0442\u043e\u0442 \u043f\u0440\u043e\u0442\u0443\u0445\u043d\u0435\u0442 \u2014 \u043e\u0431\u043c\u0435\u043d\u044f\u0435\u0442 <code>refresh<\/code> \u043d\u0430 \u043d\u043e\u0432\u0443\u044e \u043f\u0430\u0440\u0443:<\/p>\n<figure class=\"\"><img decoding=\"async\" src=\"https:\/\/habrastorage.org\/getpro\/habr\/\/post_images\/313\/240\/eb0\/313240eb019eeeba957b7abecd32ed81.svg\" sizes=\"(max-width: 780px) 100vw, 50vw\" srcset=\"https:\/\/habrastorage.org\/getpro\/habr\/\/post_images\/313\/240\/eb0\/313240eb019eeeba957b7abecd32ed81.svg 780w,&#10;       https:\/\/habrastorage.org\/getpro\/habr\/\/post_images\/313\/240\/eb0\/313240eb019eeeba957b7abecd32ed81.svg 781w\" loading=\"lazy\" decode=\"async\"\/><\/figure>\n<p>\u0412 \u043c\u043e\u0451\u043c PoC \u044d\u0442\u043e \u0441\u0434\u0435\u043b\u0430\u043d\u043e \u043c\u0430\u043a\u0441\u0438\u043c\u0430\u043b\u044c\u043d\u043e \u0442\u0443\u043f\u043e: HS256, \u043e\u0431\u0449\u0438\u0439 \u0441\u0435\u043a\u0440\u0435\u0442, <code>type<\/code> claim \u0440\u0430\u0437\u043b\u0438\u0447\u0430\u0435\u0442 access\/refresh, \u043d\u0438\u043a\u0430\u043a\u043e\u0433\u043e \u0445\u0440\u0430\u043d\u0435\u043d\u0438\u044f \u0432 \u0411\u0414. \u042d\u0442\u043e\u0433\u043e \u0445\u0432\u0430\u0442\u0430\u0435\u0442, \u0447\u0442\u043e\u0431\u044b \u043f\u0440\u043e\u0434\u0435\u043c\u043e\u043d\u0441\u0442\u0440\u0438\u0440\u043e\u0432\u0430\u0442\u044c \u043e\u0431\u0432\u044f\u0437\u043a\u0443, \u043d\u043e \u0432 \u043f\u0440\u043e\u0434\u0435 \u0442\u0430\u043a \u0434\u0435\u043b\u0430\u0442\u044c \u043d\u0435\u043b\u044c\u0437\u044f \u2014 \u043d\u0435\u0442 \u043e\u0442\u0437\u044b\u0432\u0430, \u043d\u0435\u043b\u044c\u0437\u044f \u0432\u044b\u043a\u0438\u043d\u0443\u0442\u044c \u043a\u043e\u043d\u043a\u0440\u0435\u0442\u043d\u043e\u0433\u043e \u044e\u0437\u0435\u0440\u0430, \u043f\u0440\u0438 \u0443\u0442\u0435\u0447\u043a\u0435 refresh-\u0442\u043e\u043a\u0435\u043d\u0430 \u0437\u043b\u043e\u0443\u043c\u044b\u0448\u043b\u0435\u043d\u043d\u0438\u043a \u0431\u0435\u0437 \u043f\u0440\u043e\u0431\u043b\u0435\u043c \u0440\u0435\u0444\u0440\u0435\u0448\u0438\u0442\u0441\u044f \u0434\u0430\u043b\u044c\u0448\u0435.<\/p>\n<p>\u041f\u043e\u043b\u043d\u043e\u0446\u0435\u043d\u043d\u044b\u0439 refresh \u2014 \u044d\u0442\u043e \u043e\u0434\u043d\u043e\u0440\u0430\u0437\u043e\u0432\u044b\u0435 \u0442\u043e\u043a\u0435\u043d\u044b, <code>family_id<\/code> \u0434\u043b\u044f \u0434\u0435\u0442\u0435\u043a\u0446\u0438\u0438 \u043f\u0435\u0440\u0435\u0438\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u043d\u0438\u044f, \u0436\u0443\u0440\u043d\u0430\u043b \u0441\u0435\u0441\u0441\u0438\u0439 \u0432 \u0411\u0414. \u0422\u0435\u043c\u0430 \u0431\u043e\u043b\u044c\u0448\u0430\u044f, \u0438 \u043f\u0440\u043e \u043d\u0435\u0451 \u044f \u0445\u043e\u0447\u0443 \u043d\u0430\u043f\u0438\u0441\u0430\u0442\u044c \u043e\u0442\u0434\u0435\u043b\u044c\u043d\u043e. \u0417\u0434\u0435\u0441\u044c \u2014 \u0441\u0444\u043e\u043a\u0443\u0441\u0438\u0440\u043e\u0432\u0430\u043d \u043d\u0430 \u0441\u0430\u043c\u043e\u043c OIDC-\u043e\u0431\u043c\u0435\u043d\u0435.<\/p>\n<hr\/>\n<h3>\u0413\u0440\u0430\u0431\u043b\u0438, \u043d\u0430 \u043a\u043e\u0442\u043e\u0440\u044b\u0435 \u044f \u043d\u0430\u0441\u0442\u0443\u043f\u0438\u043b<\/h3>\n<p><strong>Popup \u043e\u0442\u043a\u0440\u044b\u0432\u0430\u0435\u0442\u0441\u044f, \u043d\u043e <\/strong><code><strong>onTelegramAuth<\/strong><\/code><strong> \u043d\u0435 \u0432\u044b\u0437\u044b\u0432\u0430\u0435\u0442\u0441\u044f.<\/strong> \u041f\u043e\u0447\u0442\u0438 \u0432\u0441\u0435\u0433\u0434\u0430 \u043e\u0434\u043d\u043e \u0438\u0437 \u0434\u0432\u0443\u0445: (\u0430) origin \u043d\u0435 \u0434\u043e\u0431\u0430\u0432\u043b\u0435\u043d \u0432 Trusted Origins \u0432 BotFather, \u0438\u043b\u0438 (\u0431) \u043d\u0430 \u0441\u0430\u0439\u0442 \u043e\u0442\u0434\u0430\u0451\u0442\u0441\u044f \u0437\u0430\u0433\u043e\u043b\u043e\u0432\u043e\u043a <code>Cross-Origin-Opener-Policy: same-origin<\/code> \u2014 \u043e\u043d \u0431\u043b\u043e\u043a\u0438\u0440\u0443\u0435\u0442 <code>postMessage<\/code> \u0438\u0437 popup-\u0430. Litestar \u043f\u043e \u0443\u043c\u043e\u043b\u0447\u0430\u043d\u0438\u044e \u0435\u0433\u043e \u043d\u0435 \u0441\u0442\u0430\u0432\u0438\u0442, \u043d\u043e \u0435\u0441\u043b\u0438 \u0443 \u0432\u0430\u0441 \u0432\u043f\u0435\u0440\u0435\u0434\u0438 nginx\/CDN \u2014 \u0441\u0442\u043e\u0438\u0442 \u043f\u0440\u043e\u0432\u0435\u0440\u0438\u0442\u044c.<\/p>\n<p><code><strong>401 Invalid id_token: Audience doesn't match<\/strong><\/code><strong>.<\/strong> <code>APP_TG_CLIENT_ID<\/code> \u0432 <code>.env<\/code> \u043d\u0435 \u0441\u043e\u0432\u043f\u0430\u043b \u0441 <code>data-client-id<\/code> \u0432 <code>index.html<\/code>. \u042f \u043d\u0430 \u044d\u0442\u043e \u043f\u043e\u043f\u0430\u0434\u0430\u043b\u0441\u044f \u0434\u0432\u0430\u0436\u0434\u044b \u2014 \u043f\u043e\u043f\u0440\u0430\u0432\u0438\u043b \u0432 \u043e\u0434\u043d\u043e\u043c \u043c\u0435\u0441\u0442\u0435, \u0437\u0430\u0431\u044b\u043b \u0432 \u0434\u0440\u0443\u0433\u043e\u043c. \u0412 \u0441\u043b\u0443\u0447\u0430\u0435 \u0441 \u0448\u0430\u0431\u043b\u043e\u043d\u0430\u043c\u0438 \u044d\u0442\u043e \u043c\u043e\u0436\u043d\u043e \u0440\u0435\u0448\u0438\u0442\u044c \u043e\u0434\u043d\u043e\u0439 \u043f\u0435\u0440\u0435\u043c\u0435\u043d\u043d\u043e\u0439 \u0438 \u043f\u0440\u043e\u043a\u0438\u0434\u044b\u0432\u0430\u0442\u044c client_id \u0432 \u0448\u0430\u0431\u043b\u043e\u043d \u0441 \u0431\u044d\u043a\u0435\u043d\u0434\u0430, \u043d\u043e \u0441 \u043f\u043e\u043b\u043d\u043e\u0446\u0435\u043d\u043d\u044b\u043c \u0444\u0440\u043e\u043d\u0442\u043e\u043c \u0432 \u043e\u0442\u0434\u0435\u043b\u044c\u043d\u043e\u0439 \u0440\u0435\u043f\u0435 \u043d\u0430\u0434\u043e \u0431\u0443\u0434\u0435\u0442 \u0441\u043b\u0435\u0434\u0438\u0442\u044c \u0437\u0430 \u0434\u0432\u0443\u043c\u044f \u043f\u0435\u0440\u0435\u043c\u0435\u043d\u043d\u044b\u043c\u0438.<\/p>\n<p><code><strong>401 Invalid id_token: Signature verification failed<\/strong><\/code><strong>.<\/strong> Telegram \u0440\u043e\u0442\u0438\u0440\u043e\u0432\u0430\u043b \u043a\u043b\u044e\u0447\u0438 \u0432 JWKS, \u0430 \u0443 \u0432\u0430\u0441 \u043e\u043d\u0438 \u0437\u0430\u043a\u044d\u0448\u0438\u0440\u043e\u0432\u0430\u043d\u044b. \u0423 <code>PyJWKClient<\/code> \u044f \u0441\u0442\u0430\u0432\u0438\u043b <code>lifespan=600<\/code> \u2014 \u0442\u043e \u0435\u0441\u0442\u044c \u043a\u044d\u0448 \u0432 \u043f\u0430\u043c\u044f\u0442\u0438 \u0436\u0438\u0432\u0451\u0442 10 \u043c\u0438\u043d\u0443\u0442. \u041f\u0440\u043e\u0441\u0442\u043e\u0439 \u0440\u0435\u0431\u0443\u0442 \u043f\u0440\u043e\u0446\u0435\u0441\u0441\u0430 \u043b\u0435\u0447\u0438\u0442 \u0441\u0440\u0430\u0437\u0443.<\/p>\n<p><strong>ngrok \u043f\u0435\u0440\u0435\u0441\u043e\u0437\u0434\u0430\u043b \u0434\u043e\u043c\u0435\u043d \u2014 \u043d\u0438\u0447\u0435\u0433\u043e \u043d\u0435 \u0440\u0430\u0431\u043e\u0442\u0430\u0435\u0442.<\/strong> \u0411\u0435\u0441\u043f\u043b\u0430\u0442\u043d\u044b\u0439 ngrok \u0434\u0430\u0451\u0442 \u043d\u043e\u0432\u044b\u0439 \u043f\u043e\u0434\u0434\u043e\u043c\u0435\u043d \u043d\u0430 \u043a\u0430\u0436\u0434\u044b\u0439 \u0441\u0442\u0430\u0440\u0442. Trusted Origins \u043d\u0443\u0436\u043d\u043e \u043e\u0431\u043d\u043e\u0432\u043b\u044f\u0442\u044c \u043a\u0430\u0436\u0434\u044b\u0439 \u0440\u0430\u0437. \u041b\u0435\u0447\u0438\u0442\u0441\u044f \u043b\u0438\u0431\u043e \u043f\u043b\u0430\u0442\u043d\u044b\u043c \u0441\u0442\u0430\u0442\u0438\u0447\u0435\u0441\u043a\u0438\u043c \u0434\u043e\u043c\u0435\u043d\u043e\u043c, \u043b\u0438\u0431\u043e <code>cloudflared tunnel<\/code> \u0441 \u043f\u0440\u0438\u0432\u044f\u0437\u043a\u043e\u0439 \u043a \u0441\u0432\u043e\u0435\u043c\u0443 \u0434\u043e\u043c\u0435\u043d\u0443.<\/p>\n<p><code><strong>\/app<\/strong><\/code><strong> \u0440\u0435\u0434\u0438\u0440\u0435\u043a\u0442\u0438\u0442 \u043d\u0430 <\/strong><code><strong>\/<\/strong><\/code><strong> \u0441\u0440\u0430\u0437\u0443 \u043f\u043e\u0441\u043b\u0435 \u043b\u043e\u0433\u0438\u043d\u0430.<\/strong> Cookie \u0441\u0441\u044b\u043b\u0430\u0435\u0442\u0441\u044f \u043d\u0430 UUID \u044e\u0437\u0435\u0440\u0430, \u043a\u043e\u0442\u043e\u0440\u043e\u0433\u043e \u0432 \u0411\u0414 \u0431\u043e\u043b\u044c\u0448\u0435 \u043d\u0435\u0442 (\u0442\u0438\u043f\u0438\u0447\u043d\u0430\u044f \u0438\u0441\u0442\u043e\u0440\u0438\u044f \u2014 \u0441\u043d\u0451\u0441 \u0444\u0430\u0439\u043b <code>tg_auth.db<\/code> \u043f\u043e\u0441\u043b\u0435 \u043b\u043e\u0433\u0438\u043d\u0430). \u041a\u043e\u043d\u0442\u0440\u043e\u043b\u043b\u0435\u0440 \u0441\u0430\u043c \u044d\u0442\u043e \u0443\u0432\u0438\u0434\u0438\u0442 \u0438 \u043f\u043e\u0447\u0438\u0441\u0442\u0438\u0442 \u0441\u0435\u0441\u0441\u0438\u044e. \u041f\u0440\u043e\u0441\u0442\u043e \u0437\u0430\u043b\u043e\u0433\u0438\u043d\u044c\u0442\u0435\u0441\u044c \u0441\u043d\u043e\u0432\u0430.<\/p>\n<hr\/>\n<h3>\u0418\u0442\u043e\u0433<\/h3>\n<p>\u041d\u043e\u0432\u044b\u0439 Telegram OIDC \u2014 \u044d\u0442\u043e \u0438\u0441\u0442\u043e\u0440\u0438\u044f \u043f\u0440\u043e \u0442\u043e, \u0447\u0442\u043e Telegram \u043f\u0435\u0440\u0435\u0441\u0442\u0430\u043b \u0431\u044b\u0442\u044c \u00ab\u0441\u0432\u043e\u0435\u0439 \u043e\u0441\u043e\u0431\u0435\u043d\u043d\u043e\u0439 \u043a\u043d\u043e\u043f\u043a\u043e\u0439\u00bb \u0438 \u0441\u0442\u0430\u043b \u043e\u0431\u044b\u0447\u043d\u044b\u043c OpenID-\u043f\u0440\u043e\u0432\u0430\u0439\u0434\u0435\u0440\u043e\u043c. \u0412\u043c\u0435\u0441\u0442\u043e HMAC \u0438 <code>\/setdomain<\/code> \u2014 JWKS, JWT, claims. \u041a\u043e\u0434\u0430 \u043d\u0430 \u0431\u044d\u043a\u0435 \u0441\u0442\u0430\u043b\u043e \u043c\u0435\u043d\u044c\u0448\u0435: \u043e\u0434\u0438\u043d <code>jwt.decode<\/code> \u0441 \u043f\u0440\u0430\u0432\u0438\u043b\u044c\u043d\u044b\u043c\u0438 \u043f\u0430\u0440\u0430\u043c\u0435\u0442\u0440\u0430\u043c\u0438 \u0432\u043c\u0435\u0441\u0442\u043e \u0440\u0443\u0447\u043d\u043e\u0439 \u043f\u0440\u043e\u0432\u0435\u0440\u043a\u0438 \u043f\u043e\u0434\u043f\u0438\u0441\u0438. \u0426\u0435\u043d\u044b \u0434\u0432\u0435 \u2014 \u043e\u0431\u044f\u0437\u0430\u0442\u0435\u043b\u044c\u043d\u044b\u0439 HTTPS \u043d\u0430 origin\u2019\u0435 \u0438 \u043d\u0430\u0441\u0442\u0440\u043e\u0439\u043a\u0438 \u0432 mini-app BotFather, \u0430 \u043d\u0435 \u0432 \u0447\u0430\u0442\u0435.<\/p>\n<p>\u0415\u0441\u043b\u0438 \u0445\u043e\u0442\u0438\u0442\u0435 \u043f\u043e\u0442\u0440\u043e\u0433\u0430\u0442\u044c \u0440\u0443\u043a\u0430\u043c\u0438 \u2014 \u043a\u043e\u0434 \u0442\u0443\u0442: <a href=\"https:\/\/github.com\/andy-takker\/tg-auth\" rel=\"noopener noreferrer nofollow\">https:\/\/github.com\/andy-takker\/tg-auth<\/a>. README \u043f\u043e\u0448\u0430\u0433\u043e\u0432\u043e \u043e\u043f\u0438\u0441\u044b\u0432\u0430\u0435\u0442 \u0437\u0430\u043f\u0443\u0441\u043a, \u0430 \u0432 <code>tests\/<\/code> \u043b\u0435\u0436\u0438\u0442 <code>AsyncTestClient<\/code>-\u043e\u0432\u044b\u0435 \u043f\u0440\u043e\u0432\u0435\u0440\u043a\u0438 \u043d\u0430 \u0432\u0435\u0441\u044c HTTP-\u043f\u043e\u0442\u043e\u043a, \u0432\u043a\u043b\u044e\u0447\u0430\u044f \u043d\u0435\u0432\u0430\u043b\u0438\u0434\u043d\u044b\u0439 JWT \u0438 self-heal \u0441\u0442\u0435\u0439\u043b-\u0441\u0435\u0441\u0441\u0438\u0438.<\/p>\n<p>\u0412 \u0441\u043b\u0435\u0434\u0443\u044e\u0449\u0435\u0439 \u0441\u0442\u0430\u0442\u044c\u0435 \u0440\u0430\u0437\u0431\u0435\u0440\u0443, \u043a\u0430\u043a \u0441\u0434\u0435\u043b\u0430\u0442\u044c refresh-\u0442\u043e\u043a\u0435\u043d\u044b \u0442\u0430\u043a, \u0447\u0442\u043e\u0431\u044b \u0437\u0430 \u043d\u0438\u0445 \u043d\u0435 \u0431\u044b\u043b\u043e \u0441\u0442\u044b\u0434\u043d\u043e: \u043e\u0434\u043d\u043e\u0440\u0430\u0437\u043e\u0432\u043e\u0441\u0442\u044c, <code>family_id<\/code>, \u0436\u0443\u0440\u043d\u0430\u043b \u0441\u0435\u0441\u0441\u0438\u0439 \u0432 \u0411\u0414 \u0438 \u0434\u0435\u0442\u0435\u043a\u0446\u0438\u044f \u043f\u0435\u0440\u0435\u0438\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u043d\u0438\u044f.<\/p>\n<\/div>\n<p>\u0441\u0441\u044b\u043b\u043a\u0430 \u043d\u0430 \u043e\u0440\u0438\u0433\u0438\u043d\u0430\u043b \u0441\u0442\u0430\u0442\u044c\u0438 <a href=\"https:\/\/habr.com\/ru\/articles\/1033632\/\">https:\/\/habr.com\/ru\/articles\/1033632\/<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"<p>\u042f \u043f\u0438\u043b\u0438\u043b \u043f\u0435\u0442-\u043f\u0440\u043e\u0435\u043a\u0442 \u2014 \u043d\u0435\u0431\u043e\u043b\u044c\u0448\u043e\u0439 \u0431\u044d\u043a\u0435\u043d\u0434 \u043d\u0430 Litestar \u2014 \u0438 \u0445\u043e\u0442\u0435\u043b \u043f\u0440\u0438\u043a\u0440\u0443\u0442\u0438\u0442\u044c \u043a \u043d\u0435\u043c\u0443 \u043b\u043e\u0433\u0438\u043d \u0447\u0435\u0440\u0435\u0437 Telegram. \u041e\u0442\u043a\u0440\u044b\u043b \u043f\u0435\u0440\u0432\u044b\u0439 \u043f\u043e\u043f\u0430\u0432\u0448\u0438\u0439\u0441\u044f \u0442\u0443\u0442\u043e\u0440\u0438\u0430\u043b \u043d\u0430 GitHub: HMAC \u043e\u0442 bot-token, \/setdomain \u0432 BotFather, \u0433\u043e\u043b\u044b\u0435 \u043f\u043e\u043b\u044f \u044e\u0437\u0435\u0440\u0430 \u0432 callback. \u041f\u043e\u0447\u0442\u0438 \u0432\u0441\u0451, \u0447\u0442\u043e \u044f \u043d\u0430\u0448\u0451\u043b, \u0431\u044b\u043b\u043e \u043f\u0440\u043e \u0441\u0442\u0430\u0440\u044b\u0439 \u0432\u0438\u0434\u0436\u0435\u0442 telegram.org\/js\/telegram-widget.js.\u041e\u0442\u043a\u0440\u044b\u043b \u043e\u0444\u0438\u0446\u0438\u0430\u043b\u044c\u043d\u0443\u044e \u0434\u043e\u043a\u0443 \u2014 \u0430 \u0442\u0430\u043c \u0443\u0436\u0435 \u043d\u0435 \u0432\u0438\u0434\u0436\u0435\u0442, \u0430 \u043f\u043e\u043b\u043d\u043e\u0446\u0435\u043d\u043d\u044b\u0439 OpenID Connect \u0447\u0435\u0440\u0435\u0437 oauth.telegram.org: JWKS, JWT, claims. \u0421\u0435\u043b \u0440\u0430\u0437\u0431\u0438\u0440\u0430\u0442\u044c\u0441\u044f. \u0412 \u0438\u0442\u043e\u0433\u0435 \u0441\u043e\u0431\u0440\u0430\u043b PoC \u2014 \u043e\u043d \u0443\u043c\u0435\u0435\u0442 \u043b\u043e\u0433\u0438\u043d\u0438\u0442\u044c \u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u0435\u043b\u044f \u0447\u0435\u0440\u0435\u0437 \u043d\u043e\u0432\u044b\u0439 OIDC, \u0434\u0435\u0440\u0436\u0438\u0442 cookie-\u0441\u0435\u0441\u0441\u0438\u044e \u0434\u043b\u044f HTML-\u0441\u0442\u0440\u0430\u043d\u0438\u0446 \u0438 \u043e\u0442\u0434\u0430\u0451\u0442 \u043f\u0430\u0440\u0443 access + refresh \u0442\u043e\u043a\u0435\u043d\u043e\u0432 \u0434\u043b\u044f JSON API.\u042d\u0442\u0430 \u0441\u0442\u0430\u0442\u044c\u044f \u2014 \u043f\u0435\u0440\u0435\u0441\u043a\u0430\u0437 \u0442\u043e\u0433\u043e, \u0447\u0442\u043e \u043c\u043d\u0435 \u0441\u0430\u043c\u043e\u043c\u0443 \u0445\u043e\u0442\u0435\u043b\u043e\u0441\u044c \u0431\u044b \u043f\u0440\u043e\u0447\u0438\u0442\u0430\u0442\u044c \u0432 \u043d\u0430\u0447\u0430\u043b\u0435: \u0433\u0434\u0435 \u0432 \u043f\u043e\u0442\u043e\u043a\u0435 \u0434\u0430\u043d\u043d\u044b\u0445 Telegram, \u0433\u0434\u0435 \u0431\u0440\u0430\u0443\u0437\u0435\u0440, \u0433\u0434\u0435 \u043d\u0430\u0448 \u0431\u044d\u043a, \u0438 \u043a\u0430\u043a\u0438\u0435 \u043a\u0443\u0441\u043a\u0438 \u043d\u0443\u0436\u043d\u043e \u0440\u0435\u0430\u043b\u044c\u043d\u043e \u043f\u0438\u0441\u0430\u0442\u044c \u0440\u0443\u043a\u0430\u043c\u0438. \u041f\u043e \u0445\u043e\u0434\u0443 \u2014 \u0442\u0443\u0442\u043e\u0440\u0438\u0430\u043b: \u043d\u0430\u0441\u0442\u0440\u043e\u0439\u043a\u0430 \u0431\u043e\u0442\u0430 \u0432 BotFather, \u043b\u043e\u043a\u0430\u043b\u044c\u043d\u044b\u0439 \u0442\u0435\u0441\u0442 \u0447\u0435\u0440\u0435\u0437 ngrok, \u0437\u0430\u043f\u0443\u0441\u043a.\u041a\u043e\u0434 \u043f\u0440\u0438\u043c\u0435\u0440\u043e\u0432 \u2014 \u0438\u0437 \u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u044f https:\/\/github.com\/andy-takker\/tg-auth. \u0421\u0442\u0435\u043a: Python 3.13, Litestar, PyJWT, SQLAlchemy 2.0, aiosqlite. \u041d\u043e \u0441\u0430\u043c OIDC-\u0444\u043b\u043e\u0443 \u0441\u043e \u0441\u0442\u0435\u043a\u043e\u043c \u043d\u0435 \u0441\u0432\u044f\u0437\u0430\u043d \u2014 \u0442\u0435 \u0436\u0435 \u0448\u0430\u0433\u0438 \u043f\u043e\u0432\u0442\u043e\u0440\u044f\u044e\u0442\u0441\u044f \u043d\u0430 FastAPI, Django \u0438\u043b\u0438 \u0447\u0451\u043c \u0443\u0433\u043e\u0434\u043d\u043e \u0435\u0449\u0451.\u0421\u0442\u0430\u0440\u044b\u0439 \u0432\u0438\u0434\u0436\u0435\u0442 \u2260 \u043d\u043e\u0432\u044b\u0439 OIDC\u0415\u0441\u043b\u0438 \u0432\u044b \u043e\u0442\u043a\u0440\u044b\u0432\u0430\u043b\u0438 \u0441\u0442\u0430\u0440\u044b\u0435 \u0442\u0443\u0442\u043e\u0440\u0438\u0430\u043b\u044b \u043f\u0440\u043e Telegram Login \u2014 \u0437\u0430\u0431\u0443\u0434\u044c\u0442\u0435 \u0438\u0445 \u0441\u0440\u0430\u0437\u0443, \u043f\u043e\u0442\u043e\u043a\u0438 \u0440\u0430\u0437\u043d\u044b\u0435.\u0421\u0442\u0430\u0440\u044b\u0439 \u0432\u0438\u0434\u0436\u0435\u0442 (telegram-widget.js):\u043a\u043d\u043e\u043f\u043a\u0430 \u0432\u0441\u0442\u0430\u0432\u043b\u044f\u0435\u0442\u0441\u044f \u043d\u0430 \u043b\u044e\u0431\u043e\u0439 http:\/\/-\u0441\u0430\u0439\u0442;Telegram \u0432\u043e\u0437\u0432\u0440\u0430\u0449\u0430\u0435\u0442 \u043f\u043e\u043b\u044f \u044e\u0437\u0435\u0440\u0430 \u043f\u0440\u044f\u043c\u043e \u0432 URL \u0438\u043b\u0438 \u0432 JS-callback;\u043f\u043e\u0434\u043b\u0438\u043d\u043d\u043e\u0441\u0442\u044c \u043f\u0440\u043e\u0432\u0435\u0440\u044f\u0435\u0442\u0441\u044f HMAC-SHA256 \u043e\u0442 \u0442\u043e\u043a\u0435\u043d\u0430 \u0431\u043e\u0442\u0430;\u0432 BotFather \u0432\u044b \u043f\u0440\u043e\u043f\u0438\u0441\u044b\u0432\u0430\u0435\u0442\u0435 \u0434\u043e\u043c\u0435\u043d \u0447\u0435\u0440\u0435\u0437 \/setdomain.\u0415\u0441\u043b\u0438 \u0432 \u0442\u0443\u0442\u043e\u0440\u0438\u0430\u043b\u0435 \u0432\u0438\u0434\u0438\u0442\u0435 \u0447\u0442\u043e-\u0442\u043e \u0432\u0440\u043e\u0434\u0435 hash = HMAC_SHA256(data_check_string, SHA256(bot_token)) \u0438 \u043f\u043e\u043b\u044f id, first_name, auth_date, hash \u2014 \u044d\u0442\u043e \u0438 \u0435\u0441\u0442\u044c legacy-\u0432\u0438\u0434\u0436\u0435\u0442, \u0437\u0430\u043a\u0440\u044b\u0432\u0430\u0439\u0442\u0435.\u041d\u043e\u0432\u044b\u0439 OIDC-\u0444\u043b\u043e\u0443 (oauth.telegram.org):Telegram \u0441\u0442\u0430\u043b \u043f\u043e\u043b\u043d\u043e\u0446\u0435\u043d\u043d\u044b\u043c OpenID-\u043f\u0440\u043e\u0432\u0430\u0439\u0434\u0435\u0440\u043e\u043c;\u0435\u0441\u0442\u044c \/.well-known\/openid-configuration, \u0435\u0441\u0442\u044c JWKS;ID-\u0442\u043e\u043a\u0435\u043d \u2014 \u043d\u0430\u0441\u0442\u043e\u044f\u0449\u0438\u0439 JWT, \u043f\u043e\u0434\u043f\u0438\u0441\u0430\u043d\u043d\u044b\u0439 \u043f\u0443\u0431\u043b\u0438\u0447\u043d\u044b\u043c \u043a\u043b\u044e\u0447\u043e\u043c \u0438\u0437 JWKS Telegram;\u0431\u044d\u043a\u0435\u043d\u0434 \u043f\u0440\u043e\u0432\u0435\u0440\u044f\u0435\u0442 \u043f\u043e\u0434\u043f\u0438\u0441\u044c \u043f\u043e \u044d\u0442\u043e\u043c\u0443 \u043a\u043b\u044e\u0447\u0443, \u0430\u0443\u0434\u0438\u0442\u043e\u0440\u0438\u044e (aud), \u0438\u0437\u0434\u0430\u0442\u0435\u043b\u044f (iss), exp\/iat;bot-token \u043f\u0440\u0438 \u0430\u0432\u0442\u043e\u0440\u0438\u0437\u0430\u0446\u0438\u0438 \u043d\u0435 \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u0435\u0442\u0441\u044f \u2014 \u043e\u043d \u0442\u043e\u043b\u044c\u043a\u043e \u0434\u043b\u044f Bot API. \u041d\u0435 \u043f\u0443\u0442\u0430\u0442\u044c \u0435\u0433\u043e \u0441 Client Secret: BotFather \u0432 Web Login \u0432\u044b\u0434\u0430\u0451\u0442 \u043f\u0430\u0440\u0443 Client ID + Client Secret, \u0438 Client Secret \u043d\u0443\u0436\u0435\u043d \u0434\u043b\u044f manual OIDC code flow. \u0412 popup-\u0432\u0430\u0440\u0438\u0430\u043d\u0442\u0435 \u0431\u044d\u043a \u0435\u0433\u043e \u043d\u0435 \u0432\u0438\u0434\u0438\u0442, \u043d\u043e \u0432 \u043f\u043e\u043b\u043d\u043e\u043c flow \u043e\u043d \u0435\u0441\u0442\u044c.\u041f\u043e\u043b\u044c\u0437\u0430 \u043e\u0442 \u043f\u0435\u0440\u0435\u0445\u043e\u0434\u0430 \u2014 \u0441\u0442\u0430\u043d\u0434\u0430\u0440\u0442\u043d\u044b\u0439 \u043f\u0440\u043e\u0442\u043e\u043a\u043e\u043b, \u043d\u0438\u043a\u0430\u043a\u043e\u0439 \u0440\u0443\u0447\u043d\u043e\u0439 HMAC-\u043f\u0440\u043e\u0432\u0435\u0440\u043a\u0438 legacy-\u043f\u043e\u043b\u0435\u0439 \u0438 \u0441\u043e\u0432\u043c\u0435\u0441\u0442\u0438\u043c\u043e\u0441\u0442\u044c \u0441 \u043b\u044e\u0431\u043e\u0439 OIDC-\u0431\u0438\u0431\u043b\u0438\u043e\u0442\u0435\u043a\u043e\u0439. \u0426\u0435\u043d\u0430 \u2014 \u0434\u0440\u0443\u0433\u043e\u0439 \u043d\u0430\u0431\u043e\u0440 \u043d\u0430\u0441\u0442\u0440\u043e\u0435\u043a \u0432 BotFather \u0438 \u043e\u0431\u044f\u0437\u0430\u0442\u0435\u043b\u044c\u043d\u044b\u0439 HTTPS \u043d\u0430 origin\u2019\u0435.\u0415\u0449\u0451 \u043e\u0434\u0438\u043d \u043d\u044e\u0430\u043d\u0441, \u043d\u0430 \u043a\u043e\u0442\u043e\u0440\u044b\u0439 \u044f \u043d\u0435 \u0441\u0440\u0430\u0437\u0443 \u043e\u0431\u0440\u0430\u0442\u0438\u043b \u0432\u043d\u0438\u043c\u0430\u043d\u0438\u0435. \u0423 \u043d\u043e\u0432\u043e\u0433\u043e Telegram Login \u043d\u0430 \u0441\u0430\u043c\u043e\u043c \u0434\u0435\u043b\u0435 \u0434\u0432\u0430 \u0440\u0435\u0436\u0438\u043c\u0430:Login library \u2014 \u0431\u0440\u0430\u0443\u0437\u0435\u0440\u043d\u044b\u0439 popup \u0447\u0435\u0440\u0435\u0437 telegram-login.js. Telegram \u0432\u043d\u0443\u0442\u0440\u0438 popup-\u0430 \u0441\u0430\u043c \u0434\u0435\u043b\u0430\u0435\u0442 Authorization Code Flow \u0441 PKCE \u0438 \u0432\u043e\u0437\u0432\u0440\u0430\u0449\u0430\u0435\u0442 \u043d\u0430\u043c \u0443\u0436\u0435 \u0433\u043e\u0442\u043e\u0432\u044b\u0439 id_token \u0447\u0435\u0440\u0435\u0437 postMessage. \u0411\u044d\u043a \u0442\u043e\u043b\u044c\u043a\u043e \u043f\u0440\u043e\u0432\u0435\u0440\u044f\u0435\u0442 JWT \u2014 \u043d\u0438\u043a\u0430\u043a\u043e\u0433\u043e Client Secret, \u043d\u0438\u043a\u0430\u043a\u043e\u0433\u043e PKCE \u043d\u0430 \u043d\u0430\u0448\u0435\u0439 \u0441\u0442\u043e\u0440\u043e\u043d\u0435.Manual OIDC \u2014 \u043e\u0431\u044b\u0447\u043d\u044b\u0439 Authorization Code Flow: \u0432\u044b \u0441\u0430\u043c\u0438 \u0440\u0435\u0434\u0438\u0440\u0435\u043a\u0442\u0438\u0442\u0435 \u044e\u0437\u0435\u0440\u0430 \u043d\u0430 oauth.telegram.org\/auth, \u043b\u043e\u0432\u0438\u0442\u0435 code \u0432 \u0441\u0432\u043e\u0451\u043c callback\u2019\u0435 \u0438 \u043c\u0435\u043d\u044f\u0435\u0442\u0435 \u0435\u0433\u043e \u043d\u0430 \u0442\u043e\u043a\u0435\u043d\u044b \u0447\u0435\u0440\u0435\u0437 \/token (Basic Auth \u0441 Client ID + Client Secret).\u0412 \u044d\u0442\u043e\u0439 \u0441\u0442\u0430\u0442\u044c\u0435 \u2014 \u043f\u0435\u0440\u0432\u044b\u0439 \u0432\u0430\u0440\u0438\u0430\u043d\u0442. \u041e\u043d \u043f\u0440\u043e\u0449\u0435 \u0438 \u0434\u043b\u044f \u0442\u0438\u043f\u043e\u0432\u043e\u0433\u043e \u0432\u0435\u0431\u0430 \u0435\u0433\u043e \u0434\u043e\u0441\u0442\u0430\u0442\u043e\u0447\u043d\u043e. Manual flow \u043d\u0443\u0436\u0435\u043d, \u0435\u0441\u043b\u0438 \u0443 \u0432\u0430\u0441 \u043d\u0430\u0442\u0438\u0432\u043d\u044b\u0439 \u043a\u043b\u0438\u0435\u043d\u0442 \u0431\u0435\u0437 \u0431\u0440\u0430\u0443\u0437\u0435\u0440\u0430 \u0438\u043b\u0438 \u0445\u043e\u0447\u0435\u0442\u0441\u044f \u0434\u0435\u0440\u0436\u0430\u0442\u044c \u0432\u0435\u0441\u044c OAuth-\u043e\u0431\u043c\u0435\u043d \u0432 \u0441\u0432\u043e\u0438\u0445 \u0440\u0443\u043a\u0430\u0445.\u0427\u0442\u043e \u043c\u044b \u0441\u043e\u0431\u0435\u0440\u0451\u043c\u041c\u0438\u043d\u0438\u043c\u0430\u043b\u044c\u043d\u044b\u0439 \u043d\u0430\u0431\u043e\u0440 \u043c\u0430\u0440\u0448\u0440\u0443\u0442\u043e\u0432:\u041c\u0435\u0442\u043e\u0434\u041f\u0443\u0442\u044c\u0417\u0430\u0447\u0435\u043cGET\/\u0421\u0442\u0440\u0430\u043d\u0438\u0446\u0430 \u043b\u043e\u0433\u0438\u043d\u0430 \u0441 \u0432\u0438\u0434\u0436\u0435\u0442\u043e\u043c TelegramPOST\/api\/v1\/auth\/telegram\u041f\u0440\u0438\u043d\u0438\u043c\u0430\u0435\u0442 id_token, \u0432\u0430\u043b\u0438\u0434\u0438\u0440\u0443\u0435\u0442, \u0430\u043f\u0441\u0435\u0440\u0442\u0438\u0442 \u044e\u0437\u0435\u0440\u0430, \u0441\u0442\u0430\u0432\u0438\u0442 cookie + \u043e\u0442\u0434\u0430\u0451\u0442 access\/refreshPOST\/api\/v1\/auth\/refresh\u041c\u0435\u043d\u044f\u0435\u0442 refresh \u043d\u0430 \u043d\u043e\u0432\u0443\u044e \u043f\u0430\u0440\u0443POST\/api\/v1\/auth\/logout\u0427\u0438\u0441\u0442\u0438\u0442 cookieGET\/app\u0417\u0430\u0449\u0438\u0449\u0451\u043d\u043d\u0430\u044f HTML-\u0441\u0442\u0440\u0430\u043d\u0438\u0446\u0430, \u0447\u0438\u0442\u0430\u0435\u0442 \u044e\u0437\u0435\u0440\u0430 \u043f\u043e cookieCookie-\u0441\u0435\u0441\u0441\u0438\u044f \u043d\u0443\u0436\u043d\u0430, \u0447\u0442\u043e\u0431\u044b HTML-\u0441\u0442\u0440\u0430\u043d\u0438\u0446\u044b \u00ab\u043f\u043e\u043c\u043d\u0438\u043b\u0438\u00bb \u044e\u0437\u0435\u0440\u0430 \u043c\u0435\u0436\u0434\u0443 \u0437\u0430\u043f\u0440\u043e\u0441\u0430\u043c\u0438. JWT-\u043f\u0430\u0440\u0430 \u2014 \u0434\u043b\u044f JSON API (\u043c\u043e\u0431\u0438\u043b\u043a\u0430\/SPA). \u041e\u0434\u0438\u043d \u043b\u043e\u0433\u0438\u043d \u0432\u044b\u0434\u0430\u0451\u0442 \u0441\u0440\u0430\u0437\u0443 \u043e\u0431\u0435 \u0432\u0435\u0449\u0438.\u26a0\ufe0f \u041f\u0440\u043e \u0441\u0430\u043c\u0438 JWT-\u0442\u043e\u043a\u0435\u043d\u044b \u0433\u043b\u0443\u0431\u043e\u043a\u043e \u043b\u0435\u0437\u0442\u044c \u0437\u0434\u0435\u0441\u044c \u043d\u0435 \u0431\u0443\u0434\u0443 \u2014 \u0432 PoC \u044d\u0442\u043e \u043f\u0440\u043e\u0441\u0442\u043e HS256 \u0431\u0435\u0437 \u0445\u0440\u0430\u043d\u0435\u043d\u0438\u044f \u0432 \u0411\u0414. \u041f\u043e\u043b\u043d\u043e\u0446\u0435\u043d\u043d\u044b\u0439 refresh-\u0444\u043b\u043e\u0443 \u0441 \u043e\u0434\u043d\u043e\u0440\u0430\u0437\u043e\u0432\u043e\u0441\u0442\u044c\u044e, family_id \u0438 \u043e\u0442\u0441\u043b\u0435\u0436\u0438\u0432\u0430\u043d\u0438\u0435\u043c \u0441\u0435\u0441\u0441\u0438\u0439 \u2014 \u0442\u0435\u043c\u0430 \u0431\u043e\u043b\u044c\u0448\u0430\u044f \u0438 \u0437\u0430\u0441\u043b\u0443\u0436\u0438\u0432\u0430\u0435\u0442 \u043e\u0442\u0434\u0435\u043b\u044c\u043d\u043e\u0439 \u0441\u0442\u0430\u0442\u044c\u0438. \u0417\u0434\u0435\u0441\u044c \u0443\u043f\u043e\u0440 \u043d\u0430 \u0441\u0430\u043c OIDC-\u043e\u0431\u043c\u0435\u043d.\u041a\u0430\u0440\u0442\u0438\u043d\u043a\u0430 \u0446\u0435\u043b\u0438\u043a\u043e\u043c: \u043a\u0442\u043e \u0441 \u043a\u0435\u043c \u043e\u0431\u0449\u0430\u0435\u0442\u0441\u044f\u041f\u0440\u0435\u0436\u0434\u0435 \u0447\u0435\u043c \u043d\u044b\u0440\u044f\u0442\u044c \u0432 \u043a\u043e\u0434, \u0443\u0434\u043e\u0431\u043d\u043e \u0434\u0435\u0440\u0436\u0430\u0442\u044c \u0432 \u0433\u043e\u043b\u043e\u0432\u0435 \u0440\u043e\u043b\u0435\u0432\u0443\u044e \u0441\u0445\u0435\u043c\u0443. \u0412\u043e\u0442 \u043a\u0442\u043e \u0443\u0447\u0430\u0441\u0442\u0432\u0443\u0435\u0442 \u0438 \u0437\u0430 \u0447\u0442\u043e \u043e\u0442\u0432\u0435\u0447\u0430\u0435\u0442:\u0413\u043b\u0430\u0432\u043d\u043e\u0435, \u0447\u0442\u043e \u0441\u0442\u043e\u0438\u0442 \u0443\u0432\u0438\u0434\u0435\u0442\u044c \u043d\u0430 \u044d\u0442\u043e\u0439 \u0441\u0445\u0435\u043c\u0435: \u043f\u043e\u043b\u043d\u044b\u0439 OAuth-\u043e\u0431\u043c\u0435\u043d \/auth \u2192 \/token \u043f\u0440\u043e\u0438\u0441\u0445\u043e\u0434\u0438\u0442 \u0432\u043d\u0443\u0442\u0440\u0438 popup-\u0430 Telegram. \u0411\u044d\u043a\u0435\u043d\u0434 \u043d\u0435 \u0434\u0435\u043b\u0430\u0435\u0442 \u043d\u0438 \u043e\u0434\u043d\u043e\u0433\u043e \u0437\u0430\u043f\u0440\u043e\u0441\u0430 \u043a oauth.telegram.org\/token, \u043d\u0435 \u0445\u0440\u0430\u043d\u0438\u0442 Client Secret, \u043d\u0435 \u0432\u043e\u0437\u0438\u0442\u0441\u044f \u0441 PKCE \u0438 redirect URI. \u041f\u043e\u043b\u0443\u0447\u0430\u0435\u0442 \u0443\u0436\u0435 \u0433\u043e\u0442\u043e\u0432\u044b\u0439 id_token, \u0438 \u0435\u0433\u043e \u043e\u0441\u0442\u0430\u0451\u0442\u0441\u044f \u0442\u043e\u043b\u044c\u043a\u043e \u043f\u0440\u043e\u0432\u0435\u0440\u0438\u0442\u044c.\u0427\u0442\u043e \u043f\u0440\u043e\u0438\u0441\u0445\u043e\u0434\u0438\u0442 \u043f\u0440\u0438 \u043f\u0435\u0440\u0432\u043e\u043c \u043b\u043e\u0433\u0438\u043d\u0435: \u043f\u043e\u0448\u0430\u0433\u043e\u0432\u043e\u0413\u043b\u0430\u0432\u043d\u0430\u044f sequence-\u0434\u0438\u0430\u0433\u0440\u0430\u043c\u043c\u0430 \u0441\u0442\u0430\u0442\u044c\u0438. \u041f\u043e\u0434\u0440\u043e\u0431\u043d\u043e \u2014 \u0447\u0442\u043e \u0438 \u0432 \u043a\u0430\u043a\u043e\u043c \u043f\u043e\u0440\u044f\u0434\u043a\u0435 \u043b\u0435\u0442\u0430\u0435\u0442 \u043f\u043e \u0441\u0435\u0442\u0438.\u0427\u0442\u043e \u0437\u0434\u0435\u0441\u044c \u0432\u0430\u0436\u043d\u043e:1. id_token \u043a \u043d\u0430\u043c \u043f\u0440\u0438\u0445\u043e\u0434\u0438\u0442 \u0447\u0435\u0440\u0435\u0437 postMessage, \u0430 \u043d\u0435 \u0447\u0435\u0440\u0435\u0437 redirect. \u041d\u0438\u043a\u0430\u043a\u0438\u0445 ?code=&#8230; \u0432 URL, \u043d\u0438\u043a\u0430\u043a\u043e\u0433\u043e \u0440\u0435\u0434\u0438\u0440\u0435\u043a\u0442\u0430 \u043d\u0430 \/callback. Telegram-popup \u0432\u043d\u0443\u0442\u0440\u0438 \u0441\u0435\u0431\u044f \u043f\u0440\u043e\u0432\u043e\u0434\u0438\u0442 \u043f\u043e\u043b\u043d\u0443\u044e OAuth-\u0430\u0432\u0442\u043e\u0440\u0438\u0437\u0430\u0446\u0438\u044e \u0438 \u043e\u0442\u0434\u0430\u0451\u0442 \u043d\u0430\u043c \u0443\u0436\u0435 \u043f\u043e\u0434\u043f\u0438\u0441\u0430\u043d\u043d\u044b\u0439 JWT \u0447\u0435\u0440\u0435\u0437 window.postMessage. HTTPS \u043d\u0430 origin\u2019\u0435 \u043d\u0443\u0436\u0435\u043d \u043d\u0435 \u0438\u0437-\u0437\u0430 postMessage (\u043e\u043d \u043a\u0430\u043a \u0440\u0430\u0437 \u0434\u043b\u044f cross-origin \u043e\u0431\u0449\u0435\u043d\u0438\u044f \u0438 \u0441\u0434\u0435\u043b\u0430\u043d), \u0430 \u043f\u043e\u0442\u043e\u043c\u0443 \u0447\u0442\u043e Telegram \u043f\u0443\u0441\u043a\u0430\u0435\u0442 \u0432 Trusted Origins \u0442\u043e\u043b\u044c\u043a\u043e HTTPS-\u0441\u0445\u0435\u043c\u044b.2. JWKS \u2014 \u044d\u0442\u043e \u043f\u0443\u0431\u043b\u0438\u0447\u043d\u044b\u0435 \u043a\u043b\u044e\u0447\u0438, \u043f\u043e \u043a\u043e\u0442\u043e\u0440\u044b\u043c \u043c\u044b \u043f\u0440\u043e\u0432\u0435\u0440\u044f\u0435\u043c \u043f\u043e\u0434\u043f\u0438\u0441\u044c JWT. \u041c\u044b \u0438\u0445 \u0437\u0430\u0431\u0438\u0440\u0430\u0435\u043c \u043e\u0434\u0438\u043d \u0440\u0430\u0437 \u0438 \u043a\u044d\u0448\u0438\u0440\u0443\u0435\u043c. PyJWKClient \u0438\u0437 pyjwt \u044d\u0442\u043e \u0443\u043c\u0435\u0435\u0442 \u0438\u0437 \u043a\u043e\u0440\u043e\u0431\u043a\u0438:from jwt import PyJWKClientjwks_client = PyJWKClient(    &#171;https:\/\/oauth.telegram.org\/.well-known\/jwks.json&#187;,    cache_keys=True,    lifespan=600,  # 10 \u043c\u0438\u043d\u0443\u0442)\u0412 \u043c\u043e\u0451\u043c \u043f\u0440\u0438\u043b\u043e\u0436\u0435\u043d\u0438\u0438 \u044d\u0442\u043e\u0442 \u043a\u043b\u0438\u0435\u043d\u0442 \u0441\u043e\u0437\u0434\u0430\u0451\u0442\u0441\u044f \u043e\u0434\u0438\u043d \u0440\u0430\u0437 \u043f\u0440\u0438 \u0441\u0442\u0430\u0440\u0442\u0435 \u0438 \u0438\u043d\u0436\u0435\u043a\u0442\u0438\u0442\u0441\u044f \u0432 use-case \u0447\u0435\u0440\u0435\u0437 DI.3. \u0421\u0430\u043c\u0430 \u0432\u0430\u043b\u0438\u0434\u0430\u0446\u0438\u044f \u2014 \u044d\u0442\u043e \u043e\u0434\u0438\u043d \u0432\u044b\u0437\u043e\u0432 jwt.decode \u0441 \u043f\u0440\u0430\u0432\u0438\u043b\u044c\u043d\u044b\u043c\u0438 \u043f\u0430\u0440\u0430\u043c\u0435\u0442\u0440\u0430\u043c\u0438. \u041d\u0438\u043a\u0430\u043a\u043e\u0433\u043e \u0440\u0443\u0447\u043d\u043e\u0433\u043e HMAC-\u0430, \u043d\u0438\u043a\u0430\u043a\u0438\u0445 \u0441\u0440\u0430\u0432\u043d\u0435\u043d\u0438\u0439 \u0441\u0442\u0440\u043e\u043a:def _verify_telegram_id_token(id_token: str, jwks_client, client_id, issuer):    if not id_token:        raise ValueError(&#171;Empty id_token&#187;)    signing_key = jwks_client.get_signing_key_from_jwt(id_token).key    return jwt.decode(        id_token,        signing_key,        algorithms=[&#171;RS256&#187;, &#171;ES256&#187;],        audience=client_id,                       # \u0432\u0430\u0448 Client ID \u0438\u0437 BotFather        issuer=issuer,                            # &#171;https:\/\/oauth.telegram.org&#187;        options={&#171;require&#187;: [&#171;iss&#187;, &#171;aud&#187;, &#171;exp&#187;, &#171;iat&#187;, &#171;sub&#187;]},        leeway=30,                                # \u043d\u0430 \u0440\u0430\u0441\u0441\u0438\u043d\u0445\u0440\u043e\u043d \u0447\u0430\u0441\u043e\u0432    )\u0415\u0441\u043b\u0438 \u0445\u043e\u0442\u044c \u0447\u0442\u043e-\u0442\u043e \u043d\u0435 \u0441\u043e\u0448\u043b\u043e\u0441\u044c \u2014 \u043f\u043e\u0434\u043f\u0438\u0441\u044c, audience, \u0438\u0441\u0442\u0451\u043a\u0448\u0438\u0439 \u0441\u0440\u043e\u043a \u2014 jwt.decode \u0431\u0440\u043e\u0441\u0438\u0442 \u0438\u0441\u043a\u043b\u044e\u0447\u0435\u043d\u0438\u0435, \u043c\u044b \u043f\u0435\u0440\u0435\u0432\u043e\u0434\u0438\u043c \u0435\u0433\u043e \u0432 401. \u0412\u0441\u0451.\u0422\u0443\u0442 \u0443\u043c\u0435\u0441\u0442\u043d\u0430\u044f \u043e\u0433\u043e\u0432\u043e\u0440\u043a\u0430. \u0412 \u043a\u043e\u043c\u043c\u0435\u043d\u0442\u0430\u0440\u0438\u044f\u0445 \u043e\u0431\u044f\u0437\u0430\u0442\u0435\u043b\u044c\u043d\u043e \u0441\u043f\u0440\u043e\u0441\u044f\u0442: \u00ab\u0437\u0430\u0447\u0435\u043c \u0440\u0443\u043a\u0430\u043c\u0438 \u0447\u0435\u0440\u0435\u0437 PyJWT, \u043a\u043e\u0433\u0434\u0430 \u0435\u0441\u0442\u044c authlib?\u00bb. \u0418 \u0434\u0430, \u0434\u043b\u044f \u043f\u0440\u043e\u0434\u0430 authlib \u0447\u0430\u0441\u0442\u043e \u043f\u0440\u0430\u0432\u0438\u043b\u044c\u043d\u044b\u0439 \u0432\u044b\u0431\u043e\u0440 \u2014 \u0443\u043c\u0435\u0435\u0442 \u043f\u043e\u043b\u043d\u043e\u0446\u0435\u043d\u043d\u044b\u0439 OAuth\/OIDC-\u043a\u043b\u0438\u0435\u043d\u0442 \u0441 \u043e\u0431\u043c\u0435\u043d\u043e\u043c code \u2192 token, \u043a\u044d\u0448\u0438\u0440\u0443\u0435\u0442 JWKS, \u043f\u0440\u043e\u0432\u0435\u0440\u044f\u0435\u0442 nonce, \u0434\u0440\u0443\u0436\u0438\u0442 \u0441\u043e Starlette\/FastAPI\/Flask\/Django. \u0415\u0441\u043b\u0438 \u0443 \u0432\u0430\u0441 \u0432 \u043f\u0440\u043e\u0435\u043a\u0442\u0435 \u0443\u0436\u0435 \u043d\u0435 \u043e\u0434\u0438\u043d OIDC-\u043f\u0440\u043e\u0432\u0430\u0439\u0434\u0435\u0440 \u0438\u043b\u0438 \u043f\u043b\u0430\u043d\u0438\u0440\u0443\u0435\u0442\u0441\u044f manual code flow \u0441 PKCE \u2014 \u0431\u0435\u0440\u0438\u0442\u0435 authlib, \u043d\u0435 \u043f\u0438\u0448\u0438\u0442\u0435 \u044d\u0442\u043e \u0440\u0443\u043a\u0430\u043c\u0438. \u0417\u0434\u0435\u0441\u044c \u044f \u0441\u043e\u0437\u043d\u0430\u0442\u0435\u043b\u044c\u043d\u043e \u043f\u043e\u0448\u0451\u043b \u0433\u043e\u043b\u044b\u043c PyJWT, \u0447\u0442\u043e\u0431\u044b \u0431\u044b\u043b\u043e \u0432\u0438\u0434\u043d\u043e, \u043a\u0430\u043a\u0438\u0435 \u0438\u043c\u0435\u043d\u043d\u043e claim\u2019\u044b \u0438 \u043a\u0430\u043a\u0438\u0435 \u043f\u0440\u043e\u0432\u0435\u0440\u043a\u0438 \u043f\u0440\u043e\u0438\u0441\u0445\u043e\u0434\u044f\u0442 \u2014 \u0438 \u043a\u0430\u043a\u0438\u0435 \u0438\u0437 \u043d\u0438\u0445 Telegram-\u0441\u043f\u0435\u0446\u0438\u0444\u0438\u0447\u043d\u044b\u0435 (\u043d\u0438\u043a\u0430\u043a\u0438\u0445).\u041e\u0434\u0438\u043d \u0432\u0430\u0436\u043d\u044b\u0439 \u043f\u0443\u043d\u043a\u0442, \u043a\u043e\u0442\u043e\u0440\u044b\u0439 \u0432 \u043c\u043e\u0451\u043c PoC \u043d\u0435 \u0440\u0435\u0430\u043b\u0438\u0437\u043e\u0432\u0430\u043d \u2014 \u043f\u0440\u043e\u0432\u0435\u0440\u043a\u0430 nonce. \u0412 \u043f\u0440\u043e\u0434\u0435 \u044d\u0442\u043e \u0434\u0435\u043b\u0430\u0435\u0442\u0441\u044f \u0442\u0430\u043a: \u0441\u0435\u0440\u0432\u0435\u0440 \u043f\u0435\u0440\u0435\u0434 \u043e\u0442\u043a\u0440\u044b\u0442\u0438\u0435\u043c popup-\u0430 \u0433\u0435\u043d\u0435\u0440\u0438\u0440\u0443\u0435\u0442 \u0441\u043b\u0443\u0447\u0430\u0439\u043d\u043e\u0435 \u0437\u043d\u0430\u0447\u0435\u043d\u0438\u0435, \u043a\u043b\u0430\u0434\u0451\u0442 \u0435\u0433\u043e \u0432 \u0441\u0432\u043e\u044e \u0441\u0435\u0441\u0441\u0438\u044e, \u043f\u0435\u0440\u0435\u0434\u0430\u0451\u0442 \u0432 Telegram.Login.init(&#8230;), \u0430 \u043f\u043e\u0441\u043b\u0435 \u0432\u0430\u043b\u0438\u0434\u0430\u0446\u0438\u0438 id_token \u0441\u0432\u0435\u0440\u044f\u0435\u0442 claim nonce \u0441 \u0442\u0435\u043c, \u0447\u0442\u043e \u043b\u0435\u0436\u0438\u0442 \u0432 \u0441\u0435\u0441\u0441\u0438\u0438. \u042d\u0442\u043e \u0437\u0430\u0449\u0438\u0442\u0430 \u043e\u0442 replay: \u043f\u0435\u0440\u0435\u0445\u0432\u0430\u0447\u0435\u043d\u043d\u044b\u0439 \u043a\u043e\u0433\u0434\u0430-\u0442\u043e id_token \u043d\u0435 \u0441\u0440\u0430\u0431\u043e\u0442\u0430\u0435\u0442 \u043f\u043e\u0432\u0442\u043e\u0440\u043d\u043e. \u0415\u0441\u043b\u0438 \u0434\u0435\u043b\u0430\u0435\u0442\u0435 \u043f\u0440\u043e\u0434 \u2014 \u0434\u043e\u0431\u0430\u0432\u044c\u0442\u0435 \u0432 options.require \u0441\u0442\u0440\u043e\u043a\u0443 &#171;nonce&#187; \u0438 \u0441\u0440\u0430\u0432\u043d\u0438\u0432\u0430\u0439\u0442\u0435.4. \u041f\u043e\u0441\u043b\u0435 \u0432\u0430\u043b\u0438\u0434\u0430\u0446\u0438\u0438 \u2014 \u0434\u0435\u043b\u0430\u0435\u043c upsert \u044e\u0437\u0435\u0440\u0430. \u0412 id_token \u043b\u0435\u0436\u0430\u0442 claim\u2019\u044b: sub (\u0441\u0442\u0430\u0431\u0438\u043b\u044c\u043d\u044b\u0439 OIDC-\u0438\u0434\u0435\u043d\u0442\u0438\u0444\u0438\u043a\u0430\u0442\u043e\u0440 \u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u0435\u043b\u044f \u0443 Telegram), id (\u0447\u0438\u0441\u043b\u043e\u0432\u043e\u0439 Telegram user id, \u043c\u043e\u0436\u0435\u0442 \u043f\u0440\u0438\u0441\u0443\u0442\u0441\u0442\u0432\u043e\u0432\u0430\u0442\u044c \u043e\u0442\u0434\u0435\u043b\u044c\u043d\u043e), name, preferred_username, picture, phone_number (\u0435\u0441\u043b\u0438 \u044e\u0437\u0435\u0440 \u0434\u0430\u043b scope phone). \u0412 \u043a\u043e\u0434\u0435 \u044f \u0431\u0435\u0440\u0443 id, \u0430 \u0435\u0441\u043b\u0438 \u0435\u0433\u043e \u043d\u0435\u0442 \u2014 \u0444\u043e\u043b\u0431\u044d\u043a \u043d\u0430 sub; \u0442\u0430\u043a \u0447\u0443\u0442\u044c \u043d\u0430\u0434\u0451\u0436\u043d\u0435\u0435, \u0447\u0435\u043c \u0437\u0430\u0432\u044f\u0437\u044b\u0432\u0430\u0442\u044c\u0441\u044f \u043d\u0430 \u043e\u0434\u0438\u043d \u0438\u0437 \u0434\u0432\u0443\u0445. \u0418\u0437 \u044d\u0442\u0438\u0445 \u043f\u043e\u043b\u0435\u0439 \u0441\u043e\u0431\u0438\u0440\u0430\u0435\u043c \u0437\u0430\u043f\u0438\u0441\u044c TelegramAccount \u0438 \u043b\u0438\u043d\u043a\u0443\u0435\u043c \u043a User. \u041b\u043e\u0433\u0438\u043a\u0430 \u0442\u0430\u043a\u0430\u044f:\u0418\u0449\u0443 TelegramAccount \u043f\u043e telegram_id \u2192 \u0435\u0441\u043b\u0438 \u0435\u0441\u0442\u044c, \u043f\u0435\u0440\u0435\u0438\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u044e \u0435\u0433\u043e \u044e\u0437\u0435\u0440\u0430 \u0438 \u043e\u0431\u043d\u043e\u0432\u043b\u044f\u044e \u043c\u0443\u0442\u0430\u0431\u0435\u043b\u044c\u043d\u044b\u0435 \u043f\u043e\u043b\u044f.\u0418\u043d\u0430\u0447\u0435 \u0438\u0449\u0443 User \u043f\u043e phone_number \u2192 \u0435\u0441\u043b\u0438 \u0435\u0441\u0442\u044c, \u043f\u0440\u0438\u043a\u0440\u0435\u043f\u043b\u044f\u044e \u043d\u043e\u0432\u044b\u0439 TelegramAccount \u043a \u043d\u0435\u043c\u0443.\u0418\u043d\u0430\u0447\u0435 \u0441\u043e\u0437\u0434\u0430\u044e \u0438 User, \u0438 TelegramAccount.\u0428\u0430\u0433 2 \u2014 \u044d\u0442\u043e \u0442\u043e, \u0447\u0442\u043e \u043f\u043e\u0437\u0432\u043e\u043b\u0438\u0442 \u043f\u043e\u0437\u0436\u0435 \u0434\u043e\u0431\u0430\u0432\u0438\u0442\u044c \u043b\u043e\u0433\u0438\u043d \u043f\u043e SMS \u0438 \u043d\u0435 \u043f\u043e\u043b\u0443\u0447\u0438\u0442\u044c \u0434\u0443\u0431\u043b\u0435\u0439 \u044e\u0437\u0435\u0440\u043e\u0432, \u0443 \u043a\u043e\u0442\u043e\u0440\u044b\u0445 \u043e\u0434\u0438\u043d \u0438 \u0442\u043e\u0442 \u0436\u0435 \u0442\u0435\u043b\u0435\u0444\u043e\u043d, \u043d\u043e \u0434\u0432\u0430 \u0430\u043a\u043a\u0430\u0443\u043d\u0442\u0430.\u0422\u0443\u0442\u043e\u0440\u0438\u0430\u043b: \u0447\u0442\u043e \u043a\u0443\u0434\u0430 \u043d\u0430\u0436\u0438\u043c\u0430\u0442\u044c\u0422\u0435\u043f\u0435\u0440\u044c \u043f\u043e\u0448\u0430\u0433\u043e\u0432\u043e \u2014 \u043a\u0430\u043a \u043f\u043e\u0434\u043d\u044f\u0442\u044c \u0432\u0441\u0451 \u044d\u0442\u043e \u043b\u043e\u043a\u0430\u043b\u044c\u043d\u043e.\u0428\u0430\u0433 1. \u0421\u043e\u0437\u0434\u0430\u0442\u044c \u0431\u043e\u0442\u0430 \u0438 \u043d\u0430\u0441\u0442\u0440\u043e\u0438\u0442\u044c OIDC \u0432 BotFather\u041e\u0442\u043a\u0440\u044b\u0432\u0430\u0435\u0442\u0435 @BotFather, \u0441\u043e\u0437\u0434\u0430\u0451\u0442\u0435 \u0431\u043e\u0442\u0430 \u0447\u0435\u0440\u0435\u0437 \/newbot (\u0438\u043b\u0438 \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u0435\u0442\u0435 \u0441\u0443\u0449\u0435\u0441\u0442\u0432\u0443\u044e\u0449\u0435\u0433\u043e).\u0414\u0430\u043b\u044c\u0448\u0435 \u2014 \u0441\u0430\u043c\u043e\u0435 \u043d\u0435\u043e\u0447\u0435\u0432\u0438\u0434\u043d\u043e\u0435. \u041d\u0430\u0441\u0442\u0440\u043e\u0439\u043a\u0438 OIDC \u0436\u0438\u0432\u0443\u0442 \u043d\u0435 \u0432 \u0447\u0430\u0442\u0435 \u0441 BotFather, \u0430 \u0432 \u0435\u0433\u043e mini-app. \u0412 \u0447\u0430\u0442\u0435 \u043d\u0430\u0436\u0438\u043c\u0430\u0435\u0442\u0435 \u043a\u043d\u043e\u043f\u043a\u0443 \u00abOpen\u00bb (\u0438\u043b\u0438 \u0438\u043a\u043e\u043d\u043a\u0443 \u043f\u0440\u0438\u043b\u043e\u0436\u0435\u043d\u0438\u044f), \u0432\u043d\u0443\u0442\u0440\u0438 \u043f\u0435\u0440\u0435\u0445\u043e\u0434\u0438\u0442\u0435 \u0432 Bot Settings \u2192 Web Login.\u0422\u0430\u043c \u0434\u0432\u0430 \u0432\u0430\u0436\u043d\u044b\u0445 \u043f\u043e\u043b\u044f:Trusted Origins \u2014 \u0434\u043e\u0431\u0430\u0432\u044c\u0442\u0435 \u0441\u044e\u0434\u0430 https:\/\/&lt;\u0432\u0430\u0448-ngrok-\u0434\u043e\u043c\u0435\u043d&gt;.ngrok-free.app. \u0422\u043e\u043b\u044c\u043a\u043e origin: \u043d\u0438 \u043f\u0443\u0442\u0438, \u043d\u0438 \u0441\u043b\u0435\u0448\u0430 \u043d\u0430 \u043a\u043e\u043d\u0446\u0435. Origin\u2019\u043e\u0432 \u043c\u043e\u0436\u043d\u043e \u043d\u0435\u0441\u043a\u043e\u043b\u044c\u043a\u043e (\u043d\u0430\u043f\u0440\u0438\u043c\u0435\u0440, localhost \u0447\u0435\u0440\u0435\u0437 \u043f\u0440\u043e\u043a\u0441\u0438 \u0438 \u043f\u0440\u043e\u0434).Redirect URIs \u2014 \u0434\u043b\u044f \u043d\u0430\u0448\u0435\u0433\u043e \u0444\u043b\u043e\u0443 \u0447\u0435\u0440\u0435\u0437 telegram-login.js \u043e\u0441\u0442\u0430\u0432\u044c\u0442\u0435 \u043f\u0443\u0441\u0442\u044b\u043c. \u042d\u0442\u043e \u043f\u043e\u043b\u0435 \u043d\u0443\u0436\u043d\u043e \u0442\u043e\u043b\u044c\u043a\u043e \u0435\u0441\u043b\u0438 \u0432\u044b \u0441\u0430\u043c\u0438 \u0440\u0435\u0430\u043b\u0438\u0437\u0443\u0435\u0442\u0435 server-side \u043e\u0431\u043c\u0435\u043d code \u2192 token.\u041a\u043e\u043c\u0430\u043d\u0434\u0430 \/setdomain \u2014 \u044d\u0442\u043e \u043e\u0442 \u0441\u0442\u0430\u0440\u043e\u0433\u043e \u0432\u0438\u0434\u0436\u0435\u0442\u0430. \u0414\u043b\u044f OIDC \u043e\u043d\u0430 \u043d\u0435 \u043d\u0443\u0436\u043d\u0430.\u0428\u0430\u0433 2. ngrok (\u0438\u043b\u0438 \u043b\u044e\u0431\u043e\u0439 HTTPS-\u0442\u0443\u043d\u043d\u0435\u043b\u044c)Telegram \u043f\u0443\u0441\u043a\u0430\u0435\u0442 \u0432 Trusted Origins \u0442\u043e\u043b\u044c\u043a\u043e HTTPS-\u0441\u0445\u0435\u043c\u044b, \u043f\u043e\u044d\u0442\u043e\u043c\u0443 http:\/\/localhost:8000 \u043d\u0430\u043f\u0440\u044f\u043c\u0443\u044e \u043d\u0435 \u043f\u043e\u0434\u043e\u0439\u0434\u0451\u0442 \u2014 \u043d\u0443\u0436\u0435\u043d HTTPS-\u0442\u0443\u043d\u043d\u0435\u043b\u044c \u043d\u0430\u0440\u0443\u0436\u0443.\u0421\u0430\u043c\u043e\u0435 \u043f\u0440\u043e\u0441\u0442\u043e\u0435 \u2014 ngrok:ngrok http 8000\u041f\u043e\u043b\u0443\u0447\u0430\u0435\u0442\u0435 URL \u0432\u0438\u0434\u0430 https:\/\/abcd-1234.ngrok-free.app. \u042d\u0442\u043e\u0442 URL \u043a\u043b\u0430\u0434\u0451\u0442\u0435 \u0432 Trusted Origins \u0432 BotFather. \u041d\u0430 \u0431\u0435\u0441\u043f\u043b\u0430\u0442\u043d\u043e\u043c \u0442\u0430\u0440\u0438\u0444\u0435 ngrok \u0434\u043e\u043c\u0435\u043d \u043c\u0435\u043d\u044f\u0435\u0442\u0441\u044f \u043f\u0440\u0438 \u043a\u0430\u0436\u0434\u043e\u043c \u043f\u0435\u0440\u0435\u0437\u0430\u043f\u0443\u0441\u043a\u0435 \u2014 \u043f\u0440\u0438\u0434\u0451\u0442\u0441\u044f \u043e\u0431\u043d\u043e\u0432\u043b\u044f\u0442\u044c Trusted Origins \u043a\u0430\u0436\u0434\u044b\u0439 \u0440\u0430\u0437. \u0415\u0441\u043b\u0438 \u0438\u0433\u0440\u0430\u0435\u0442\u0435\u0441\u044c \u0447\u0430\u0441\u0442\u043e \u2014 \u0435\u0441\u0442\u044c \u0441\u043c\u044b\u0441\u043b \u043a\u0443\u043f\u0438\u0442\u044c \u0441\u0442\u0430\u0442\u0438\u0447\u0435\u0441\u043a\u0438\u0439 \u0434\u043e\u043c\u0435\u043d \u0438\u043b\u0438 \u0432\u0437\u044f\u0442\u044c Cloudflare Tunnel.\u0428\u0430\u0433 3. .env \u0438 client_id\u0412 \u043a\u043e\u0440\u043d\u0435 \u043f\u0440\u043e\u0435\u043a\u0442\u0430 \u0435\u0441\u0442\u044c .env.dev \u2014 \u043a\u043e\u043f\u0438\u0440\u0443\u0435\u0442\u0435 \u0432 .env \u0438 \u0437\u0430\u043f\u043e\u043b\u043d\u044f\u0435\u0442\u0435:APP_TG_CLIENT_ID=8506301481      # \u0432\u0430\u0448 Client ID \u0438\u0437 BotFatherAPP_SECRET_KEY=&lt;32 hex-\u0441\u0438\u043c\u0432\u043e\u043b\u0430&gt;  # \u043a\u043b\u044e\u0447 AES \u0434\u043b\u044f \u043f\u043e\u0434\u043f\u0438\u0441\u0438 cookie-\u0441\u0435\u0441\u0441\u0438\u0438 (16\/24\/32 \u0441\u0438\u043c\u0432\u043e\u043b\u0430)APP_DB_URL=sqlite+aiosqlite:\/\/\/.\/tg_auth.db\u0421\u0435\u043a\u0440\u0435\u0442 \u0434\u043b\u044f cookie-\u0441\u0435\u0441\u0441\u0438\u0438 \u0443 \u043c\u0435\u043d\u044f \u0432 Litestar-\u043e\u0432\u0441\u043a\u043e\u043c CookieBackendConfig \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u0435\u0442\u0441\u044f \u043a\u0430\u043a \u043a\u043b\u044e\u0447 AES \u2014 \u0434\u043b\u0438\u043d\u0430 \u0441\u0442\u0440\u043e\u0433\u043e 16\/24\/32 \u0431\u0430\u0439\u0442\u0430. \u0421\u0433\u0435\u043d\u0435\u0440\u0438\u0440\u043e\u0432\u0430\u0442\u044c \u043f\u0440\u043e\u0441\u0442\u043e:python3 -c &#171;import secrets; print(secrets.token_hex(16))&#187;  # 32 hex-\u0441\u0438\u043c\u0432\u043e\u043b\u0430 = 32-\u0431\u0430\u0439\u0442\u043d\u0430\u044f \u0441\u0442\u0440\u043e\u043a\u0430 \u0434\u043b\u044f AES-\u043a\u043b\u044e\u0447\u0430\u0422\u043e\u0442 \u0436\u0435 Client ID \u043d\u0443\u0436\u043d\u043e \u043f\u0440\u043e\u043f\u0438\u0441\u0430\u0442\u044c \u0432 data-client-id \u0432 tg_auth\/presentors\/rest\/templates\/index.html \u2014 \u044d\u0442\u043e \u0430\u0442\u0440\u0438\u0431\u0443\u0442 \u0442\u0435\u0433\u0430 &lt;script&gt;, \u043a\u043e\u0442\u043e\u0440\u044b\u0439 \u0433\u0440\u0443\u0437\u0438\u0442 \u0432\u0438\u0434\u0436\u0435\u0442:&lt;script async&#8230;<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[],"tags":[],"class_list":["post-479274","post","type-post","status-publish","format-standard","hentry"],"_links":{"self":[{"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=\/wp\/v2\/posts\/479274","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=479274"}],"version-history":[{"count":0,"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=\/wp\/v2\/posts\/479274\/revisions"}],"wp:attachment":[{"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=479274"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=479274"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=479274"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}