EN SeedWebs

สมาชิก: เข้าสู่ระบบด้วย Google Client ของเว็บเอง

สร้าง OAuth Client ในโปรเจกต์ Google Cloud ของคุณเอง ให้หน้าเข้าสู่ระบบของ Google แสดงชื่อเว็บของคุณแทน SeedWebs

โดยปกติสมาชิกเข้าสู่ระบบด้วย Google ผ่าน Client ของ SeedWebs หน้าเลือกบัญชีของ Google จึงแสดงชื่อ SeedWebs ถ้าต้องการให้แสดงชื่อเว็บของคุณ ให้สร้าง OAuth Client ใน Google Cloud ของคุณเอง แล้วนำมาใส่ในหน้าตั้งค่าของเว็บ

ก่อนเริ่ม

  • เว็บต้องเชื่อมโดเมนของตัวเองและใช้งานได้แล้ว (แพ็กเกจที่ใช้โดเมนของตัวเองได้) เพราะ Google ต้องส่งผู้ใช้กลับมาที่โดเมนของคุณ ถ้ายังใช้ที่อยู่ ชื่อเว็บ.seedwebs.app สมาชิกจะเข้าสู่ระบบด้วย Client ของ SeedWebs ต่อไป
  • ในหน้าแอดมิน เปิด สมาชิก ▸ ตั้งค่าการเข้าสู่ระบบ แท็บ วิธีเข้าสู่ระบบ แล้วเปิด Google ไว้ ใต้แถว Google จะมีค่าที่ต้องกรอกใน Google Cloud พร้อมปุ่มคัดลอก (ต้องเป็นผู้ดูแลระบบ)
  • บัญชี Google ที่จะใช้สร้างโปรเจกต์ใน Google Cloud

1. สร้างโปรเจกต์ใน Google Cloud

  1. เปิด Google Cloud Console แล้วกดตัวเลือกโปรเจกต์ด้านบน ▸ New project
  2. ตั้งชื่อโปรเจกต์ (เช่น ชื่อเว็บ) แล้วกด Create

2. ตั้งค่าหน้ายินยอม (OAuth consent screen)

ในเมนู APIs & Services ▸ OAuth consent screen (Google เรียกส่วนนี้ว่า Google Auth Platform)

  1. Branding: ใส่ App name (ชื่อเว็บ), อีเมลติดต่อ, โลโก้ (ถ้ามี), หน้าแรก https://โดเมนของคุณ และลิงก์นโยบายความเป็นส่วนตัว ใน Authorized domains ใส่ค่า Authorized domain จากการ์ดในหน้าแอดมิน
  2. Audience: เลือก User type เป็น External แล้วกด Publish app ให้สถานะเป็น In production (ถ้าค้างไว้ที่ Testing จะเข้าสู่ระบบได้เฉพาะบัญชีที่เพิ่มเป็น Test users)
  3. Data access: ใช้แค่ scope พื้นฐาน openid, email และ profile ห้ามเพิ่ม scope อื่น scope ชุดนี้ไม่ต้องผ่านการตรวจแอป (app verification) และไม่จำกัดจำนวนผู้ใช้
ชื่อแอปและโลโก้จะขึ้นบนหน้ายินยอมของ Google ก็ต่อเมื่อผ่านการยืนยันแบรนด์ (brand verification) แล้ว ซึ่ง Google ให้ยืนยันว่าคุณเป็นเจ้าของโดเมนใน Google Search Console ด้วยบัญชีที่เป็นเจ้าของหรือผู้แก้ไขโปรเจกต์ ระหว่างรอ สมาชิกเข้าสู่ระบบได้ตามปกติ

3. สร้าง OAuth Client

  1. ไปที่ Clients (หรือ Credentials) ▸ Create client เลือก Application type เป็น Web application
  2. Authorized JavaScript origins: ใส่ https://โดเมนของคุณ (คัดลอกจากการ์ด ช่อง Authorized JavaScript origin)
  3. Authorized redirect URIs: ใส่ https://โดเมนของคุณ/api/member/auth/callback (คัดลอกจากการ์ด ช่อง Authorized redirect URI) ต้องตรงทุกตัวอักษร
  4. กด Create แล้วคัดลอก Client ID และ Client secret เก็บไว้

