- Yêu cầu HTTP
- Nội dung yêu cầu
- Nội dung phản hồi
- Phạm vi uỷ quyền
- DeviceSignals
- OperatingSystem
- DiskEncryption
- OsFirewall
- ScreenLockSecured
- SecureBootMode
- SafeBrowsingProtectionLevel
- PasswordProtectionWarningTrigger
- RealtimeUrlCheckMode
- CrowdStrikeAgent
- Điều kiện kích hoạt
- KeyTrustLevel
Xác minh phản hồi thử thách.
Yêu cầu HTTP
POST https://verifiedaccess.googleapis.com/v2/challenge:verify
URL sử dụng cú pháp Chuyển mã gRPC.
Nội dung yêu cầu
Nội dung yêu cầu chứa dữ liệu có cấu trúc sau:
Biểu diễn dưới dạng JSON |
---|
{ "challengeResponse": string, "expectedIdentity": string } |
Trường | |
---|---|
challengeResponse |
Bắt buộc. Phản hồi được tạo cho yêu cầu xác thực, đại diện cho các byte của SignedData. Một chuỗi được mã hoá base64. |
expectedIdentity |
Không bắt buộc. Dịch vụ có thể cung cấp thông tin nhận dạng của thiết bị hoặc người dùng liên kết với khoá (không bắt buộc). Đối với EMK, giá trị này là miền đã đăng ký. Đối với EUK, giá trị này là địa chỉ email của người dùng. Nếu có, hệ thống sẽ kiểm tra giá trị này dựa trên nội dung của phản hồi và quá trình xác minh sẽ không thành công nếu không có kết quả trùng khớp. |
Nội dung phản hồi
Thông báo kết quả cho VerifyAccess.VerifyChallengeResponse.
Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:
Biểu diễn dưới dạng JSON |
---|
{ "devicePermanentId": string, "virtualDeviceId": string, "customerId": string, "signedPublicKeyAndChallenge": string, "deviceSignal": string, "deviceSignals": { object ( |
Trường | |
---|---|
devicePermanentId |
Mã nhận dạng vĩnh viễn của thiết bị được trả về trong trường này (chỉ dành cho phản hồi của máy). |
virtualDeviceId |
Mã thiết bị ảo của thiết bị. Định nghĩa về mã thiết bị ảo tuỳ theo nền tảng. |
customerId |
Mã khách hàng duy nhất của thiết bị này, do SDK dành cho quản trị viên của Google xác định tại https://developers.google.com/admin-sdk/directory/v1/guides/manage-customers |
signedPublicKeyAndChallenge |
Yêu cầu ký chứng chỉ (ở định dạng SPKAC, được mã hoá base64) được trả về trong trường này. Trường này sẽ chỉ được đặt nếu thiết bị có CSR trong phản hồi yêu cầu. (tuỳ chọn đưa CSR hiện có sẵn cho cả phản hồi của người dùng và phản hồi bằng máy) |
deviceSignal |
Không dùng nữa. Tín hiệu thiết bị trong cách biểu diễn dạng chuỗi json. Ưu tiên sử dụng |
deviceSignals |
Tín hiệu của thiết bị. |
keyTrustLevel |
Mức độ tin cậy của khoá được chứng thực thiết bị. |
profileCustomerId |
Mã khách hàng duy nhất của hồ sơ này, như được SDK dành cho quản trị viên của Google xác định tại https://developers.google.com/admin-sdk/directory/v1/guides/manage-customers |
virtualProfileId |
Mã của một hồ sơ trên thiết bị. |
profileKeyTrustLevel |
Mức độ tin cậy khoá đã chứng thực của hồ sơ. |
attestedDeviceId |
Mã thiết bị đã chứng thực (ADID). |
deviceEnrollmentId |
Mã đăng ký thiết bị cho thiết bị ChromeOS. |
Phạm vi uỷ quyền
Yêu cầu phạm vi OAuth sau:
https://www.googleapis.com/auth/verifiedaccess
Để biết thêm thông tin, hãy xem bài viết Tổng quan về hoạt động xác thực.
DeviceSignals
Các tín hiệu của thiết bị theo báo cáo của Chrome. Tín hiệu có sẵn trên tất cả các nền tảng, trừ phi có quy định khác.
Biểu diễn dưới dạng JSON |
---|
{ "deviceManufacturer": string, "deviceModel": string, "operatingSystem": enum ( |
Trường | |
---|---|
deviceManufacturer |
Tên nhà sản xuất thiết bị. |
deviceModel |
Tên mẫu của thiết bị. |
operatingSystem |
Loại hệ điều hành hiện đang chạy trên thiết bị. |
osVersion |
Phiên bản hiện tại của hệ điều hành. Trên Windows và Linux, giá trị này cũng sẽ bao gồm thông tin về bản vá bảo mật. |
displayName |
Tên hiển thị của thiết bị, do người dùng xác định. |
diskEncryption |
Trạng thái mã hoá của ổ đĩa. Trên ChromeOS, ổ đĩa chính luôn ở trạng thái ĐƯỢC MÃ HOÁ. |
serialNumber |
Số sê-ri của thiết bị. Trên Windows, số này biểu thị số sê-ri của BIOS. Không có trên hầu hết các bản phân phối Linux. |
osFirewall |
Trạng thái của tường lửa cấp hệ điều hành. Trên ChromeOS, giá trị này sẽ luôn ở trạng thái BẬT trên các thiết bị thông thường và KHÔNG XÁC ĐỊNH trên các thiết bị ở chế độ nhà phát triển. |
systemDnsServers[] |
Danh sách địa chỉ của tất cả máy chủ DNS cấp hệ điều hành được định cấu hình trong phần cài đặt mạng của thiết bị. |
hostname |
Tên máy chủ của thiết bị. |
macAddresses[] |
Địa chỉ MAC của thiết bị. |
screenLockSecured |
Trạng thái bảo vệ bằng mật khẩu Khoá màn hình. Trên ChromeOS, giá trị này sẽ luôn ở trạng thái BẬT vì không có cách nào để tắt chế độ yêu cầu mật khẩu hoặc mã PIN khi mở khoá thiết bị. |
allowScreenLock |
Giá trị của chính sách AllowScreenLock trên thiết bị. Hãy truy cập vào https://chromeenterprise.google/policies/?policy=AllowScreenLock để biết thêm chi tiết. Chỉ có trên ChromeOS. |
imei[] |
Mã nhận dạng thiết bị di động quốc tế (IMEI) của thiết bị. Chỉ có trên ChromeOS. |
meid[] |
Mã nhận dạng thiết bị di động (MEID) của thiết bị. Chỉ có trên ChromeOS. |
secureBootMode |
Liệu phần mềm khởi động của thiết bị đã bật tính năng Khởi động an toàn hay chưa. Chỉ có trên Windows. |
windowsMachineDomain |
Miền Windows mà máy hiện tại đã tham gia. Chỉ có trên Windows. |
windowsUserDomain |
Miền Windows cho người dùng hệ điều hành hiện tại. Chỉ có trên Windows. |
deviceEnrollmentDomain |
Miền đăng ký của khách hàng hiện đang quản lý thiết bị. |
browserVersion |
Phiên bản hiện tại của trình duyệt Chrome đã tạo ra bộ tín hiệu này. Giá trị mẫu: "107.0.5286.0". |
deviceAffiliationIds[] |
Mã đơn vị liên kết của những tổ chức đã liên kết với tổ chức hiện đang quản lý thiết bị. Khi bộ mã đơn vị liên kết của thiết bị và hồ sơ chồng chéo nhau, điều đó có nghĩa là các tổ chức quản lý thiết bị và người dùng được liên kết với nhau. Để tìm hiểu thêm về mối liên kết của người dùng, hãy truy cập vào https://support.google.com/chrome/a/answer/12801245?ref_topic=9027936. |
profileAffiliationIds[] |
Mã đơn vị liên kết của những tổ chức liên kết với tổ chức hiện đang quản lý người dùng hoặc người dùng ChromeOS của Hồ sơ Chrome. |
builtInDnsClientEnabled |
Liệu ứng dụng DNS tích hợp của Chrome có được sử dụng hay không. Nếu không, ứng dụng DNS của hệ điều hành sẽ được sử dụng. Giá trị này có thể do chính sách doanh nghiệp kiểm soát: https://chromeenterprise.google/policies/#BuiltInDnsClientEnabled. |
chromeRemoteDesktopAppBlocked |
Quyền truy cập vào ứng dụng Chrome Remote Desktop có bị chặn theo chính sách hay không. |
safeBrowsingProtectionLevel |
Mức độ bảo vệ của tính năng Duyệt web an toàn. Bạn có thể kiểm soát chế độ cài đặt đó bằng một chính sách doanh nghiệp: https://chromeenterprise.google/policies/#SafeBrowsingProtectionLevel. |
siteIsolationEnabled |
Liệu chế độ Tách biệt trang web (còn gọi là Trang web trên mỗi quy trình) có được bật hay không. Chế độ cài đặt đó có thể do một chính sách doanh nghiệp kiểm soát: https://chromeenterprise.google/policies/#SitePerProcess |
passwordProtectionWarningTrigger |
Liệu tính năng Cảnh báo bảo vệ mật khẩu có được bật hay không. Tính năng bảo vệ mật khẩu cảnh báo người dùng khi họ sử dụng lại mật khẩu được bảo vệ của mình trên các trang web đáng ngờ. Chế độ cài đặt này do một chính sách doanh nghiệp kiểm soát: https://chromeenterprise.google/policies/#PasswordProtectionWarningTrigger. Xin lưu ý rằng việc không đặt chính sách này không có tác động tương tự như việc đặt chính sách một cách rõ ràng thành |
realtimeUrlCheckMode |
Cho biết tính năng quét URL không an toàn ở cấp doanh nghiệp (tức là tuỳ chỉnh) có được bật hay không. Chế độ cài đặt này có thể do một chính sách doanh nghiệp kiểm soát: https://chromeenterprise.google/policies/#EnterpriseRealTimeUrlCheckMode |
thirdPartyBlockingEnabled |
Liệu Chrome có đang chặn thao tác chèn phần mềm bên thứ ba vào hay không. Chế độ cài đặt này có thể do một chính sách doanh nghiệp kiểm soát: https://chromeenterprise.google/policies/?policy=ThirdPartyBlockingEnabled. Chỉ có trên Windows. |
trigger |
Điều kiện kích hoạt đã tạo ra tập hợp các tín hiệu này. |
profileEnrollmentDomain |
Miền đăng ký của khách hàng hiện đang quản lý hồ sơ. |
crowdStrikeAgent |
Các tài sản của tác nhân Crowdstrike được cài đặt trên thiết bị (nếu có). Chỉ có trên Windows và MacOS. |
OperatingSystem
Hệ điều hành được hỗ trợ.
Enum | |
---|---|
OPERATING_SYSTEM_UNSPECIFIED |
KHÔNG XÁC ĐỊNH. |
CHROME_OS |
ChromeOS. |
CHROMIUM_OS |
ChromiumOS. |
WINDOWS |
Windows. |
MAC_OS_X |
Mac OS X. |
LINUX |
Linux |
DiskEncryption
Các trạng thái mã hoá có thể có của ổ đĩa chính.
Enum | |
---|---|
DISK_ENCRYPTION_UNSPECIFIED |
Không xác định. |
DISK_ENCRYPTION_UNKNOWN |
Chrome không thể đánh giá trạng thái mã hoá. |
DISK_ENCRYPTION_DISABLED |
Đĩa chính không được mã hoá. |
DISK_ENCRYPTION_ENCRYPTED |
Ổ đĩa chính được mã hoá. |
OsFirewall
Các trạng thái có thể có của tường lửa cấp hệ điều hành.
Enum | |
---|---|
OS_FIREWALL_UNSPECIFIED |
Không xác định. |
OS_FIREWALL_UNKNOWN |
Chrome không thể đánh giá trạng thái tường lửa của hệ điều hành. |
OS_FIREWALL_DISABLED |
Tường lửa của hệ điều hành đã bị tắt. |
OS_FIREWALL_ENABLED |
Tường lửa của hệ điều hành đang bật. |
ScreenLockSecured
Các trạng thái có thể có của tính năng bảo vệ bằng mật khẩu bằng phương thức Khoá màn hình.
Enum | |
---|---|
SCREEN_LOCK_SECURED_UNSPECIFIED |
Không xác định. |
SCREEN_LOCK_SECURED_UNKNOWN |
Chrome không thể đánh giá trạng thái của cơ chế Khoá màn hình. |
SCREEN_LOCK_SECURED_DISABLED |
Tính năng Khoá màn hình không được bảo vệ bằng mật khẩu. |
SCREEN_LOCK_SECURED_ENABLED |
Khoá màn hình được bảo vệ bằng mật khẩu. |
SecureBootMode
Các trạng thái có thể có của chế độ Khởi động an toàn trên thiết bị.
Enum | |
---|---|
SECURE_BOOT_MODE_UNSPECIFIED |
Không xác định. |
SECURE_BOOT_MODE_UNKNOWN |
Chrome không thể xác định chế độ Khởi động an toàn. |
SECURE_BOOT_MODE_DISABLED |
Tính năng Khởi động an toàn đã bị tắt trong phần mềm khởi động. |
SECURE_BOOT_MODE_ENABLED |
Tính năng Khởi động an toàn đã được bật trong phần mềm khởi động. |
SafeBrowsingProtectionLevel
Giá trị có thể sử dụng cho Mức độ bảo vệ của tính năng Duyệt web an toàn.
Enum | |
---|---|
SAFE_BROWSING_PROTECTION_LEVEL_UNSPECIFIED |
Không xác định. |
INACTIVE |
Tính năng Duyệt web an toàn đang tắt. |
STANDARD |
Tính năng Duyệt web an toàn hoạt động ở chế độ tiêu chuẩn. |
ENHANCED |
Tính năng Duyệt web an toàn hoạt động ở chế độ nâng cao. |
PasswordProtectionWarningTrigger
Giá trị có thể sử dụng cho Trình kích hoạt Cảnh báo bảo vệ mật khẩu.
Enum | |
---|---|
PASSWORD_PROTECTION_WARNING_TRIGGER_UNSPECIFIED |
Không xác định. |
POLICY_UNSET |
Chưa đặt chính sách này. |
PASSWORD_PROTECTION_OFF |
Sẽ không có cảnh báo bảo vệ mật khẩu nào hiển thị. |
PASSWORD_REUSE |
Cảnh báo bảo vệ mật khẩu hiển thị nếu mật khẩu được bảo vệ được sử dụng lại. |
PHISHING_REUSE |
Cảnh báo bảo vệ mật khẩu hiển thị nếu mật khẩu được bảo vệ được sử dụng lại trên một trang web lừa đảo đã biết. |
RealtimeUrlCheckMode
Giá trị có thể sử dụng cho Chế độ kiểm tra URL theo thời gian thực.
Enum | |
---|---|
REALTIME_URL_CHECK_MODE_UNSPECIFIED |
Không xác định. |
REALTIME_URL_CHECK_MODE_DISABLED |
Đang tắt. Hoạt động kiểm tra của tính năng Duyệt web an toàn cho người tiêu dùng sẽ được áp dụng. |
REALTIME_URL_CHECK_MODE_ENABLED_MAIN_FRAME |
Tính năng kiểm tra theo thời gian thực cho các URL trong khung chính đang bật. |
CrowdStrikeAgent
Các thuộc tính của nhân viên CrowdStrike được cài đặt trên một thiết bị.
Biểu diễn dưới dạng JSON |
---|
{ "agentId": string, "customerId": string } |
Trường | |
---|---|
agentId |
Mã nhân viên hỗ trợ của nhân viên Crowdstrike. |
customerId |
Mã khách hàng của nhân viên hỗ trợ. |
Điều kiện kích hoạt
Giá trị có thể dùng cho Trình kích hoạt.
Enum | |
---|---|
TRIGGER_UNSPECIFIED |
Không xác định. |
TRIGGER_BROWSER_NAVIGATION |
Khi điều hướng đến một URL trong trình duyệt. |
TRIGGER_LOGIN_SCREEN |
Khi đăng nhập vào một tài khoản trên màn hình đăng nhập của ChromeOS. |
KeyTrustLevel
Mức độ tin cậy của khoá đã được chứng thực.
Enum | |
---|---|
KEY_TRUST_LEVEL_UNSPECIFIED |
KHÔNG XÁC ĐỊNH. |
CHROME_OS_VERIFIED_MODE |
Thiết bị ChromeOS ở chế độ đã xác minh. |
CHROME_OS_DEVELOPER_MODE |
Thiết bị ChromeOS ở chế độ nhà phát triển. |
CHROME_BROWSER_HW_KEY |
Trình duyệt Chrome với khoá được lưu trữ trong phần cứng của thiết bị. |
CHROME_BROWSER_OS_KEY |
Trình duyệt Chrome với khoá được lưu trữ ở cấp hệ điều hành. |
CHROME_BROWSER_NO_KEY |
Trình duyệt Chrome không có khoá chứng thực. |