รับรหัสไคลเอ็นต์ OAuth 2.0

ภาพรวม

หากต้องการใช้ Google Fit สำหรับ Android คุณต้องมีรหัสไคลเอ็นต์ OAuth 2.0 สำหรับแอปพลิเคชัน Android

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

รหัสไคลเอ็นต์ OAuth ของ Android จะลิงก์กับคู่ใบรับรอง/แพ็กเกจที่เจาะจง คุณต้องใช้รหัสเพียง 1 รหัสต่อใบรับรอง 1 ใบ ไม่ว่าคุณจะมีผู้ใช้กี่คนก็ตาม

การขอรหัสสำหรับแอปมีหลายขั้นตอน ขั้นตอนเหล่านี้แสดงไว้ด้านล่าง

  1. ค้นหาข้อมูลใบรับรองของแอป
  2. สร้างหรือแก้ไขโปรเจ็กต์ในคอนโซล Google API
  3. ขอรหัสไคลเอ็นต์ OAuth 2.0

ค้นหาข้อมูลใบรับรองของแอป

คีย์ API อิงตามใบรับรองดิจิทัลแบบสั้นๆ ของแอป ซึ่งเรียกว่าลายนิ้วมือ SHA-1 หากต้องการแสดงลายนิ้วมือ SHA-1 สำหรับใบรับรอง ก่อนอื่นให้ตรวจสอบว่าคุณใช้ใบรับรองที่ถูกต้อง คุณอาจมีใบรับรอง 2 ใบ ได้แก่

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

ทำตามขั้นตอนด้านล่างเพื่อแสดงลายนิ้วมือ SHA-1 ของใบรับรองโดยใช้โปรแกรม keytool ที่มีพารามิเตอร์ -v ดูข้อมูลเพิ่มเติมเกี่ยวกับ Keytool ได้ที่เอกสารประกอบของ Oracle

ใบรับรองการแก้ไขข้อบกพร่อง

การแสดงลายนิ้วมือสำหรับใบรับรองการแก้ไขข้อบกพร่อง

  1. ค้นหาไฟล์คีย์สโตร์สำหรับการแก้ไขข้อบกพร่อง ชื่อไฟล์คือ debug.keystore และสร้างขึ้นในครั้งแรกที่คุณสร้างโปรเจ็กต์ โดยค่าเริ่มต้น ระบบจะจัดเก็บไว้ในไดเรกทอรีเดียวกับไฟล์อุปกรณ์เสมือนของ Android (AVD) ดังนี้

    • macOS และ Linux: ~/.android/
    • Windows Vista และ Windows 7: C:\Users\your_user_name\.android\

  2. แสดงลายนิ้วมือ SHA-1

    • สำหรับ Linux หรือ macOS ให้เปิดหน้าต่างเทอร์มินัลแล้วป้อนข้อมูลต่อไปนี้

      keytool -list -v -keystore ~/.android/debug.keystore -alias androiddebugkey -storepass android -keypass android

    • สำหรับ Windows Vista และ Windows 7 ให้เรียกใช้

      keytool -list -v -keystore "%USERPROFILE%\.android\debug.keystore" -alias androiddebugkey -storepass android -keypass android

คุณควรเห็นเอาต์พุตในลักษณะนี้

Alias name: androiddebugkey
Creation date: Jan 01, 2013
Entry type: PrivateKeyEntry
Certificate chain length: 1
Certificate[1]:
Owner: CN=Android Debug, O=Android, C=US
Issuer: CN=Android Debug, O=Android, C=US
Serial number: 4aa9b300
Valid from: Mon Jan 01 08:04:04 UTC 2013 until: Mon Jan 01 18:04:04 PST 2033
Certificate fingerprints:
     MD5:  AE:9F:95:D0:A6:86:89:BC:A8:70:BA:34:FF:6A:AC:F9
     SHA1: BB:0D:AC:74:D3:21:E1:43:07:71:9B:62:90:AF:A1:66:6E:44:5D:75
     Signature algorithm name: SHA1withRSA
     Version: 3
ใบรับรองรุ่น

