สำหรับเพื่อนใหม่ของเรา:

Logto คือทางเลือกแทน Auth0 ที่ออกแบบมาสำหรับแอปและผลิตภัณฑ์ SaaS ยุคใหม่ โดยมีทั้งบริการ Cloud และ Open-source เพื่อช่วยให้คุณเปิดตัวระบบการจัดการเอกลักษณ์และการเข้าถึง (IAM) ได้อย่างรวดเร็ว สนุกกับการยืนยันตัวตน (การยืนยันตัวตน), การอนุญาต (การอนุญาต), และการจัดการหลายผู้เช่า ครบจบในที่เดียว

เราแนะนำให้เริ่มต้นด้วย tenant สำหรับการพัฒนาแบบฟรีบน Logto Cloud เพื่อให้คุณสามารถสำรวจฟีเจอร์ทั้งหมดได้อย่างง่ายดาย

ในบทความนี้ เราจะพาคุณไปทีละขั้นตอนเพื่อสร้างประสบการณ์ลงชื่อเข้าใช้ Naver (การยืนยันตัวตนของผู้ใช้) อย่างรวดเร็วด้วย Expo (React Native) และ Logto

ข้อกำหนดเบื้องต้น

• มี Logto instance ที่พร้อมใช้งาน ดู หน้าแนะนำ เพื่อเริ่มต้นใช้งาน
• มีความรู้พื้นฐานเกี่ยวกับ Expo (React Native)
• มีบัญชี Naver ที่ใช้งานได้

สร้างแอปพลิเคชันใน Logto

Logto สร้างขึ้นบนพื้นฐานของการยืนยันตัวตน OpenID Connect (OIDC) และการอนุญาต OAuth 2.0 โดยรองรับการจัดการข้อมูลระบุตัวตนแบบรวมศูนย์ข้ามหลายแอปพลิเคชัน ซึ่งมักเรียกว่า การลงชื่อเข้าใช้ครั้งเดียว (Single Sign-On; SSO)

ในการสร้างแอปพลิเคชัน Native app ของคุณ เพียงทำตามขั้นตอนเหล่านี้:

1. เปิด Logto Console ในส่วน "เริ่มต้นใช้งาน" ให้คลิกที่ลิงก์ "ดูทั้งหมด" เพื่อเปิดรายการเฟรมเวิร์กของแอปพลิเคชัน หรือคุณสามารถไปที่ Logto Console > Applications แล้วคลิกปุ่ม "สร้างแอปพลิเคชัน"
2. ในหน้าต่างที่เปิดขึ้น ให้คลิกที่ส่วน "Native app" หรือกรองเฟรมเวิร์ก "Native app" ทั้งหมดที่มีโดยใช้ช่องกรองด่วนทางซ้ายมือ จากนั้นคลิกที่การ์ดเฟรมเวิร์ก "Expo" เพื่อเริ่มสร้างแอปพลิเคชันของคุณ
3. กรอกชื่อแอปพลิเคชัน เช่น "Bookstore" แล้วคลิก "สร้างแอปพลิเคชัน"

🎉 เยี่ยมมาก! คุณเพิ่งสร้างแอปพลิเคชันแรกของคุณใน Logto คุณจะเห็นหน้าข้อความแสดงความยินดีซึ่งมีคู่มือการเชื่อมต่ออย่างละเอียด ให้ทำตามคู่มือเพื่อดูประสบการณ์ที่จะเกิดขึ้นในแอปพลิเคชันของคุณ

ผสานรวม Expo กับ Logto

เคล็ดลับ:

• ตัวอย่างสาธิตต่อไปนี้สร้างขึ้นบน Expo ~50.0.6
• โปรเจกต์ตัวอย่างสามารถดูได้ที่ SDK repository ของเรา

การติดตั้ง

ติดตั้ง Logto SDK และแพ็กเกจที่จำเป็นร่วมกันผ่านตัวจัดการแพ็กเกจที่คุณชื่นชอบ:

npm

npm i @logto/rn
npm i expo-crypto expo-secure-store expo-web-browser @react-native-async-storage/async-storage

Yarn

yarn add @logto/rn
yarn add expo-crypto expo-secure-store expo-web-browser @react-native-async-storage/async-storage

pnpm

pnpm add @logto/rn
pnpm add expo-crypto expo-secure-store expo-web-browser @react-native-async-storage/async-storage

