[{"data":1,"prerenderedAt":593},["ShallowReactive",2],{"navigation":3,"\u002Fauthentication\u002Foauth-flow":88,"\u002Fauthentication\u002Foauth-flow-surround":588},[4,21,42,63,83],{"title":5,"icon":6,"path":7,"stem":8,"children":9,"page":20},"Начало работы","i-lucide-compass","\u002Fgetting-started","1.getting-started",[10,15],{"title":11,"path":12,"stem":13,"icon":14},"Обзор сервиса","\u002Fgetting-started\u002Foverview","1.getting-started\u002F1.overview","i-lucide-book-open",{"title":16,"path":17,"stem":18,"icon":19},"Быстрый старт","\u002Fgetting-started\u002Fquickstart","1.getting-started\u002F2.quickstart","i-lucide-zap",false,{"title":22,"icon":23,"path":24,"stem":25,"children":26,"page":20},"Аутентификация","i-lucide-key-round","\u002Fauthentication","2.authentication",[27,32,37],{"title":28,"path":29,"stem":30,"icon":31},"OAuth Flow и сессии","\u002Fauthentication\u002Foauth-flow","2.authentication\u002F1.oauth-flow","i-lucide-log-in",{"title":33,"path":34,"stem":35,"icon":36},"JWT и Discovery","\u002Fauthentication\u002Fjwt-and-discovery","2.authentication\u002F2.jwt-and-discovery","i-lucide-file-key-2",{"title":38,"path":39,"stem":40,"icon":41},"API-ключи","\u002Fauthentication\u002Fapi-keys","2.authentication\u002F3.api-keys","i-lucide-key-square",{"title":43,"icon":44,"path":45,"stem":46,"children":47,"page":20},"Доступ и сущности","i-lucide-layers","\u002Fconcepts","3.concepts",[48,53,58],{"title":49,"path":50,"stem":51,"icon":52},"Права доступа","\u002Fconcepts\u002Fpermissions","3.concepts\u002F1.permissions","i-lucide-shield-check",{"title":54,"path":55,"stem":56,"icon":57},"Пользователи","\u002Fconcepts\u002Fusers","3.concepts\u002F2.users","i-lucide-users",{"title":59,"path":60,"stem":61,"icon":62},"Отделы (Departments)","\u002Fconcepts\u002Fdepartments","3.concepts\u002F3.departments","i-lucide-network",{"title":64,"icon":65,"path":66,"stem":67,"children":68,"page":20},"Интеграция","i-lucide-blocks","\u002Fintegration","4.integration",[69,74,78],{"title":70,"path":71,"stem":72,"icon":73},"Пакеты .NET","\u002Fintegration\u002Fdotnet-sdk","4.integration\u002F1.dotnet-sdk","i-lucide-package",{"title":75,"path":76,"stem":77,"icon":73},"Пакет Go","\u002Fintegration\u002Fgo-sdk","4.integration\u002F2.go-sdk",{"title":79,"path":80,"stem":81,"icon":82},"gRPC API","\u002Fintegration\u002Fgrpc","4.integration\u002F3.grpc","i-lucide-server",{"title":84,"path":85,"stem":86,"icon":87},"OpenAPI","\u002Fopenapi","5.openapi","i-lucide-braces",{"id":89,"title":28,"body":90,"description":581,"extension":582,"hideToc":20,"links":583,"meta":584,"navigation":585,"path":29,"seo":586,"stem":30,"wide":20,"__hash__":587},"docs\u002F2.authentication\u002F1.oauth-flow.md",{"type":91,"value":92,"toc":573},"minimark",[93,106,111,121,125,139,196,217,223,232,238,241,282,291,367,393,413,417,426,457,462,488,492,502,530,551,569],[94,95,96,97,101,102,105],"p",{},"Авторизация конечных пользователей в Julia построена на редиректном OAuth-потоке с одноразовым кодом обмена (",[98,99,100],"code",{},"trade code","). Все маршруты этой группы находятся под ",[98,103,104],{},"\u002Fv1\u002Fauth",".",[107,108,110],"h2",{"id":109},"схема-авторизации","Схема авторизации",[112,113,119],"pre",{"className":114,"code":116,"language":117,"meta":118},[115],"language-text","1. Клиент  ── GET \u002Fv1\u002Fauth\u002Fredirect?sourceId=\u003Cuuid> ──▶ Julia\n2. Julia   ── 302 Redirect ───────────────────────────▶ Провайдер входа\n3. Провайдер ── Callback ─────────────────────────────▶ Julia (\u002Fv1\u002Fauth\u002Foauth\u002Fcallback\u002F{provider})\n4. Julia   ── 302 Redirect: \u003Ccallback_url>?code=... ──▶ Клиент\n5. Клиент  ── POST \u002Fv1\u002Fauth\u002Foauth\u002Fexchange { code } ──▶ Julia\n6. Julia   ── 200 OK { access_token, refresh_token } ─▶ Клиент\n","text","",[98,120,116],{"__ignoreMap":118},[107,122,124],{"id":123},"_1-инициализация-входа","1. Инициализация входа",[112,126,130],{"className":127,"code":128,"language":129,"meta":118,"style":118},"language-http shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","GET \u002Fv1\u002Fauth\u002Fredirect?sourceId=\u003Cclient_application_uuid>&service=\u003Cprovider>\n","http",[98,131,132],{"__ignoreMap":118},[133,134,137],"span",{"class":135,"line":136},"line",1,[133,138,128],{},[140,141,142,158],"table",{},[143,144,145],"thead",{},[146,147,148,152,155],"tr",{},[149,150,151],"th",{},"Параметр",[149,153,154],{},"Обязательный",[149,156,157],{},"Описание",[159,160,161,183],"tbody",{},[146,162,163,169,172],{},[164,165,166],"td",{},[98,167,168],{},"sourceId",[164,170,171],{},"Да",[164,173,174,175,178,179,182],{},"UUID зарегистрированного клиентского приложения (",[98,176,177],{},"ClientApplication","). Определяет, на какой ",[98,180,181],{},"callback_url"," вернуть пользователя после входа.",[146,184,185,190,193],{},[164,186,187],{},[98,188,189],{},"service",[164,191,192],{},"Нет",[164,194,195],{},"Идентификатор провайдера входа. Если не указан, используется провайдер по умолчанию.",[94,197,198,199,201,202,206,207,210,211,213,214,105],{},"Julia проверяет ",[98,200,168],{},", создаёт временное состояние авторизации (действует ",[203,204,205],"strong",{},"10 минут",") и отвечает ",[98,208,209],{},"302 Found"," на страницу входа провайдера. При неизвестном ",[98,212,168],{}," или неактивном провайдере возвращается ",[98,215,216],{},"400 Bad Request",[107,218,220,221],{"id":219},"_2-возврат-на-клиент-и-обмен-code","2. Возврат на клиент и обмен ",[98,222,98],{},[94,224,225,226,228,229,231],{},"После успешной аутентификации Julia перенаправляет браузер на зарегистрированный ",[98,227,181],{}," клиентского приложения с query-параметром ",[98,230,98],{},":",[112,233,236],{"className":234,"code":235,"language":117,"meta":118},[115],"https:\u002F\u002Fapp.example.com\u002Fcallback?code=019f9bdc-13b5-7e2b-bc68-ccf3446d2cc0\n",[98,237,235],{"__ignoreMap":118},[94,239,240],{},"Клиентское приложение должно обменять полученный код на пару JWT-токенов:",[112,242,244],{"className":127,"code":243,"language":129,"meta":118,"style":118},"POST \u002Fv1\u002Fauth\u002Foauth\u002Fexchange\nContent-Type: application\u002Fjson\n\n{\n  \"code\": \"019f9bdc-13b5-7e2b-bc68-ccf3446d2cc0\"\n}\n",[98,245,246,251,257,264,270,276],{"__ignoreMap":118},[133,247,248],{"class":135,"line":136},[133,249,250],{},"POST \u002Fv1\u002Fauth\u002Foauth\u002Fexchange\n",[133,252,254],{"class":135,"line":253},2,[133,255,256],{},"Content-Type: application\u002Fjson\n",[133,258,260],{"class":135,"line":259},3,[133,261,263],{"emptyLinePlaceholder":262},true,"\n",[133,265,267],{"class":135,"line":266},4,[133,268,269],{},"{\n",[133,271,273],{"class":135,"line":272},5,[133,274,275],{},"  \"code\": \"019f9bdc-13b5-7e2b-bc68-ccf3446d2cc0\"\n",[133,277,279],{"class":135,"line":278},6,[133,280,281],{},"}\n",[94,283,284],{},[203,285,286,287,290],{},"Успешный ответ (",[98,288,289],{},"200 OK","):",[112,292,296],{"className":293,"code":294,"language":295,"meta":118,"style":118},"language-json shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","{\n  \"access_token\": \"eyJhbGciOiJFZERTQSIs...\",\n  \"refresh_token\": \"eyJhbGciOiJFZERTQSIs...\",\n  \"expires_in\": 900\n}\n","json",[98,297,298,303,329,348,363],{"__ignoreMap":118},[133,299,300],{"class":135,"line":136},[133,301,269],{"class":302},"sMK4o",[133,304,305,308,312,315,317,320,324,326],{"class":135,"line":253},[133,306,307],{"class":302},"  \"",[133,309,311],{"class":310},"spNyl","access_token",[133,313,314],{"class":302},"\"",[133,316,231],{"class":302},[133,318,319],{"class":302}," \"",[133,321,323],{"class":322},"sfazB","eyJhbGciOiJFZERTQSIs...",[133,325,314],{"class":302},[133,327,328],{"class":302},",\n",[133,330,331,333,336,338,340,342,344,346],{"class":135,"line":259},[133,332,307],{"class":302},[133,334,335],{"class":310},"refresh_token",[133,337,314],{"class":302},[133,339,231],{"class":302},[133,341,319],{"class":302},[133,343,323],{"class":322},[133,345,314],{"class":302},[133,347,328],{"class":302},[133,349,350,352,355,357,359],{"class":135,"line":266},[133,351,307],{"class":302},[133,353,354],{"class":310},"expires_in",[133,356,314],{"class":302},[133,358,231],{"class":302},[133,360,362],{"class":361},"sbssI"," 900\n",[133,364,365],{"class":135,"line":272},[133,366,281],{"class":302},[368,369,370,380,385],"ul",{},[371,372,373,375,376,379],"li",{},[98,374,311],{}," — короткоживущий JWT для доступа к API (",[98,377,378],{},"Authorization: Bearer \u003Caccess_token>",").",[371,381,382,384],{},[98,383,335],{}," — долгоживущий JWT для продления сессии.",[371,386,387,389,390,392],{},[98,388,354],{}," — время жизни ",[98,391,311],{}," в секундах.",[394,395,398],"callout",{"color":396,"icon":397},"warning","i-lucide-clock",[94,399,400,402,403,406,407,410,411,105],{},[98,401,98],{}," является ",[203,404,405],{},"одноразовым"," и действителен ",[203,408,409],{},"5 минут",". Повторная отправка того же кода или отправка просроченного кода возвращает ",[98,412,216],{},[107,414,416],{"id":415},"_3-обновление-токенов","3. Обновление токенов",[94,418,419,420,422,423,231],{},"Когда срок действия ",[98,421,311],{}," подходит к концу, запросите новую пару через ",[98,424,425],{},"POST \u002Fv1\u002Fauth\u002Frefresh",[112,427,429],{"className":127,"code":428,"language":129,"meta":118,"style":118},"POST \u002Fv1\u002Fauth\u002Frefresh\nContent-Type: application\u002Fjson\n\n{\n  \"refresh_token\": \"eyJhbGciOiJFZERTQSIs...\"\n}\n",[98,430,431,436,440,444,448,453],{"__ignoreMap":118},[133,432,433],{"class":135,"line":136},[133,434,435],{},"POST \u002Fv1\u002Fauth\u002Frefresh\n",[133,437,438],{"class":135,"line":253},[133,439,256],{},[133,441,442],{"class":135,"line":259},[133,443,263],{"emptyLinePlaceholder":262},[133,445,446],{"class":135,"line":266},[133,447,269],{},[133,449,450],{"class":135,"line":272},[133,451,452],{},"  \"refresh_token\": \"eyJhbGciOiJFZERTQSIs...\"\n",[133,454,455],{"class":135,"line":278},[133,456,281],{},[94,458,459],{},[203,460,461],{},"Поведение при обновлении:",[368,463,464,482],{},[371,465,466,468,469,472,473,475,476,478,479,379],{},[98,467,335],{}," ",[203,470,471],{},"ротируется",": предыдущий refresh-токен сессии отзывается, а в ответе возвращаются новые ",[98,474,311],{}," и ",[98,477,335],{}," в рамках той же сессии (",[98,480,481],{},"sid",[371,483,484,485,487],{},"Если refresh-токен истёк, отозван или сессия завершена, сервер отвечает ",[98,486,216],{}," — пользователю нужно пройти вход заново.",[107,489,491],{"id":490},"_4-завершение-сессии-logout","4. Завершение сессии (Logout)",[94,493,494,495,498,499,501],{},"Для выхода из системы отправьте ",[98,496,497],{},"POST \u002Fv1\u002Fauth\u002Flogout"," с действующим ",[98,500,311],{}," пользователя:",[112,503,505],{"className":127,"code":504,"language":129,"meta":118,"style":118},"POST \u002Fv1\u002Fauth\u002Flogout\nAuthorization: Bearer \u003Caccess_token>\nContent-Type: application\u002Fjson\n\n{}\n",[98,506,507,512,517,521,525],{"__ignoreMap":118},[133,508,509],{"class":135,"line":136},[133,510,511],{},"POST \u002Fv1\u002Fauth\u002Flogout\n",[133,513,514],{"class":135,"line":253},[133,515,516],{},"Authorization: Bearer \u003Caccess_token>\n",[133,518,519],{"class":135,"line":259},[133,520,256],{},[133,522,523],{"class":135,"line":266},[133,524,263],{"emptyLinePlaceholder":262},[133,526,527],{"class":135,"line":272},[133,528,529],{},"{}\n",[368,531,532,538,544],{},[371,533,534,535,537],{},"По умолчанию завершается текущая сессия, указанная в claim ",[98,536,481],{}," переданного JWT.",[371,539,540,541,379],{},"Можно явно указать другую собственную сессию в теле запроса (",[98,542,543],{},"{ \"session_id\": \"\u003Cuuid>\" }",[371,545,546,547,550],{},"Успешный ответ — ",[98,548,549],{},"204 No Content",". Токены этой сессии немедленно перестают приниматься.",[394,552,555],{"color":553,"icon":554},"neutral","i-lucide-info",[94,556,557,558,475,561,564,565,105],{},"Для управления всеми активными сессиями пользователя (просмотр списка устройств\u002FIP и завершение конкретной сессии) также доступны эндпоинты ",[98,559,560],{},"GET \u002Fv1\u002Fusers\u002F{uuid}\u002Fsessions",[98,562,563],{},"DELETE \u002Fv1\u002Fusers\u002F{uuid}\u002Fsessions\u002F{sessionId}",". Подробнее — на странице ",[566,567,568],"a",{"href":55},"Пользователи и сессии",[570,571,572],"style",{},"html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}",{"title":118,"searchDepth":253,"depth":253,"links":574},[575,576,577,579,580],{"id":109,"depth":253,"text":110},{"id":123,"depth":253,"text":124},{"id":219,"depth":253,"text":578},"2. Возврат на клиент и обмен code",{"id":415,"depth":253,"text":416},{"id":490,"depth":253,"text":491},"Авторизация пользователей через редирект, обмен trade code на JWT, обновление refresh-токена и завершение сессии.","md",null,{},{"icon":31},{"title":28,"description":581},"5MA2HtjxnFzVDt1_sHhDVDovdNZ8YOQhKbWMC10PD8I",[589,591],{"title":16,"path":17,"stem":18,"description":590,"icon":19,"children":-1},"Пошаговая интеграция веб-приложения и бэкенд-сервиса с Julia за несколько минут.",{"title":33,"path":34,"stem":35,"description":592,"icon":36,"children":-1},"Формат JWT-токенов Julia (EdDSA \u002F Ed25519), список claims, эндпоинты \u002F.well-known и проверка подписи.",1795320979027]