"use strict"; const {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0]; const {useMDXComponents: _provideComponents} = arguments[0]; const headings = [{ "data": { "id": "введение", "hProperties": { "id": "введение" } }, "depth": 2, "value": "Введение" }, { "data": { "id": "предварительные-требования", "hProperties": { "id": "предварительные-требования" } }, "depth": 2, "value": "Предварительные требования" }, { "data": { "id": "создание-приложения-logto", "hProperties": { "id": "создание-приложения-logto" } }, "depth": 2, "value": "Создание приложения Logto" }, { "data": { "id": "интеграция-с-sdk-logto", "hProperties": { "id": "интеграция-с-sdk-logto" } }, "depth": 2, "value": "Интеграция с SDK Logto" }, { "data": { "id": "установка", "hProperties": { "id": "установка" } }, "depth": 3, "value": "Установка" }, { "data": { "id": "добавление-промежуточного-программного-обеспечения-аутентификации-logto", "hProperties": { "id": "добавление-промежуточного-программного-обеспечения-аутентификации-logto" } }, "depth": 3, "value": "Добавление промежуточного программного обеспечения аутентификации Logto" }, { "data": { "id": "вход-в-систему", "hProperties": { "id": "вход-в-систему" } }, "depth": 3, "value": "Вход в систему" }, { "data": { "id": "выход-из-системы", "hProperties": { "id": "выход-из-системы" } }, "depth": 3, "value": "Выход из системы" }, { "data": { "id": "реализация-кнопок-входа--выхода-razor-pages", "hProperties": { "id": "реализация-кнопок-входа--выхода-razor-pages" } }, "depth": 3, "value": "Реализация кнопок входа / выхода (Razor Pages)" }, { "data": { "id": "контрольная-точка-запустите-веб-приложение", "hProperties": { "id": "контрольная-точка-запустите-веб-приложение" } }, "depth": 2, "value": "Контрольная точка: Запустите веб-приложение" }, { "data": { "id": "дальнейшее-чтение", "hProperties": { "id": "дальнейшее-чтение" } }, "depth": 2, "value": "Дальнейшее чтение" }]; const readingTime = { "minutes": 1, "words": 299, "text": "less than a minute read" }; const frontmatter = undefined; function _createMdxContent(props) { const _components = { a: "a", code: "code", h2: "h2", h3: "h3", li: "li", ol: "ol", p: "p", pre: "pre", span: "span", strong: "strong", ul: "ul", ..._provideComponents(), ...props.components }, {LogtoCloudButton, Note} = _components; if (!LogtoCloudButton) _missingMdxReference("LogtoCloudButton", true); if (!Note) _missingMdxReference("Note", true); return _jsxs(_Fragment, { children: [_jsxs(_components.h2, { id: "введение", children: [_jsx(_components.a, { "aria-hidden": "true", tabIndex: "-1", href: "#введение", children: _jsx(_components.span, { children: "#" }) }), "Введение"] }), "\n", _jsxs(_components.ul, { children: ["\n", _jsxs(_components.li, { children: [_jsx(_components.a, { href: "https://logto.io/", children: "Logto" }), " - это современная альтернатива Auth0 для создания инфраструктуры идентификации клиентов с минимальными усилиями. Он поддерживает различные методы входа в систему, включая имя пользователя, электронную почту, номер телефона и популярные социальные входы, такие как Google и GitHub."] }), "\n", _jsxs(_components.li, { children: [_jsx(_components.a, { href: "https://docs.microsoft.com/en-us/aspnet/core/", children: "ASP.NET Core" }), " - это кросс-платформенный, высокопроизводительный, открытый фреймворк для создания современных, облачных, подключенных к Интернету приложений."] }), "\n"] }), "\n", _jsx(_components.p, { children: "В этом руководстве мы покажем вам, как создать поток аутентификации пользователя с ASP.NET Core, интегрировав SDK от Logto. В руководстве используется C# в качестве языка программирования." }), "\n", _jsxs(_components.h2, { id: "предварительные-требования", children: [_jsx(_components.a, { "aria-hidden": "true", tabIndex: "-1", href: "#предварительные-требования", children: _jsx(_components.span, { children: "#" }) }), "Предварительные требования"] }), "\n", _jsx(_components.p, { children: "Перед началом убедитесь, что у вас есть следующее:" }), "\n", _jsxs(_components.ul, { children: ["\n", _jsxs(_components.li, { children: ["Учетная запись Logto. Если у вас ее нет, вы можете ", _jsx(_components.a, { href: "https://cloud.logto.io/", children: "зарегистрироваться бесплатно" }), "."] }), "\n", _jsxs(_components.li, { children: ["Среда разработки .NET и проект ASP.NET Core. Если у вас их нет, вы можете ", _jsx(_components.a, { href: "https://dotnet.microsoft.com/download", children: "установить .NET" }), " и следовать ", _jsx(_components.a, { href: "https://dotnet.microsoft.com/en-us/apps/aspnet", children: "руководствам по ASP.NET" }), " для настройки вашего проекта."] }), "\n"] }), "\n", _jsxs(_components.h2, { id: "создание-приложения-logto", children: [_jsx(_components.a, { "aria-hidden": "true", tabIndex: "-1", href: "#создание-приложения-logto", children: _jsx(_components.span, { children: "#" }) }), "Создание приложения Logto"] }), "\n", _jsx(_components.p, { children: "Для начала создайте приложение Logto типа \"Традиционный веб\". Следуйте этим шагам для создания приложения Logto:" }), "\n", _jsxs(_components.ol, { children: ["\n", _jsxs(_components.li, { children: ["Войдите в ", _jsx(_components.a, { href: "https://cloud.logto.io/", children: "консоль Logto" }), "."] }), "\n", _jsxs(_components.li, { children: ["В левой панели навигации нажмите на ", _jsx(_components.strong, { children: "Приложения" }), "."] }), "\n", _jsxs(_components.li, { children: ["Нажмите на ", _jsx(_components.strong, { children: "Создать приложение" }), "."] }), "\n", _jsx(_components.li, { children: "На открывшейся странице найдите раздел \"Традиционное веб-приложение\" и найдите карту \"ASP.NET Core\"." }), "\n", _jsxs(_components.li, { children: ["Нажмите на ", _jsx(_components.strong, { children: "Начать создание" }), " и введите имя вашего приложения."] }), "\n", _jsxs(_components.li, { children: ["Нажмите на ", _jsx(_components.strong, { children: "Создать" }), "."] }), "\n"] }), "\n", _jsx(_components.p, { children: "Затем вы должны увидеть интерактивное руководство, которое направляет вас по процессу интеграции SDK Logto с вашим приложением ASP.NET Core. Следующее содержание может быть ссылкой для будущего использования." }), "\n", _jsx(LogtoCloudButton, { children: "Попробуйте интерактивное руководство Logto Cloud" }), "\n", _jsxs(_components.h2, { id: "интеграция-с-sdk-logto", children: [_jsx(_components.a, { "aria-hidden": "true", tabIndex: "-1", href: "#интеграция-с-sdk-logto", children: _jsx(_components.span, { children: "#" }) }), "Интеграция с SDK Logto"] }), "\n", _jsxs(_components.h3, { id: "установка", children: [_jsx(_components.a, { "aria-hidden": "true", tabIndex: "-1", href: "#установка", children: _jsx(_components.span, { children: "#" }) }), "Установка"] }), "\n", _jsx(_components.pre, { children: _jsx(_components.code, { className: "language-bash", children: "dotnet add package Logto.AspNetCore.Authentication\n" }) }), "\n", _jsxs(_components.p, { children: ["Обратите внимание, что минимальная поддерживаемая версия ASP.NET Core - ", _jsx(_components.code, { children: "6.0" }), "."] }), "\n", _jsxs(_components.h3, { id: "добавление-промежуточного-программного-обеспечения-аутентификации-logto", children: [_jsx(_components.a, { "aria-hidden": "true", tabIndex: "-1", href: "#добавление-промежуточного-программного-обеспечения-аутентификации-logto", children: _jsx(_components.span, { children: "#" }) }), "Добавление промежуточного программного обеспечения аутентификации Logto"] }), "\n", _jsxs(_components.p, { children: ["Откройте ", _jsx(_components.code, { children: "Startup.cs" }), " (или ", _jsx(_components.code, { children: "Program.cs" }), ") и добавьте следующий код для регистрации промежуточного программного обеспечения аутентификации Logto:"] }), "\n", _jsx(_components.pre, { children: _jsx(_components.code, { className: "language-csharp", children: "using Logto.AspNetCore.Authentication;\n\nvar builder = WebApplication.CreateBuilder(args);\n\nbuilder.Services.AddLogtoAuthentication(options =>\n{\n options.Endpoint = builder.Configuration[\"Logto:Endpoint\"]!;\n options.AppId = builder.Configuration[\"Logto:AppId\"]!;\n options.AppSecret = builder.Configuration[\"Logto:AppSecret\"];\n});\n\napp.UseAuthentication();\n" }) }), "\n", _jsxs(_components.p, { children: ["Метод ", _jsx(_components.code, { children: "AddLogtoAuthentication" }), " будет делать следующее:"] }), "\n", _jsxs(_components.ul, { children: ["\n", _jsxs(_components.li, { children: ["Устанавливает схему аутентификации по умолчанию на ", _jsx(_components.code, { children: "LogtoDefaults.CookieScheme" }), "."] }), "\n", _jsxs(_components.li, { children: ["Устанавливает схему вызова аутентификации по умолчанию на ", _jsx(_components.code, { children: "LogtoDefaults.AuthenticationScheme" }), "."] }), "\n", _jsxs(_components.li, { children: ["Устанавливает схему выхода по умолчанию на ", _jsx(_components.code, { children: "LogtoDefaults.AuthenticationScheme" }), "."] }), "\n", _jsx(_components.li, { children: "Добавляет обработчики аутентификации cookie и OpenID Connect к схеме аутентификации." }), "\n"] }), "\n", _jsxs(_components.h3, { id: "вход-в-систему", children: [_jsx(_components.a, { "aria-hidden": "true", tabIndex: "-1", href: "#вход-в-систему", children: _jsx(_components.span, { children: "#" }) }), "Вход в систему"] }), "\n", _jsxs(_components.p, { children: ["Добавьте следующий URI в список ", _jsx(_components.code, { children: "Redirect URIs" }), " на странице сведений о приложении Logto:"] }), "\n", _jsx(_components.pre, { children: _jsx(_components.code, { children: "http:///Callback\n" }) }), "\n", _jsxs(_components.p, { children: ["Чтобы войти с Logto, вы можете использовать метод ", _jsx(_components.code, { children: "ChallengeAsync" }), ":"] }), "\n", _jsx(_components.pre, { children: _jsx(_components.code, { className: "language-csharp", children: "await HttpContext.ChallengeAsync(new AuthenticationProperties\n{\n RedirectUri = \"/\"\n});\n" }) }), "\n", _jsxs(_components.p, { children: ["Метод ", _jsx(_components.code, { children: "ChallengeAsync" }), " перенаправит пользователя на страницу входа в систему Logto."] }), "\n", _jsxs(_components.p, { children: ["Свойство ", _jsx(_components.code, { children: "RedirectUri" }), " используется для перенаправления пользователя обратно в ваше веб-приложение после аутентификации. Обратите внимание, что это отличается от URI-адреса перенаправления, который вы настроили на странице деталей приложения Logto:"] }), "\n", _jsxs(_components.ol, { children: ["\n", _jsx(_components.li, { children: "URI-адрес перенаправления на странице деталей приложения Logto - это URI-адрес, на который Logto перенаправит пользователя после входа в систему." }), "\n", _jsxs(_components.li, { children: ["Свойство ", _jsx(_components.code, { children: "RedirectUri" }), " - это URI, на который будет выполнено перенаправление после выполнения необходимых действий в промежуточном программном обеспечении аутентификации Logto."] }), "\n"] }), "\n", _jsxs(_components.p, { children: ["Порядок действий - 1 -> 2. Для ясности давайте назовем URI перенаправления на странице деталей приложения Logto ", _jsx(_components.strong, { children: "URI перенаправления Logto" }), " и свойство ", _jsx(_components.code, { children: "RedirectUri" }), " - ", _jsx(_components.strong, { children: "URI перенаправления приложения" }), "."] }), "\n", _jsxs(_components.p, { children: [_jsx(_components.strong, { children: "URI перенаправления Logto" }), " имеет значение по умолчанию ", _jsx(_components.code, { children: "/Callback" }), ", которое вы можете оставить, если нет особых требований. Если вы хотите его изменить, вы можете установить свойство ", _jsx(_components.code, { children: "CallbackPath" }), " для ", _jsx(_components.code, { children: "LogtoOptions" }), ":"] }), "\n", _jsx(_components.pre, { children: _jsx(_components.code, { className: "language-csharp", children: "builder.Services.AddLogtoAuthentication(options =>\n{\n options.CallbackPath = \"/SomeOtherCallbackPath\";\n});\n" }) }), "\n", _jsx(_components.p, { children: "Не забудьте обновить значение на странице сведений о приложении Logto соответствующим образом." }), "\n", _jsx(Note, { children: _jsxs(_components.p, { children: ["Нет необходимости устанавливать ", _jsx(_components.strong, { children: "URI перенаправления приложения" }), " на странице сведений о приложении Logto."] }) }), "\n", _jsxs(_components.h3, { id: "выход-из-системы", children: [_jsx(_components.a, { "aria-hidden": "true", tabIndex: "-1", href: "#выход-из-системы", children: _jsx(_components.span, { children: "#" }) }), "Выход из системы"] }), "\n", _jsxs(_components.p, { children: ["Добавьте следующий URI в список ", _jsx(_components.code, { children: "Post sign-out redirect URIs" }), " на странице сведений о приложении Logto:"] }), "\n", _jsx(_components.pre, { children: _jsx(_components.code, { children: "http:///SignedOutCallback\n" }) }), "\n", _jsxs(_components.p, { children: ["Чтобы выйти с Logto, вы можете использовать метод ", _jsx(_components.code, { children: "SignOutAsync" }), ":"] }), "\n", _jsx(_components.pre, { children: _jsx(_components.code, { className: "language-csharp", children: "await HttpContext.SignOutAsync(new AuthenticationProperties\n{\n RedirectUri = \"/\"\n});\n" }) }), "\n", _jsxs(_components.p, { children: ["Метод ", _jsx(_components.code, { children: "SignOutAsync" }), " очистит аутентификационный cookie и перенаправит пользователя на страницу выхода из Logto."] }), "\n", _jsxs(_components.p, { children: ["Свойство ", _jsx(_components.code, { children: "RedirectUri" }), " используется для перенаправления пользователя обратно в ваше веб-приложение после выхода из системы. Обратите внимание, что это отличается от URI перенаправления после выхода, который вы настроили на странице деталей приложения Logto:"] }), "\n", _jsxs(_components.ol, { children: ["\n", _jsx(_components.li, { children: "URI перенаправления после выхода на странице деталей приложения Logto - это URI-адрес, на который Logto перенаправит пользователя после выхода из системы." }), "\n", _jsxs(_components.li, { children: ["Свойство ", _jsx(_components.code, { children: "RedirectUri" }), " - это URI, на который будет выполнено перенаправление после выполнения необходимых действий в промежуточном программном обеспечении аутентификации Logto."] }), "\n"] }), "\n", _jsxs(_components.p, { children: ["Порядок действий - 1 -> 2. Для ясности давайте назовемURI перенаправления после выхода на странице деталей приложения Logto ** URI перенаправления после выхода из Logto **, а свойство ", _jsx(_components.code, { children: "RedirectUri" }), " - ** URI перенаправления приложения после выхода из системы **."] }), "\n", _jsxs(_components.p, { children: ["** URI перенаправления после выхода из Logto ** имеет значение по умолчанию ", _jsx(_components.code, { children: "/SignedOutCallback" }), ", который вы можете оставить, если нет особых требований. Если вы хотите его изменить, вы можете установить свойство ", _jsx(_components.code, { children: "SignedOutCallbackPath" }), " для ", _jsx(_components.code, { children: "LogtoOptions" }), ":"] }), "\n", _jsx(_components.pre, { children: _jsx(_components.code, { className: "language-csharp", children: "builder.Services.AddLogtoAuthentication(options =>\n{\n options.SignedOutCallbackPath = \"/SomeOtherSignedOutCallbackPath\";\n});\n" }) }), "\n", _jsx(_components.p, { children: "Не забудьте обновить значение на странице сведений о приложении Logto соответствующим образом." }), "\n", _jsx(Note, { children: _jsx(_components.p, { children: "Нет необходимости устанавливать ** URI перенаправления приложения после выхода из системы ** на странице сведений о приложении Logto." }) }), "\n", _jsxs(_components.h3, { id: "реализация-кнопок-входа--выхода-razor-pages", children: [_jsx(_components.a, { "aria-hidden": "true", tabIndex: "-1", href: "#реализация-кнопок-входа--выхода-razor-pages", children: _jsx(_components.span, { children: "#" }) }), "Реализация кнопок входа / выхода (Razor Pages)"] }), "\n", _jsxs(_components.p, { children: ["Во-первых, добавьте методы обработчика в ваш ", _jsx(_components.code, { children: "PageModel" }), ", например:"] }), "\n", _jsx(_components.pre, { children: _jsx(_components.code, { className: "language-csharp", children: "public class IndexModel : PageModel\n{\n public async Task OnPostSignInAsync()\n {\n await HttpContext.ChallengeAsync(new AuthenticationProperties\n {\n RedirectUri = \"/\"\n });\n }\n\n public async Task OnPostSignOutAsync()\n {\n await HttpContext.SignOutAsync(new AuthenticationProperties\n {\n RedirectUri = \"/\"\n });\n }\n}\n" }) }), "\n", _jsx(_components.p, { children: "Затем добавьте кнопки на вашей странице Razor (html):" }), "\n", _jsx("pre", { class: "language-html", children: _jsx("code", { children: `

Аутентифицирован: @User.Identity?.IsAuthenticated

` }) }), "\n", _jsx(_components.p, { children: "Он покажет кнопку \"Войти\", если пользователь не аутентифицирован, и покажет кнопку \"Выйти\", если пользователь аутентифицирован." }), "\n", _jsxs(_components.h2, { id: "контрольная-точка-запустите-веб-приложение", children: [_jsx(_components.a, { "aria-hidden": "true", tabIndex: "-1", href: "#контрольная-точка-запустите-веб-приложение", children: _jsx(_components.span, { children: "#" }) }), "Контрольная точка: Запустите веб-приложение"] }), "\n", _jsx(_components.p, { children: "Теперь вы можете запустить веб-приложение и попробовать войти / выйти с Logto:" }), "\n", _jsxs(_components.ol, { children: ["\n", _jsx(_components.li, { children: "Откройте веб-приложение в вашем браузере, вы должны увидеть \"Аутентифицирован: False\" и кнопку \"Войти\"." }), "\n", _jsx(_components.li, { children: "Нажмите кнопку \"Войти\", и вы должны быть перенаправлены на страницу входа в Logto." }), "\n", _jsx(_components.li, { children: "После того как вы вошли в систему, вы должны быть перенаправлены обратно в веб-приложение, и вы должны увидеть \"Аутентифицирован: True\" и кнопку \"Выйти\"." }), "\n", _jsx(_components.li, { children: "Нажмите кнопку \"Выйти\", и вы должны быть перенаправлены на страницу выхода из Logto, а затем перенаправлены обратно в веб-приложение." }), "\n"] }), "\n", _jsxs(_components.p, { children: ["Если вы столкнулись с какими-либо проблемами во время интеграции, пожалуйста, не стесняйтесь связаться с нами по электронной почте по адресу ", _jsx(_components.a, { href: "mailto:contact@logto.io", children: "contact@logto.io" }), " или ", _jsx(_components.a, { href: "https://discord.gg/UEPaF3j5e6", children: "присоединиться к нашему серверу Discord" }), "!"] }), "\n", _jsxs(_components.h2, { id: "дальнейшее-чтение", children: [_jsx(_components.a, { "aria-hidden": "true", tabIndex: "-1", href: "#дальнейшее-чтение", children: _jsx(_components.span, { children: "#" }) }), "Дальнейшее чтение"] }), "\n", _jsxs(_components.ul, { children: ["\n", _jsx(_components.li, { children: _jsx(_components.a, { href: "https://docs.logto.io/docs/recipes/customize-sie/", children: "Настройка входа в систему" }) }), "\n", _jsx(_components.li, { children: _jsx(_components.a, { href: "https://docs.logto.io/docs/recipes/configure-connectors/", children: "Настройка коннекторов" }) }), "\n", _jsx(_components.li, { children: _jsx(_components.a, { href: "https://docs.logto.io/docs/recipes/protect-your-api/", children: "Защитите свой API" }) }), "\n"] }), "\n", _jsx(LogtoCloudButton, { children: "Попробуйте Logto Сегодня" })] }); } function MDXContent(props = {}) { const {wrapper: MDXLayout} = { ..._provideComponents(), ...props.components }; return MDXLayout ? _jsx(MDXLayout, { ...props, children: _jsx(_createMdxContent, { ...props }) }) : _createMdxContent(props); } return { headings, readingTime, frontmatter, default: MDXContent }; function _missingMdxReference(id, component) { throw new Error("Expected " + (component ? "component" : "object") + " `" + id + "` to be defined: you likely forgot to import, pass, or provide it."); }