ตั้งค่าการแชร์ข้อมูลเข้าสู่ระบบที่ราบรื่นในแอปและเว็บไซต์ต่างๆ ของ Android

เพิ่มความสะดวกให้กับผู้ใช้สูงสุดด้วยการเปิดใช้การแชร์ข้อมูลเข้าสู่ระบบอย่างราบรื่นข้ามแพลตฟอร์มในแอปและเว็บไซต์ เมื่อเว็บไซต์และแอป Android หลายรายการใช้แบ็กเอนด์การจัดการบัญชีร่วมกัน ฟีเจอร์นี้จะช่วยให้ผู้ใช้บันทึกข้อมูลเข้าสู่ระบบได้เพียงครั้งเดียวและระบบจะแนะนำข้อมูลเข้าสู่ระบบนั้นโดยอัตโนมัติในเว็บไซต์หรือแอป Android ที่ลิงก์ไว้

การตั้งค่าการแชร์ข้อมูลเข้าสู่ระบบทำได้ 2 วิธีดังนี้

• Play Console: แนะนำสำหรับนักพัฒนาแอปส่วนใหญ่เมื่อตั้งค่าการแชร์ข้อมูลเข้าสู่ระบบกับแอป Android วิธีนี้ช่วยให้คุณกำหนดค่าการแชร์ข้อมูลเข้าสู่ระบบได้โดยไม่ต้องเผยแพร่แอปเวอร์ชันใหม่ โปรดทราบว่าแม้จะใช้ Play Console คุณยังคงต้องเผยแพร่ไฟล์ assetlinks.json ที่ถูกต้องในเว็บไซต์
• ลิงก์เนื้อหาดิจิทัล (DAL): เหมาะสำหรับ Use Case ขั้นสูง เช่น การรองรับแอปหรือโดเมนหลายรายการที่มีการกําหนดค่าที่ซับซ้อนมากขึ้น

ประเด็นสำคัญ: ไม่ว่าคุณจะตั้งค่าการแชร์ข้อมูลเข้าสู่ระบบอย่างไร เครื่องมือจัดการรหัสผ่านจะถือว่าความสัมพันธ์ของการแชร์ข้อมูลเข้าสู่ระบบเป็นแบบเปลี่ยนผ่าน ซึ่งหมายความว่าหากเว็บไซต์ ก แชร์ข้อมูลเข้าสู่ระบบกับเว็บไซต์ ค และเว็บไซต์ ข แชร์ข้อมูลเข้าสู่ระบบกับเว็บไซต์ ค ด้วย เว็บไซต์ ก และเว็บไซต์ ข จะแชร์ข้อมูลเข้าสู่ระบบกับกันและกันโดยอัตโนมัติด้วย

แนวทางปฏิบัติแนะนำ

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

• แบบฟอร์มการลงชื่อเข้าใช้: เปิดใช้การป้อนข้อมูลเข้าสู่ระบบอัตโนมัติ
• แบบฟอร์มลงชื่อสมัครใช้: จัดเก็บข้อมูลเข้าสู่ระบบใหม่อย่างปลอดภัยเพื่อใช้ในแพลตฟอร์มต่างๆ
• แบบฟอร์มเปลี่ยนรหัสผ่าน: ซิงค์การอัปเดตรหัสผ่านในแพลตฟอร์มทั้งหมด
• แบบฟอร์มรีเซ็ตรหัสผ่าน: อนุญาตให้รีเซ็ตรหัสผ่านครั้งเดียวเพื่ออัปเดตแพลตฟอร์มทั้งหมด
• โดเมน WebView: ขยายการแชร์ข้อมูลเข้าสู่ระบบไปยังโดเมน WebView ภายในแอปที่จัดการการจัดการบัญชี (แบบฟอร์มการลงชื่อเข้าใช้ของโฮสต์ การลงชื่อสมัครใช้ การเปลี่ยนรหัสผ่าน หรือการรีเซ็ตรหัสผ่าน)
• แอป Android

แนวทางนี้สร้างระบบการจัดการข้อมูลเข้าสู่ระบบแบบรวม ซึ่งช่วยเพิ่มความสะดวกและความปลอดภัยให้แก่ผู้ใช้

เมื่อออกแบบเว็บไซต์การจัดการบัญชี เราขอแนะนำให้คุณทำตามแนวทางปฏิบัติแนะนำต่อไปนี้สำหรับเว็บไซต์การจัดการบัญชี

• ออกแบบแบบฟอร์มการลงชื่อสมัครใช้ตามแนวทางปฏิบัติแนะนำ
• ออกแบบแบบฟอร์มการลงชื่อเข้าใช้ตามแนวทางปฏิบัติแนะนำ
• เพิ่ม URL ที่รู้จักกันดีสำหรับการเปลี่ยนรหัสผ่าน

