พารามิเตอร์หน้าจอแรก
ชุดพารามิเตอร์การยืนยันตัวตนแบบกำหนดเองที่ช่วยให้คุณปรับแต่งประสบการณ์หน้าจอแรกตามที่ต้องการสำหรับผู้ใช้ปลายทาง
first_screen: ระบุหน้าจอแรกที่ผู้ใช้จะเห็นidentifier: ระบุประเภทตัวระบุที่ฟอร์มลงชื่อเข้าใช้หรือลงทะเบียนจะยอมรับlogin_hint: เติมข้อมูลในช่องตัวระบุด้วยอีเมลหรือชื่อผู้ใช้ของผู้ใช้ (นี่คือพารามิเตอร์มาตรฐานของ OIDC)
first_screen
พารามิเตอร์ first_screen เป็นพารามิเตอร์หลักที่กำหนดว่าผู้ใช้จะเห็นหน้าจอแรกใดเมื่อถูกเปลี่ยนเส้นทางไปยังหน้าลงชื่อเข้าใช้ของ Logto โดยค่าเริ่มต้นจะเป็นฟอร์มลงชื่อเข้าใช้แบบสากล คุณสามารถใช้พารามิเตอร์นี้เพื่อปรับแต่งหน้าจอแรกตามความต้องการของแอปพลิเคชันของคุณ ค่าที่รองรับ ได้แก่:
sign_in(ค่าเริ่มต้น): แสดงฟอร์มลงชื่อเข้าใช้register: แสดงฟอร์มลงทะเบียนreset_password: แสดงฟอร์มรีเซ็ตรหัสผ่านsingle_sign_on: แสดงฟอร์มลงชื่อเข้าใช้ SSO สำหรับองค์กร (ระบบจะถามอีเมลเพื่อกำหนดผู้ให้บริการ SSO ที่เปิดใช้งาน)identifier:sign-in: แสดงฟอร์มลงชื่อเข้าใช้แบบระบุประเภทตัวระบุ สามารถระบุประเภทตัวระบุได้ด้วยพารามิเตอร์identifier(ไม่บังคับ) เหมาะสำหรับกรณีที่คุณเปิดใช้งานวิธีลงชื่อเข้าใช้หลายประเภทidentifier:register: แสดงฟอร์มลงทะเบียนแบบระบุประเภทตัวระบุ สามารถระบุประเภทตัวระบุได้ด้วยพารามิเตอร์identifier(ไม่บังคับ) เหมาะสำหรับกรณีที่คุณเปิดใช้งานวิธีลงทะเบียนหลายประเภท
ตัวอย่างเช่น ส่งผู้ใช้ไปยังฟอร์มลงชื่อเข้าใช้ SSO สำหรับองค์กรโดยตรง:
curl --location \
--request GET 'https://<your-tenant>.logto.app/oidc/auth?client_id=<client_id>&...&first_screen=single_sign_on'
หน้าจอแรกจะเป็นไปตามการตั้งค่าที่กำหนดใน Console > ประสบการณ์การลงชื่อเข้าใช้ คุณต้องเปิดใช้งานวิธีการยืนยันตัวตนที่ต้องการก่อน และตั้งค่าแบรนด์ ข้อกำหนดและนโยบายความเป็นส่วนตัว และการแปลภาษา (i18n) โปรดทราบว่าเฉพาะหน้าลงชื่อเข้าใช้ (sign-in) และหน้าลงทะเบียน (register) เท่านั้นที่แสดงโลโก้โดยค่าเริ่มต้น
identifier
พารามิเตอร์ identifier ใช้เพื่อระบุประเภทตัวระบุที่ฟอร์มลงชื่อเข้าใช้หรือลงทะเบียนจะรับ ค่านี้ใช้ได้เฉพาะเมื่อพารามิเตอร์ first_screen ถูกตั้งค่าเป็น identifier:sign-in, identifier:register หรือ reset_password ค่าที่รองรับ ได้แก่: username, email และ phone หากต้องการอนุญาตหลายประเภท ให้คั่นค่าด้วยช่องว่าง
ตัวอย่างเช่น ส่งผู้ใช้ไปยังหน้าลงทะเบียนด้วยอีเมลหรือเบอร์โทรศัพท์โดยตรง:
curl --location \
--request GET 'https://<your-tenant>.logto.app/oidc/auth?client_id=<client_id>&...&first_screen=identifier:register&identifier=email phone'
ประเภทตัวระบุทั้งหมดที่ระบุในพารามิเตอร์นี้จะต้องถูกเปิดใช้งานในหน้าตั้งค่าการลงชื่อเข้าใช้หรือลงทะเบียนใน Logto Console
ประเภทตัวระบุที่ไม่รองรับหรือถูกปิดใช้งานจะถูกละเว้น หากตัวระบุที่ระบุทั้งหมดไม่รองรับ จะใช้การตั้งค่าประสบการณ์การลงชื่อเข้าใช้เริ่มต้นแทน
login_hint
พารามิเตอร์ login_hint ซึ่งกำหนดไว้ใน OpenID Connect specification มาตรฐาน ใช้เพื่อเติมข้อมูลล่วงหน้าในฟอร์มลงชื่อเข้าใช้ด้วยตัวระบุของผู้ใช้ (เช่น อีเมล เบอร์โทรศัพท์ หรือชื่อผู้ใช้) ใน Logto คุณสามารถใช้ร่วมกับพารามิเตอร์หน้าจอลงชื่อเข้าใช้อื่น ๆ เพื่อเพิ่มประสบการณ์ผู้ใช้ พารามิเตอร์นี้มีประโยชน์มากหากคุณมีฟอร์มก่อนการยืนยันตัวตนแบบกำหนดเองที่เก็บตัวระบุของผู้ใช้ไว้ล่วงหน้า ทำให้ผู้ใช้ไม่ต้องกรอกซ้ำในขั้นตอนลงชื่อเข้าใช้
ตัวอย่างเช่น เติมอีเมลที่เก็บไว้ล่วงหน้าในฟอร์มลงชื่อเข้าใช้:
curl --location \
--request GET 'https://<your-tenant>.logto.app/oidc/auth?client_id=<client_id>&...&first_screen=identifier:sign_in&identifier=email&login_hint=[email protected]
การรองรับ SDK
ใน Logto SDK ที่รองรับ คุณสามารถตั้งค่าพารามิเตอร์เหล่านี้ขณะเรียกใช้เมธอด signIn ได้ดังนี้:
logtoClient.signIn({
redirectUri: 'https://your-app.com/callback',
firstScreen: 'identifier:register',
identifier: ['email', 'phone'],
loginHint: '[email protected]',
});