การยืนยันไคลเอ็นต์ OAuth

ไคลเอ็นต์ OAuth ของ Google ที่ขอขอบเขต OAuth ที่มีความละเอียดอ่อนบางอย่างจะต้องได้รับการยืนยันจาก Google

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

สำหรับข้อมูลเพิ่มเติม โปรดอ่านบทความต่อไปนี้

 

หน้าจอแอปที่ยังไม่ได้รับการยืนยัน
ภาพที่ 1: หน้าจอแอปที่ยังไม่ได้รับการยืนยัน
ขั้นตอนการให้สิทธิ์แอปที่ไม่ได้รับการยืนยัน
ภาพที่ 2: ขั้นตอนการให้สิทธิ์แอปที่ยังไม่ได้รับการยืนยัน

 

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

แอปที่ไม่ได้รับการยืนยัน

ส่วนเสริม เว็บแอป และการติดตั้งใช้งานอื่นๆ (เช่น แอปที่ใช้ Apps Script API) อาจต้องได้รับการยืนยัน

ประโยชน์ต่อการให้บริการ

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

ตารางต่อไปนี้แสดงสถานการณ์ที่ทำให้เกิดขั้นตอนการให้สิทธิ์แอปที่ไม่ได้รับการยืนยัน

ยืนยันลูกค้าแล้ว ผู้เผยแพร่โฆษณาเป็นบัญชี Google Workspace ของลูกค้า ก สคริปต์อยู่ในไดรฟ์ที่แชร์ของลูกค้า A ผู้เผยแพร่โฆษณาเป็นบัญชี Gmail
ผู้ใช้เป็นบัญชี Google Workspace ของลูกค้า ก ขั้นตอนการตรวจสอบสิทธิ์ปกติ ขั้นตอนการตรวจสอบสิทธิ์ปกติ ขั้นตอนการตรวจสอบสิทธิ์ปกติ ขั้นตอนการตรวจสอบสิทธิ์ที่ไม่ได้รับการยืนยัน
ผู้ใช้เป็นบัญชี Google Workspace ที่ไม่ใช่ของลูกค้า ก ขั้นตอนการตรวจสอบสิทธิ์ปกติ ขั้นตอนการตรวจสอบสิทธิ์ที่ไม่ได้รับการยืนยัน ขั้นตอนการตรวจสอบสิทธิ์ที่ไม่ได้รับการยืนยัน ขั้นตอนการตรวจสอบสิทธิ์ที่ไม่ได้รับการยืนยัน
ผู้ใช้เป็นบัญชี Gmail1 ขั้นตอนการตรวจสอบสิทธิ์ปกติ ขั้นตอนการตรวจสอบสิทธิ์ที่ไม่ได้รับการยืนยัน ขั้นตอนการตรวจสอบสิทธิ์ที่ไม่ได้รับการยืนยัน ขั้นตอนการตรวจสอบสิทธิ์ที่ไม่ได้รับการยืนยัน

1บัญชี Gmail ทั้งหมด รวมถึงบัญชีที่ใช้เผยแพร่แอป

จำนวนผู้ใช้สูงสุด

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

กำลังขอการยืนยัน

คุณสามารถขอรับการยืนยันไคลเอ็นต์ OAuth ที่แอปและโปรเจ็กต์ Cloud Platform (GCP) ที่เชื่อมโยงใช้อยู่ได้ เมื่อแอปได้รับการยืนยันแล้ว ผู้ใช้จะไม่เห็นหน้าจอแอปที่ไม่ได้รับการยืนยันอีกต่อไป นอกจากนี้ แอปของคุณจะไม่อยู่ภายใต้ จํานวนผู้ใช้สูงสุดอีกต่อไป

ข้อกำหนด

หากต้องการส่งไคลเอ็นต์ OAuth เพื่อรับการยืนยัน คุณต้องปฏิบัติตามข้อกำหนดต่อไปนี้

  1. คุณต้องเป็นเจ้าของเว็บไซต์ในโดเมน เว็บไซต์ต้องโฮสต์หน้าที่เข้าถึงได้แบบสาธารณะซึ่งอธิบายแอปของคุณและนโยบายความเป็นส่วนตัวของแอป และคุณยังต้องยืนยันการเป็นเจ้าของเว็บไซต์กับ Google ด้วย

  2. โปรเจ็กต์ Google Cloud ที่โปรเจ็กต์สคริปต์ใช้ต้องเป็นโปรเจ็กต์ Google Cloud มาตรฐานที่คุณมีสิทธิ์เข้าถึงเพื่อแก้ไข หากสคริปต์ใช้โปรเจ็กต์ Google Cloud เริ่มต้นอยู่ คุณต้องเปลี่ยนเป็นโปรเจ็กต์ Google Cloud มาตรฐาน