เมื่อออกแบบแอป Android เราขอแนะนำให้คุณผสานรวมแอปกับเครื่องมือจัดการข้อมูลเข้าสู่ระบบของ Android

ตั้งค่าการแชร์ข้อมูลเข้าสู่ระบบโดยใช้ Play Console

ตอนนี้คุณเปิดใช้การแชร์ข้อมูลเข้าสู่ระบบอย่างราบรื่นได้โดยตรงจาก Play Console โดยไม่ต้องเผยแพร่แอป Android เวอร์ชันใหม่ วิธีนี้ลดความซับซ้อนของกระบวนการด้วยการจัดการการกำหนดค่าการแชร์ข้อมูลเข้าสู่ระบบผ่านอินเทอร์เฟซของ Play Console

เคล็ดลับ: Play Console จะสร้างข้อมูลโค้ด JSON ที่จำเป็น บอกตำแหน่งที่จะเผยแพร่ข้อมูลโค้ดในเว็บไซต์ แล้วตรวจสอบข้อมูลโค้ดเมื่อติดตั้งใช้งานแล้วเพื่อช่วยป้องกันข้อผิดพลาดในการกำหนดค่า

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

ก่อนตั้งค่าการแชร์ข้อมูลเข้าสู่ระบบโดยใช้ Play Console โปรดตรวจสอบว่าคุณมีสิ่งต่อไปนี้

• สิทธิ์ที่จำเป็นใน Play Console เพื่อเข้าถึงส่วน Deep Link และการกำหนดค่าแอป หากคุณไม่ใช่เจ้าของบัญชี โปรดขอให้ผู้ดูแลระบบ Play Console ให้สิทธิ์เข้าถึงที่เหมาะสมแก่คุณ
• ความสามารถในการเผยแพร่ไฟล์ /.well-known/assetlinks.json ในโดเมนที่เกี่ยวข้องแต่ละโดเมนตามไวยากรณ์ของลิงก์เนื้อหาดิจิทัล (Digital Asset Links)

เปิดใช้การแชร์ข้อมูลเข้าสู่ระบบสำหรับโดเมนใหม่

หากต้องการตั้งค่าการแชร์ข้อมูลเข้าสู่ระบบอย่างราบรื่นใน Play Console สำหรับโดเมนใหม่ ให้ทำตามขั้นตอนต่อไปนี้

