พารามิเตอร์หน้าจอแรก
ชุดของพารามิเตอร์การยืนยันตัวตนแบบกำหนดเองที่ช่วยให้คุณปรับแต่งประสบการณ์หน้าจอแรกตามที่ต้องการสำหรับผู้ใช้ปลายทาง
first_screen: ระบุหน้าจอแรกที่ผู้ใช้จะเห็นidentifier: ระบุประเภทตัวระบุที่ฟอร์มลงชื่อเข้าใช้หรือลงทะเบียนจะยอมรับlogin_hint: เติมข้อมูลในช่องตัวระบุด้วยอีเมลหรือชื่อผู้ใช้ของผู้ใช้ (นี่เป็นพารามิเตอร์มาตรฐานของ OIDC)
first_screen
พารามิเตอร์ first_screen เป็นพารามิเตอร์หลักที่กำหนดว่าผู้ใช้จะเห็นหน้าจอแรกใดเมื่อถูกเปลี่ยนเส้นทางไปยังหน้าลงชื่อเข้าใช้ของ Logto โดยค่าเริ่มต้นจะเป็นฟอร์มลงชื่อเข้าใช้แบบสากล คุณสามารถใช้พารามิเตอร์นี้เพื่อปรับแต่งหน้าจอแรกตามความต้องการของแอปพลิเคชันของคุณ ค่าที่รองรับ ได้แก่:
sign_in: แสดงฟอร์มลงชื่อเข้าใช้ (ค่าเริ่มต้น)register: แสดงฟอร์มลงทะเบียนreset_password: แสดงฟอร์มรีเซ็ตรหัสผ่านsingle_sign_on: แสดงฟอร์มลงชื่อเข้าใช้ Enterprise SSO (ระบบจะขออีเมลเพื่อระบุผู้ให้บริการ SSO ที่เปิดใช้งาน)identifier:sign-in: แสดงฟอร์มลงชื่อเข้าใช้แบบระบุประเภทตัวระบุ สามารถระบุประเภทตัวระบุได้ด้วยพารามิเตอร์identifierเหมาะสำหรับกรณีที่คุณเปิดใช้งานวิธีลงชื่อเข้าใช้หลายประเภทidentifier:register: แสดงฟอร์มลงทะเบียนแบบระบุประเภทตัวระบุ สามารถระบุประเภทตัวระบุได้ด้วยพารามิเตอร์identifierเหมาะสำหรับกรณีที่คุณเปิดใช้งานวิธีลงทะเบียนหลายประเภท
ตัวอย่างเช่น ส่งผู้ใช้ไปยังฟอร์มลงชื่อเข้าใช้ Enterprise SSO โดยตรง:
curl --location \
--request GET 'https://<your-tenant>.logto.app/oidc/auth?client_id=<client_id>&...&first_screen=single_sign_on'
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]',
});