นอกจากนี้ คุณต้องมีชิ้นงานที่จำเป็นต่อไปนี้

  • ชื่อแอปพลิเคชัน ชื่อของแอป ซึ่งจะแสดงในหน้าจอคำยินยอม และควรตรงกับชื่อที่ใช้สำหรับแอปในประเทศอื่นๆ เช่น รายชื่อ Google Workspace Marketplace สำหรับแอปที่เผยแพร่
  • โลโก้แอปพลิเคชัน รูปภาพโลโก้แอป JPEG, PNG หรือ BMP ที่จะใช้ในหน้าจอความยินยอม ไฟล์ต้องมีขนาดไม่เกิน 1 MB
  • อีเมลทีมสนับสนุน อีเมลนี้เป็นอีเมลที่จะปรากฏบนหน้าจอคำยินยอม เพื่อให้ผู้ใช้ติดต่อเมื่อต้องการการสนับสนุนของแอป ซึ่งอาจเป็นที่อยู่อีเมลของคุณหรือ Google Group ที่คุณเป็นเจ้าของหรือจัดการอยู่ก็ได้
  • ขอบเขต รายการขอบเขตทั้งหมดที่แอปของคุณใช้ คุณดูขอบเขตได้ในเครื่องมือแก้ไข Apps Script
  • โดเมนที่ได้รับอนุญาต นี่คือรายการโดเมนที่มีข้อมูลเกี่ยวกับแอปของคุณ ลิงก์ทั้งหมดของแอปพลิเคชัน (เช่น หน้านโยบายความเป็นส่วนตัวที่กำหนด) ต้องโฮสต์ในโดเมนที่ได้รับอนุญาต
  • URL หน้าแรกของแอปพลิเคชัน ตำแหน่งของหน้าแรกที่อธิบายแอปของคุณ สถานที่นี้ต้องโฮสต์ในโดเมนที่ได้รับอนุญาต
  • URL นโยบายความเป็นส่วนตัวของแอปพลิเคชัน ตำแหน่งของหน้าที่อธิบาย นโยบายความเป็นส่วนตัวของแอป สถานที่ตั้งนี้ต้องโฮสต์ในโดเมนที่ได้รับอนุญาต

นอกเหนือจากเนื้อหาที่จำเป็นข้างต้นแล้ว คุณยังระบุ URL ข้อกำหนดในการให้บริการของแอปพลิเคชันที่ชี้ไปยังหน้าที่อธิบายข้อกำหนดในการให้บริการของแอปได้อีกด้วย หากระบุ ตำแหน่งที่ตั้งนี้ต้องอยู่ในโดเมนที่ได้รับอนุญาต

ขั้นตอน

  1. หากยังไม่ได้ดำเนินการ ให้ยืนยันการเป็นเจ้าของโดเมนที่ได้รับอนุญาตทั้งหมดที่คุณใช้เพื่อโฮสต์นโยบายความเป็นส่วนตัวและข้อมูลอื่นๆ ของโปรเจ็กต์สคริปต์ เจ้าของที่ได้รับการยืนยันของโดเมนต้องเป็นผู้แก้ไขหรือเจ้าของโปรเจ็กต์สคริปต์
  2. ในโปรเจ็กต์ Apps Script ให้คลิกภาพรวม ในส่วนขอบเขต OAuth ของโปรเจ็กต์ ให้คัดลอกขอบเขตที่โปรเจ็กต์สคริปต์ใช้
  3. กรอกหน้าจอขอความยินยอม OAuth สําหรับโปรเจ็กต์ Google Cloud ของแอปพลิเคชันโดยใช้เนื้อหาข้อความและ URL ที่คุณรวบรวม

    1. ระบุโดเมนที่ได้รับอนุญาตซึ่งเป็นที่ที่โฮสต์ข้อมูลแอป (เช่น นโยบายความเป็นส่วนตัว)
    2. หากต้องการเพิ่มขอบเขตแอปพลิเคชัน ให้คลิกเพิ่มหรือนำขอบเขตออก กล่องโต้ตอบที่ปรากฏขึ้นจะพยายามตรวจหาขอบเขตโดยอัตโนมัติสำหรับ API ที่คุณเปิดใช้ในคอนโซล Google Cloud (เช่น บริการขั้นสูง) คุณเลือกขอบเขตจากรายการนี้ได้โดยเลือกช่องที่เกี่ยวข้อง

      รายการที่ตรวจหาอัตโนมัตินี้ไม่ได้รวมขอบเขตที่บริการในตัวของ Apps Script ใช้เสมอไป คุณต้องป้อนขอบเขตเหล่านี้ในส่วนเพิ่มขอบเขตด้วยตนเอง

      เมื่อเสร็จแล้ว ให้คลิกอัปเดต

  4. เมื่อป้อนข้อมูลที่จำเป็นทั้งหมดแล้ว ให้คลิกบันทึก

  5. คลิกส่งเพื่อขอรับการยืนยันเพื่อเริ่มส่งคําขอยืนยัน

คำขอการยืนยันส่วนใหญ่จะได้รับการตอบกลับภายใน 24-72 ชั่วโมง ตรวจสอบสถานะการยืนยันได้ที่ด้านบนของแบบฟอร์มความยินยอม OAuth เมื่อการยืนยันไคลเอ็นต์ OAuth แล้ว แอปจะได้รับการยืนยัน