1. เปิด Play Console แล้วไปที่หน้า Deep Link (เพิ่มผู้ใช้ > Deep Link)
2. คลิกเพิ่มโดเมนในแท็บการกําหนดค่าแอป
3. ป้อนโดเมนของเว็บไซต์
4. เปิดปุ่มสลับเปิดใช้การแชร์ข้อมูลเข้าสู่ระบบ
5. คัดลอกไฟล์ JSON ที่สร้างขึ้นและเผยแพร่ในตำแหน่งที่ระบุ (https://YOUR_DOMAIN/.well-known/assetlinks.jsonตามโปรโตคอล) หรือเพิ่มข้อมูลที่เกี่ยวข้องลงในไฟล์ assetlinks.json ที่มีอยู่
6. คลิกสร้างการเชื่อมโยงเว็บไซต์

หากดำเนินการสำเร็จ ระบบจะนำคุณกลับไปยังหน้าDeep Link

เปิดใช้การแชร์ข้อมูลเข้าสู่ระบบสำหรับโดเมนที่มีอยู่

หากต้องการตั้งค่าการแชร์ข้อมูลเข้าสู่ระบบอย่างราบรื่นใน Play Console สำหรับโดเมนที่มีอยู่ ให้ทำตามขั้นตอนต่อไปนี้

1. เลือกแท็บการกําหนดค่าแอป
2. ในส่วนโดเมน ภายในการกำหนดค่าแอป ให้คลิกเปิดในคอลัมน์การแชร์ข้อมูลเข้าสู่ระบบ
3. คัดลอกไฟล์ JSON ที่สร้างขึ้นและเผยแพร่ในตำแหน่งที่ระบุ (หรือเพิ่มข้อมูลที่เกี่ยวข้องลงในไฟล์ assetlinks.json ที่มีอยู่)
4. คลิกเปิดการแชร์ข้อมูลเข้าสู่ระบบ

หากดำเนินการสำเร็จ ระบบจะนำคุณกลับไปยังหน้าDeep Link

ตั้งค่าการแชร์ข้อมูลเข้าสู่ระบบโดยใช้ลิงก์เนื้อหาดิจิทัล (Digital Asset Links หรือ DAL) เท่านั้น

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

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

ก่อนตั้งค่าการแชร์ข้อมูลเข้าสู่ระบบอย่างราบรื่น โปรดตรวจสอบว่าคุณมีสิ่งต่อไปนี้สำหรับแต่ละแพลตฟอร์ม

สําหรับแอป Android แต่ละแอป

• รหัสแอปพลิเคชัน Android ตามที่ประกาศไว้ในไฟล์ build.gradle ของแอป
• ลายนิ้วมือ SHA256 ของใบรับรองการรับรอง
• (แนะนำ) การลงชื่อเข้าใช้ของผู้ใช้ที่ติดตั้งใช้งานด้วย Credential Manager API

สำหรับแต่ละเว็บไซต์

• ความสามารถในการเผยแพร่ไฟล์ /.well-known/assetlinks.json ในโดเมนที่เกี่ยวข้องแต่ละโดเมนตามไวยากรณ์ของลิงก์เนื้อหาดิจิทัล (Digital Asset Links)
• โดเมนการจัดการบัญชีทั้งหมด (แบบฟอร์มการลงชื่อเข้าใช้ การลงชื่อสมัครใช้ การเปลี่ยนรหัสผ่าน หรือการเปลี่ยนรหัสผ่าน) ต้องเข้าถึงได้ผ่าน HTTPS

หมายเหตุ: Chrome จะแชร์ข้อมูลเข้าสู่ระบบที่บันทึกไว้โดยอัตโนมัติระหว่างเว็บไซต์ในเว็บไซต์เดียวกัน (เช่น www.example.com และ m.example.com)

เปิดใช้การแชร์ข้อมูลเข้าสู่ระบบอย่างราบรื่นในแอปและเว็บไซต์ Android

หากต้องการกำหนดค่าการแชร์ข้อมูลเข้าสู่ระบบอย่างราบรื่นในแอปและเว็บไซต์ คุณจะต้องสร้างและเผยแพร่รายการคำสั่งลิงก์เนื้อหาดิจิทัลที่ประกาศว่าเอนทิตีใด (เว็บไซต์หรือแอป Android) ได้รับอนุญาตให้แชร์ข้อมูลเข้าสู่ระบบ

สำคัญ: เครื่องมือจัดการรหัสผ่านจะถือว่าความสัมพันธ์ของการแชร์ข้อมูลเข้าสู่ระบบเป็นความสัมพันธ์แบบทรานซิทีฟ

วิธีประกาศความสัมพันธ์การแชร์ข้อมูลเข้าสู่ระบบ

1. สร้างไฟล์ assetlinks.json ที่มีคำสั่งที่ลิงก์ไปยังเว็บไซต์และแอป Android โดยทำตามไวยากรณ์รายการคำสั่ง DALs ดังนี้

   [
     {
       "relation":[
         "delegate_permission/common.get_login_creds"
       ],
       "target":{
         "namespace":"web",
         "site":URL
       }
     },
     {
       "relation":[
         "delegate_permission/common.get_login_creds"
       ],
       "target":{
         "namespace":"android_app",
         "package_name":"APP_ID",
         "sha256_cert_fingerprints":[
           "SHA_HEX_VALUE"
         ]
       }
     }
   ]
   

   โดยที่ URL คือ URL ของเว็บไซต์ APP_ID คือ รหัสแอปพลิเคชัน Android และ SHA_HEX_VALUE คือลายนิ้วมือ SHA256 ของใบรับรองการลงนามแอป Android

   ช่อง relation จะอธิบายความสัมพันธ์ที่ประกาศ หากต้องการประกาศว่าแอปและเว็บไซต์ใช้ข้อมูลเข้าสู่ระบบร่วมกัน ให้ระบุความสัมพันธ์เป็นdelegate_permission/common.get_login_creds ดูข้อมูลเพิ่มเติมเกี่ยวกับสตริงความสัมพันธ์ใน DAL

   ฟิลด์ target คือออบเจ็กต์ที่ระบุเนื้อหาที่ใช้ประกาศ

   ฟิลด์ต่อไปนี้จะระบุเว็บไซต์

   namespace

   web

   site

   URL ของเว็บไซต์ในรูปแบบ https://domain[:optional_port] เช่น https://www.example.com domain ต้องระบุค่าอย่างเต็มรูปแบบ และไม่ต้องระบุ optional_port เมื่อใช้พอร์ต 443 สำหรับ HTTPS เป้าหมาย site ต้องเป็นโดเมนรูทเท่านั้น คุณไม่สามารถจํากัดการเชื่อมโยงแอปกับไดเรกทอรีย่อยที่เฉพาะเจาะจงได้ อย่าใส่เส้นทางใน URL เช่น เครื่องหมายทับต่อท้าย ระบบจะไม่ถือว่าโดเมนย่อยตรงกัน กล่าวคือ หากคุณระบุ domain เป็น www.example.com โดเมน www.counter.example.com จะไม่เชื่อมโยงกับแอปของคุณ

   ฟิลด์ต่อไปนี้จะระบุแอป Android

   เนมสเปซ	android_app
   package_name	ชื่อแพ็กเกจที่ประกาศไว้ในไฟล์ Manifest ของแอป เช่น com.example.android
   sha256_cert_fingerprints	ลายนิ้วมือ SHA256 ของใบรับรองการรับรองของแอป

   สำคัญ: เมื่อสร้างการแชร์ข้อมูลเข้าสู่ระบบที่ราบรื่นระหว่างเว็บไซต์กับแอป Android เราจะใส่คำสั่งอ้างอิงตนเองไว้ในไฟล์ assetlinks.json ของเว็บไซต์ ซึ่งจำเป็นต้องทำเนื่องจากไฟล์ Manifest ของแอป Android จะอ้างอิงไฟล์นี้ในขั้นตอนการกำหนดค่าต่อๆ ไปเพื่อเปิดใช้การแชร์รหัสผ่าน

2. โฮสต์ไฟล์ JSON ของลิงก์เนื้อหาดิจิทัล (Digital Asset Links) ในตำแหน่งต่อไปนี้ในโดเมนการลงชื่อเข้าใช้ https://DOMAIN[:OPTIONAL_PORT]/.well-known/assetlinks.json โดยที่ DOMAIN คือโดเมนแบบเต็ม และจะต้องยกเว้น OPTIONAL_PORT เมื่อใช้พอร์ต 443 สำหรับ HTTPS

   หมายเหตุ: ไฟล์ JSON ของลิงก์เนื้อหาดิจิทัล (Digital Asset Links) ต้องแสดงเป็น Content-Type: application/json ในส่วนหัว HTTP และจะต้องไม่ใช่การเปลี่ยนเส้นทาง (ดูการสร้างรายการคำสั่ง)

3. ประกาศการเชื่อมโยงในแอป Android ด้วยการฝังคำสั่งในไฟล์ res/values/strings.xml ของแอป Android ซึ่งลิงก์กับรายการคำสั่งที่คุณสร้างขึ้นในขั้นตอนที่ 1 เพิ่มออบเจ็กต์ที่ระบุไฟล์ assetlinks.json ที่จะอัปโหลด เช่น

     <string name="asset_statements" translatable="false">
   [{
     \"include\": \"https://DOMAIN[:OPTIONAL_PORT]/.well-known/assetlinks.json\"
   }]
   </string>
   

   แทนที่ DOMAIN และ OPTIONAL_PORT (ต้องละเว้นเมื่อใช้พอร์ต 443 สําหรับ HTTPS) เช่น https://www.example.com หลีกเครื่องหมายเครื่องหมายคำพูดและเครื่องหมายอะพอสโทรฟีที่คุณใช้ในสตริง

   นอกจากนี้ คุณยังเพิ่มข้อมูลโค้ด JSON ในไฟล์ strings.xml ได้ด้วยตามที่แสดงในเอกสารประกอบ DAL แต่การใช้คำสั่ง include จะช่วยให้คุณเปลี่ยนแปลงคำสั่งได้โดยไม่ต้องเผยแพร่แอปเวอร์ชันใหม่

4. อ้างอิงคำสั่งในไฟล์ Manifest โดยเพิ่มบรรทัดต่อไปนี้ลงในไฟล์ AndroidManifest.xml ของแอปในส่วน <application>

   <meta-data android:name="asset_statements" android:resource="@string/asset_statements"/>
   

5. เผยแพร่แอป Android เวอร์ชันใหม่ใน Google Play Console

   สำคัญ: การแชร์ข้อมูลเข้าสู่ระบบอย่างราบรื่นจะมีผลหลังจากที่คุณเผยแพร่แอป Android เวอร์ชันใหม่ซึ่งมีข้อมูลอ้างอิงถึงไฟล์ assetlinks.json ที่โฮสต์ในเว็บไซต์ของคุณเท่านั้น

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

โปรดทราบว่านี่ไม่ใช่วิธีเดียวที่ถูกต้องในการตั้งค่า DAL สำหรับการแชร์ข้อมูลเข้าสู่ระบบ แต่วิธีนี้ช่วยให้กระบวนการเพิ่มเอนทิตีใหม่ไปยังเครือข่ายการแชร์ข้อมูลเข้าสู่ระบบเป็นไปอย่างราบรื่นในอนาคต ส่งเสริมการนำโค้ดมาใช้ซ้ำ และลดโอกาสที่จะเกิดข้อผิดพลาดระหว่างการอัปเดต