[{"data":1,"prerenderedAt":1488},["ShallowReactive",2],{"navigation":3,"\u002Fintegration\u002Fgo-sdk":88,"\u002Fintegration\u002Fgo-sdk-surround":1483},[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":90,"body":91,"description":1472,"extension":1473,"hideToc":20,"links":1474,"meta":1479,"navigation":1480,"path":76,"seo":1481,"stem":77,"wide":20,"__hash__":1482},"docs\u002F4.integration\u002F2.go-sdk.md","Пакет для Go (julia-go)",{"type":92,"value":93,"toc":1453},"minimark",[94,122,148,151,319,324,367,377,387,390,394,401,487,542,544,551,557,659,662,671,689,694,710,755,773,777,841,847,849,853,860,893,899,914,929,931,941,945,957,1024,1032,1036,1119,1153,1155,1159,1166,1190,1247,1249,1256,1266,1300,1302,1306,1312,1449],[95,96,97,98,102,103,113,114,117,118,121],"p",{},"Для сервисов на ",[99,100,101],"strong",{},"Go (1.25+)"," доступен официальный модуль ",[104,105,109],"a",{"href":106,"rel":107},"https:\u002F\u002Fgit.cyberzone.dev\u002Fcyberzone\u002Fjulia-go",[108],"nofollow",[110,111,112],"code",{},"git.cyberzone.dev\u002Fcyberzone\u002Fjulia-go",", закрывающий все задачи интеграции: валидацию EdDSA JWT, работу с моделью ",[110,115,116],{},"Principal",", иерархическую проверку прав, ",[110,119,120],{},"net\u002Fhttp","-middleware, клиентские и серверные gRPC-инструменты, интроспекцию и локальный парсинг API-ключей.",[123,124,127],"callout",{"color":125,"icon":126},"warning","i-lucide-git-branch",[95,128,129,130,135,136,139,140,143,144,147],{},"Модуль находится в статусе пре-релиза: актуальный тег — ",[99,131,132],{},[110,133,134],{},"v0.1.0-rc.1"," (ветка ",[110,137,138],{},"dev","). Ветка ",[110,141,142],{},"main"," пока не содержит стабильного релиза, поэтому при установке указывайте тег ",[110,145,146],{},"@v0.1.0-rc.1"," явно.",[95,149,150],{},"Ядро пакета не привязано к конкретному транспорту и разделено на несколько подпакетов:",[152,153,154,167],"table",{},[155,156,157],"thead",{},[158,159,160,164],"tr",{},[161,162,163],"th",{},"Пакет",[161,165,166],{},"Назначение",[168,169,170,206,240,264,289],"tbody",{},[158,171,172,182],{},[173,174,175,177,178,181],"td",{},[110,176,112],{}," (",[110,179,180],{},"julia",")",[173,183,184,187,188,191,192,194,195,198,199,198,202,205],{},[110,185,186],{},"Client",", валидация ",[99,189,190],{},"EdDSA (Ed25519)"," JWT, ",[110,193,116],{},", проверка прав (",[110,196,197],{},"Check",", ",[110,200,201],{},"CheckInAnyScope",[110,203,204],{},"ResolveAccessLevel","), интроспекция API-ключей и интерфейсы кэширования",[158,207,208,213],{},[173,209,210],{},[110,211,212],{},"...\u002Fjuliahttp",[173,214,215,216,219,220,177,222,198,225,198,228,231,232,235,236,239],{},"Middleware формата ",[110,217,218],{},"func(http.Handler) http.Handler"," для ",[110,221,120],{},[110,223,224],{},"stdlib",[110,226,227],{},"chi",[110,229,230],{},"gorilla","; для ",[110,233,234],{},"gin"," и ",[110,237,238],{},"echo"," оборачивается одной строкой)",[158,241,242,247],{},[173,243,244],{},[110,245,246],{},"...\u002Fjuliagrpc",[173,248,249,250,253,254,257,258,235,261],{},"Исходящее подключение ",[110,251,252],{},"Dial"," с ",[110,255,256],{},"X-Api-Key"," и TLS по умолчанию, серверные интерцепторы ",[110,259,260],{},"UnaryServerInterceptor",[110,262,263],{},"StreamServerInterceptor",[158,265,266,271],{},[173,267,268],{},[110,269,270],{},"...\u002Fapikey",[173,272,273,274,277,278,281,282,198,285,288],{},"Локальный парсинг, проверка контрольной суммы (",[110,275,276],{},"Parse","), маскирование (",[110,279,280],{},"Hint",") и хеширование (",[110,283,284],{},"Hash",[110,286,287],{},"HashEqual",") без сетевых вызовов",[158,290,291,296],{},[173,292,293],{},[110,294,295],{},"...\u002Fcontracts\u002F*",[173,297,298,299,198,302,198,305,198,308,311,312,315,316],{},"Экспортированные gRPC-клиенты и типы (",[110,300,301],{},"authpb",[110,303,304],{},"userpb",[110,306,307],{},"departmentpb",[110,309,310],{},"adminpb",") + исходные ",[110,313,314],{},".proto","-файлы в каталоге ",[110,317,318],{},"proto\u002F",[320,321,323],"h2",{"id":322},"установка","Установка",[325,326,331],"pre",{"className":327,"code":328,"language":329,"meta":330,"style":330},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","export GOPRIVATE=git.cyberzone.dev\ngo get git.cyberzone.dev\u002Fcyberzone\u002Fjulia-go@v0.1.0-rc.1\n","bash","",[110,332,333,353],{"__ignoreMap":330},[334,335,338,342,346,350],"span",{"class":336,"line":337},"line",1,[334,339,341],{"class":340},"spNyl","export",[334,343,345],{"class":344},"sTEyZ"," GOPRIVATE",[334,347,349],{"class":348},"sMK4o","=",[334,351,352],{"class":344},"git.cyberzone.dev\n",[334,354,356,360,364],{"class":336,"line":355},2,[334,357,359],{"class":358},"sBMFI","go",[334,361,363],{"class":362},"sfazB"," get",[334,365,366],{"class":362}," git.cyberzone.dev\u002Fcyberzone\u002Fjulia-go@v0.1.0-rc.1\n",[95,368,369,370,373,374,376],{},"Путь модуля заканчивается на ",[110,371,372],{},"julia-go",", но имя корневого пакета — ",[110,375,180],{},". Чтобы избежать расхождений в автоимпорте IDE, рекомендуется использовать явный алиас:",[325,378,381],{"className":379,"code":380,"language":359,"meta":330,"style":330},"language-go shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","import julia \"git.cyberzone.dev\u002Fcyberzone\u002Fjulia-go\"\n",[110,382,383],{"__ignoreMap":330},[334,384,385],{"class":336,"line":337},[334,386,380],{},[388,389],"hr",{},[320,391,393],{"id":392},"инициализация-клиента","Инициализация клиента",[95,395,396,397,400],{},"Создайте один экземпляр ",[110,398,399],{},"julia.Client"," на процесс — он хранит gRPC-соединение с Julia и закэшированный ключ подписи:",[325,402,404],{"className":379,"code":403,"language":359,"meta":330,"style":330},"client, err := julia.New(julia.Config{\n    Token: julia.TokenConfig{\n        Issuer:   \"https:\u002F\u002Fauth.mirea.app\",\n        Audience: \"cyberzone\",\n    },\n    Upstream: julia.UpstreamConfig{\n        Address: \"julia.example:443\",\n        APIKey:  os.Getenv(\"JULIA_API_KEY\"),\n    },\n})\nif err != nil {\n    return err\n}\ndefer client.Close()\n",[110,405,406,411,416,422,428,434,440,446,452,457,463,469,475,481],{"__ignoreMap":330},[334,407,408],{"class":336,"line":337},[334,409,410],{},"client, err := julia.New(julia.Config{\n",[334,412,413],{"class":336,"line":355},[334,414,415],{},"    Token: julia.TokenConfig{\n",[334,417,419],{"class":336,"line":418},3,[334,420,421],{},"        Issuer:   \"https:\u002F\u002Fauth.mirea.app\",\n",[334,423,425],{"class":336,"line":424},4,[334,426,427],{},"        Audience: \"cyberzone\",\n",[334,429,431],{"class":336,"line":430},5,[334,432,433],{},"    },\n",[334,435,437],{"class":336,"line":436},6,[334,438,439],{},"    Upstream: julia.UpstreamConfig{\n",[334,441,443],{"class":336,"line":442},7,[334,444,445],{},"        Address: \"julia.example:443\",\n",[334,447,449],{"class":336,"line":448},8,[334,450,451],{},"        APIKey:  os.Getenv(\"JULIA_API_KEY\"),\n",[334,453,455],{"class":336,"line":454},9,[334,456,433],{},[334,458,460],{"class":336,"line":459},10,[334,461,462],{},"})\n",[334,464,466],{"class":336,"line":465},11,[334,467,468],{},"if err != nil {\n",[334,470,472],{"class":336,"line":471},12,[334,473,474],{},"    return err\n",[334,476,478],{"class":336,"line":477},13,[334,479,480],{},"}\n",[334,482,484],{"class":336,"line":483},14,[334,485,486],{},"defer client.Close()\n",[488,489,490,501,504,523],"ul",{},[491,492,493,496,497,500],"li",{},[110,494,495],{},"julia.New"," проверяет всю конфигурацию сразу и возвращает объединённую ошибку (каждая часть оборачивает ",[110,498,499],{},"julia.ErrInvalidConfig",").",[491,502,503],{},"Соединение устанавливается лениво при первом вызове — недоступность Julia на старте не мешает запуску сервиса.",[491,505,506,507,510,511,514,515,518,519,522],{},"Принимается строго алгоритм ",[110,508,509],{},"EdDSA"," и по умолчанию только ",[110,512,513],{},"token_type == \"access\"",". Публичный ключ загружается из ",[110,516,517],{},"Keys.GetPublicKey"," и кэшируется с защитой от повторных запросов на неизвестные ",[110,520,521],{},"kid",".",[491,524,525,526,529,530,533,534,537,538,541],{},"При необходимости ключ можно закрепить локально через ",[110,527,528],{},"julia.WithKeySource(...)",", переиспользовать готовое соединение через ",[110,531,532],{},"julia.WithConn(conn)"," или передать опции дозвона через ",[110,535,536],{},"julia.WithDialOptions(...)"," (например, ",[110,539,540],{},"grpc.WithTransportCredentials(insecure.NewCredentials())"," для незашифрованного внутреннего канала).",[388,543],{},[320,545,547,548,181],{"id":546},"http-middleware-juliahttp","HTTP-middleware (",[110,549,550],{},"juliahttp",[95,552,553,554,556],{},"Все middleware имеют стандартную сигнатуру ",[110,555,218],{},":",[325,558,560],{"className":379,"code":559,"language":359,"meta":330,"style":330},"import (\n    \"net\u002Fhttp\"\n\n    julia \"git.cyberzone.dev\u002Fcyberzone\u002Fjulia-go\"\n    \"git.cyberzone.dev\u002Fcyberzone\u002Fjulia-go\u002Fjuliahttp\"\n)\n\nrouter := http.NewServeMux()\n\n\u002F\u002F Только аутентификация (Bearer JWT):\nrouter.Handle(\"GET \u002Fprofile\", juliahttp.Authenticate(client)(profileHandler))\n\n\u002F\u002F Аутентификация + проверка права (Authenticate всегда идёт первым):\nrouter.Handle(\"DELETE \u002Fusers\u002F{id}\",\n    juliahttp.Authenticate(client)(\n        juliahttp.RequirePermission(client, \"myservice.users:delete\")(deleteUserHandler)))\n\n\u002F\u002F Анонимные запросы допускаются, валидный токен распознаётся (битый — отклоняется с 401):\nrouter.Handle(\"GET \u002Farticles\", juliahttp.Optional(client)(articlesHandler))\n",[110,561,562,567,572,578,583,588,593,597,602,606,611,616,620,625,630,636,642,647,653],{"__ignoreMap":330},[334,563,564],{"class":336,"line":337},[334,565,566],{},"import (\n",[334,568,569],{"class":336,"line":355},[334,570,571],{},"    \"net\u002Fhttp\"\n",[334,573,574],{"class":336,"line":418},[334,575,577],{"emptyLinePlaceholder":576},true,"\n",[334,579,580],{"class":336,"line":424},[334,581,582],{},"    julia \"git.cyberzone.dev\u002Fcyberzone\u002Fjulia-go\"\n",[334,584,585],{"class":336,"line":430},[334,586,587],{},"    \"git.cyberzone.dev\u002Fcyberzone\u002Fjulia-go\u002Fjuliahttp\"\n",[334,589,590],{"class":336,"line":436},[334,591,592],{},")\n",[334,594,595],{"class":336,"line":442},[334,596,577],{"emptyLinePlaceholder":576},[334,598,599],{"class":336,"line":448},[334,600,601],{},"router := http.NewServeMux()\n",[334,603,604],{"class":336,"line":454},[334,605,577],{"emptyLinePlaceholder":576},[334,607,608],{"class":336,"line":459},[334,609,610],{},"\u002F\u002F Только аутентификация (Bearer JWT):\n",[334,612,613],{"class":336,"line":465},[334,614,615],{},"router.Handle(\"GET \u002Fprofile\", juliahttp.Authenticate(client)(profileHandler))\n",[334,617,618],{"class":336,"line":471},[334,619,577],{"emptyLinePlaceholder":576},[334,621,622],{"class":336,"line":477},[334,623,624],{},"\u002F\u002F Аутентификация + проверка права (Authenticate всегда идёт первым):\n",[334,626,627],{"class":336,"line":483},[334,628,629],{},"router.Handle(\"DELETE \u002Fusers\u002F{id}\",\n",[334,631,633],{"class":336,"line":632},15,[334,634,635],{},"    juliahttp.Authenticate(client)(\n",[334,637,639],{"class":336,"line":638},16,[334,640,641],{},"        juliahttp.RequirePermission(client, \"myservice.users:delete\")(deleteUserHandler)))\n",[334,643,645],{"class":336,"line":644},17,[334,646,577],{"emptyLinePlaceholder":576},[334,648,650],{"class":336,"line":649},18,[334,651,652],{},"\u002F\u002F Анонимные запросы допускаются, валидный токен распознаётся (битый — отклоняется с 401):\n",[334,654,656],{"class":336,"line":655},19,[334,657,658],{},"router.Handle(\"GET \u002Farticles\", juliahttp.Optional(client)(articlesHandler))\n",[95,660,661],{},"Получение субъекта в обработчике:",[325,663,665],{"className":379,"code":664,"language":359,"meta":330,"style":330},"principal, ok := julia.PrincipalFromContext(r.Context())\n",[110,666,667],{"__ignoreMap":330},[334,668,669],{"class":336,"line":337},[334,670,664],{},[95,672,673,674,235,677,680,681,684,685,688],{},"Для проверки нескольких прав используйте ",[110,675,676],{},"juliahttp.RequireAny(client, []string{...})",[110,678,679],{},"juliahttp.RequireAll(client, []string{...})"," (передача пустого среза вызывает ",[110,682,683],{},"panic"," при инициализации, чтобы исключить случайно незащищённый маршрут). Цепочка из нескольких ",[110,686,687],{},"Require*","-middleware запрашивает права пользователя один раз на запрос.",[690,691,693],"h3",{"id":692},"приём-api-ключей-на-http-маршрутах","Приём API-ключей на HTTP-маршрутах",[95,695,696,697,699,700,703,704,706,707,556],{},"По умолчанию ",[110,698,550],{}," принимает только ",[110,701,702],{},"Authorization: Bearer \u003Cjwt>",". Приём ",[110,705,256],{}," включается явно на нужных маршрутах через ",[110,708,709],{},"juliahttp.WithAPIKeyHeader()",[325,711,713],{"className":379,"code":712,"language":359,"meta":330,"style":330},"router.Handle(\"POST \u002Finvoices\",\n    juliahttp.Authenticate(client,\n        juliahttp.WithAPIKeyHeader(),\n        \u002F\u002F За прокси укажите доверенный источник IP клиента для проверки AllowedIps:\n        juliahttp.WithClientIP(func(r *http.Request) string {\n            return r.Header.Get(\"X-Real-Ip\")\n        }),\n    )(createInvoiceHandler))\n",[110,714,715,720,725,730,735,740,745,750],{"__ignoreMap":330},[334,716,717],{"class":336,"line":337},[334,718,719],{},"router.Handle(\"POST \u002Finvoices\",\n",[334,721,722],{"class":336,"line":355},[334,723,724],{},"    juliahttp.Authenticate(client,\n",[334,726,727],{"class":336,"line":418},[334,728,729],{},"        juliahttp.WithAPIKeyHeader(),\n",[334,731,732],{"class":336,"line":424},[334,733,734],{},"        \u002F\u002F За прокси укажите доверенный источник IP клиента для проверки AllowedIps:\n",[334,736,737],{"class":336,"line":430},[334,738,739],{},"        juliahttp.WithClientIP(func(r *http.Request) string {\n",[334,741,742],{"class":336,"line":436},[334,743,744],{},"            return r.Header.Get(\"X-Real-Ip\")\n",[334,746,747],{"class":336,"line":442},[334,748,749],{},"        }),\n",[334,751,752],{"class":336,"line":448},[334,753,754],{},"    )(createInvoiceHandler))\n",[123,756,758],{"color":125,"icon":757},"i-lucide-shield-alert",[95,759,760,761,764,765,768,769,772],{},"По умолчанию для проверки ",[110,762,763],{},"AllowedIps"," используется ",[110,766,767],{},"r.RemoteAddr"," (peer соединения), а заголовок ",[110,770,771],{},"X-Forwarded-For"," намеренно игнорируется, так как его может подделать клиент. Если в запросе переданы одновременно и Bearer JWT, и API-ключ, приоритет отдаётся Bearer-токену.",[690,774,776],{"id":775},"коды-http-ответов","Коды HTTP-ответов",[152,778,779,789],{},[155,780,781],{},[158,782,783,786],{},[161,784,785],{},"Статус",[161,787,788],{},"Когда возвращается",[168,790,791,804,814,828],{},[158,792,793,798],{},[173,794,795],{},[110,796,797],{},"401",[173,799,800,801,181],{},"Нет учётных данных или они не прошли проверку (с заголовком ",[110,802,803],{},"WWW-Authenticate",[158,805,806,811],{},[173,807,808],{},[110,809,810],{},"403",[173,812,813],{},"Субъект аутентифицирован, но не обладает требуемым правом",[158,815,816,821],{},[173,817,818],{},[110,819,820],{},"503",[173,822,823,824,827],{},"Julia недоступна (",[110,825,826],{},"ErrUpstream",") — сбой ретраибелен и не сбрасывает сессию клиента",[158,829,830,835],{},[173,831,832],{},[110,833,834],{},"500",[173,836,837,838,181],{},"Прочие внутренние ошибки (например, проверка прав без ",[110,839,840],{},"PermissionProvider",[95,842,843,844,522],{},"По умолчанию тело ответа не раскрывает причину отказа; поведение настраивается через ",[110,845,846],{},"juliahttp.WithErrorHandler(...)",[388,848],{},[320,850,852],{"id":851},"проверка-доступа-к-ресурсу-и-уровни-доступа","Проверка доступа к ресурсу и уровни доступа",[95,854,855,856,859],{},"Для маршрутов с идентификатором целевого ресурса используйте грубую проверку ",[110,857,858],{},"RequirePermissionInAnyScope"," на роутере и точную проверку экземпляра внутри обработчика:",[325,861,863],{"className":379,"code":862,"language":359,"meta":330,"style":330},"router.Handle(\"GET \u002Fusers\u002F{id}\u002Forders\",\n    juliahttp.Authenticate(client)(\n        juliahttp.RequirePermissionInAnyScope(client, \"myservice.orders:read\")(listOrdersHandler)))\n\n\u002F\u002F Внутри listOrdersHandler, когда известен id целевого пользователя:\ngranted, err := client.Check(ctx, principal, \"myservice.orders:read:\"+id)\n",[110,864,865,870,874,879,883,888],{"__ignoreMap":330},[334,866,867],{"class":336,"line":337},[334,868,869],{},"router.Handle(\"GET \u002Fusers\u002F{id}\u002Forders\",\n",[334,871,872],{"class":336,"line":355},[334,873,635],{},[334,875,876],{"class":336,"line":418},[334,877,878],{},"        juliahttp.RequirePermissionInAnyScope(client, \"myservice.orders:read\")(listOrdersHandler)))\n",[334,880,881],{"class":336,"line":424},[334,882,577],{"emptyLinePlaceholder":576},[334,884,885],{"class":336,"line":430},[334,886,887],{},"\u002F\u002F Внутри listOrdersHandler, когда известен id целевого пользователя:\n",[334,889,890],{"class":336,"line":436},[334,891,892],{},"granted, err := client.Check(ctx, principal, \"myservice.orders:read:\"+id)\n",[95,894,895,896,556],{},"Если эндпоинт публичен и меняет объём ответа в зависимости от вызывающего, используйте ",[110,897,898],{},"client.ResolveAccessLevel",[325,900,902],{"className":379,"code":901,"language":359,"meta":330,"style":330},"level, err := client.ResolveAccessLevel(ctx, principal, ownerID, \"myservice.users:read\")\n\u002F\u002F Возвращает julia.AccessPublic, julia.AccessOwner или julia.AccessPrivileged\n",[110,903,904,909],{"__ignoreMap":330},[334,905,906],{"class":336,"line":337},[334,907,908],{},"level, err := client.ResolveAccessLevel(ctx, principal, ownerID, \"myservice.users:read\")\n",[334,910,911],{"class":336,"line":355},[334,912,913],{},"\u002F\u002F Возвращает julia.AccessPublic, julia.AccessOwner или julia.AccessPrivileged\n",[95,915,916,917,920,921,924,925,928],{},"Владение (",[110,918,919],{},"AccessOwner",") проверяется до сетевого запроса прав и применяется только к пользователям (",[110,922,923],{},"SubjectUser","); сервисные субъекты (",[110,926,927],{},"SubjectMachine",") получают доступ исключительно через права.",[388,930],{},[320,932,934,935,235,938,181],{"id":933},"grpc-juliagrpc-и-contracts","gRPC (",[110,936,937],{},"juliagrpc",[110,939,940],{},"contracts",[690,942,944],{"id":943},"исходящие-вызовы-к-julia","Исходящие вызовы к Julia",[95,946,947,950,951,953,954,556],{},[110,948,949],{},"juliagrpc.Dial"," открывает TLS-соединение и автоматически добавляет метаданные ",[110,952,256],{}," к каждому унарному и потоковому вызову. Сгенерированные клиенты лежат в ",[110,955,956],{},"contracts\u002F",[325,958,960],{"className":379,"code":959,"language":359,"meta":330,"style":330},"import (\n    \"os\"\n\n    \"git.cyberzone.dev\u002Fcyberzone\u002Fjulia-go\u002Fcontracts\u002Fdepartmentpb\"\n    \"git.cyberzone.dev\u002Fcyberzone\u002Fjulia-go\u002Fjuliagrpc\"\n)\n\nconn, err := juliagrpc.Dial(\"julia.example:443\", os.Getenv(\"JULIA_API_KEY\"))\nif err != nil {\n    return err\n}\ndefer conn.Close()\n\ndepartments := departmentpb.NewDepartmentsClient(conn)\n",[110,961,962,966,971,975,980,985,989,993,998,1002,1006,1010,1015,1019],{"__ignoreMap":330},[334,963,964],{"class":336,"line":337},[334,965,566],{},[334,967,968],{"class":336,"line":355},[334,969,970],{},"    \"os\"\n",[334,972,973],{"class":336,"line":418},[334,974,577],{"emptyLinePlaceholder":576},[334,976,977],{"class":336,"line":424},[334,978,979],{},"    \"git.cyberzone.dev\u002Fcyberzone\u002Fjulia-go\u002Fcontracts\u002Fdepartmentpb\"\n",[334,981,982],{"class":336,"line":430},[334,983,984],{},"    \"git.cyberzone.dev\u002Fcyberzone\u002Fjulia-go\u002Fjuliagrpc\"\n",[334,986,987],{"class":336,"line":436},[334,988,592],{},[334,990,991],{"class":336,"line":442},[334,992,577],{"emptyLinePlaceholder":576},[334,994,995],{"class":336,"line":448},[334,996,997],{},"conn, err := juliagrpc.Dial(\"julia.example:443\", os.Getenv(\"JULIA_API_KEY\"))\n",[334,999,1000],{"class":336,"line":454},[334,1001,468],{},[334,1003,1004],{"class":336,"line":459},[334,1005,474],{},[334,1007,1008],{"class":336,"line":465},[334,1009,480],{},[334,1011,1012],{"class":336,"line":471},[334,1013,1014],{},"defer conn.Close()\n",[334,1016,1017],{"class":336,"line":477},[334,1018,577],{"emptyLinePlaceholder":576},[334,1020,1021],{"class":336,"line":483},[334,1022,1023],{},"departments := departmentpb.NewDepartmentsClient(conn)\n",[95,1025,1026,1027,1029,1030,522],{},"Для локальной работы или внутреннего незашифрованного канала передайте ",[110,1028,540],{}," в ",[110,1031,949],{},[690,1033,1035],{"id":1034},"защита-собственного-grpc-сервера","Защита собственного gRPC-сервера",[325,1037,1039],{"className":379,"code":1038,"language":359,"meta":330,"style":330},"import (\n    \"google.golang.org\u002Fgrpc\"\n\n    \"git.cyberzone.dev\u002Fcyberzone\u002Fjulia-go\u002Fjuliagrpc\"\n)\n\nserver := grpc.NewServer(\n    grpc.ChainUnaryInterceptor(juliagrpc.UnaryServerInterceptor(client,\n        juliagrpc.WithServerAPIKeys(), \u002F\u002F опционально: принимать X-Api-Key в метаданных\n        juliagrpc.WithAnonymousMethods(\"\u002Fgrpc.health.v1.Health\u002FCheck\"),\n        juliagrpc.WithMethodPolicies(map[string]juliagrpc.MethodPolicy{\n            \"\u002Fbilling.Invoices\u002FDelete\": {All: []string{\"billing.invoices:delete\"}},\n            \"\u002Fbilling.Invoices\u002FList\":   {AnyScope: \"billing.invoices:read\"},\n        }),\n    )),\n    grpc.ChainStreamInterceptor(juliagrpc.StreamServerInterceptor(client)),\n)\n",[110,1040,1041,1045,1050,1054,1058,1062,1066,1071,1076,1081,1086,1091,1096,1101,1105,1110,1115],{"__ignoreMap":330},[334,1042,1043],{"class":336,"line":337},[334,1044,566],{},[334,1046,1047],{"class":336,"line":355},[334,1048,1049],{},"    \"google.golang.org\u002Fgrpc\"\n",[334,1051,1052],{"class":336,"line":418},[334,1053,577],{"emptyLinePlaceholder":576},[334,1055,1056],{"class":336,"line":424},[334,1057,984],{},[334,1059,1060],{"class":336,"line":430},[334,1061,592],{},[334,1063,1064],{"class":336,"line":436},[334,1065,577],{"emptyLinePlaceholder":576},[334,1067,1068],{"class":336,"line":442},[334,1069,1070],{},"server := grpc.NewServer(\n",[334,1072,1073],{"class":336,"line":448},[334,1074,1075],{},"    grpc.ChainUnaryInterceptor(juliagrpc.UnaryServerInterceptor(client,\n",[334,1077,1078],{"class":336,"line":454},[334,1079,1080],{},"        juliagrpc.WithServerAPIKeys(), \u002F\u002F опционально: принимать X-Api-Key в метаданных\n",[334,1082,1083],{"class":336,"line":459},[334,1084,1085],{},"        juliagrpc.WithAnonymousMethods(\"\u002Fgrpc.health.v1.Health\u002FCheck\"),\n",[334,1087,1088],{"class":336,"line":465},[334,1089,1090],{},"        juliagrpc.WithMethodPolicies(map[string]juliagrpc.MethodPolicy{\n",[334,1092,1093],{"class":336,"line":471},[334,1094,1095],{},"            \"\u002Fbilling.Invoices\u002FDelete\": {All: []string{\"billing.invoices:delete\"}},\n",[334,1097,1098],{"class":336,"line":477},[334,1099,1100],{},"            \"\u002Fbilling.Invoices\u002FList\":   {AnyScope: \"billing.invoices:read\"},\n",[334,1102,1103],{"class":336,"line":483},[334,1104,749],{},[334,1106,1107],{"class":336,"line":632},[334,1108,1109],{},"    )),\n",[334,1111,1112],{"class":336,"line":638},[334,1113,1114],{},"    grpc.ChainStreamInterceptor(juliagrpc.StreamServerInterceptor(client)),\n",[334,1116,1117],{"class":336,"line":644},[334,1118,592],{},[123,1120,1123],{"color":1121,"icon":1122},"neutral","i-lucide-info",[95,1124,1125,1126,198,1129,1132,1133,1136,1137,198,1140,198,1143,235,1146,1149,1150,522],{},"Метод, не указанный в ",[110,1127,1128],{},"WithMethodPolicies",[99,1130,1131],{},"аутентифицируется и пропускается без проверки прав"," (как в .NET-интерцепторе без атрибута ",[110,1134,1135],{},"[RequirePermission]","). Ошибки по умолчанию мапятся в ",[110,1138,1139],{},"Unauthenticated",[110,1141,1142],{},"PermissionDenied",[110,1144,1145],{},"Unavailable",[110,1147,1148],{},"Internal","; маппинг переопределяется через ",[110,1151,1152],{},"juliagrpc.WithStatusMapper",[388,1154],{},[320,1156,1158],{"id":1157},"кэширование-прав-и-интроспекции","Кэширование прав и интроспекции",[95,1160,1161,1162,1165],{},"Модуль намеренно не реализует хранилище кэша (in-memory, Redis и т. д.), но предоставляет готовые интерфейсы с дедупликацией параллельных промахов (",[110,1163,1164],{},"singleflight",") и отказоустойчивым fallback при ошибках кэша:",[325,1167,1169],{"className":379,"code":1168,"language":359,"meta":330,"style":330},"client, err := julia.New(cfg,\n    julia.WithPermissionCache(myPermissionCache, time.Minute),\n    julia.WithAPIKeyCache(myAPIKeyCache),\n)\n",[110,1170,1171,1176,1181,1186],{"__ignoreMap":330},[334,1172,1173],{"class":336,"line":337},[334,1174,1175],{},"client, err := julia.New(cfg,\n",[334,1177,1178],{"class":336,"line":355},[334,1179,1180],{},"    julia.WithPermissionCache(myPermissionCache, time.Minute),\n",[334,1182,1183],{"class":336,"line":418},[334,1184,1185],{},"    julia.WithAPIKeyCache(myAPIKeyCache),\n",[334,1187,1188],{"class":336,"line":424},[334,1189,592],{},[488,1191,1192,1211],{},[491,1193,1194,1199,1200,1203,1204,1207,1208,522],{},[99,1195,1196],{},[110,1197,1198],{},"julia.PermissionCache"," — кэширует ",[110,1201,1202],{},"PermissionSet"," по ключу субъекта (",[110,1205,1206],{},"julia.PermissionCacheKey(subjectID)","). Ручная инвалидация: ",[110,1209,1210],{},"client.ForgetPermissions(ctx, subjectID)",[491,1212,1213,1199,1218,1221,1222,1225,1226,177,1229,235,1232,1235,1236,1239,1240,1243,1244,522],{},[99,1214,1215],{},[110,1216,1217],{},"julia.APIKeyCache",[110,1219,1220],{},"APIKeyRecord"," по ",[110,1223,1224],{},"SHA-256"," предъявленного ключа с учётом ",[110,1227,1228],{},"ip_unrestricted",[110,1230,1231],{},"APIKeyCacheKey",[110,1233,1234],{},"APIKeyCacheKeyAnyAddress","). TTL передавать не нужно: клиент автоматически использует ",[110,1237,1238],{},"cache_ttl_seconds"," из ответа Julia и ограничивает его сроком ",[110,1241,1242],{},"expires_at",". Ручная инвалидация: ",[110,1245,1246],{},"client.ForgetAPIKey(ctx, key, remoteIP)",[388,1248],{},[320,1250,1252,1253,181],{"id":1251},"локальный-разбор-api-ключей-apikey","Локальный разбор API-ключей (",[110,1254,1255],{},"apikey",[95,1257,1258,1259,1261,1262,1265],{},"Пакет ",[110,1260,1255],{}," проверяет структуру и контрольную сумму ключа локально без соединения с Julia (зависит только от stdlib и ",[110,1263,1264],{},"google\u002Fuuid","):",[325,1267,1269],{"className":379,"code":1268,"language":359,"meta":330,"style":330},"import \"git.cyberzone.dev\u002Fcyberzone\u002Fjulia-go\u002Fapikey\"\n\nref, err := apikey.Parse(presentedKey)  \u002F\u002F ref.TokenID, ref.Namespace, ref.Kind\nhint, err := apikey.Hint(presentedKey)  \u002F\u002F \"cza-pat-019f***c349\" — безопасно для логов и UI\nhash := apikey.Hash(presentedKey)       \u002F\u002F [32]byte SHA-256 для ключей кэша\nequal := apikey.HashEqual(a, b)         \u002F\u002F сравнение за постоянное время\n",[110,1270,1271,1276,1280,1285,1290,1295],{"__ignoreMap":330},[334,1272,1273],{"class":336,"line":337},[334,1274,1275],{},"import \"git.cyberzone.dev\u002Fcyberzone\u002Fjulia-go\u002Fapikey\"\n",[334,1277,1278],{"class":336,"line":355},[334,1279,577],{"emptyLinePlaceholder":576},[334,1281,1282],{"class":336,"line":418},[334,1283,1284],{},"ref, err := apikey.Parse(presentedKey)  \u002F\u002F ref.TokenID, ref.Namespace, ref.Kind\n",[334,1286,1287],{"class":336,"line":424},[334,1288,1289],{},"hint, err := apikey.Hint(presentedKey)  \u002F\u002F \"cza-pat-019f***c349\" — безопасно для логов и UI\n",[334,1291,1292],{"class":336,"line":430},[334,1293,1294],{},"hash := apikey.Hash(presentedKey)       \u002F\u002F [32]byte SHA-256 для ключей кэша\n",[334,1296,1297],{"class":336,"line":436},[334,1298,1299],{},"equal := apikey.HashEqual(a, b)         \u002F\u002F сравнение за постоянное время\n",[388,1301],{},[320,1303,1305],{"id":1304},"ошибки","Ошибки",[95,1307,1308,1309,556],{},"Все ошибки оборачиваются и проверяются через ",[110,1310,1311],{},"errors.Is",[152,1313,1314,1324],{},[155,1315,1316],{},[158,1317,1318,1321],{},[161,1319,1320],{},"Ошибка",[161,1322,1323],{},"Значение",[168,1325,1326,1344,1357,1371,1387,1397,1410,1421,1436],{},[158,1327,1328,1333],{},[173,1329,1330],{},[110,1331,1332],{},"julia.ErrInvalidToken",[173,1334,1335,1336,1339,1340,1343],{},"Токен или API-ключ не прошёл проверку (подпись, ",[110,1337,1338],{},"iss","\u002F",[110,1341,1342],{},"aud",", срок действия, тип токена, отказ Julia)",[158,1345,1346,1351],{},[173,1347,1348],{},[110,1349,1350],{},"julia.ErrUnknownKey",[173,1352,1353,1354,181],{},"Подпись ключом, которого нет в Julia (также матчится как ",[110,1355,1356],{},"ErrInvalidToken",[158,1358,1359,1364],{},[173,1360,1361],{},[110,1362,1363],{},"julia.ErrUpstream",[173,1365,1366,1367,1370],{},"Сбой обращения к Julia — ",[99,1368,1369],{},"не"," ошибка аутентификации",[158,1372,1373,1378],{},[173,1374,1375],{},[110,1376,1377],{},"julia.ErrForbidden",[173,1379,1380,1381,1383,1384,181],{},"Недостаточно прав (возвращают транспорты; ",[110,1382,197],{}," возвращает ",[110,1385,1386],{},"false, nil",[158,1388,1389,1394],{},[173,1390,1391],{},[110,1392,1393],{},"julia.ErrInvalidClaims",[173,1395,1396],{},"Валидный токен не содержит корректной структуры claims Julia",[158,1398,1399,1404],{},[173,1400,1401],{},[110,1402,1403],{},"julia.ErrInvalidPermission",[173,1405,1406,1407,181],{},"Некорректная строка права (при разборе через ",[110,1408,1409],{},"ParsePermission",[158,1411,1412,1416],{},[173,1413,1414],{},[110,1415,499],{},[173,1417,1418,1419],{},"Ошибки конфигурации при вызове ",[110,1420,495],{},[158,1422,1423,1428],{},[173,1424,1425],{},[110,1426,1427],{},"julia.ErrNoPermissionProvider",[173,1429,1430,1431,1433,1434],{},"Вызвана проверка прав на ",[110,1432,186],{}," без ",[110,1435,840],{},[158,1437,1438,1443],{},[173,1439,1440],{},[110,1441,1442],{},"julia.ErrNoIntrospection",[173,1444,1445,1446,1448],{},"Попытка проверить API-ключ на ",[110,1447,186],{}," без подключения к Julia",[1450,1451,1452],"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 .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}",{"title":330,"searchDepth":355,"depth":355,"links":1454},[1455,1456,1457,1462,1463,1468,1469,1471],{"id":322,"depth":355,"text":323},{"id":392,"depth":355,"text":393},{"id":546,"depth":355,"text":1458,"children":1459},"HTTP-middleware (juliahttp)",[1460,1461],{"id":692,"depth":418,"text":693},{"id":775,"depth":418,"text":776},{"id":851,"depth":355,"text":852},{"id":933,"depth":355,"text":1464,"children":1465},"gRPC (juliagrpc и contracts)",[1466,1467],{"id":943,"depth":418,"text":944},{"id":1034,"depth":418,"text":1035},{"id":1157,"depth":355,"text":1158},{"id":1251,"depth":355,"text":1470},"Локальный разбор API-ключей (apikey)",{"id":1304,"depth":355,"text":1305},"Интеграция сервисов на Go (1.25+) с помощью официального модуля git.cyberzone.dev\u002Fcyberzone\u002Fjulia-go — проверка EdDSA JWT, права, HTTP\u002FgRPC middleware и API-ключи.","md",[1475],{"label":1476,"icon":126,"to":106,"target":1477,"color":1121,"variant":1478},"Репозиторий","_blank","outline",{},{"title":75,"icon":73},{"title":90,"description":1472},"wiJOUByVIIxX5GKjS1HgajpPFt6fzeM2L8PabSA1tiU",[1484,1486],{"title":70,"path":71,"stem":72,"description":1485,"icon":73,"children":-1},"Интеграция сервисов на .NET с помощью публичных NuGet-пакетов Cyberzone.Julia.Contracts и Cyberzone.Julia.Authorization.",{"title":79,"path":80,"stem":81,"description":1487,"icon":82,"children":-1},"Обзор публичных gRPC-сервисов Julia, аутентификация метаданными X-Api-Key и примеры вызовов для .NET и Go.",1795320979184]