แพ็กเกจ @logto/rn คือ SDK สำหรับ Logto ส่วนแพ็กเกจที่เหลือเป็นแพ็กเกจที่จำเป็นร่วมกัน ไม่สามารถระบุเป็น dependencies โดยตรงได้ เนื่องจาก Expo CLI กำหนดให้ dependencies ทั้งหมดของ native modules ต้องติดตั้งไว้โดยตรงใน package.json ของโปรเจกต์หลัก

บันทึก:

หากคุณกำลังติดตั้งใน แอป React Native แบบ bare คุณควรปฏิบัติตาม คำแนะนำการติดตั้งเพิ่มเติม เหล่านี้ด้วย

เริ่มต้น Logto provider

นำเข้าและใช้ LogtoProvider เพื่อให้บริบท Logto:

App.tsx

import { LogtoProvider, LogtoConfig } from '@logto/rn';

const config: LogtoConfig = {
  endpoint: '<your-logto-endpoint>',
  appId: '<your-application-id>',
};

const App = () => (
  <LogtoProvider config={config}>
    <YourAppContent />
  </LogtoProvider>
);

สร้างฟังก์ชันลงชื่อเข้าใช้และออกจากระบบ

ก่อนที่เราจะลงลึกในรายละเอียด นี่คือภาพรวมประสบการณ์ของผู้ใช้ปลายทาง กระบวนการลงชื่อเข้าใช้สามารถสรุปได้ดังนี้:

1. แอปของคุณเรียกใช้งานเมธอดลงชื่อเข้าใช้
2. ผู้ใช้จะถูกเปลี่ยนเส้นทางไปยังหน้าลงชื่อเข้าใช้ของ Logto สำหรับแอปเนทีฟ ระบบจะเปิดเบราว์เซอร์ของระบบ
3. ผู้ใช้ลงชื่อเข้าใช้และถูกเปลี่ยนเส้นทางกลับไปยังแอปของคุณ (ตามที่กำหนดไว้ใน redirect URI)

เกี่ยวกับการลงชื่อเข้าใช้แบบเปลี่ยนเส้นทาง (redirect-based sign-in)

1. กระบวนการยืนยันตัวตนนี้เป็นไปตามโปรโตคอล OpenID Connect (OIDC) และ Logto บังคับใช้มาตรการรักษาความปลอดภัยอย่างเข้มงวดเพื่อปกป้องการลงชื่อเข้าใช้ของผู้ใช้
2. หากคุณมีหลายแอป คุณสามารถใช้ผู้ให้บริการข้อมูลระบุตัวตน (Logto) เดียวกันได้ เมื่อผู้ใช้ลงชื่อเข้าใช้แอปหนึ่งแล้ว Logto จะดำเนินการลงชื่อเข้าใช้โดยอัตโนมัติเมื่อผู้ใช้เข้าถึงแอปอื่น

หากต้องการเรียนรู้เพิ่มเติมเกี่ยวกับเหตุผลและประโยชน์ของการลงชื่อเข้าใช้แบบเปลี่ยนเส้นทาง โปรดดูที่ อธิบายประสบการณ์การลงชื่อเข้าใช้ของ Logto

---