แสดงลายนิ้วมือสำหรับใบรับรองรุ่น

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

    keytool -list -keystore your_keystore_name

    แทนที่ your_keystore_name ด้วยเส้นทางและชื่อสโตร์ที่มีคุณสมบัติครบถ้วนของคีย์สโตร์ รวมถึงส่วนขยาย .keystore ระบบจะแจ้งให้คุณป้อนรหัสผ่านของคีย์สโตร์ จากนั้น keytool จะแสดงชื่อแทนทั้งหมดในคีย์สโตร์

  2. ป้อนข้อมูลต่อไปนี้ที่เทอร์มินัลหรือ Command Prompt

    keytool -list -v -keystore your_keystore_name -alias your_alias_name

    แทนที่ your_keystore_name ด้วยเส้นทางและชื่อสโตร์ที่มีคุณสมบัติครบถ้วนของคีย์สโตร์ รวมถึงส่วนขยาย .keystore แทนที่ your_alias_name ด้วยชื่อแทนที่คุณกำหนดให้กับใบรับรองเมื่อสร้างใบรับรอง

คุณควรเห็นเอาต์พุตในลักษณะนี้

Alias name: <alias_name>
Creation date: Feb 02, 2013
Entry type: PrivateKeyEntry
Certificate chain length: 1
Certificate[1]:
Owner: CN=Android Debug, O=Android, C=US
Issuer: CN=Android Debug, O=Android, C=US
Serial number: 4cc9b300
Valid from: Mon Feb 02 08:01:04 UTC 2013 until: Mon Feb 02 18:05:04 PST 2033
Certificate fingerprints:
    MD5:  AE:9F:95:D0:A6:86:89:BC:A8:70:BA:34:FF:6B:AC:F9
    SHA1: BB:0D:AC:74:D3:21:E1:43:67:71:9B:62:90:AF:A1:66:6E:44:5D:75
    Signature algorithm name: SHA1withRSA
    Version: 3

บรรทัดที่เริ่มต้นด้วย SHA1 มีลายนิ้วมือ SHA-1 ของใบรับรอง ลายนิ้วมือคือลำดับของตัวเลขฐานสิบหก 2 หลัก ที่คั่นด้วยโคลอน

ขอรหัสไคลเอ็นต์ OAuth 2.0 ในคอนโซล Google API

ทำตามขั้นตอนต่อไปนี้เพื่อสร้างหรือแก้ไขโปรเจ็กต์สำหรับแอปใน คอนโซล Google API, เปิดใช้ Fitness API และขอรหัสไคลเอ็นต์ OAuth 2.0

หากคุณต้องการคำแนะนำตลอดกระบวนการและเปิดใช้งาน Fitness API โดยอัตโนมัติ ให้คลิก

รับรหัสไคลเอ็นต์

หรือทำตามขั้นตอนเหล่านี้เพื่อเปิดใช้ฟิตเนส API ในคอนโซล Google API และรับรหัสไคลเอ็นต์ OAuth 2.0

  1. ไปที่ คอนโซล Google API
  2. เลือกโปรเจ็กต์ หรือสร้างโปรเจ็กต์ใหม่ ใช้โปรเจ็กต์เดียวกันสำหรับแอปเวอร์ชัน Android และ REST
  3. คลิกต่อไปเพื่อเปิดใช้ Fitness API
  4. คลิกไปที่ข้อมูลเข้าสู่ระบบ
  5. คลิกข้อมูลเข้าสู่ระบบใหม่ แล้วเลือกรหัสไคลเอ็นต์ OAuth
  6. ในส่วนประเภทแอปพลิเคชัน ให้เลือก Android

  7. ในกล่องโต้ตอบที่แสดง ให้ป้อนลายนิ้วมือ SHA-1 และชื่อแพ็กเกจของแอป เช่น

    BB:0D:AC:74:D3:21:E1:43:67:71:9B:62:91:AF:A1:66:6E:44:5D:75

    com.example.android.fit-example

  8. คลิกสร้าง รหัสไคลเอ็นต์และข้อมูลลับ OAuth 2.0 ของ Android ใหม่จะปรากฏในรายการรหัสสำหรับโปรเจ็กต์ของคุณ รหัสไคลเอ็นต์ OAuth 2.0 เป็นสตริงอักขระที่มีลักษณะเช่นนี้

    780816631155-gbvyo1o7r2pn95qc4ei9d61io4uh48hl.apps.googleusercontent.com