- คำขอ HTTP
- เนื้อความของคำขอ
- เนื้อหาการตอบกลับ
- ขอบเขตการให้สิทธิ์
- DeviceSignals
- OperatingSystem
- DiskEncryption
- OsFirewall
- ScreenLockSecured
- SecureBootMode
- SafeBrowsingProtectionLevel
- PasswordProtectionWarningTrigger
- RealtimeUrlCheckMode
- CrowdStrikeAgent
- ทริกเกอร์
- โปรแกรมป้องกันไวรัส
- สถานะ
- KeyTrustLevel
ยืนยันคำตอบของภารกิจ
คำขอ HTTP
POST https://verifiedaccess.googleapis.com/v2/challenge:verify
URL ใช้ไวยากรณ์การแปลง gRPC
เนื้อหาของคำขอ
เนื้อความของคำขอมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้
การแสดง JSON |
---|
{ "challengeResponse": string, "expectedIdentity": string } |
ช่อง | |
---|---|
challengeResponse |
ต้องระบุ การตอบกลับที่สร้างขึ้นเพื่อยืนยันตัวตน ซึ่งเป็นการนำเสนอ SignedData เป็นไบต์ สตริงที่เข้ารหัส Base64 |
expectedIdentity |
ไม่บังคับ บริการอาจระบุข้อมูลระบุตัวตนเกี่ยวกับอุปกรณ์หรือผู้ใช้ที่เชื่อมโยงกับคีย์ สำหรับ EMK ค่านี้คือโดเมนที่ลงทะเบียน สำหรับ EUK ค่านี้คืออีเมลของผู้ใช้ หากมี ระบบจะตรวจสอบค่านี้กับเนื้อหาของคำตอบ และยืนยันไม่สำเร็จหากไม่พบรายการที่ตรงกัน |
เนื้อหาการตอบกลับ
ข้อความผลลัพธ์สําหรับ VerifiedAccess.VerifyChallengeResponse
การตอบกลับที่แสดงเมื่อโปรไฟล์ที่จัดการในเบราว์เซอร์ที่ไม่ได้รับการจัดการดำเนินการเสร็จสมบูรณ์จะไม่มีช่อง devicePermanentId, keyTrustLevel, virtualDeviceId และ customerId โปรไฟล์ที่มีการจัดการจะมีช่อง profileCustomerId, virtualProfileId, profilePermanentId และ profileKeyTrustLevel แทน
หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้
การแสดง JSON |
---|
{ "devicePermanentId": string, "virtualDeviceId": string, "customerId": string, "signedPublicKeyAndChallenge": string, "deviceSignal": string, "deviceSignals": { object ( |
ช่อง | |
---|---|
devicePermanentId |
เอาต์พุตเท่านั้น ระบบจะแสดงรหัสถาวรของอุปกรณ์ในช่องนี้ (สำหรับการตอบกลับจากเครื่องเท่านั้น) |
virtualDeviceId |
เอาต์พุตเท่านั้น รหัสอุปกรณ์เสมือนจริงของอุปกรณ์ คําจํากัดความของรหัสอุปกรณ์เสมือนจริงจะแตกต่างกันไปตามแพลตฟอร์ม |
customerId |
เอาต์พุตเท่านั้น รหัสลูกค้าที่ไม่ซ้ำกันซึ่งอุปกรณ์นี้เป็นเจ้าของตามที่ Google Admin SDK กำหนดไว้ที่ https://developers.google.com/admin-sdk/directory/v1/guides/manage-customers |
signedPublicKeyAndChallenge |
เอาต์พุตเท่านั้น ระบบจะแสดงคำขอการรับรองใบรับรอง (ในรูปแบบ SPKAC ซึ่งเข้ารหัส Base64) ในช่องนี้ ระบบจะตั้งค่าช่องนี้เฉพาะในกรณีที่อุปกรณ์รวม CSR ไว้ในคำตอบของคำขอยืนยันเท่านั้น (ตอนนี้ตัวเลือกในการรวม CSR พร้อมใช้งานสำหรับทั้งคำตอบของผู้ใช้และคำตอบจากเครื่องแล้ว) |
deviceSignal |
เอาต์พุตเท่านั้น เลิกใช้งานแล้ว สัญญาณของอุปกรณ์ในการแสดงสตริง JSON โปรดใช้ |
deviceSignals |
เอาต์พุตเท่านั้น สัญญาณของอุปกรณ์ |
keyTrustLevel |
เอาต์พุตเท่านั้น ระดับความน่าเชื่อถือของคีย์ที่รับรองโดยอุปกรณ์ |
profileCustomerId |
เอาต์พุตเท่านั้น รหัสลูกค้าที่ไม่ซ้ำกันซึ่งโปรไฟล์นี้เป็นเจ้าของตามที่ Google Admin SDK กำหนดไว้ที่ https://developers.google.com/admin-sdk/directory/v1/guides/manage-customers |
virtualProfileId |
เอาต์พุตเท่านั้น รหัสโปรไฟล์ในอุปกรณ์ที่ไคลเอ็นต์ระบุ |
profilePermanentId |
เอาต์พุตเท่านั้น รหัสที่ไม่ซ้ำกันฝั่งเซิร์ฟเวอร์ของโปรไฟล์ในอุปกรณ์ |
profileKeyTrustLevel |
เอาต์พุตเท่านั้น ระดับความน่าเชื่อถือของคีย์ที่รับรองโดยโปรไฟล์ |
attestedDeviceId |
เอาต์พุตเท่านั้น รหัสอุปกรณ์ที่ผ่านการรับรอง (ADID) |
deviceEnrollmentId |
เอาต์พุตเท่านั้น รหัสการลงทะเบียนอุปกรณ์สำหรับอุปกรณ์ ChromeOS |
ขอบเขตการให้สิทธิ์
ต้องใช้ขอบเขต OAuth ต่อไปนี้
https://www.googleapis.com/auth/verifiedaccess
ดูข้อมูลเพิ่มเติมได้ที่ OAuth 2.0 Overview
DeviceSignals
สัญญาณของอุปกรณ์ตามที่ Chrome รายงาน สัญญาณจะพร้อมใช้งานในทุกแพลตฟอร์ม เว้นแต่จะระบุไว้เป็นอย่างอื่น
การแสดง JSON |
---|
{ "deviceManufacturer": string, "deviceModel": string, "operatingSystem": enum ( |
ช่อง | |
---|---|
deviceManufacturer |
เอาต์พุตเท่านั้น ชื่อผู้ผลิตของอุปกรณ์ |
deviceModel |
เอาต์พุตเท่านั้น ชื่อรุ่นของอุปกรณ์ |
operatingSystem |
เอาต์พุตเท่านั้น ประเภทของระบบปฏิบัติการที่ทำงานอยู่ในอุปกรณ์ |
osVersion |
เอาต์พุตเท่านั้น เวอร์ชันปัจจุบันของระบบปฏิบัติการ ใน Windows และ Linux ค่าดังกล่าวจะมีข้อมูลแพตช์ความปลอดภัยด้วย |
displayName |
เอาต์พุตเท่านั้น ชื่อที่แสดงของอุปกรณ์ตามที่ผู้ใช้กำหนด |
diskEncryption |
เอาต์พุตเท่านั้น สถานะการเข้ารหัสของดิสก์ ใน ChromeOS ดิสก์หลักจะเข้ารหัสอยู่เสมอ |
serialNumber |
เอาต์พุตเท่านั้น หมายเลขซีเรียลของอุปกรณ์ ใน Windows ข้อมูลนี้จะแสดงหมายเลขซีเรียลของ BIOS ไม่พร้อมใช้งานในระบบปฏิบัติการ Linux ส่วนใหญ่ |
osFirewall |
เอาต์พุตเท่านั้น สถานะของไฟร์วอลล์ระดับระบบปฏิบัติการ ใน ChromeOS ค่าจะเป็น "เปิดใช้" เสมอในอุปกรณ์ปกติและ "ไม่ทราบ" ในอุปกรณ์ที่อยู่ในโหมดนักพัฒนาซอฟต์แวร์ การรองรับ macOS 15 (Sequoia) ขึ้นไปได้เปิดตัวใน Chrome M131 |
systemDnsServers[] |
รายการที่อยู่ของเซิร์ฟเวอร์ DNS ระดับระบบปฏิบัติการทั้งหมดที่กำหนดค่าไว้ในการตั้งค่าเครือข่ายของอุปกรณ์ |
hostname |
ชื่อโฮสต์ของอุปกรณ์ |
macAddresses[] |
เอาต์พุตเท่านั้น ที่อยู่ MAC ของอุปกรณ์ |
screenLockSecured |
เอาต์พุตเท่านั้น สถานะการป้องกันด้วยรหัสผ่านของหน้าจอล็อก ใน ChromeOS ค่านี้จะเปิดใช้อยู่เสมอ เนื่องจากไม่มีวิธีปิดใช้การกําหนดให้ต้องใช้รหัสผ่านหรือ PIN เมื่อปลดล็อกอุปกรณ์ |
allowScreenLock |
เอาต์พุตเท่านั้น ค่าของนโยบาย AllowScreenLock ในอุปกรณ์ ดูรายละเอียดเพิ่มเติมได้ที่ https://chromeenterprise.google/policies/?policy=AllowScreenLock ใช้ได้ใน ChromeOS เท่านั้น |
imei[] |
เอาต์พุตเท่านั้น หมายเลข International Mobile Equipment Identity (IMEI) ของอุปกรณ์ ใช้ได้ใน ChromeOS เท่านั้น |
meid[] |
เอาต์พุตเท่านั้น เลขประจำอุปกรณ์เคลื่อนที่ (Mobile Equipment Identifier) ของอุปกรณ์ ใช้ได้ใน ChromeOS เท่านั้น |
secureBootMode |
เอาต์พุตเท่านั้น ซอฟต์แวร์เริ่มต้นของอุปกรณ์เปิดใช้ฟีเจอร์การบูตอย่างปลอดภัยหรือไม่ พร้อมให้ใช้งานใน Windows เท่านั้น |
windowsMachineDomain |
เอาต์พุตเท่านั้น โดเมน Windows ที่เครื่องปัจจุบันเข้าร่วม พร้อมให้ใช้งานใน Windows เท่านั้น |
windowsUserDomain |
เอาต์พุตเท่านั้น โดเมน Windows สำหรับผู้ใช้ระบบปฏิบัติการปัจจุบัน พร้อมให้ใช้งานใน Windows เท่านั้น |
deviceEnrollmentDomain |
เอาต์พุตเท่านั้น โดเมนการลงทะเบียนของลูกค้าที่จัดการอุปกรณ์อยู่ในปัจจุบัน |
browserVersion |
เอาต์พุตเท่านั้น เวอร์ชันปัจจุบันของเบราว์เซอร์ Chrome ที่สร้างชุดสัญญาณนี้ ตัวอย่างค่า: "107.0.5286.0" |
deviceAffiliationIds[] |
เอาต์พุตเท่านั้น รหัสการเชื่อมโยงขององค์กรที่เชื่อมโยงกับองค์กรที่จัดการอุปกรณ์อยู่ในปัจจุบัน เมื่อชุดรหัสการเชื่อมโยงของอุปกรณ์และโปรไฟล์ทับซ้อนกัน หมายความว่าองค์กรที่จัดการอุปกรณ์และผู้ใช้มีความเกี่ยวข้องกัน ดูข้อมูลเพิ่มเติมเกี่ยวกับการเชื่อมโยงผู้ใช้ได้ที่ https://support.google.com/chrome/a/answer/12801245?ref_topic=9027936 |
profileAffiliationIds[] |
เอาต์พุตเท่านั้น รหัสการเชื่อมโยงขององค์กรที่เกี่ยวข้องซึ่งเชื่อมโยงกับองค์กรที่จัดการผู้ใช้โปรไฟล์ Chrome หรือผู้ใช้ ChromeOS อยู่ในปัจจุบัน |
builtInDnsClientEnabled |
เอาต์พุตเท่านั้น การใช้ไคลเอ็นต์ DNS ในตัว Chrome ไม่เช่นนั้นระบบจะใช้ไคลเอ็นต์ DNS ของระบบปฏิบัติการ ค่านี้อาจควบคุมโดยนโยบายขององค์กร https://chromeenterprise.google/policies/#BuiltInDnsClientEnabled |
chromeRemoteDesktopAppBlocked |
เอาต์พุตเท่านั้น มีการบล็อกการเข้าถึงแอปพลิเคชัน Chrome Remote Desktop ผ่านนโยบายหรือไม่ |
safeBrowsingProtectionLevel |
เอาต์พุตเท่านั้น ระดับการป้องกันของ Google Safe Browsing การตั้งค่าดังกล่าวอาจควบคุมโดยนโยบายขององค์กร https://chromeenterprise.google/policies/#SafeBrowsingProtectionLevel |
siteIsolationEnabled |
เอาต์พุตเท่านั้น การตั้งค่าการแยกเว็บไซต์ (หรือที่เรียกว่าเว็บไซต์ต่อกระบวนการ) เปิดใช้อยู่หรือไม่ การตั้งค่าดังกล่าวอาจควบคุมโดยนโยบายขององค์กร https://chromeenterprise.google/policies/#SitePerProcess |
passwordProtectionWarningTrigger |
เอาต์พุตเท่านั้น ฟีเจอร์คำเตือนเพื่อการป้องกันรหัสผ่านเปิดใช้อยู่หรือไม่ การปกป้องรหัสผ่านจะแจ้งเตือนผู้ใช้เมื่อใช้รหัสผ่านที่มีการปกป้องซ้ำในเว็บไซต์ที่น่าสงสัย การตั้งค่านี้ควบคุมโดยนโยบายองค์กร: https://chromeenterprise.google/policies/#PasswordProtectionWarningTrigger โปรดทราบว่าการไม่ได้ตั้งค่านโยบายไว้จะไม่มีผลเหมือนกับการตั้งค่านโยบายเป็น |
realtimeUrlCheckMode |
เอาต์พุตเท่านั้น การเปิดใช้การสแกน URL ที่ไม่เป็นอันตรายระดับองค์กร (เช่น ที่กำหนดเอง) หรือไม่ การตั้งค่านี้อาจควบคุมโดยนโยบายขององค์กร: https://chromeenterprise.google/policies/#EnterpriseRealTimeUrlCheckMode |
thirdPartyBlockingEnabled |
เอาต์พุตเท่านั้น เลิกใช้งานแล้ว นโยบายที่เกี่ยวข้องจึงเลิกใช้งานแล้ว ระบุว่า Chrome บล็อกการแทรกซอฟต์แวร์ของบุคคลที่สามหรือไม่ การตั้งค่านี้อาจควบคุมโดยนโยบายขององค์กร: https://chromeenterprise.google/policies/?policy=ThirdPartyBlockingEnabled พร้อมให้ใช้งานใน Windows เท่านั้น |
trigger |
เอาต์พุตเท่านั้น ทริกเกอร์ที่สร้างชุดสัญญาณนี้ |
profileEnrollmentDomain |
เอาต์พุตเท่านั้น โดเมนการลงทะเบียนของลูกค้าที่จัดการโปรไฟล์อยู่ในปัจจุบัน |
antivirus |
เอาต์พุตเท่านั้น ข้อมูลเกี่ยวกับซอฟต์แวร์ป้องกันไวรัสในอุปกรณ์ พร้อมให้ใช้งานใน Windows เท่านั้น |
crowdStrikeAgent |
เอาต์พุตเท่านั้น พร็อพเพอร์ตี้ของตัวแทน Crowdstrike ที่ติดตั้งในอุปกรณ์ (หากมี) ใช้ได้ใน Windows และ MacOS เท่านั้น |
ระบบปฏิบัติการ
ระบบปฏิบัติการที่รองรับ
Enum | |
---|---|
OPERATING_SYSTEM_UNSPECIFIED |
ไม่ระบุ |
CHROME_OS |
ChromeOS |
CHROMIUM_OS |
ChromiumOS |
WINDOWS |
Windows |
MAC_OS_X |
Mac OS X |
LINUX |
Linux |
DiskEncryption
สถานะการเข้ารหัสที่เป็นไปได้สำหรับดิสก์หลัก
Enum | |
---|---|
DISK_ENCRYPTION_UNSPECIFIED |
ไม่ระบุ |
DISK_ENCRYPTION_UNKNOWN |
Chrome ประเมินสถานะการเข้ารหัสไม่ได้ |
DISK_ENCRYPTION_DISABLED |
ดิสก์หลักไม่ได้เข้ารหัส |
DISK_ENCRYPTION_ENCRYPTED |
ดิสก์หลักได้รับการเข้ารหัสแล้ว |
OsFirewall
สถานะที่เป็นไปได้ของไฟร์วอลล์ระดับระบบปฏิบัติการ
Enum | |
---|---|
OS_FIREWALL_UNSPECIFIED |
ไม่ระบุ |
OS_FIREWALL_UNKNOWN |
Chrome ประเมินสถานะไฟร์วอลล์ของระบบปฏิบัติการไม่ได้ |
OS_FIREWALL_DISABLED |
ไฟร์วอลล์ของระบบปฏิบัติการปิดอยู่ |
OS_FIREWALL_ENABLED |
ไฟร์วอลล์ของระบบปฏิบัติการเปิดใช้งานอยู่ |
ScreenLockSecured
สถานะการป้องกันด้วยรหัสผ่านของการล็อกหน้าจอที่เป็นไปได้
Enum | |
---|---|
SCREEN_LOCK_SECURED_UNSPECIFIED |
ไม่ระบุ |
SCREEN_LOCK_SECURED_UNKNOWN |
Chrome ประเมินสถานะกลไกการล็อกหน้าจอไม่ได้ |
SCREEN_LOCK_SECURED_DISABLED |
การล็อกหน้าจอไม่ได้ป้องกันด้วยรหัสผ่าน |
SCREEN_LOCK_SECURED_ENABLED |
การล็อกหน้าจอได้รับการปกป้องด้วยรหัสผ่าน |
SecureBootMode
สถานะที่เป็นไปได้ของโหมดการบูตที่ปลอดภัยของอุปกรณ์
Enum | |
---|---|
SECURE_BOOT_MODE_UNSPECIFIED |
ไม่ระบุ |
SECURE_BOOT_MODE_UNKNOWN |
Chrome ไม่สามารถระบุโหมดการบูตที่ปลอดภัย |
SECURE_BOOT_MODE_DISABLED |
ปิดใช้ Secure Boot ในซอฟต์แวร์เริ่มต้น |
SECURE_BOOT_MODE_ENABLED |
การเปิดเครื่องที่ปลอดภัยเปิดใช้ในซอฟต์แวร์เริ่มต้น |
SafeBrowsingProtectionLevel
ค่าที่เป็นไปได้สำหรับระดับการป้องกันของ Google Safe Browsing
Enum | |
---|---|
SAFE_BROWSING_PROTECTION_LEVEL_UNSPECIFIED |
ไม่ระบุ |
INACTIVE |
Google Safe Browsing ถูกปิดใช้ |
STANDARD |
Google Safe Browsing ทำงานในโหมดมาตรฐาน |
ENHANCED |
Google Safe Browsing ทำงานในโหมดเพิ่มประสิทธิภาพ |
PasswordProtectionWarningTrigger
ค่าที่เป็นไปได้สำหรับทริกเกอร์คำเตือนให้ใช้รหัสผ่านป้องกัน
Enum | |
---|---|
PASSWORD_PROTECTION_WARNING_TRIGGER_UNSPECIFIED |
ไม่ระบุ |
POLICY_UNSET |
ไม่ได้ตั้งค่านโยบาย |
PASSWORD_PROTECTION_OFF |
จะไม่มีการแสดงคำเตือนเพื่อการป้องกันรหัสผ่าน |
PASSWORD_REUSE |
คำเตือนให้ปกป้องรหัสผ่านจะแสดงขึ้นหากมีการใช้รหัสผ่านที่ได้รับการปกป้องซ้ำ |
PHISHING_REUSE |
คำเตือนให้ปกป้องรหัสผ่านจะแสดงขึ้นหากมีการใช้รหัสผ่านที่ได้รับการปกป้องซ้ำในเว็บไซต์ฟิชชิงที่รู้จัก |
RealtimeUrlCheckMode
ค่าที่เป็นไปได้สำหรับโหมดการตรวจสอบ URL แบบเรียลไทม์
Enum | |
---|---|
REALTIME_URL_CHECK_MODE_UNSPECIFIED |
ไม่ระบุ |
REALTIME_URL_CHECK_MODE_DISABLED |
ปิดใช้อยู่ ระบบจะใช้การตรวจสอบ Google Safe Browsing สำหรับผู้บริโภค |
REALTIME_URL_CHECK_MODE_ENABLED_MAIN_FRAME |
เปิดใช้การตรวจสอบ URL ในเฟรมหลักแบบเรียลไทม์อยู่ |
CrowdStrikeAgent
พร็อพเพอร์ตี้ของตัวแทน CrowdStrike ที่ติดตั้งในอุปกรณ์
การแสดง JSON |
---|
{ "agentId": string, "customerId": string } |
ช่อง | |
---|---|
agentId |
เอาต์พุตเท่านั้น รหัสตัวแทนของตัวแทน Crowdstrike |
customerId |
เอาต์พุตเท่านั้น รหัสลูกค้าของตัวแทน |
ทริกเกอร์
ค่าที่เป็นไปได้สำหรับทริกเกอร์
Enum | |
---|---|
TRIGGER_UNSPECIFIED |
ไม่ระบุ |
TRIGGER_BROWSER_NAVIGATION |
เมื่อไปยัง URL ภายในเบราว์เซอร์ |
TRIGGER_LOGIN_SCREEN |
เมื่อลงชื่อเข้าใช้บัญชีในหน้าจอการเข้าสู่ระบบ ChromeOS |
ป้องกันไวรัส
ข้อมูลโปรแกรมป้องกันไวรัสในอุปกรณ์
การแสดง JSON |
---|
{
"state": enum ( |
ช่อง | |
---|---|
state |
เอาต์พุตเท่านั้น สถานะของโปรแกรมป้องกันไวรัสในอุปกรณ์ เปิดตัวใน Chrome M136 |
รัฐ
สถานะโปรแกรมป้องกันไวรัสที่เป็นไปได้ในอุปกรณ์
Enum | |
---|---|
STATE_UNSPECIFIED |
ไม่ระบุ |
MISSING |
ไม่พบโปรแกรมป้องกันไวรัสในอุปกรณ์ |
DISABLED |
มีการติดตั้งโปรแกรมป้องกันไวรัสอย่างน้อย 1 รายการในอุปกรณ์ แต่ไม่ได้เปิดใช้รายการใดเลย |
ENABLED |
เปิดใช้โปรแกรมป้องกันไวรัสอย่างน้อย 1 รายการในอุปกรณ์ |
KeyTrustLevel
ระดับความน่าเชื่อถือของคีย์ที่ยืนยันแล้ว
Enum | |
---|---|
KEY_TRUST_LEVEL_UNSPECIFIED |
ไม่ระบุ |
CHROME_OS_VERIFIED_MODE |
อุปกรณ์ ChromeOS ในโหมดที่ยืนยันแล้ว |
CHROME_OS_DEVELOPER_MODE |
อุปกรณ์ ChromeOS ในโหมดนักพัฒนาซอฟต์แวร์ |
CHROME_BROWSER_HW_KEY |
เบราว์เซอร์ Chrome ที่มีคีย์ที่จัดเก็บไว้ในฮาร์ดแวร์ของอุปกรณ์ |
CHROME_BROWSER_OS_KEY |
เบราว์เซอร์ Chrome ที่มีคีย์ที่จัดเก็บไว้ที่ระดับระบบปฏิบัติการ |
CHROME_BROWSER_NO_KEY |
เบราว์เซอร์ Chrome ที่ไม่มีคีย์การรับรอง |