[{"data":1,"prerenderedAt":803},["ShallowReactive",2],{"navigation":3,"\u002Fauthentication\u002Fapi-keys":88,"\u002Fauthentication\u002Fapi-keys-surround":798},[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":38,"body":90,"description":791,"extension":792,"hideToc":20,"links":793,"meta":794,"navigation":795,"path":39,"seo":796,"stem":40,"wide":20,"__hash__":797},"docs\u002F2.authentication\u002F3.api-keys.md",{"type":91,"value":92,"toc":774},"minimark",[93,106,111,119,135,138,142,235,242,247,310,317,324,339,343,349,360,374,381,536,549,553,556,620,627,633,745,750,770],[94,95,96,97,101,102,105],"p",{},"API-ключи — это долгоживущие учётные данные, работающие наряду с JWT. Ключ может представлять как ",[98,99,100],"strong",{},"сервис"," (machine), так и ",[98,103,104],{},"пользователя"," (personal access token).",[107,108,110],"h2",{"id":109},"передача-ключа-в-запросах","Передача ключа в запросах",[94,112,113,114,118],{},"API-ключ передаётся в HTTP-заголовке или gRPC-метаданных ",[115,116,117],"code",{},"X-Api-Key",":",[120,121,126],"pre",{"className":122,"code":123,"language":124,"meta":125,"style":125},"language-http shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","X-Api-Key: cza-svc-019f9bdc...25782\n","http","",[115,127,128],{"__ignoreMap":125},[129,130,133],"span",{"class":131,"line":132},"line",1,[129,134,123],{},[94,136,137],{},"При неуспешной аутентификации (неизвестный, отозванный, просроченный ключ или запрещённый IP-адрес) Julia возвращает одинаковый отказ, не раскрывая причину неавторизованному клиенту.",[107,139,141],{"id":140},"формат-ключа","Формат ключа",[143,144,145,158],"table",{},[146,147,148],"thead",{},[149,150,151,155],"tr",{},[152,153,154],"th",{},"Характеристика",[152,156,157],{},"Значение",[159,160,161,174,184,193,208,220],"tbody",{},[149,162,163,167],{},[164,165,166],"td",{},"Общая длина",[164,168,169,170,173],{},"104 символа (для текущего 3-символьного префикса ",[115,171,172],{},"cza",")",[149,175,176,179],{},[164,177,178],{},"Регулярное выражение",[164,180,181],{},[115,182,183],{},"^[a-z][a-z0-9]{2,15}-[a-z]{3}-[A-Za-z0-9]{96}$",[149,185,186,189],{},[164,187,188],{},"Текущий префикс (namespace)",[164,190,191],{},[115,192,172],{},[149,194,195,198],{},[164,196,197],{},"Классы ключей",[164,199,200,203,204,207],{},[115,201,202],{},"svc"," — сервисный (machine), ",[115,205,206],{},"pat"," — пользовательский (personal access token)",[149,209,210,213],{},[164,211,212],{},"Контрольная сумма",[164,214,215,216,219],{},"Первые 6 hex-символов ",[115,217,218],{},"SHA-256"," от первых 90 символов тела ключа",[149,221,222,225],{},[164,223,224],{},"Маскированное представление",[164,226,227,230,231,234],{},[115,228,229],{},"partial_token",", например ",[115,232,233],{},"cza-pat-019f***c349"," (безопасно для UI и логов)",[94,236,237,238,241],{},"Полное значение ключа возвращается ",[98,239,240],{},"один раз"," при создании и в дальнейшем не восстанавливается.",[243,244,246],"h3",{"id":245},"рекомендации-по-локальной-валидации","Рекомендации по локальной валидации",[248,249,250,257,277,283],"ul",{},[251,252,253,256],"li",{},[98,254,255],{},"Валидируйте по структуре, а не по жёстко зашитому префиксу."," Паттерн допускает любой namespace и любой 3-буквенный класс — это позволяет вводить новые классы без срочного обновления всех потребителей.",[251,258,259,268,269,272,273,276],{},[98,260,261,262,264,265,267],{},"Сегмент класса (",[115,263,202],{}," \u002F ",[115,266,206],{},") — это подсказка, а не источник истины."," Реальный тип субъекта (",[115,270,271],{},"user"," или ",[115,274,275],{},"machine",") и права определяет только Julia при интроспекции.",[251,278,279,282],{},[98,280,281],{},"Контрольная сумма отсеивает опечатки, но не заменяет проверку."," Успешный локальный парсинг лишь экономит сетевой запрос, но не означает, что ключ действителен.",[251,284,285,286,289,290,294,295,298,299,302,303,294,306,309],{},"Для локального разбора, хеширования и получения маски используйте класс ",[115,287,288],{},"ApiKey"," из пакета ",[291,292,293],"a",{"href":71},"Cyberzone.Julia.Authorization"," (",[98,296,297],{},".NET",") или подпакет ",[115,300,301],{},"apikey"," из модуля ",[291,304,305],{"href":76},"julia-go",[98,307,308],{},"Go",").",[107,311,313,314,173],{"id":312},"ограничение-по-ip-адресам-allowedips","Ограничение по IP-адресам (",[115,315,316],{},"AllowedIps",[94,318,319,320,323],{},"Для ключа может быть задан список разрешённых IP-адресов (",[115,321,322],{},"allowed_ips","). Если список не пуст, запросы с других адресов отклоняются.",[248,325,326,336],{},[251,327,328,329,332,333,309],{},"IPv4-mapped IPv6 адреса (например, ",[115,330,331],{},"::ffff:203.0.113.7",") автоматически нормализуются к IPv4 (",[115,334,335],{},"203.0.113.7",[251,337,338],{},"Поддерживаются точные IP-адреса (CIDR-диапазоны не поддерживаются).",[107,340,342],{"id":341},"проверка-api-ключа-в-вашем-сервисе-introspection","Проверка API-ключа в вашем сервисе (Introspection)",[94,344,345,346,118],{},"Если ваш сервис сам принимает API-ключи Julia от внешних клиентов, валидируйте формат локально и проверяйте ключ через gRPC-метод ",[115,347,348],{},"ApiTokens.IntrospectApiKey",[120,350,354],{"className":351,"code":352,"language":353,"meta":125,"style":125},"language-protobuf shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","rpc IntrospectApiKey (IntrospectApiKeyRequest) returns (IntrospectApiKeyResponse);\n","protobuf",[115,355,356],{"__ignoreMap":125},[129,357,358],{"class":131,"line":132},[129,359,352],{},[94,361,362,363,366,367,370,371,309],{},"Для вызова требуется ",[98,364,365],{},"сервисный"," ключ с правом ",[115,368,369],{},"authservice.apitokens:introspect",". В запросе передайте сам ключ и IP-адрес конечного клиента (",[115,372,373],{},"remote_ip",[243,375,377,378],{"id":376},"поля-ответа-introspectapikeyresponse","Поля ответа ",[115,379,380],{},"IntrospectApiKeyResponse",[143,382,383,393],{},[146,384,385],{},[149,386,387,390],{},[152,388,389],{},"Поле",[152,391,392],{},"Описание",[159,394,395,407,417,432,442,452,468,478,488,507],{},[149,396,397,402],{},[164,398,399],{},[115,400,401],{},"valid",[164,403,404,405],{},"Действителен ли ключ с указанного ",[115,406,373],{},[149,408,409,414],{},[164,410,411],{},[115,412,413],{},"token_id",[164,415,416],{},"UUID записи ключа",[149,418,419,424],{},[164,420,421],{},[115,422,423],{},"subject_type",[164,425,426,272,429],{},[115,427,428],{},"SUBJECT_TYPE_USER",[115,430,431],{},"SUBJECT_TYPE_MACHINE",[149,433,434,439],{},[164,435,436],{},[115,437,438],{},"subject_id",[164,440,441],{},"UUID пользователя или сервиса",[149,443,444,449],{},[164,445,446],{},[115,447,448],{},"name",[164,450,451],{},"Имя ключа",[149,453,454,459],{},[164,455,456],{},[115,457,458],{},"permissions",[164,460,461,464,465,467],{},[98,462,463],{},"Эффективные права"," ключа (для ",[115,466,206],{}," уже пересечены с актуальными правами владельца)",[149,469,470,475],{},[164,471,472],{},[115,473,474],{},"expires_at",[164,476,477],{},"Срок действия ключа (жёсткий предел)",[149,479,480,485],{},[164,481,482],{},[115,483,484],{},"cache_ttl_seconds",[164,486,487],{},"Разрешённое время кеширования ответа",[149,489,490,495],{},[164,491,492],{},[115,493,494],{},"ip_unrestricted",[164,496,497,500,501,504,505],{},[115,498,499],{},"true",", если у ключа нет ограничений по IP; ",[115,502,503],{},"false",", если ответ зависит от ",[115,506,373],{},[149,508,509,514],{},[164,510,511],{},[115,512,513],{},"error",[164,515,516,517,294,520,523,524,523,527,523,530,523,533,173],{},"Код причины при ",[115,518,519],{},"valid = false",[115,521,522],{},"MALFORMED",", ",[115,525,526],{},"NOT_FOUND",[115,528,529],{},"IP_FORBIDDEN",[115,531,532],{},"REVOKED",[115,534,535],{},"EXPIRED",[537,538,540],"callout",{"color":539,"icon":52},"primary",[94,541,542,548],{},[98,543,544,545,547],{},"Используйте ",[115,546,458],{}," из ответа напрямую."," Для пользовательского ключа сохранённые на нём права выступают потолком, а не выдачей — Julia уже вычисляет пересечение с живыми правами пользователя.",[243,550,552],{"id":551},"безопасное-кеширование-результата-интроспекции","Безопасное кеширование результата интроспекции",[94,554,555],{},"Чтобы не вызывать Julia на каждый запрос и при этом не создать уязвимость:",[557,558,559,577,609],"ol",{},[251,560,561,570,571,573,574,576],{},[98,562,563,564,566,567,569],{},"Ключ кеша — ",[115,565,218],{}," от предъявленного ключа, но никогда не ",[115,568,413],{},"."," Идентификатор ",[115,572,413],{}," содержится в самом ключе в открытом виде; кеширование по ",[115,575,413],{}," позволило бы подделать доступ, зная только ID.",[251,578,579,584],{},[98,580,581,582,569],{},"Учитывайте ",[115,583,494],{},[248,585,586,596],{},[251,587,588,589,592,593,569],{},"Если ",[115,590,591],{},"ip_unrestricted == true",", достаточно ключа ",[115,594,595],{},"sha256(key)",[251,597,588,598,601,602,605,606,608],{},[115,599,600],{},"ip_unrestricted == false",", добавляйте в ключ кеша нормализованный IP-адрес клиента (",[115,603,604],{},"sha256(key) + \":\" + remoteIp","), иначе ограничение ",[115,607,316],{}," перестанет работать для кешированных ответов.",[251,610,611,614,615,617,618,569],{},[98,612,613],{},"Соблюдайте TTL."," Не храните запись дольше ",[115,616,484],{}," и никогда — дольше ",[115,619,474],{},[107,621,623,624,173],{"id":622},"управление-api-ключами-grpc-apitokens","Управление API-ключами (gRPC ",[115,625,626],{},"ApiTokens",[94,628,629,630,118],{},"Управление ключами доступно по gRPC в сервисе ",[115,631,632],{},"admin.ApiTokens",[143,634,635,648],{},[146,636,637],{},[149,638,639,642,645],{},[152,640,641],{},"Метод",[152,643,644],{},"Требуемое право",[152,646,647],{},"Примечание",[159,649,650,669,686,712,729],{},[149,651,652,657,662],{},[164,653,654],{},[115,655,656],{},"GetApiTokens",[164,658,659],{},[115,660,661],{},"authservice.apitokens:read:self",[164,663,664,665,668],{},"Список ключей с курсорной пагинацией. Без глобального ",[115,666,667],{},":read"," видны только собственные ключи",[149,670,671,676,680],{},[164,672,673],{},[115,674,675],{},"GetApiToken",[164,677,678],{},[115,679,661],{},[164,681,682,683,685],{},"Чужой ключ без глобального ",[115,684,667],{}," возвращается как не найденный",[149,687,688,693,705],{},[164,689,690],{},[115,691,692],{},"CreateApiToken",[164,694,695,698,699,702,703,173],{},[115,696,697],{},"authservice.apitokens:write:self"," (+ ",[115,700,701],{},":write"," для ",[115,704,202],{},[164,706,707,708,711],{},"Возвращает полный секрет в поле ",[115,709,710],{},"token"," один раз",[149,713,714,719,726],{},[164,715,716],{},[115,717,718],{},"RevokeApiToken",[164,720,721,698,723,725],{},[115,722,697],{},[115,724,701],{}," для чужих)",[164,727,728],{},"Идемпотентная операция",[149,730,731,736,740],{},[164,732,733],{},[115,734,735],{},"IntrospectApiKey",[164,737,738],{},[115,739,369],{},[164,741,742,743,173],{},"Только для сервисных ключей (",[115,744,275],{},[94,746,747],{},[98,748,749],{},"Правила выпуска ключей:",[248,751,752,755,764],{},[251,753,754],{},"Ключ не может получить право, которым не обладает сам вызывающий.",[251,756,757,758,760,761,763],{},"Пользовательский ключ (",[115,759,206],{},") всегда привязывается к текущему пользователю (",[115,762,438],{}," из запроса игнорируется).",[251,765,766,767,769],{},"Права и ",[115,768,316],{}," существующего ключа не редактируются — при необходимости выпустите новый ключ и отзовите старый.",[771,772,773],"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);}",{"title":125,"searchDepth":775,"depth":775,"links":776},2,[777,778,782,784,789],{"id":109,"depth":775,"text":110},{"id":140,"depth":775,"text":141,"children":779},[780],{"id":245,"depth":781,"text":246},3,{"id":312,"depth":775,"text":783},"Ограничение по IP-адресам (AllowedIps)",{"id":341,"depth":775,"text":342,"children":785},[786,788],{"id":376,"depth":781,"text":787},"Поля ответа IntrospectApiKeyResponse",{"id":551,"depth":781,"text":552},{"id":622,"depth":775,"text":790},"Управление API-ключами (gRPC ApiTokens)","Формат API-ключей Julia, передача в заголовке X-Api-Key, интроспекция через gRPC и безопасное кеширование.","md",null,{},{"icon":41},{"title":38,"description":791},"SoO1WpWDbdWxrwcmcNB_PxT8IMqN8W_4AmgY2asJceo",[799,801],{"title":33,"path":34,"stem":35,"description":800,"icon":36,"children":-1},"Формат JWT-токенов Julia (EdDSA \u002F Ed25519), список claims, эндпоинты \u002F.well-known и проверка подписи.",{"title":49,"path":50,"stem":51,"description":802,"icon":52,"children":-1},"Иерархическая модель прав base:operation:scope, скоупы self и делегирование по UUID, справочник прав Julia.",1795320979027]