Method: challenge.verify

request.verify API

คำขอ HTTP

POST https://verifiedaccess.googleapis.com/v1/challenge:verify

URL ใช้ไวยากรณ์การแปลง gRPC

เนื้อหาของคำขอ

เนื้อหาของคำขอมีข้อมูลซึ่งมีโครงสร้างต่อไปนี้

การแสดง JSON 
{
  "challengeResponse": {
    object (SignedData)
  },
  "expectedIdentity": string
}
ช่อง
challengeResponse

object (SignedData)

คำตอบที่สร้างขึ้นสำหรับคำท้า
expectedIdentity

string

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

เนื้อหาการตอบกลับ

ข้อความผลลัพธ์ของ VerifiedAccess.VerifyChallengeResponse

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON 
{
  "verificationOutput": string,
  "devicePermanentId": string,
  "signedPublicKeyAndChallenge": string,
  "deviceEnrollmentId": string,
  "attestedDeviceId": string
}
ช่อง
verificationOutput
(deprecated)

string

สำหรับการตรวจสอบ EMCert ระบบจะส่งคืนรหัสถาวรของอุปกรณ์ที่นี่ สำหรับการตรวจสอบ EUCert จะส่งคืนsignedPublicKeyAndChallenge [base64 encrypted] หากมีอยู่ ไม่เช่นนั้นจะส่งกลับสตริงที่ว่างเปล่า ช่องนี้เลิกใช้งานแล้ว โปรดใช้ช่อง devicePermanentId หรือsignedPublicKeyAndChallenge
devicePermanentId

string

ระบบจะส่งรหัสถาวรของอุปกรณ์กลับมาในช่องนี้ (สำหรับการตอบกลับของเครื่องเท่านั้น)
signedPublicKeyAndChallenge

string

คำขอลงชื่อใบรับรอง (ในรูปแบบ SPKAC เข้ารหัส base64) ส่งคืนในช่องนี้ ระบบจะตั้งค่าช่องนี้เฉพาะเมื่ออุปกรณ์มี CSR ในการตอบคำถามเท่านั้น (ขณะนี้ตัวเลือกในการรวม CSR พร้อมใช้งานแล้วทั้งสำหรับการตอบกลับของผู้ใช้และคอมพิวเตอร์)
deviceEnrollmentId

string

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

string

รหัสอุปกรณ์ (ADID) ที่ผ่านการรับรองของอุปกรณ์ อ่านจากข้อมูลที่ยืนยันแล้ว

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/verifiedaccess

ดูข้อมูลเพิ่มเติมได้ที่ภาพรวมการตรวจสอบสิทธิ์