- एचटीटीपी अनुरोध
- अनुरोध का मुख्य हिस्सा
- जवाब का मुख्य हिस्सा
- अनुमति पाने के लिंक
- DeviceSignals
- OperatingSystem
- DiskEncryption
- OsFirewall
- ScreenLockSecured
- SecureBootMode
- SafeBrowsingProtectionLevel
- PasswordProtectionWarningTrigger
- RealtimeUrlCheckMode
- CrowdStrikeAgent
- ट्रिगर
- एंटीवायरस
- राज्य
- KeyTrustLevel
चैलेंज के जवाब की पुष्टि करता है.
एचटीटीपी अनुरोध
POST https://verifiedaccess.googleapis.com/v2/challenge:verify
यूआरएल में gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल किया गया है.
अनुरोध का मुख्य भाग
अनुरोध के मुख्य भाग में नीचे दिए गए स्ट्रक्चर वाला डेटा होता है:
JSON के काेड में दिखाना |
---|
{ "challengeResponse": string, "expectedIdentity": string } |
फ़ील्ड | |
---|---|
challengeResponse |
ज़रूरी है. चैलेंज के लिए जनरेट किया गया रिस्पॉन्स, SignedData के बाइट का प्रतिनिधित्व. base64 कोड में बदली गई स्ट्रिंग. |
expectedIdentity |
ज़रूरी नहीं. सेवा, कुंजी से जुड़े डिवाइस या उपयोगकर्ता की पहचान की जानकारी दे सकती है. हालांकि, ऐसा करना ज़रूरी नहीं है. ईएमके के लिए, यह वैल्यू रजिस्टर किया गया डोमेन है. ईयूके के लिए, यह वैल्यू उपयोगकर्ता का ईमेल पता होती है. अगर यह वैल्यू मौजूद है, तो इसकी पुष्टि जवाब के कॉन्टेंट से की जाएगी. अगर कोई मैच नहीं होता है, तो पुष्टि नहीं हो पाएगी. |
जवाब का मुख्य भाग
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 कोड में बदला गया) दिखाया जाता है. यह फ़ील्ड सिर्फ़ तब सेट होगा, जब डिवाइस ने चैलेंज रिस्पॉन्स में सीएसआर शामिल किया हो. (सीएसआर को शामिल करने का विकल्प, अब उपयोगकर्ता और मशीन, दोनों के जवाबों के लिए उपलब्ध है) |
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 पर, सामान्य डिवाइसों पर इस एट्रिब्यूट की वैल्यू हमेशा 'चालू है' होगी. वहीं, डेवलपर मोड में चल रहे डिवाइसों पर इसकी वैल्यू 'जानकारी नहीं है' होगी. Chrome M131 में, macOS 15 (Sequoia) और उसके बाद के वर्शन के लिए सहायता जोड़ी गई है. |
systemDnsServers[] |
डिवाइस की नेटवर्क सेटिंग में कॉन्फ़िगर किए गए, ओएस लेवल के सभी डीएनएस सर्वर के पतों की सूची. |
hostname |
डिवाइस का होस्टनेम. |
macAddresses[] |
सिर्फ़ आउटपुट के लिए. डिवाइस के मैक पते. |
screenLockSecured |
सिर्फ़ आउटपुट के लिए. स्क्रीन लॉक के पासवर्ड से सुरक्षा की स्थिति. ChromeOS पर, यह वैल्यू हमेशा चालू रहेगी, क्योंकि डिवाइस को अनलॉक करते समय पासवर्ड या पिन डालने की ज़रूरत को बंद नहीं किया जा सकता. |
allowScreenLock |
सिर्फ़ आउटपुट के लिए. डिवाइस पर AllowScreenLock नीति की वैल्यू. ज़्यादा जानकारी के लिए, https://chromeenterprise.google/policies/?policy=AllowScreenLock पर जाएं. यह सुविधा सिर्फ़ ChromeOS पर उपलब्ध है. |
imei[] |
सिर्फ़ आउटपुट के लिए. डिवाइस का इंटरनैशनल मोबाइल इक्विपमेंट आइडेंटिटी (IMEI) नंबर. यह सुविधा सिर्फ़ ChromeOS पर उपलब्ध है. |
meid[] |
सिर्फ़ आउटपुट के लिए. डिवाइस का मोबाइल इक्विपमेंट आइडेंटिफ़ायर (एमईआईडी). यह सुविधा सिर्फ़ ChromeOS पर उपलब्ध है. |
secureBootMode |
सिर्फ़ आउटपुट के लिए. डिवाइस के स्टार्टअप सॉफ़्टवेयर में, Secure Boot की सुविधा चालू है या नहीं. यह सुविधा सिर्फ़ 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 |
सिर्फ़ आउटपुट के लिए. Chrome के पहले से मौजूद डीएनएस क्लाइंट का इस्तेमाल किया गया है या नहीं. ओएस डीएनएस क्लाइंट का इस्तेमाल किया जाता है. इस वैल्यू को एंटरप्राइज़ नीति से कंट्रोल किया जा सकता है: https://chromeenterprise.google/policies/#BuiltInDnsClientEnabled. |
chromeRemoteDesktopAppBlocked |
सिर्फ़ आउटपुट के लिए. क्या नीति के तहत, Chrome रिमोट डेस्कटॉप ऐप्लिकेशन का ऐक्सेस ब्लॉक किया गया है. |
safeBrowsingProtectionLevel |
सिर्फ़ आउटपुट के लिए. सुरक्षित ब्राउज़िंग के लिए सुरक्षा का लेवल. इस सेटिंग को एंटरप्राइज़ नीति से कंट्रोल किया जा सकता है: https://chromeenterprise.google/policies/#SafeBrowsingProtectionLevel. |
siteIsolationEnabled |
सिर्फ़ आउटपुट के लिए. साइट आइसोलेशन (जिसे साइट के हिसाब से प्रोसेस भी कहा जाता है) सेटिंग चालू है या नहीं. इस सेटिंग को एंटरप्राइज़ नीति से कंट्रोल किया जा सकता है: https://chromeenterprise.google/policies/#SitePerProcess |
passwordProtectionWarningTrigger |
सिर्फ़ आउटपुट के लिए. पासवर्ड सुरक्षा चेतावनी की सुविधा चालू है या नहीं. जब उपयोगकर्ता अपने सुरक्षित पासवर्ड का दोबारा इस्तेमाल ऐसी साइटों पर करते हैं जिनसे उनकी सुरक्षा को खतरा है, तब 'पासवर्ड की सुरक्षा' सुविधा से उन्हें चेतावनी मिलती है. इस सेटिंग को एंटरप्राइज़ नीति से कंट्रोल किया जाता है: https://chromeenterprise.google/policies/#PasswordProtectionWarningTrigger. ध्यान दें कि नीति को अनसेट करने और साफ़ तौर पर |
realtimeUrlCheckMode |
सिर्फ़ आउटपुट के लिए. एंटरप्राइज़-ग्रेड (यानी कस्टम) असुरक्षित यूआरएल की स्कैनिंग की सुविधा चालू है या नहीं. इस सेटिंग को एंटरप्राइज़ नीति से कंट्रोल किया जा सकता है: https://chromeenterprise.google/policies/#EnterpriseRealTimeUrlCheckMode |
thirdPartyBlockingEnabled |
सिर्फ़ आउटपुट के लिए. समर्थन नहीं होना या रुकना. उससे जुड़ी नीति अब लागू नहीं है. Chrome, तीसरे पक्ष के सॉफ़्टवेयर इंजेक्शन को ब्लॉक कर रहा है या नहीं. इस सेटिंग को एंटरप्राइज़ नीति से कंट्रोल किया जा सकता है: https://chromeenterprise.google/policies/?policy=ThirdPartyBlockingEnabled. यह सुविधा सिर्फ़ Windows पर उपलब्ध है. |
trigger |
सिर्फ़ आउटपुट के लिए. वह ट्रिगर जिसने सिग्नल का यह सेट जनरेट किया. |
profileEnrollmentDomain |
सिर्फ़ आउटपुट के लिए. उस ग्राहक का रजिस्ट्रेशन डोमेन जो फ़िलहाल प्रोफ़ाइल को मैनेज कर रहा है. |
antivirus |
सिर्फ़ आउटपुट के लिए. डिवाइस पर मौजूद एंटीवायरस सॉफ़्टवेयर के बारे में जानकारी. यह सुविधा सिर्फ़ Windows पर उपलब्ध है. |
crowdStrikeAgent |
सिर्फ़ आउटपुट के लिए. डिवाइस पर इंस्टॉल की गई Crowdstrike एजेंट प्रॉपर्टी, अगर कोई हो. यह सुविधा सिर्फ़ Windows और MacOS पर उपलब्ध है. |
OperatingSystem
इसके साथ काम करने वाले ऑपरेटिंग सिस्टम.
Enums | |
---|---|
OPERATING_SYSTEM_UNSPECIFIED |
UNSPECIFIED. |
CHROME_OS |
ChromeOS. |
CHROMIUM_OS |
ChromiumOS. |
WINDOWS |
Windows. |
MAC_OS_X |
Mac OS X. |
LINUX |
Linux |
DiskEncryption
मुख्य डिस्क के लिए, एन्क्रिप्शन की संभावित स्थितियां.
Enums | |
---|---|
DISK_ENCRYPTION_UNSPECIFIED |
नहीं बताया गया है |
DISK_ENCRYPTION_UNKNOWN |
Chrome, एन्क्रिप्शन की स्थिति का आकलन नहीं कर सका. |
DISK_ENCRYPTION_DISABLED |
मुख्य डिस्क को एन्क्रिप्ट (सुरक्षित) नहीं किया गया है. |
DISK_ENCRYPTION_ENCRYPTED |
मुख्य डिस्क एन्क्रिप्ट (सुरक्षित) हो. |
OsFirewall
ओएस-लेवल फ़ायरवॉल की संभावित स्थितियां.
Enums | |
---|---|
OS_FIREWALL_UNSPECIFIED |
नहीं बताया गया है |
OS_FIREWALL_UNKNOWN |
Chrome, ओएस फ़ायरवॉल की स्थिति का आकलन नहीं कर सका. |
OS_FIREWALL_DISABLED |
ओएस फ़ायरवॉल बंद है. |
OS_FIREWALL_ENABLED |
ओएस फ़ायरवॉल चालू हो. |
ScreenLockSecured
स्क्रीन लॉक के पासवर्ड से सुरक्षित रखने की संभावित स्थितियां.
Enums | |
---|---|
SCREEN_LOCK_SECURED_UNSPECIFIED |
नहीं बताया गया है |
SCREEN_LOCK_SECURED_UNKNOWN |
Chrome, स्क्रीन लॉक की सुविधा की स्थिति का आकलन नहीं कर सका. |
SCREEN_LOCK_SECURED_DISABLED |
स्क्रीन लॉक को पासवर्ड से सुरक्षित नहीं किया गया हो. |
SCREEN_LOCK_SECURED_ENABLED |
स्क्रीन लॉक को पासवर्ड से सुरक्षित किया गया हो. |
SecureBootMode
डिवाइस के सिक्योर बूट मोड की संभावित स्थितियां.
Enums | |
---|---|
SECURE_BOOT_MODE_UNSPECIFIED |
नहीं बताया गया है |
SECURE_BOOT_MODE_UNKNOWN |
Chrome, सुरक्षित बूट मोड का पता नहीं लगा सका. |
SECURE_BOOT_MODE_DISABLED |
स्टार्टअप सॉफ़्टवेयर पर, सुरक्षित बूट की सुविधा बंद थी. |
SECURE_BOOT_MODE_ENABLED |
स्टार्टअप सॉफ़्टवेयर पर, सुरक्षित बूट की सुविधा चालू थी. |
SafeBrowsingProtectionLevel
सुरक्षित ब्राउज़िंग के लिए सुरक्षा के लेवल की संभावित वैल्यू.
Enums | |
---|---|
SAFE_BROWSING_PROTECTION_LEVEL_UNSPECIFIED |
नहीं बताया गया है |
INACTIVE |
सुरक्षित ब्राउज़िंग की सुविधा बंद है. |
STANDARD |
स्टैंडर्ड मोड में सुरक्षित ब्राउज़िंग की सुविधा चालू रहती है. |
ENHANCED |
बेहतर मोड में सुरक्षित ब्राउज़िंग की सुविधा चालू रहती है. |
PasswordProtectionWarningTrigger
पासवर्ड सुरक्षा चेतावनी ट्रिगर के लिए संभावित वैल्यू.
Enums | |
---|---|
PASSWORD_PROTECTION_WARNING_TRIGGER_UNSPECIFIED |
नहीं बताया गया है |
POLICY_UNSET |
नीति सेट नहीं है. |
PASSWORD_PROTECTION_OFF |
पासवर्ड की सुरक्षा से जुड़ी कोई भी चेतावनी नहीं दिखेगी. |
PASSWORD_REUSE |
पासवर्ड की सुरक्षा की चेतावनी तब दिखती है, जब सुरक्षित किए गए पासवर्ड का दोबारा इस्तेमाल किया जाता है. |
PHISHING_REUSE |
पासवर्ड की सुरक्षा की चेतावनी तब दिखती है, जब सुरक्षित पासवर्ड का इस्तेमाल, फ़िशिंग वाली किसी ऐसी वेबसाइट पर दोबारा किया जाता है जिसकी पहचान पहले से हो चुकी है. |
RealtimeUrlCheckMode
रीयल-टाइम में यूआरएल की जांच करने के मोड की संभावित वैल्यू.
Enums | |
---|---|
REALTIME_URL_CHECK_MODE_UNSPECIFIED |
नहीं बताया गया है |
REALTIME_URL_CHECK_MODE_DISABLED |
सबमिट नहीं किया जा सकता. उपभोक्ता के लिए सुरक्षित ब्राउज़िंग की जांच लागू की गई है. |
REALTIME_URL_CHECK_MODE_ENABLED_MAIN_FRAME |
मुख्य फ़्रेम वाले यूआरएल के लिए, रीयल-टाइम में जांच की सुविधा चालू है. |
CrowdStrikeAgent
किसी डिवाइस पर इंस्टॉल किए गए CrowdStrike एजेंट की प्रॉपर्टी.
JSON के काेड में दिखाना |
---|
{ "agentId": string, "customerId": string } |
फ़ील्ड | |
---|---|
agentId |
सिर्फ़ आउटपुट के लिए. Crowdstrike एजेंट का एजेंट आईडी. |
customerId |
सिर्फ़ आउटपुट के लिए. वह ग्राहक आईडी जिससे एजेंट जुड़ा है. |
ट्रिगर
ट्रिगर के लिए संभावित वैल्यू.
Enums | |
---|---|
TRIGGER_UNSPECIFIED |
नहीं बताया गया है |
TRIGGER_BROWSER_NAVIGATION |
ब्राउज़र में किसी यूआरएल पर नेविगेट करते समय. |
TRIGGER_LOGIN_SCREEN |
ChromeOS की लॉगिन स्क्रीन पर किसी खाते में साइन इन करते समय. |
एंटीवायरस
किसी डिवाइस पर एंटीवायरस की जानकारी.
JSON के काेड में दिखाना |
---|
{
"state": enum ( |
फ़ील्ड | |
---|---|
state |
सिर्फ़ आउटपुट के लिए. डिवाइस पर मौजूद एंटीवायरस की स्थिति. यह सुविधा, Chrome M136 में लॉन्च की गई थी. |
स्थिति
किसी डिवाइस पर एंटीवायरस की संभावित स्थिति.
Enums | |
---|---|
STATE_UNSPECIFIED |
नहीं बताया गया है |
MISSING |
डिवाइस पर कोई एंटीवायरस नहीं मिला. |
DISABLED |
डिवाइस पर कम से कम एक एंटीवायरस इंस्टॉल था, लेकिन कोई भी चालू नहीं था. |
ENABLED |
डिवाइस पर कम से कम एक एंटीवायरस चालू था. |
KeyTrustLevel
पुष्टि की गई कुंजी का ट्रस्ट लेवल.
Enums | |
---|---|
KEY_TRUST_LEVEL_UNSPECIFIED |
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 ब्राउज़र, जिसमें पुष्टि करने वाली कुंजी नहीं है. |