สร้างคีย์ reCAPTCHA ที่อิงตามคะแนน

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

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

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

ก่อนเริ่มต้น

โปรดอ่านข้อกำหนดและคำแนะนำเหล่านี้ก่อนสร้างคีย์ที่อิงตามคะแนน reCAPTCHAสำหรับแอปในแพลตฟอร์มต่อไปนี้ เว็บ, Android และ Apple

สิทธิ์ IAM ที่จำเป็น

ตรวจสอบว่าคุณมีบทบาท IAM ต่อไปนี้ ผู้ดูแลระบบ reCAPTCHA Enterprise (roles/recaptchaenterprise.admin)

คำแนะนำทั่วไป

คุณสร้างคีย์ reCAPTCHA สำหรับโปรเจ็กต์ Firebase ได้ไม่จำกัดจำนวน คำแนะนำทั่วไปในการสร้าง reCAPTCHAคีย์สำหรับการตั้งค่าทั่วไปสำหรับโปรเจ็กต์ Firebase มีดังนี้

  • สร้างคีย์ 1 รายการสำหรับแอป Firebase ที่ลงทะเบียนแต่ละแอป เช่น

    • หากคุณมีแอป iOS, Android และเว็บแอปที่ใช้โปรเจ็กต์ Firebase เดียวกัน โปรเจ็กต์ของคุณควรมีคีย์ 3 รายการ

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

  • สร้างคีย์แยกต่างหากสำหรับแอปเวอร์ชันพัฒนา ทดสอบ และใช้งานจริง (ตัวแปรแต่ละรายการเหล่านี้ควรใช้โปรเจ็กต์ Firebase แยกต่างหากอยู่แล้ว) ไม่เช่นนั้น คุณอาจเสี่ยงต่อการปนเปื้อนการวิเคราะห์ความเสี่ยงของ reCAPTCHA Enterprise ด้วย ข้อมูลจากสภาพแวดล้อมที่ไม่ได้ใช้งานจริง

เว็บ

หากต้องการสร้างคีย์ตามคะแนน คุณสามารถใช้Google Cloudคอนโซล gcloud CLIหรือ REST API

สำหรับเว็บไซต์ คีย์ reCAPTCHA จะไม่ซ้ำกันสำหรับโดเมนและโดเมนย่อยที่คุณระบุ คุณระบุโดเมนได้มากกว่า 1 โดเมนหากแสดง เว็บไซต์จากหลายโดเมน หากระบุโดเมน (เช่น examplepetstore.com) คุณก็ไม่ต้องระบุโดเมนย่อยของโดเมนนั้น (เช่น subdomain.examplepetstore.com)

Google Cloud คอนโซล

  1. ในGoogle Cloudคอนโซล ให้ไปที่หน้า การป้องกันการประพฤติมิชอบ (ที่ตั้งค่าคีย์ reCAPTCHA)

  2. ตรวจสอบว่าคุณอยู่ในโปรเจ็กต์ที่ถูกต้อง (ดูตัวเลือกโปรเจ็กต์ที่ด้านบนของหน้าจอ)

  3. คลิกสร้างคีย์

  4. ในช่องชื่อที่แสดง ให้ป้อนชื่อที่แสดงสำหรับคีย์

  5. สำหรับประเภทแอปพลิเคชัน ให้เลือกเว็บ

  6. หากต้องการปกป้องคีย์สำหรับโดเมนและโดเมนย่อย ให้ตรวจสอบว่าได้ปิดปุ่มเปิด/ปิดสำหรับปิดใช้การยืนยันโดเมนแล้ว

  7. ในส่วนรายการโดเมน ให้ทำดังนี้

    1. คลิกเพิ่มโดเมน

    2. ในช่องโดเมน ให้ป้อนชื่อโดเมน

    3. (ไม่บังคับ) หากต้องการเพิ่มโดเมนอื่น ให้คลิกเพิ่มโดเมน แล้ว ป้อนชื่อโดเมนอื่น

      • App Checkไม่รองรับเว็บแอปที่แสดงในโดเมนมากกว่า 250 โดเมน

      • ห้ามเพิ่ม localhost เป็นโดเมนในคีย์ reCAPTCHA ที่ใช้ (หรือจะใช้) สำหรับเวอร์ชันที่ใช้งานจริง

  8. (ไม่บังคับ) หากคุณกำลังสร้างคีย์ทดสอบสำหรับแอปที่ไม่ใช่เวอร์ชันที่ใช้งานจริง และหากต้องการระบุคะแนนที่ต้องการให้คีย์แสดงเมื่อ มีการสร้างการประเมินสำหรับคีย์ ให้ทำดังนี้

    1. คลิกขั้นตอนถัดไป (ไม่บังคับ) เพื่อเข้าถึงขั้นตอนการตั้งค่าเพิ่มเติม

    2. อย่าเปิดปุ่มสลับสำหรับคุณจะใช้การยืนยันตัวตนไหม

    3. เปิดปุ่มสลับสำหรับ คุณสร้างคีย์นี้เพื่อวัตถุประสงค์ในการทดสอบเท่านั้นใช่ไหม จากนั้นใช้ แถบเลื่อนตั้งคะแนนเพื่อระบุคะแนนระหว่าง 0 ถึง 1.0

  9. คลิกสร้างคีย์

