"use strict"; const {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0]; const {useMDXComponents: _provideComponents} = arguments[0]; const headings = [{ "data": { "id": "oturum-ile-express-kurulumunu-yapma", "hProperties": { "id": "oturum-ile-express-kurulumunu-yapma" } }, "depth": 2, "value": "Oturum ile Express kurulumunu yapma" }, { "data": { "id": "ana-dosyayı-hazırlama", "hProperties": { "id": "ana-dosyayı-hazırlama" } }, "depth": 3, "value": "Ana dosyayı hazırlama" }, { "data": { "id": "logto-uygulaması-oluşturma", "hProperties": { "id": "logto-uygulaması-oluşturma" } }, "depth": 2, "value": "Logto uygulaması oluşturma" }, { "data": { "id": "urileri-ayarlama", "hProperties": { "id": "urileri-ayarlama" } }, "depth": 3, "value": "URI'leri Ayarlama" }, { "data": { "id": "uygulama-ayarlarıyla-passportjs-yapılandırma", "hProperties": { "id": "uygulama-ayarlarıyla-passportjs-yapılandırma" } }, "depth": 2, "value": "Uygulama ayarlarıyla Passport.js yapılandırma" }, { "data": { "id": "bağımlılıkları-yükleme", "hProperties": { "id": "bağımlılıkları-yükleme" } }, "depth": 3, "value": "Bağımlılıkları yükleme" }, { "data": { "id": "yapılandırma-dosyasını-hazırlama", "hProperties": { "id": "yapılandırma-dosyasını-hazırlama" } }, "depth": 3, "value": "Yapılandırma dosyasını hazırlama" }, { "data": { "id": "passportjsi-oidc-stratejisi-ile-başlatma", "hProperties": { "id": "passportjsi-oidc-stratejisi-ile-başlatma" } }, "depth": 3, "value": "Passport.js’i OIDC stratejisi ile başlatma" }, { "data": { "id": "kimlik-doğrulama-rotalarını-oluşturma", "hProperties": { "id": "kimlik-doğrulama-rotalarını-oluşturma" } }, "depth": 2, "value": "Kimlik doğrulama rotalarını oluşturma" }, { "data": { "id": "giriş-sign-in", "hProperties": { "id": "giriş-sign-in" } }, "depth": 3, "value": "Giriş: /sign-in" }, { "data": { "id": "giriş-geri-aramasını-işleme-callback", "hProperties": { "id": "giriş-geri-aramasını-işleme-callback" } }, "depth": 3, "value": "Giriş geri aramasını işleme: /callback" }, { "data": { "id": "çıkış-sign-out", "hProperties": { "id": "çıkış-sign-out" } }, "depth": 3, "value": "Çıkış: /sign-out" }, { "data": { "id": "kimlik-doğrulama-durumunu-alma-ve-rotaları-koruma", "hProperties": { "id": "kimlik-doğrulama-durumunu-alma-ve-rotaları-koruma" } }, "depth": 2, "value": "Kimlik doğrulama durumunu alma ve rotaları koruma" }, { "data": { "id": "sonuç", "hProperties": { "id": "sonuç" } }, "depth": 2, "value": "Sonuç" }]; const readingTime = { "minutes": 2, "words": 696, "text": "2 min read" }; const frontmatter = undefined; function _createMdxContent(props) { const _components = { a: "a", code: "code", h2: "h2", h3: "h3", img: "img", li: "li", ol: "ol", p: "p", pre: "pre", span: "span", strong: "strong", table: "table", tbody: "tbody", td: "td", th: "th", thead: "thead", tr: "tr", ..._provideComponents(), ...props.components }, {LogtoCloudButton} = _components; if (!LogtoCloudButton) _missingMdxReference("LogtoCloudButton", true); return _jsxs(_Fragment, { children: [_jsxs(_components.p, { children: [_jsx(_components.a, { href: "https://www.passportjs.org/", children: "Passport.js" }), " , Express tabanlı herhangi bir web uygulamasına kesintisiz bir şekilde eklenebilen, Node.js için bir kimlik doğrulama ara yazılımıdır. Bu kapsamlı rehber, Logto'yu Passport.js ile entegre etmenin basit ama etkili bir yolunu sunan ", _jsx(_components.code, { children: "passport-openidconnect" }), " eklentisini kullanmaya odaklanacaktır. Bu eğitim boyunca uygulamamızı oluşturmak için Express.js kullanacağız. Tartışacağımız tüm kodlar, halka açık bir ", _jsx(_components.a, { href: "https://github.com/logto-io/js/tree/master/packages/passportjs-sample", children: "GitHub deposunda" }), " mevcuttur."] }), "\n", _jsxs(_components.h2, { id: "oturum-ile-express-kurulumunu-yapma", children: ["Oturum ile Express kurulumunu yapma", _jsx(_components.a, { "aria-hidden": "true", tabIndex: "-1", href: "#oturum-ile-express-kurulumunu-yapma", children: _jsx(_components.span, { children: "#" }) })] }), "\n", _jsxs(_components.p, { children: ["Entegrasyon sürecine dalmadan önce, ", _jsx(_components.a, { href: "https://expressjs.com/", children: "Express.js" }), " ve oturum ara yazılımını yükleyerek temel projeyi kurmamız gerekecek."] }), "\n", _jsxs(_components.p, { children: ["Bir TypeScript proje ortamınızın hazır olduğunu varsayarak (eğer değilse, ", _jsx(_components.a, { href: "https://www.typescriptlang.org/docs/", children: "resmi TypeScript belgelerine" }), " başvurun), gerekli paketleri yükleyerek başlayın:"] }), "\n", _jsx(_components.pre, { children: _jsx(_components.code, { className: "language-bash", children: "npm i cookie-parser express-session\n" }) }), "\n", _jsxs(_components.h3, { id: "ana-dosyayı-hazırlama", children: ["Ana dosyayı hazırlama", _jsx(_components.a, { "aria-hidden": "true", tabIndex: "-1", href: "#ana-dosyayı-hazırlama", children: _jsx(_components.span, { children: "#" }) })] }), "\n", _jsxs(_components.p, { children: [_jsx(_components.code, { children: "src/app.ts" }), " dosyasını aşağıdaki kodla oluşturun:"] }), "\n", _jsx(_components.pre, { children: _jsx(_components.code, { className: "language-tsx", children: "import http from 'node:http';\n\nimport cookieParser from 'cookie-parser';\nimport express from 'express';\nimport session from 'express-session';\n\nconst app = express();\napp.use(cookieParser());\napp.use(\n session({\n secret: 'randome secret',\n cookie: { maxAge: 14 * 24 * 60 * 60 * 1000 },\n resave: false,\n saveUninitialized: false,\n })\n);\n\nconst server = http.createServer(app);\nserver.listen(3000, () => {\n console.log('Sample app listening on http://localhost:3000');\n});\n" }) }), "\n", _jsxs(_components.p, { children: ["Bu script, Express uygulamasını başlatır ve Passport.js'de kimlik doğrulama sonuçlarını depolamak için kritik olan çerez bazlı oturum yönetimi için ", _jsx(_components.code, { children: "cookieParser" }), " ve ", _jsx(_components.code, { children: "session" }), " ara yazılımını yapılandırır. Ardından hizmeti başlatmak için ", _jsx(_components.code, { children: "http" }), " modülünü kullanır."] }), "\n", _jsxs(_components.h2, { id: "logto-uygulaması-oluşturma", children: ["Logto uygulaması oluşturma", _jsx(_components.a, { "aria-hidden": "true", tabIndex: "-1", href: "#logto-uygulaması-oluşturma", children: _jsx(_components.span, { children: "#" }) })] }), "\n", _jsxs(_components.p, { children: ["Devam etmek için bir Logto uygulaması gereklidir. ", _jsx(_components.a, { href: "https://cloud.logto.io/", children: "Logto Konsolu" }), " adresini ziyaret ederek, \"Uygulamalar\"a giderek ve \"Uygulama Oluştur\"a tıklayarak bir tane oluşturun. \"Express\"i seçin, uygulamanıza bir isim verin ve \"Uygulama Oluştur\"a tıklayın."] }), "\n", _jsx(_components.p, { children: _jsx(_components.img, { src: "https://uploads.strapi.logto.io/1/create_application_8641e7c1ab.webp", alt: "Uygulama oluştur" }) }), "\n", _jsx(_components.p, { children: "Oluşturma rehberini tamamladıktan veya okuduktan sonra, sonraki adımlar için yapılandırma bilgileri içeren ayrıntılı bir sayfa bulacaksınız." }), "\n", _jsx(_components.p, { children: _jsx(_components.img, { src: "https://uploads.strapi.logto.io/1/application_detail_55d0c61075.webp", alt: "Uygulama detayı" }) }), "\n", _jsxs(_components.h3, { id: "urileri-ayarlama", children: ["URI'leri Ayarlama", _jsx(_components.a, { "aria-hidden": "true", tabIndex: "-1", href: "#urileri-ayarlama", children: _jsx(_components.span, { children: "#" }) })] }), "\n", _jsx(_components.p, { children: "Uygulama detayları sayfasında iki değeri yapılandırın:" }), "\n", _jsxs(_components.ol, { children: ["\n", _jsxs(_components.li, { children: [_jsx(_components.strong, { children: "Yönlendirme URI'leri" }), ": Projenin geri çağırma rotasıyla uyumlu olması için bunu ", _jsx(_components.code, { children: "http://localhost:3000/callback" }), " olarak ayarlayın."] }), "\n", _jsxs(_components.li, { children: [_jsx(_components.strong, { children: "Oturum Sonrası Yönlendirme URI'leri" }), ": Kullanıcıları oturum sonrası ana sayfaya yönlendirmek için basitlik adına ", _jsx(_components.code, { children: "http://localhost:3000" }), " kullanın."] }), "\n"] }), "\n", _jsx(_components.p, { children: "Bu değerleri daha sonra değiştirebilirsiniz." }), "\n", _jsxs(_components.h2, { id: "uygulama-ayarlarıyla-passportjs-yapılandırma", children: ["Uygulama ayarlarıyla Passport.js yapılandırma", _jsx(_components.a, { "aria-hidden": "true", tabIndex: "-1", href: "#uygulama-ayarlarıyla-passportjs-yapılandırma", children: _jsx(_components.span, { children: "#" }) })] }), "\n", _jsxs(_components.h3, { id: "bağımlılıkları-yükleme", children: ["Bağımlılıkları yükleme", _jsx(_components.a, { "aria-hidden": "true", tabIndex: "-1", href: "#bağımlılıkları-yükleme", children: _jsx(_components.span, { children: "#" }) })] }), "\n", _jsxs(_components.p, { children: [_jsx(_components.code, { children: "passport" }), " ve OIDC strateji eklentisini, ", _jsx(_components.code, { children: "passport-openidconnect" }), "’i yükleyin:"] }), "\n", _jsx(_components.pre, { children: _jsx(_components.code, { className: "language-bash", children: "npm i passport passport-openidconnect\n" }) }), "\n", _jsxs(_components.h3, { id: "yapılandırma-dosyasını-hazırlama", children: ["Yapılandırma dosyasını hazırlama", _jsx(_components.a, { "aria-hidden": "true", tabIndex: "-1", href: "#yapılandırma-dosyasını-hazırlama", children: _jsx(_components.span, { children: "#" }) })] }), "\n", _jsxs(_components.p, { children: ["Yapılandırma yönetimi için ", _jsx(_components.code, { children: "app/config.ts" }), " oluşturun:"] }), "\n", _jsx(_components.pre, { children: _jsx(_components.code, { className: "language-tsx", children: "const appId = process.env.APP_ID;\nconst appSecret = process.env.APP_SECRET;\nconst endpoint = process.env.ENDPOINT;\nconst cookieSecret = process.env.COOKIE_SECRET ?? 'keyboard cat';\n\nexport const config = {\n appId,\n appSecret,\n endpoint,\n cookieSecret,\n};\n" }) }), "\n", _jsx(_components.p, { children: "Çevresel değişkenleri uygun şekilde kurun:" }), "\n", _jsxs(_components.table, { children: [_jsx(_components.thead, { children: _jsxs(_components.tr, { children: [_jsx(_components.th, { children: "Çevresel Değişken" }), _jsx(_components.th, { children: "Açıklama" }), _jsx(_components.th, { children: "Örnek" })] }) }), _jsxs(_components.tbody, { children: [_jsxs(_components.tr, { children: [_jsx(_components.td, { children: _jsx(_components.code, { children: "APP_ID" }) }), _jsx(_components.td, { children: "Logto'dan Uygulama ID'si" }), _jsx(_components.td, { children: _jsx(_components.code, { children: "4ukboxxxxxxxxx" }) })] }), _jsxs(_components.tr, { children: [_jsx(_components.td, { children: _jsx(_components.code, { children: "APP_SECRET" }) }), _jsx(_components.td, { children: "Logto'dan Uygulama Şifresi" }), _jsx(_components.td, { children: _jsx(_components.code, { children: "5aqccxxxxxxx" }) })] }), _jsxs(_components.tr, { children: [_jsx(_components.td, { children: _jsx(_components.code, { children: "ENDPOINT" }) }), _jsx(_components.td, { children: "Logto Endpoint" }), _jsx(_components.td, { children: _jsx(_components.code, { children: "https://g5xxx.logto.app/" }) })] })] })] }), "\n", _jsxs(_components.h3, { id: "passportjsi-oidc-stratejisi-ile-başlatma", children: ["Passport.js’i OIDC stratejisi ile başlatma", _jsx(_components.a, { "aria-hidden": "true", tabIndex: "-1", href: "#passportjsi-oidc-stratejisi-ile-başlatma", children: _jsx(_components.span, { children: "#" }) })] }), "\n", _jsxs(_components.p, { children: [_jsx(_components.code, { children: "src/passport.ts" }), " oluşturun"] }), "\n", _jsx(_components.pre, { children: _jsx(_components.code, { className: "language-tsx", children: "import passport from 'passport';\nimport OpenIDConnectStrategy, { type Profile, type VerifyCallback } from 'passport-openidconnect';\n\nimport { config } from './config.js';\n\nconst { appId, appSecret, endpoint } = config;\n\nexport default function initPassport() {\n passport.use(\n new OpenIDConnectStrategy(\n {\n issuer: `${endpoint}/oidc`,\n authorizationURL: `${endpoint}/oidc/auth`,\n tokenURL: `${endpoint}/oidc/token`,\n userInfoURL: `${endpoint}/oidc/me`,\n clientID: appId,\n clientSecret: appSecret,\n callbackURL: '/callback',\n scope: ['profile', 'offline_access'],\n },\n (issuer: string, profile: Profile, callback: VerifyCallback) => {\n callback(null, profile);\n }\n )\n );\n\n passport.serializeUser((user, callback) => {\n callback(null, user);\n });\n\n passport.deserializeUser(function (user, callback) {\n callback(null, user as Express.User);\n });\n}\n" }) }), "\n", _jsxs(_components.p, { children: ["Bu kod Passport'u ", _jsx(_components.strong, { children: _jsx(_components.code, { children: "OpenIDConnectStrategy" }) }), " ile başlatır. Serialize ve deserialize yöntemleri, gösterim amacıyla ayarlanmıştır."] }), "\n", _jsx(_components.p, { children: "Uygulamanızda Passport ara yazılımını başlattığınızdan ve eklediğinizden emin olun:" }), "\n", _jsx(_components.pre, { children: _jsx(_components.code, { className: "language-tsx", children: "...\ninitPassport();\n\nconst app = express();\napp.use(cookieParser());\napp.use(\n session({\n secret: 'randome secret',\n cookie: { maxAge: 14 * 24 * 60 * 60 * 1000 },\n resave: false,\n saveUninitialized: false,\n })\n);\napp.use(passport.authenticate('session'));\n...\n" }) }), "\n", _jsxs(_components.h2, { id: "kimlik-doğrulama-rotalarını-oluşturma", children: ["Kimlik doğrulama rotalarını oluşturma", _jsx(_components.a, { "aria-hidden": "true", tabIndex: "-1", href: "#kimlik-doğrulama-rotalarını-oluşturma", children: _jsx(_components.span, { children: "#" }) })] }), "\n", _jsx(_components.p, { children: "Şimdi kimlik doğrulama süreçleri için belirli rotaları oluşturacağız:" }), "\n", _jsxs(_components.h3, { id: "giriş-sign-in", children: ["Giriş: ", _jsx(_components.code, { children: "/sign-in" }), _jsx(_components.a, { "aria-hidden": "true", tabIndex: "-1", href: "#giriş-sign-in", children: _jsx(_components.span, { children: "#" }) })] }), "\n", _jsx(_components.pre, { children: _jsx(_components.code, { className: "language-tsx", children: "app.get('/sign-in', passport.authenticate('openidconnect'));\n" }) }), "\n", _jsx(_components.p, { children: "Bu rota, bir OIDC kimlik doğrulama rotası oluşturur ve yönlendirir." }), "\n", _jsxs(_components.h3, { id: "giriş-geri-aramasını-işleme-callback", children: ["Giriş geri aramasını işleme: ", _jsx(_components.code, { children: "/callback" }), _jsx(_components.a, { "aria-hidden": "true", tabIndex: "-1", href: "#giriş-geri-aramasını-işleme-callback", children: _jsx(_components.span, { children: "#" }) })] }), "\n", _jsx(_components.pre, { children: _jsx(_components.code, { className: "language-tsx", children: "app.get(\n '/callback',\n passport.authenticate('openidconnect', {\n successReturnToOrRedirect: '/',\n })\n);\n" }) }), "\n", _jsx(_components.p, { children: "Bu, OIDC oturum açma geri aramasını işler, tokenları saklar ve ana sayfaya yönlendirir." }), "\n", _jsxs(_components.h3, { id: "çıkış-sign-out", children: ["Çıkış: ", _jsx(_components.code, { children: "/sign-out" }), _jsx(_components.a, { "aria-hidden": "true", tabIndex: "-1", href: "#çıkış-sign-out", children: _jsx(_components.span, { children: "#" }) })] }), "\n", _jsx(_components.pre, { children: _jsx(_components.code, { className: "language-tsx", children: "app.get('/sign-out', (request, response, next) => {\n request.logout((error) => {\n if (error) {\n next(error);\n return;\n }\n response.redirect(`${endpoint}/oidc/session/end?client_id=${appId}`);\n });\n});\n" }) }), "\n", _jsx(_components.p, { children: "Bu, Logto’nun oturum sonu URL'sine ve ardından ana sayfaya yeniden yönlendirir." }), "\n", _jsxs(_components.h2, { id: "kimlik-doğrulama-durumunu-alma-ve-rotaları-koruma", children: ["Kimlik doğrulama durumunu alma ve rotaları koruma", _jsx(_components.a, { "aria-hidden": "true", tabIndex: "-1", href: "#kimlik-doğrulama-durumunu-alma-ve-rotaları-koruma", children: _jsx(_components.span, { children: "#" }) })] }), "\n", _jsx(_components.p, { children: "Kimlik doğrulama durumu ile ana sayfayı geliştirin:" }), "\n", _jsx(_components.pre, { children: _jsx(_components.code, { className: "language-tsx", children: "app.get('/', (request: Request, response) => {\n const { user } = request;\n response.setHeader('content-type', 'text/html');\n\n if (user) {\n response.end(\n `

Hello Logto

Şu kullanıcı olarak giriş yapıldı: ${JSON.stringify(\n user\n )}, Çıkış Yap

`\n );\n } else {\n response.end(`

Hello Logto

Giriş Yap

`);\n }\n});\n" }) }), "\n", _jsxs(_components.p, { children: ["Burada, ", _jsx(_components.code, { children: "JSON.stringify" }), " kullanılarak kullanıcı bilgileri görüntülenir ve ", _jsx(_components.code, { children: "request.user" }), "'ın varlığı rotaları korumak için kullanılır."] }), "\n", _jsxs(_components.h2, { id: "sonuç", children: ["Sonuç", _jsx(_components.a, { "aria-hidden": "true", tabIndex: "-1", href: "#sonuç", children: _jsx(_components.span, { children: "#" }) })] }), "\n", _jsx(_components.p, { children: "Passport.js ile Logto'yu entegre ettiğiniz için tebrikler. Umarım bu rehber, mevcut sistemlerden Logto kullanmaya geçmenize yardımcı olabilir. Gelişmiş bir kimlik doğrulama deneyimi için bugün Logto Cloud'u denemeyi düşünebilirsiniz. İyi kodlamalar!" }), "\n", _jsx(LogtoCloudButton, { children: "Bugün Logto'yu deneyin" })] }); } 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."); }