ไปที่หน้ารายละเอียดแอปพลิเคชันใน Logto Console เพิ่ม native redirect URI (เช่น io.logto://callback) แล้วคลิก "Save"

• สำหรับ iOS สคีมของ redirect URI ไม่สำคัญนัก เพราะคลาส ASWebAuthenticationSession จะฟัง redirect URI ไม่ว่าจะลงทะเบียนไว้หรือไม่

• สำหรับ Android สคีมของ redirect URI ต้องถูกระบุในไฟล์ app.json ของ Expo เช่น:

  app.json

  {
    "expo": {
      "scheme": "io.logto"
    }
  }

กลับมาที่แอปของคุณ สามารถใช้ hook useLogto เพื่อเข้าสู่ระบบและออกจากระบบได้:

App.tsx

import { useLogto } from '@logto/rn';
import { Button } from 'react-native';

const Content = () => {
  const { signIn, signOut, isAuthenticated } = useLogto();

  return (
    <div>
      {isAuthenticated ? (
        <Button title="Sign out" onPress={async () => signOut()} />
      ) : (
        // เปลี่ยน redirect URI เป็นของคุณเอง
        <Button title="Sign in" onPress={async () => signIn('io.logto://callback')} />
      )}
    </div>
  );
};

จุดตรวจสอบ: ทดสอบแอปพลิเคชันของคุณ

ตอนนี้คุณสามารถทดสอบแอปพลิเคชันของคุณได้แล้ว:

1. รันแอปพลิเคชันของคุณ คุณจะเห็นปุ่มลงชื่อเข้าใช้
2. คลิกปุ่มลงชื่อเข้าใช้ SDK จะเริ่มกระบวนการลงชื่อเข้าใช้และเปลี่ยนเส้นทางคุณไปยังหน้าลงชื่อเข้าใช้ของ Logto
3. หลังจากที่คุณลงชื่อเข้าใช้แล้ว คุณจะถูกเปลี่ยนเส้นทางกลับไปยังแอปพลิเคชันของคุณและเห็นปุ่มลงชื่อออก
4. คลิกปุ่มลงชื่อออกเพื่อเคลียร์ที่เก็บโทเค็นและออกจากระบบ

เพิ่มตัวเชื่อมต่อ Naver

เพื่อเปิดใช้งานการลงชื่อเข้าใช้อย่างรวดเร็วและเพิ่มอัตราการเปลี่ยนผู้ใช้ ให้เชื่อมต่อกับ Expo ในฐานะผู้ให้บริการข้อมูลระบุตัวตน (Identity provider) ตัวเชื่อมต่อโซเชียลของ Logto ช่วยให้คุณสร้างการเชื่อมต่อนี้ได้ภายในไม่กี่นาที โดยสามารถกรอกพารามิเตอร์ได้หลายค่า

ในการเพิ่มตัวเชื่อมต่อโซเชียล ให้ทำตามขั้นตอนดังนี้:

1. ไปที่ Console > Connectors > Social Connectors
2. คลิก "Add social connector" และเลือก "Naver"
3. ทำตามคู่มือ README กรอกข้อมูลที่จำเป็น และปรับแต่งการตั้งค่า

บันทึก:

หากคุณกำลังทำตามคู่มือ Connector แบบ in-place คุณสามารถข้ามส่วนถัดไปได้

ตั้งค่า Naver login

ขณะนี้เว็บไซต์สำหรับนักพัฒนา รองรับเฉพาะภาษาเกาหลี

ปัจจุบันเว็บไซต์ Naver Developers รองรับเฉพาะภาษาเกาหลีเท่านั้น กรุณาพิจารณาใช้ตัวแปลภาษา

สำหรับการใช้งานจริง (Production)

• สำหรับการใช้งานจริง คุณต้องขอรับการตรวจสอบจากทีม Naver มิฉะนั้น เฉพาะผู้ใช้ที่ลงทะเบียนไว้เท่านั้นจึงจะสามารถลงชื่อเข้าใช้ได้
  • คุณสามารถเพิ่มผู้ทดสอบได้จากเมนู 맴버관리(Member Manage)
• ในการขอรับการตรวจสอบ กรุณาตรวจสอบ 애플리케이션 개발 상태(Application Development Status) จาก API 설정(API Setting) ในการตั้งค่าโปรเจกต์แอปพลิเคชันของคุณ

ตั้งค่าโปรเจกต์ใน Naver Developers

• ไปที่ Naver Developers และลงชื่อเข้าใช้ด้วยบัญชี Naver ของคุณ
• คลิก Application -> 어플리케이션 등록 จากเมนูเพื่อสร้างโปรเจกต์ใหม่
• ทำตามคำแนะนำด้านล่างเพื่อสร้างแอปพลิเคชัน

ชื่อแอปพลิเคชัน (어플리케이션 이름)

• พิมพ์ชื่อแอปพลิเคชันของคุณในช่อง 어플리케이션 이름 (ชื่อนี้จะแสดงขณะผู้ใช้ลงชื่อเข้าใช้)

การใช้งาน API (사용 API)

• เลือก 네이버 로그인(Naver Login) สำหรับ 사용 API(API Usage)
• ทำเครื่องหมาย 이메일 주소(Email Address), 별명(Nickname), 프로필 사진(Profile Image) เป็น 필수(Neccessary) ใน 권한(Role) (คุณสามารถเลือก 추가(Add) เป็นตัวเลือกเสริมได้ แต่จะไม่ได้รับข้อมูลนี้จากผู้ใช้)

สภาพแวดล้อมบริการ Open API สำหรับการลงชื่อเข้าใช้ (로그인 오픈 API 서비스 환경)

• สำหรับ 로그인 오픈 API 서비스 환경(Sign in Open API Service Environment) ให้เพิ่มสองสภาพแวดล้อมคือ PC웹(PC Web) และ 모바일웹(Mobile Web)

PC Web (PC 웹)

• สำหรับ 서비스 URL(Service URL) ให้กรอก http(s)://YOUR_URL (เช่น https://logto.io)
• สำหรับ 네이버 로그인(Naver Login) Callback URL ให้กรอก http(s)://YOUR_URL/callback/${connector_id} (เช่น https://logto.io/callback/${connector_id})

Mobile Web (Mobile 웹)

• สำหรับ 서비스 URL(Service URL) ให้กรอก http(s)://YOUR_URL (เช่น https://logto.io)
• สำหรับ 네이버 로그인(Naver Login) Callback URL ให้กรอก http(s)://YOUR_URL/callback/${connector_id} (เช่น https://logto.io/callback/${connector_id})

ข้อควรระวัง:

connector_id สามารถดูได้ที่แถบด้านบนของหน้ารายละเอียดตัวเชื่อมต่อใน Logto Admin Console

ตั้งค่า Logto

ประเภทของการตั้งค่า

Name	Type
clientId	string
clientSecret	string

clientId

clientId คือ Client ID ของโปรเจกต์คุณ (สามารถดูได้จาก 애플리케이션 정보(Application Info) ของโปรเจกต์ใน Naver developers)

clientSecret

clientSecret คือ Client Secret ของโปรเจกต์คุณ (สามารถดูได้จาก 애플리케이션 정보(Application Info) ของโปรเจกต์ใน Naver developers)

บันทึกการตั้งค่าของคุณ

โปรดตรวจสอบให้แน่ใจว่าคุณได้กรอกค่าที่จำเป็นในพื้นที่การตั้งค่าตัวเชื่อมต่อ Logto เรียบร้อยแล้ว คลิก "บันทึกและเสร็จสิ้น" (หรือ "บันทึกการเปลี่ยนแปลง") และตัวเชื่อมต่อ Naver ควรพร้อมใช้งานแล้ว

เปิดใช้งานตัวเชื่อมต่อ Naver ในประสบการณ์การลงชื่อเข้าใช้

เมื่อคุณสร้างตัวเชื่อมต่อโซเชียลสำเร็จแล้ว คุณสามารถเปิดใช้งานเป็นปุ่ม "ดำเนินการต่อด้วย Naver" ในประสบการณ์การลงชื่อเข้าใช้ (Sign-in Experience) ได้

1. ไปที่ Console > ประสบการณ์การลงชื่อเข้าใช้ > สมัครและลงชื่อเข้าใช้
2. (ไม่บังคับ) เลือก "ไม่เกี่ยวข้อง" สำหรับตัวระบุการสมัคร หากคุณต้องการเฉพาะการเข้าสู่ระบบโซเชียล
3. เพิ่มตัวเชื่อมต่อ Naver ที่ตั้งค่าไว้แล้วในส่วน "เข้าสู่ระบบโซเชียล" (Social sign-in)

การทดสอบและการตรวจสอบความถูกต้อง

กลับไปที่แอป Expo (React Native) ของคุณ ตอนนี้คุณควรจะสามารถลงชื่อเข้าใช้ด้วย Naver ได้แล้ว ขอให้สนุก!

อ่านเพิ่มเติม

กระบวนการสำหรับผู้ใช้ปลายทาง: Logto มีโฟลว์การยืนยันตัวตนสำเร็จรูปพร้อมใช้งาน รวมถึง MFA และ Enterprise SSO พร้อม API อันทรงพลังสำหรับการปรับแต่งการตั้งค่าบัญชี การตรวจสอบความปลอดภัย และประสบการณ์แบบหลายผู้เช่า (multi-tenant) ได้อย่างยืดหยุ่น

การอนุญาต (Authorization): การอนุญาต (Authorization) กำหนดว่าผู้ใช้สามารถทำอะไรหรือเข้าถึงทรัพยากรใดได้บ้างหลังจากได้รับการยืนยันตัวตนแล้ว สำรวจวิธีปกป้อง API ของคุณสำหรับแอปเนทีฟและแอปหน้าเดียว (SPA) และการใช้งานการควบคุมการเข้าถึงตามบทบาท (RBAC)

องค์กร (Organizations): ฟีเจอร์องค์กรมีประสิทธิภาพอย่างยิ่งใน SaaS แบบหลายผู้เช่าและแอป B2B โดยช่วยให้สร้างผู้เช่า จัดการสมาชิก RBAC ระดับองค์กร และ Just-in-Time Provisioning ได้

ชุดบทความ Customer IAM: บทความต่อเนื่องเกี่ยวกับการจัดการข้อมูลระบุตัวตนและการเข้าถึงของลูกค้า (Customer IAM) ตั้งแต่ระดับพื้นฐาน 101 ไปจนถึงหัวข้อขั้นสูงและอื่น ๆ