[{"data":1,"prerenderedAt":975},["ShallowReactive",2],{"navigation":3,"\u002Fintegration\u002Fdotnet-sdk":88,"\u002Fintegration\u002Fdotnet-sdk-surround":970},[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":963,"extension":964,"hideToc":20,"links":965,"meta":966,"navigation":967,"path":71,"seo":968,"stem":72,"wide":20,"__hash__":969},"docs\u002F4.integration\u002F1.dotnet-sdk.md","Пакеты для .NET (NuGet)",{"type":92,"value":93,"toc":948},"minimark",[94,108,169,174,214,217,222,232,240,257,381,404,408,415,485,487,492,499,503,510,611,619,629,722,747,751,785,805,834,838,853,925,944],[95,96,97,98,102,103,107],"p",{},"Для сервисов на ",[99,100,101],"strong",{},".NET (8.0+)"," публикуются два официальных NuGet-пакета, покрывающих все задачи интеграции: gRPC-контракты, валидацию EdDSA JWT, работу с моделью ",[104,105,106],"code",{},"JuliaPrincipal",", проверку прав и парсинг API-ключей.",[109,110,111,124],"table",{},[112,113,114],"thead",{},[115,116,117,121],"tr",{},[118,119,120],"th",{},"Пакет",[118,122,123],{},"Назначение",[125,126,127,149],"tbody",{},[115,128,129,135],{},[130,131,132],"td",{},[104,133,134],{},"Cyberzone.Julia.Contracts",[130,136,137,138,141,142,145,146],{},"Сгенерированные gRPC-клиенты и ",[104,139,140],{},".proto","-контракты + поддержка ",[99,143,144],{},"EdDSA (Ed25519)"," для ",[104,147,148],{},"Microsoft.IdentityModel.Tokens",[115,150,151,156],{},[130,152,153],{},[104,154,155],{},"Cyberzone.Julia.Authorization",[130,157,158,159,161,162,165,166],{},"Типизированная модель субъекта ",[104,160,106],{},", иерархическая проверка прав, фильтры Minimal API, gRPC ",[104,163,164],{},"PermissionInterceptor"," и валидатор ",[104,167,168],{},"ApiKey",[170,171,173],"h2",{"id":172},"установка","Установка",[175,176,181],"pre",{"className":177,"code":178,"language":179,"meta":180,"style":180},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","dotnet add package Cyberzone.Julia.Contracts\ndotnet add package Cyberzone.Julia.Authorization\n","bash","",[104,182,183,202],{"__ignoreMap":180},[184,185,188,192,196,199],"span",{"class":186,"line":187},"line",1,[184,189,191],{"class":190},"sBMFI","dotnet",[184,193,195],{"class":194},"sfazB"," add",[184,197,198],{"class":194}," package",[184,200,201],{"class":194}," Cyberzone.Julia.Contracts\n",[184,203,205,207,209,211],{"class":186,"line":204},2,[184,206,191],{"class":190},[184,208,195],{"class":194},[184,210,198],{"class":194},[184,212,213],{"class":194}," Cyberzone.Julia.Authorization\n",[215,216],"hr",{},[170,218,220],{"id":219},"cyberzonejuliacontracts",[104,221,134],{},[95,223,224,225,227,228,231],{},"Пакет состоит из двух независимых частей: gRPC-клиентов (плюс исходные ",[104,226,140],{},"-файлы в каталоге ",[104,229,230],{},"protos\u002F"," пакета) и криптографии EdDSA.",[233,234,236,237],"h3",{"id":235},"валидация-jwt-с-помощью-eddsasecuritykey","Валидация JWT с помощью ",[104,238,239],{},"EdDsaSecurityKey",[95,241,242,243,245,246,248,249,252,253,256],{},"Стандартная библиотека ",[104,244,148],{}," не поддерживает Ed25519 из коробки. ",[104,247,239],{}," автоматически регистрирует свой ",[104,250,251],{},"CryptoProviderFactory"," и работает с ",[104,254,255],{},"TokenValidationParameters"," как обычный ключ:",[175,258,262],{"className":259,"code":260,"language":261,"meta":180,"style":180},"language-csharp shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","using Cyberzone.Julia.Contracts.Crypto;\nusing Cyberzone.Julia.Contracts.Crypto.EdDsa;\nusing Microsoft.IdentityModel.Tokens;\n\n\u002F\u002F Из REST \u002Fv1\u002Fauth\u002Fpublickey?type=base64 или gRPC Keys.GetPublicKey:\nvar key = new EdDsaSecurityKey(Convert.FromBase64String(publicKeyBase64));\n\n\u002F\u002F Либо из JWKS (\u002F.well-known\u002Fjwks.json):\n\u002F\u002F var key = new EdDsaSecurityKey(Base64UrlEncoder.DecodeBytes(jwk.X));\n\noptions.MapInboundClaims = false;\noptions.TokenValidationParameters = new TokenValidationParameters\n{\n    ValidAlgorithms = [ExtendedSecurityAlgorithms.EdDsa],\n    ValidIssuer = issuer,\n    ValidAudience = audience,\n    ValidateLifetime = true,\n    IssuerSigningKeyResolver = (_, _, kid, _) =>\n        string.IsNullOrEmpty(kid) || kid == key.KeyId ? [key] : [],\n};\n","csharp",[104,263,264,269,274,280,287,293,299,304,310,316,321,327,333,339,345,351,357,363,369,375],{"__ignoreMap":180},[184,265,266],{"class":186,"line":187},[184,267,268],{},"using Cyberzone.Julia.Contracts.Crypto;\n",[184,270,271],{"class":186,"line":204},[184,272,273],{},"using Cyberzone.Julia.Contracts.Crypto.EdDsa;\n",[184,275,277],{"class":186,"line":276},3,[184,278,279],{},"using Microsoft.IdentityModel.Tokens;\n",[184,281,283],{"class":186,"line":282},4,[184,284,286],{"emptyLinePlaceholder":285},true,"\n",[184,288,290],{"class":186,"line":289},5,[184,291,292],{},"\u002F\u002F Из REST \u002Fv1\u002Fauth\u002Fpublickey?type=base64 или gRPC Keys.GetPublicKey:\n",[184,294,296],{"class":186,"line":295},6,[184,297,298],{},"var key = new EdDsaSecurityKey(Convert.FromBase64String(publicKeyBase64));\n",[184,300,302],{"class":186,"line":301},7,[184,303,286],{"emptyLinePlaceholder":285},[184,305,307],{"class":186,"line":306},8,[184,308,309],{},"\u002F\u002F Либо из JWKS (\u002F.well-known\u002Fjwks.json):\n",[184,311,313],{"class":186,"line":312},9,[184,314,315],{},"\u002F\u002F var key = new EdDsaSecurityKey(Base64UrlEncoder.DecodeBytes(jwk.X));\n",[184,317,319],{"class":186,"line":318},10,[184,320,286],{"emptyLinePlaceholder":285},[184,322,324],{"class":186,"line":323},11,[184,325,326],{},"options.MapInboundClaims = false;\n",[184,328,330],{"class":186,"line":329},12,[184,331,332],{},"options.TokenValidationParameters = new TokenValidationParameters\n",[184,334,336],{"class":186,"line":335},13,[184,337,338],{},"{\n",[184,340,342],{"class":186,"line":341},14,[184,343,344],{},"    ValidAlgorithms = [ExtendedSecurityAlgorithms.EdDsa],\n",[184,346,348],{"class":186,"line":347},15,[184,349,350],{},"    ValidIssuer = issuer,\n",[184,352,354],{"class":186,"line":353},16,[184,355,356],{},"    ValidAudience = audience,\n",[184,358,360],{"class":186,"line":359},17,[184,361,362],{},"    ValidateLifetime = true,\n",[184,364,366],{"class":186,"line":365},18,[184,367,368],{},"    IssuerSigningKeyResolver = (_, _, kid, _) =>\n",[184,370,372],{"class":186,"line":371},19,[184,373,374],{},"        string.IsNullOrEmpty(kid) || kid == key.KeyId ? [key] : [],\n",[184,376,378],{"class":186,"line":377},20,[184,379,380],{},"};\n",[382,383,386],"callout",{"color":384,"icon":385},"warning","i-lucide-triangle-alert",[95,387,388,389,392,393,396,397,400,401,403],{},"Всегда задавайте ",[104,390,391],{},"MapInboundClaims = false"," при настройке ",[104,394,395],{},"JwtBearerOptions",". Иначе ASP.NET Core переименует claim ",[104,398,399],{},"sub",", и разбор ",[104,402,106],{}," не сработает.",[233,405,407],{"id":406},"генерация-тестовых-токенов","Генерация тестовых токенов",[95,409,410,411,414],{},"В интеграционных тестах вашего сервиса удобно выпускать тестовые EdDSA-токены через ",[104,412,413],{},"EdDsaSecurityKeyProvider",":",[175,416,418],{"className":259,"code":417,"language":261,"meta":180,"style":180},"using System.IdentityModel.Tokens.Jwt;\nusing Cyberzone.Julia.Contracts.Crypto;\nusing Cyberzone.Julia.Contracts.Crypto.EdDsa;\nusing Microsoft.IdentityModel.Tokens;\n\nusing var keys = new EdDsaSecurityKeyProvider();\nvar credentials = new SigningCredentials(keys.GetSecurityKey(), ExtendedSecurityAlgorithms.EdDsa);\n\nvar jwt = new JwtSecurityTokenHandler().WriteToken(new JwtSecurityToken(\n    issuer,\n    audience,\n    claims,\n    expires: DateTime.UtcNow.AddMinutes(15),\n    signingCredentials: credentials));\n",[104,419,420,425,429,433,437,441,446,451,455,460,465,470,475,480],{"__ignoreMap":180},[184,421,422],{"class":186,"line":187},[184,423,424],{},"using System.IdentityModel.Tokens.Jwt;\n",[184,426,427],{"class":186,"line":204},[184,428,268],{},[184,430,431],{"class":186,"line":276},[184,432,273],{},[184,434,435],{"class":186,"line":282},[184,436,279],{},[184,438,439],{"class":186,"line":289},[184,440,286],{"emptyLinePlaceholder":285},[184,442,443],{"class":186,"line":295},[184,444,445],{},"using var keys = new EdDsaSecurityKeyProvider();\n",[184,447,448],{"class":186,"line":301},[184,449,450],{},"var credentials = new SigningCredentials(keys.GetSecurityKey(), ExtendedSecurityAlgorithms.EdDsa);\n",[184,452,453],{"class":186,"line":306},[184,454,286],{"emptyLinePlaceholder":285},[184,456,457],{"class":186,"line":312},[184,458,459],{},"var jwt = new JwtSecurityTokenHandler().WriteToken(new JwtSecurityToken(\n",[184,461,462],{"class":186,"line":318},[184,463,464],{},"    issuer,\n",[184,466,467],{"class":186,"line":323},[184,468,469],{},"    audience,\n",[184,471,472],{"class":186,"line":329},[184,473,474],{},"    claims,\n",[184,476,477],{"class":186,"line":335},[184,478,479],{},"    expires: DateTime.UtcNow.AddMinutes(15),\n",[184,481,482],{"class":186,"line":341},[184,483,484],{},"    signingCredentials: credentials));\n",[215,486],{},[170,488,490],{"id":489},"cyberzonejuliaauthorization",[104,491,155],{},[95,493,494,495,498],{},"Пакет предоставляет единую модель субъекта и проверку прав формата ",[104,496,497],{},"base:operation:scope"," для ASP.NET Core Minimal API и gRPC.",[233,500,502],{"id":501},"_1-регистрация-и-провайдер-прав","1. Регистрация и провайдер прав",[95,504,505,506,509],{},"Реализуйте ",[104,507,508],{},"IPermissionProvider"," и зарегистрируйте авторизацию в DI:",[175,511,513],{"className":259,"code":512,"language":261,"meta":180,"style":180},"using Cyberzone.Julia.Authorization.Abstractions;\nusing Cyberzone.Julia.Authorization.Extensions;\nusing Cyberzone.Julia.Authorization.Interceptors;\nusing Cyberzone.Julia.Authorization.Models;\n\nbuilder.Services.AddJuliaAuthorization\u003CPermissionProvider>();\nbuilder.Services.AddGrpc(o => o.Interceptors.Add\u003CPermissionInterceptor>()); \u002F\u002F если используете gRPC\n\npublic sealed class PermissionProvider : IPermissionProvider\n{\n    public async Task\u003CIEnumerable\u003Cstring>> GetSubjectPermissionsAsync(JuliaPrincipal subject)\n    {\n        \u002F\u002F API-ключи и сервисные субъекты уже несут эффективные права\n        if (subject.IsApiKey || subject.IsMachine)\n            return subject.EmbeddedPermissions ?? [];\n\n        \u002F\u002F Для пользователей загрузите и закешируйте права из Julia\n        return await LoadUserPermissionsAsync(subject.SubjectId);\n    }\n}\n",[104,514,515,520,525,530,535,539,544,549,553,558,562,567,572,577,582,587,591,596,601,606],{"__ignoreMap":180},[184,516,517],{"class":186,"line":187},[184,518,519],{},"using Cyberzone.Julia.Authorization.Abstractions;\n",[184,521,522],{"class":186,"line":204},[184,523,524],{},"using Cyberzone.Julia.Authorization.Extensions;\n",[184,526,527],{"class":186,"line":276},[184,528,529],{},"using Cyberzone.Julia.Authorization.Interceptors;\n",[184,531,532],{"class":186,"line":282},[184,533,534],{},"using Cyberzone.Julia.Authorization.Models;\n",[184,536,537],{"class":186,"line":289},[184,538,286],{"emptyLinePlaceholder":285},[184,540,541],{"class":186,"line":295},[184,542,543],{},"builder.Services.AddJuliaAuthorization\u003CPermissionProvider>();\n",[184,545,546],{"class":186,"line":301},[184,547,548],{},"builder.Services.AddGrpc(o => o.Interceptors.Add\u003CPermissionInterceptor>()); \u002F\u002F если используете gRPC\n",[184,550,551],{"class":186,"line":306},[184,552,286],{"emptyLinePlaceholder":285},[184,554,555],{"class":186,"line":312},[184,556,557],{},"public sealed class PermissionProvider : IPermissionProvider\n",[184,559,560],{"class":186,"line":318},[184,561,338],{},[184,563,564],{"class":186,"line":323},[184,565,566],{},"    public async Task\u003CIEnumerable\u003Cstring>> GetSubjectPermissionsAsync(JuliaPrincipal subject)\n",[184,568,569],{"class":186,"line":329},[184,570,571],{},"    {\n",[184,573,574],{"class":186,"line":335},[184,575,576],{},"        \u002F\u002F API-ключи и сервисные субъекты уже несут эффективные права\n",[184,578,579],{"class":186,"line":341},[184,580,581],{},"        if (subject.IsApiKey || subject.IsMachine)\n",[184,583,584],{"class":186,"line":347},[184,585,586],{},"            return subject.EmbeddedPermissions ?? [];\n",[184,588,589],{"class":186,"line":353},[184,590,286],{"emptyLinePlaceholder":285},[184,592,593],{"class":186,"line":359},[184,594,595],{},"        \u002F\u002F Для пользователей загрузите и закешируйте права из Julia\n",[184,597,598],{"class":186,"line":365},[184,599,600],{},"        return await LoadUserPermissionsAsync(subject.SubjectId);\n",[184,602,603],{"class":186,"line":371},[184,604,605],{},"    }\n",[184,607,608],{"class":186,"line":377},[184,609,610],{},"}\n",[233,612,614,615,618],{"id":613},"_2-обёртка-juliaclaimsprincipal-в-обработчиках-аутентификации","2. Обёртка ",[104,616,617],{},"JuliaClaimsPrincipal"," в обработчиках аутентификации",[95,620,621,622,625,626,628],{},"Оберните ",[104,623,624],{},"ClaimsPrincipal"," в ",[104,627,617],{}," один раз на этапе аутентификации, чтобы фильтры и обработчики не перечитывали клеймы повторно:",[175,630,632],{"className":259,"code":631,"language":261,"meta":180,"style":180},"using Cyberzone.Julia.Authorization;\nusing Cyberzone.Julia.Authorization.Models;\n\n\u002F\u002F В JwtBearerEvents:\nOnTokenValidated = context =>\n{\n    if (JuliaClaimsPrincipal.TryWrap(context.Principal!, out var wrapped))\n        context.Principal = wrapped;\n\n    return Task.CompletedTask;\n};\n\n\u002F\u002F В собственном обработчике API-ключей:\nif (!ApiKey.TryParse(presentedKey, out var reference))\n    return AuthenticateResult.Fail(\"Invalid API key\");\n\nvar subject = await IntrospectAsync(presentedKey, remoteIp);\nreturn AuthenticateResult.Success(new AuthenticationTicket(\n    JuliaClaimsPrincipal.Issue(subject, Scheme.Name), Scheme.Name));\n",[104,633,634,639,643,647,652,657,661,666,671,675,680,684,688,693,698,703,707,712,717],{"__ignoreMap":180},[184,635,636],{"class":186,"line":187},[184,637,638],{},"using Cyberzone.Julia.Authorization;\n",[184,640,641],{"class":186,"line":204},[184,642,534],{},[184,644,645],{"class":186,"line":276},[184,646,286],{"emptyLinePlaceholder":285},[184,648,649],{"class":186,"line":282},[184,650,651],{},"\u002F\u002F В JwtBearerEvents:\n",[184,653,654],{"class":186,"line":289},[184,655,656],{},"OnTokenValidated = context =>\n",[184,658,659],{"class":186,"line":295},[184,660,338],{},[184,662,663],{"class":186,"line":301},[184,664,665],{},"    if (JuliaClaimsPrincipal.TryWrap(context.Principal!, out var wrapped))\n",[184,667,668],{"class":186,"line":306},[184,669,670],{},"        context.Principal = wrapped;\n",[184,672,673],{"class":186,"line":312},[184,674,286],{"emptyLinePlaceholder":285},[184,676,677],{"class":186,"line":318},[184,678,679],{},"    return Task.CompletedTask;\n",[184,681,682],{"class":186,"line":323},[184,683,380],{},[184,685,686],{"class":186,"line":329},[184,687,286],{"emptyLinePlaceholder":285},[184,689,690],{"class":186,"line":335},[184,691,692],{},"\u002F\u002F В собственном обработчике API-ключей:\n",[184,694,695],{"class":186,"line":341},[184,696,697],{},"if (!ApiKey.TryParse(presentedKey, out var reference))\n",[184,699,700],{"class":186,"line":347},[184,701,702],{},"    return AuthenticateResult.Fail(\"Invalid API key\");\n",[184,704,705],{"class":186,"line":353},[184,706,286],{"emptyLinePlaceholder":285},[184,708,709],{"class":186,"line":359},[184,710,711],{},"var subject = await IntrospectAsync(presentedKey, remoteIp);\n",[184,713,714],{"class":186,"line":365},[184,715,716],{},"return AuthenticateResult.Success(new AuthenticationTicket(\n",[184,718,719],{"class":186,"line":371},[184,720,721],{},"    JuliaClaimsPrincipal.Issue(subject, Scheme.Name), Scheme.Name));\n",[382,723,725],{"color":724,"icon":52},"primary",[95,726,727,728,731,732,735,736,742,743,746],{},"Для кеша интроспекции используйте ",[104,729,730],{},"ApiKey.ComputeHash(presentedKey)"," (и IP-адрес клиента при ",[104,733,734],{},"ip_unrestricted == false","), но ",[99,737,738,739],{},"никогда не кешируйте по ",[104,740,741],{},"reference.TokenId",". Для отображения и логов используйте ",[104,744,745],{},"ApiKey.Hint(presentedKey)",".",[233,748,750],{"id":749},"_3-защита-эндпоинтов-minimal-api-и-grpc","3. Защита эндпоинтов (Minimal API и gRPC)",[175,752,754],{"className":259,"code":753,"language":261,"meta":180,"style":180},"\u002F\u002F Minimal API:\napp.MapGet(\"\u002Fapi\u002Fv1\u002Fitems\", GetItems)\n   .RequirePermission(\"myservice.items:read\"); \u002F\u002F требуются все перечисленные\n\napp.MapGet(\"\u002Fapi\u002Fv1\u002Fstats\", GetStats)\n   .RequireAnyPermission(\"myservice.stats:read\", \"myservice.admin\"); \u002F\u002F достаточно любого\n",[104,755,756,761,766,771,775,780],{"__ignoreMap":180},[184,757,758],{"class":186,"line":187},[184,759,760],{},"\u002F\u002F Minimal API:\n",[184,762,763],{"class":186,"line":204},[184,764,765],{},"app.MapGet(\"\u002Fapi\u002Fv1\u002Fitems\", GetItems)\n",[184,767,768],{"class":186,"line":276},[184,769,770],{},"   .RequirePermission(\"myservice.items:read\"); \u002F\u002F требуются все перечисленные\n",[184,772,773],{"class":186,"line":282},[184,774,286],{"emptyLinePlaceholder":285},[184,776,777],{"class":186,"line":289},[184,778,779],{},"app.MapGet(\"\u002Fapi\u002Fv1\u002Fstats\", GetStats)\n",[184,781,782],{"class":186,"line":295},[184,783,784],{},"   .RequireAnyPermission(\"myservice.stats:read\", \"myservice.admin\"); \u002F\u002F достаточно любого\n",[175,786,788],{"className":259,"code":787,"language":261,"meta":180,"style":180},"\u002F\u002F gRPC-сервис (требует подключённый PermissionInterceptor):\n[RequirePermission(\"myservice.items:read\")]\npublic override Task\u003CItemResponse> GetItem(ItemRequest request, ServerCallContext context)\n",[104,789,790,795,800],{"__ignoreMap":180},[184,791,792],{"class":186,"line":187},[184,793,794],{},"\u002F\u002F gRPC-сервис (требует подключённый PermissionInterceptor):\n",[184,796,797],{"class":186,"line":204},[184,798,799],{},"[RequirePermission(\"myservice.items:read\")]\n",[184,801,802],{"class":186,"line":276},[184,803,804],{},"public override Task\u003CItemResponse> GetItem(ItemRequest request, ServerCallContext context)\n",[95,806,807,808,811,812,815,816,811,819,822,823,826,827,811,830,833],{},"При отказе возвращается ",[104,809,810],{},"401"," \u002F ",[104,813,814],{},"403"," в HTTP и ",[104,817,818],{},"Unauthenticated",[104,820,821],{},"PermissionDenied"," в gRPC. Если настроить ",[104,824,825],{},"PermissionFilterOptions.UseExceptions",", фильтры выбрасывают ",[104,828,829],{},"UnauthorizedAccessException",[104,831,832],{},"ForbiddenException"," для вашего exception middleware.",[233,835,837],{"id":836},"_4-проверка-доступа-к-ресурсу-конкретного-пользователя","4. Проверка доступа к ресурсу конкретного пользователя",[95,839,840,841,844,845,848,849,852],{},"Когда в маршруте есть ",[104,842,843],{},"{uuid}"," целевого пользователя, используйте ",[104,846,847],{},"RequirePermissionInAnyScope"," на маршруте и ",[104,850,851],{},"AuthorizationHelper.CanAccessUserResourceAsync"," в обработчике:",[175,854,856],{"className":259,"code":855,"language":261,"meta":180,"style":180},"app.MapGet(\"\u002Fapi\u002Fv1\u002Fusers\u002F{uuid:guid}\u002Forders\", async (\n        Guid uuid, HttpContext http, IPermissionProvider permissions) =>\n    {\n        var subject = http.User.ToJuliaPrincipal();\n\n        \u002F\u002F Пропускает владельца (subject.SubjectId == uuid) либо носителя глобального\u002Fделегированного права\n        if (!await AuthorizationHelper.CanAccessUserResourceAsync(\n                permissions, subject, uuid, \"myservice.orders:read\",\n                new HttpPermissionContext(http)))\n            return Results.Forbid();\n\n        return Results.Ok(await LoadOrdersAsync(uuid));\n    })\n    .RequirePermissionInAnyScope(\"myservice.orders:read\");\n",[104,857,858,863,868,872,877,881,886,891,896,901,906,910,915,920],{"__ignoreMap":180},[184,859,860],{"class":186,"line":187},[184,861,862],{},"app.MapGet(\"\u002Fapi\u002Fv1\u002Fusers\u002F{uuid:guid}\u002Forders\", async (\n",[184,864,865],{"class":186,"line":204},[184,866,867],{},"        Guid uuid, HttpContext http, IPermissionProvider permissions) =>\n",[184,869,870],{"class":186,"line":276},[184,871,571],{},[184,873,874],{"class":186,"line":282},[184,875,876],{},"        var subject = http.User.ToJuliaPrincipal();\n",[184,878,879],{"class":186,"line":289},[184,880,286],{"emptyLinePlaceholder":285},[184,882,883],{"class":186,"line":295},[184,884,885],{},"        \u002F\u002F Пропускает владельца (subject.SubjectId == uuid) либо носителя глобального\u002Fделегированного права\n",[184,887,888],{"class":186,"line":301},[184,889,890],{},"        if (!await AuthorizationHelper.CanAccessUserResourceAsync(\n",[184,892,893],{"class":186,"line":306},[184,894,895],{},"                permissions, subject, uuid, \"myservice.orders:read\",\n",[184,897,898],{"class":186,"line":312},[184,899,900],{},"                new HttpPermissionContext(http)))\n",[184,902,903],{"class":186,"line":318},[184,904,905],{},"            return Results.Forbid();\n",[184,907,908],{"class":186,"line":323},[184,909,286],{"emptyLinePlaceholder":285},[184,911,912],{"class":186,"line":329},[184,913,914],{},"        return Results.Ok(await LoadOrdersAsync(uuid));\n",[184,916,917],{"class":186,"line":335},[184,918,919],{},"    })\n",[184,921,922],{"class":186,"line":341},[184,923,924],{},"    .RequirePermissionInAnyScope(\"myservice.orders:read\");\n",[95,926,927,928,931,932,935,936,939,940,943],{},"Если эндпоинт доступен публично и меняет объём ответа в зависимости от вызывающего (как профили в Julia), используйте ",[104,929,930],{},"httpContext.ResolveAccessLevelAsync(...)"," — он возвращает ",[104,933,934],{},"ResourceAccessLevel.Public",", ",[104,937,938],{},"Owner"," или ",[104,941,942],{},"Privileged"," и корректно работает с анонимными запросами.",[945,946,947],"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 .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":180,"searchDepth":204,"depth":204,"links":949},[950,951,956],{"id":172,"depth":204,"text":173},{"id":219,"depth":204,"text":134,"children":952},[953,955],{"id":235,"depth":276,"text":954},"Валидация JWT с помощью EdDsaSecurityKey",{"id":406,"depth":276,"text":407},{"id":489,"depth":204,"text":155,"children":957},[958,959,961,962],{"id":501,"depth":276,"text":502},{"id":613,"depth":276,"text":960},"2. Обёртка JuliaClaimsPrincipal в обработчиках аутентификации",{"id":749,"depth":276,"text":750},{"id":836,"depth":276,"text":837},"Интеграция сервисов на .NET с помощью публичных NuGet-пакетов Cyberzone.Julia.Contracts и Cyberzone.Julia.Authorization.","md",null,{},{"title":70,"icon":73},{"title":90,"description":963},"DfxPLDsM99O6iP4Xl6r4CcgsTf51OjfIwfUDvWTbs6U",[971,973],{"title":59,"path":60,"stem":61,"description":972,"icon":62,"children":-1},"Иерархия отделов, slug, системные и кастомные роли, старшинство, правила видимости и справочник кодов ошибок.",{"title":75,"path":76,"stem":77,"description":974,"icon":73,"children":-1},"Интеграция сервисов на Go (1.25+) с помощью официального модуля git.cyberzone.dev\u002Fcyberzone\u002Fjulia-go — проверка EdDSA JWT, права, HTTP\u002FgRPC middleware и API-ключи.",1795320979027]