คีย์ที่สร้างขึ้นใหม่จะแสดงในหน้าreCAPTCHAคีย์ ในคอนโซล Google Cloud

gcloud CLI

หากต้องการสร้างคีย์ตามคะแนนโดยใช้ gcloud CLI ให้ทำตาม วิธีการในเอกสารประกอบของ reCAPTCHA Enterprise

REST

หากต้องการสร้างคีย์ตามคะแนนโดยใช้ REST API ให้ทำตาม วิธีการในเอกสารประกอบของ reCAPTCHA Enterprise

Android

หากต้องการสร้างคีย์ตามคะแนน คุณสามารถใช้Google Cloudคอนโซล gcloud CLIหรือ REST API

Google Cloud คอนโซล

  1. ในGoogle Cloudคอนโซล ให้ไปที่หน้า การป้องกันการประพฤติมิชอบ (ที่ตั้งค่าคีย์ reCAPTCHA)

  2. ตรวจสอบว่าคุณอยู่ในโปรเจ็กต์ที่ถูกต้อง (ดูตัวเลือกโปรเจ็กต์ที่ด้านบนของหน้าจอ)

  3. คลิกสร้างคีย์

  4. ในช่องชื่อที่แสดง ให้ป้อนชื่อที่แสดงสำหรับคีย์

  5. ในส่วนประเภทแอปพลิเคชัน ให้เลือก Android

  6. หากต้องการปกป้องคีย์สำหรับแอป Android ให้ตรวจสอบว่าได้ปิดปุ่มเปิด/ปิดสำหรับปิดใช้การยืนยันชื่อแพ็กเกจแล้ว

  7. ในส่วนรายการแพ็กเกจ Android ให้ทำดังนี้

    1. คลิกเพิ่มแพ็กเกจ Android

    2. ในช่องแพ็กเกจ Android ให้ป้อนชื่อแพ็กเกจของแอป Android (เช่น com.example.my_app)

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

      • สำหรับ App Check ชื่อแพ็กเกจแต่ละชื่อจะสอดคล้องกับreCAPTCHAคีย์เดียวเท่านั้น

  8. หากต้องการสร้างคีย์สำหรับแอปที่พร้อมให้บริการใน App Store อื่นๆ นอกเหนือจาก Google Play Store ให้เปิดปุ่มสลับสำหรับรองรับแอปพลิเคชันที่จัดจำหน่ายภายนอก Google Play Store

  9. (ไม่บังคับ) หากคุณกำลังสร้างคีย์ทดสอบสำหรับแอปที่ไม่ใช่เวอร์ชันที่ใช้งานจริง และหากต้องการระบุคะแนนที่ต้องการให้คีย์แสดงเมื่อ มีการสร้างการประเมินสำหรับคีย์ ให้ทำดังนี้

    1. คลิกขั้นตอนถัดไป (ไม่บังคับ) เพื่อเข้าถึงขั้นตอนการตั้งค่าเพิ่มเติม

    2. อย่าเปิดปุ่มสลับสำหรับคุณจะใช้การยืนยันตัวตนไหม

    3. เปิดปุ่มสลับสำหรับ คุณสร้างคีย์นี้เพื่อวัตถุประสงค์ในการทดสอบเท่านั้นใช่ไหม จากนั้นใช้ แถบเลื่อนตั้งคะแนนเพื่อระบุคะแนนระหว่าง 0 ถึง 1.0

  10. คลิกสร้างคีย์

คีย์ที่สร้างขึ้นใหม่จะแสดงในหน้าreCAPTCHAคีย์ ในคอนโซล Google Cloud

gcloud CLI

หากต้องการสร้างคีย์ตามคะแนนโดยใช้ gcloud CLI ให้ทำตาม วิธีการในเอกสารประกอบของ reCAPTCHA Enterprise

REST

หากต้องการสร้างคีย์ตามคะแนนโดยใช้ REST API ให้ทำตาม วิธีการในเอกสารประกอบของ reCAPTCHA Enterprise