4. ทดสอบและบันทึกใน SeedWebs

  1. กลับไปที่ สมาชิก ▸ ตั้งค่าการเข้าสู่ระบบ ▸ วิธีเข้าสู่ระบบ ▸ Google วาง Client ID และ Client secret
  2. กด ทดสอบและบันทึก ระบบจะเปิด Google ในแท็บใหม่ ให้เข้าสู่ระบบด้วยบัญชี Google ใดก็ได้
  3. ถ้าแท็บนั้นขึ้นว่า เชื่อมต่อ Google สำเร็จ แปลว่าบันทึกแล้ว ปิดแท็บได้เลย กลับมาที่หน้าตั้งค่าจะเห็นสถานะ ใช้ Google Client ของเว็บเอง การทดสอบไม่สร้างสมาชิกและไม่ได้เข้าสู่ระบบให้ใคร
  4. หลังบันทึก Client ID แสดงเป็นตัวหนังสือ และ Client secret ถูกซ่อนไว้ แก้ในช่องไม่ได้ ถ้าจะใช้ Client อื่น กด เปลี่ยน Client Client เดิมยังใช้งานอยู่จนกว่า Client ใหม่จะทดสอบผ่าน
  5. ถ้าไม่สำเร็จ ระบบจะไม่บันทึกอะไรเลย และสมาชิกยังเข้าสู่ระบบผ่าน Client ของ SeedWebs เหมือนเดิม
ข้อความจาก Google สาเหตุที่พบบ่อย
redirect_uri_mismatch Authorized redirect URI ใน Google Cloud ไม่ตรงกับค่าในการ์ด (เช่น ขาด https หรือมี / ท้าย)
invalid_client Client ID หรือ Client secret ไม่ถูกต้อง หรือคัดลอกมาไม่ครบ
access_denied กดยกเลิกที่หน้า Google หรือแอปยังอยู่ในสถานะ Testing และบัญชีนั้นไม่ได้เป็น Test user

ถ้าเปลี่ยนโดเมนหรือยกเลิกโดเมน

สมาชิกจะเข้าสู่ระบบได้เสมอ: เมื่อ Client ของเว็บใช้ไม่ได้ (โดเมนเปลี่ยน ยกเลิกโดเมน หรือแพ็กเกจไม่รวมโดเมนของตัวเองแล้ว) ระบบจะสลับไปใช้ Client ของ SeedWebs ให้เองทันที และแจ้งคุณ 3 ทาง คือ แถบแจ้งเตือนในแดชบอร์ด สถานะในการ์ด Google และอีเมลถึงเจ้าของเว็บหนึ่งฉบับ

จะกลับมาใช้ Client ของเว็บ: เพิ่ม Authorized JavaScript origin, Authorized redirect URI และ Authorized domain ของโดเมนใหม่ใน Google Cloud (ดูค่าจากการ์ด) แล้วกด ทดสอบอีกครั้ง ระบบใช้ Client secret เดิมที่บันทึกไว้

สมาชิกเดิม

สมาชิกจับคู่กันด้วยอีเมล และ Google ใช้รหัสบัญชีเดียวกันไม่ว่าจะเข้าผ่าน Client ไหน การสลับระหว่าง Client ของ SeedWebs กับ Client ของเว็บจึงไม่กระทบสมาชิกเดิม

เลิกใช้ Client ของเว็บ

กด กลับไปใช้ Client ของ SeedWebs ใต้แถว Google แล้วยืนยัน Client ของเว็บที่บันทึกไว้จะถูกลบ และสมาชิกจะกลับไปเข้าสู่ระบบด้วย Client ของ SeedWebs ทันที

← คู่มือทั้งหมด