แพลตฟอร์มของ Apple

หากต้องการสร้างคีย์ตามคะแนน คุณสามารถใช้Google Cloudคอนโซล gcloud CLIหรือ REST API

Google Cloud คอนโซล

  1. ในGoogle Cloudคอนโซล ให้ไปที่หน้า การป้องกันการประพฤติมิชอบ (ที่ตั้งค่าคีย์ reCAPTCHA)

  2. ตรวจสอบว่าคุณอยู่ในโปรเจ็กต์ที่ถูกต้อง (ดูตัวเลือกโปรเจ็กต์ที่ด้านบนของหน้าจอ)

  3. คลิกสร้างคีย์

  4. ในช่องชื่อที่แสดง ให้ป้อนชื่อที่แสดงสำหรับคีย์

  5. ในส่วนประเภทแอปพลิเคชัน ให้เลือก iOS

  6. หากต้องการปกป้องคีย์สำหรับแอปแพลตฟอร์ม Apple ให้ตรวจสอบว่าได้ปิดปุ่มเปิด/ปิดปิดใช้การยืนยัน Bundle ID แล้ว

  7. ในส่วนรายการรายการรหัสชุด iOS ให้ทำดังนี้

    1. คลิกเพิ่มรหัสชุด iOS

    2. ในช่องรหัสชุด ให้ป้อนรหัสชุดของแอป (เช่น com.example.my_app)

      • ตรวจสอบว่าคุณป้อนรหัสชุดเดียวกันกับที่ระบุไว้ เมื่อสร้างแอป Firebase Apple ในโปรเจ็กต์ Firebase ค่ารหัสชุดจะคำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่

      • สำหรับ App Check รหัสชุดแต่ละรหัสจะสอดคล้องกับคีย์ reCAPTCHA ได้เพียงคีย์เดียว

    3. (ไม่บังคับ) หากต้องการเพิ่มรหัสชุดเพิ่มเติม ให้คลิก เพิ่มรหัสชุด iOS แล้วป้อนรหัสชุดอื่น

  8. ระบุการตั้งค่าสำหรับนักพัฒนาแอปของ Apple

    เราขอแนะนำให้ระบุข้อมูลนี้ เนื่องจากจะช่วยให้ reCAPTCHA Enterprise ให้คะแนนความเสี่ยงที่แม่นยำยิ่งขึ้นสำหรับ การเข้าชมของคุณ

    ป้อนข้อมูลต่อไปนี้

    • คีย์ส่วนตัว (.p8): สร้างขึ้นในศูนย์นักพัฒนาซอฟต์แวร์ของ Apple ในส่วนใบรับรอง ตัวระบุ และโปรไฟล์

    • ตัวระบุคีย์: ตัวระบุคีย์นักพัฒนาซอฟต์แวร์ของ Apple (สตริง 10 อักขระ)

    • รหัสทีม: รหัสทีม Apple (สตริงแบบ 10 อักขระ) ที่เป็นเจ้าของ โปรไฟล์การจัดสรรที่ใช้สร้างแอปพลิเคชัน

  9. (ไม่บังคับ) หากคุณกำลังสร้างคีย์ทดสอบสำหรับแอปที่ไม่ใช่เวอร์ชันที่ใช้งานจริง และหากต้องการระบุคะแนนที่ต้องการให้คีย์แสดงเมื่อ มีการสร้างการประเมินสำหรับคีย์ ให้ทำดังนี้

    1. คลิกขั้นตอนถัดไป (ไม่บังคับ) เพื่อเข้าถึงขั้นตอนการตั้งค่าเพิ่มเติม

    2. อย่าเปิดปุ่มสลับสำหรับคุณจะใช้การยืนยันตัวตนไหม

    3. เปิดปุ่มสลับสำหรับ คุณสร้างคีย์นี้เพื่อวัตถุประสงค์ในการทดสอบเท่านั้นใช่ไหม จากนั้นใช้ แถบเลื่อนตั้งคะแนนเพื่อระบุคะแนนระหว่าง 0 ถึง 1.0

  10. คลิกสร้างคีย์

คีย์ที่สร้างขึ้นใหม่จะแสดงในหน้าreCAPTCHAคีย์ ในคอนโซล Google Cloud

gcloud CLI

หากต้องการสร้างคีย์ตามคะแนนโดยใช้ gcloud CLI ให้ทำตาม วิธีการในเอกสารประกอบของ reCAPTCHA Enterprise

REST

หากต้องการสร้างคีย์ตามคะแนนโดยใช้ REST API ให้ทำตาม วิธีการในเอกสารประกอบของ reCAPTCHA Enterprise