تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

Method: challenge.verify

التحقق من استجابة التحدي.

طلب HTTP

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

يستخدم عنوان URL بنية تحويل الترميز gRPC.

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

تمثيل JSON
{ "challengeResponse": string, "expectedIdentity": string }

الحقول

الحقول
`challengeResponse`	`string (bytes format)` مطلوبة. الاستجابة التي تم إنشاؤها للتحدي، تمثيل وحدات البايت للبيانات الموقَّعة. سلسلة بترميز base64.
`expectedIdentity`	`string` اختياريّ. يمكن أن تقدّم الخدمة اختياريًا معلومات الهوية حول الجهاز أو المستخدم المرتبط بالمفتاح. بالنسبة إلى رمز EMK، تكون هذه القيمة هي النطاق المسجَّل. بالنسبة إلى الاتحاد الأوروبي، تكون هذه القيمة هي عنوان البريد الإلكتروني للمستخدم. وفي حال توفّرها، سيتم التحقّق من هذه القيمة مقابل محتوى الردّ، وسيتعذّر التحقّق في حال عدم العثور على مطابقة.

challengeResponse

string (bytes format)

مطلوبة. الاستجابة التي تم إنشاؤها للتحدي، تمثيل وحدات البايت للبيانات الموقَّعة.

سلسلة بترميز base64.

expectedIdentity

string

اختياريّ. يمكن أن تقدّم الخدمة اختياريًا معلومات الهوية حول الجهاز أو المستخدم المرتبط بالمفتاح. بالنسبة إلى رمز EMK، تكون هذه القيمة هي النطاق المسجَّل. بالنسبة إلى الاتحاد الأوروبي، تكون هذه القيمة هي عنوان البريد الإلكتروني للمستخدم. وفي حال توفّرها، سيتم التحقّق من هذه القيمة مقابل محتوى الردّ، وسيتعذّر التحقّق في حال عدم العثور على مطابقة.

نص الاستجابة

رسالة نتيجة البحث عن التحقّق بخطوتين (في حال التحقّق)

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON

تمثيل JSON
{ "devicePermanentId": string, "virtualDeviceId": string, "customerId": string, "signedPublicKeyAndChallenge": string, "deviceSignal": string, "deviceSignals": { object (`DeviceSignals`) }, "keyTrustLevel": enum (`KeyTrustLevel`), "profileCustomerId": string, "virtualProfileId": string, "profileKeyTrustLevel": enum (`KeyTrustLevel`), "attestedDeviceId": string, "deviceEnrollmentId": string }

{
  "devicePermanentId": string,
  "virtualDeviceId": string,
  "customerId": string,
  "signedPublicKeyAndChallenge": string,
  "deviceSignal": string,
  "deviceSignals": {
    object (DeviceSignals)
  },
  "keyTrustLevel": enum (KeyTrustLevel),
  "profileCustomerId": string,
  "virtualProfileId": string,
  "profileKeyTrustLevel": enum (KeyTrustLevel),
  "attestedDeviceId": string,
  "deviceEnrollmentId": string
}

الحقول
`devicePermanentId`	`string` يتم عرض المعرّف الدائم للجهاز في هذا الحقل (لاستجابة الجهاز فقط).
`virtualDeviceId`	`string` رقم تعريف الجهاز الافتراضي للجهاز يرتبط تعريف رقم تعريف الجهاز الافتراضي بالنظام الأساسي.
`customerId`	`string` الرقم التعريفي الفريد للعميل الذي ينتمي إليه هذا الجهاز، على النحو المحدّد في حزمة تطوير البرامج (SDK) لوحدة تحكُّم المشرف في Google على https://developers.google.com/admin-sdk/directory/v1/guides/manage-customers
`signedPublicKeyAndChallenge`	`string` يتم عرض طلب توقيع الشهادة (بتنسيق SPKAC، بترميز base64) في هذا الحقل. سيتم ضبط هذا الحقل فقط إذا تضمّن الجهاز CSR في استجابته للتحدي. (أصبح خيار تضمين CSR متاحًا الآن لكل من استجابات المستخدم والجهاز)
`deviceSignal`	`string` تمّ الإيقاف. إشارة الجهاز في تمثيل سلسلة JSON أفضّل استخدام `deviceSignals` بدلاً من ذلك.
`deviceSignals`	`object (DeviceSignals)` إشارات الجهاز
`keyTrustLevel`	`enum (KeyTrustLevel)` تم التصديق على مستوى الثقة الرئيسي للجهاز.
`profileCustomerId`	`string` الرقم التعريفي الفريد للعميل الذي ينتمي إليه هذا الملف الشخصي، على النحو المحدّد في حزمة تطوير البرامج (SDK) لوحدة تحكُّم المشرف في Google على https://developers.google.com/admin-sdk/directory/v1/guides/manage-customers
`virtualProfileId`	`string` رقم تعريف ملف شخصي على الجهاز.
`profileKeyTrustLevel`	`enum (KeyTrustLevel)` تم التصديق على مستوى الثقة الرئيسي في الملف الشخصي
`attestedDeviceId`	`string` رقم تعريف الجهاز الذي تم التصديق عليه (ADID)
`deviceEnrollmentId`	`string` رقم تعريف تسجيل الجهاز لأجهزة ChromeOS

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

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

لمزيد من المعلومات، يُرجى الاطّلاع على نظرة عامة على المصادقة.

DeviceSignals

يرسل الجهاز إشارات كما تم الإبلاغ عنها من خلال Chrome. تتوفّر الإشارات على جميع المنصات، ما لم يتم تحديد خلاف ذلك.

تمثيل JSON

تمثيل JSON
{ "deviceManufacturer": string, "deviceModel": string, "operatingSystem": enum (`OperatingSystem`), "osVersion": string, "displayName": string, "diskEncryption": enum (`DiskEncryption`), "serialNumber": string, "osFirewall": enum (`OsFirewall`), "systemDnsServers": [ string ], "hostname": string, "macAddresses": [ string ], "screenLockSecured": enum (`ScreenLockSecured`), "allowScreenLock": boolean, "imei": [ string ], "meid": [ string ], "secureBootMode": enum (`SecureBootMode`), "windowsMachineDomain": string, "windowsUserDomain": string, "deviceEnrollmentDomain": string, "browserVersion": string, "deviceAffiliationIds": [ string ], "profileAffiliationIds": [ string ], "builtInDnsClientEnabled": boolean, "chromeRemoteDesktopAppBlocked": boolean, "safeBrowsingProtectionLevel": enum (`SafeBrowsingProtectionLevel`), "siteIsolationEnabled": boolean, "passwordProtectionWarningTrigger": enum (`PasswordProtectionWarningTrigger`), "realtimeUrlCheckMode": enum (`RealtimeUrlCheckMode`), "thirdPartyBlockingEnabled": boolean, "trigger": enum (`Trigger`), "profileEnrollmentDomain": string, "crowdStrikeAgent": { object (`CrowdStrikeAgent`) } }

{
  "deviceManufacturer": string,
  "deviceModel": string,
  "operatingSystem": enum (OperatingSystem),
  "osVersion": string,
  "displayName": string,
  "diskEncryption": enum (DiskEncryption),
  "serialNumber": string,
  "osFirewall": enum (OsFirewall),
  "systemDnsServers": [
    string
  ],
  "hostname": string,
  "macAddresses": [
    string
  ],
  "screenLockSecured": enum (ScreenLockSecured),
  "allowScreenLock": boolean,
  "imei": [
    string
  ],
  "meid": [
    string
  ],
  "secureBootMode": enum (SecureBootMode),
  "windowsMachineDomain": string,
  "windowsUserDomain": string,
  "deviceEnrollmentDomain": string,
  "browserVersion": string,
  "deviceAffiliationIds": [
    string
  ],
  "profileAffiliationIds": [
    string
  ],
  "builtInDnsClientEnabled": boolean,
  "chromeRemoteDesktopAppBlocked": boolean,
  "safeBrowsingProtectionLevel": enum (SafeBrowsingProtectionLevel),
  "siteIsolationEnabled": boolean,
  "passwordProtectionWarningTrigger": enum (PasswordProtectionWarningTrigger),
  "realtimeUrlCheckMode": enum (RealtimeUrlCheckMode),
  "thirdPartyBlockingEnabled": boolean,
  "trigger": enum (Trigger),
  "profileEnrollmentDomain": string,
  "crowdStrikeAgent": {
    object (CrowdStrikeAgent)
  }
}

الحقول
`deviceManufacturer`	`string` اسم الشركة المصنِّعة للجهاز
`deviceModel`	`string` اسم طراز الجهاز
`operatingSystem`	`enum (OperatingSystem)` تشير هذه السمة إلى نوع نظام التشغيل الذي يعمل حاليًا على الجهاز.
`osVersion`	`string` الإصدار الحالي من نظام التشغيل على نظامي التشغيل Windows وLinux، ستتضمن القيمة أيضًا معلومات تصحيح الأمان.
`displayName`	`string` الاسم المعروض للجهاز، كما يحدده المستخدم.
`diskEncryption`	`enum (DiskEncryption)` حالة تشفير القرص. في ChromeOS، يتم دائمًا تشفير القرص الرئيسي.
`serialNumber`	`string` الرقم التسلسلي للجهاز في نظام التشغيل Windows، يمثل هذا الرقم التسلسلي لنظام BIOS. هذه الميزة غير متاحة في معظم توزيعات Linux.
`osFirewall`	`enum (OsFirewall)` حالة جدار الحماية على مستوى نظام التشغيل. في نظام التشغيل ChromeOS، ستكون القيمة مفعَّلة دائمًا على الأجهزة العادية وغير معروفة على الأجهزة في وضع مطوّر البرامج.
`systemDnsServers[]`	`string` قائمة بعناوين جميع خوادم نظام أسماء النطاقات على مستوى نظام التشغيل التي تم ضبطها في إعدادات شبكة الجهاز
`hostname`	`string` اسم مضيف الجهاز
`macAddresses[]`	`string` عناوين MAC للجهاز.
`screenLockSecured`	`enum (ScreenLockSecured)` حالة الحماية بكلمة مرور لقفل الشاشة. في نظام التشغيل ChromeOS، ستكون هذه القيمة مفعّلة دائمًا نظرًا لعدم وجود طريقة لإيقاف طلب كلمة مرور أو رقم تعريف شخصي عند فتح قفل الجهاز.
`allowScreenLock`	`boolean` قيمة سياسة AllowScreenLock على الجهاز. لمزيد من التفاصيل، يُرجى الاطّلاع على https://chromeenterprise.google/policies/?policy=AllowScreenLock. تتوفّر هذه الميزة على نظام التشغيل ChromeOS فقط.
`imei[]`	`string` الهوية الدولية للأجهزة الجوّالة (IMEI) للجهاز تتوفّر هذه الميزة على نظام التشغيل ChromeOS فقط.
`meid[]`	`string` معرّف الجهاز الجوّال (MEID) للجهاز تتوفّر هذه الميزة على نظام التشغيل ChromeOS فقط.
`secureBootMode`	`enum (SecureBootMode)` تحدد هذه القيمة ما إذا كانت ميزة "التشغيل الآمن" مفعَّلة في برنامج بدء تشغيل الجهاز. تتوفّر هذه الميزة على نظام التشغيل Windows فقط.
`windowsMachineDomain`	`string` نطاق Windows الذي انضم إليه الجهاز الحالي. تتوفّر هذه الميزة على نظام التشغيل Windows فقط.
`windowsUserDomain`	`string` نطاق Windows لمستخدم نظام التشغيل الحالي. تتوفّر هذه الميزة على نظام التشغيل Windows فقط.
`deviceEnrollmentDomain`	`string` نطاق تسجيل العميل الذي يدير الجهاز حاليًا.
`browserVersion`	`string` الإصدار الحالي من متصفّح Chrome الذي أنشأ هذه المجموعة من الإشارات. مثال على القيمة: "107.0.5286.0".
`deviceAffiliationIds[]`	`string` معرّفات تبعيات المؤسسات التابعة للمؤسسة التي تدير الجهاز حاليًا عندما تتداخل مجموعات أرقام تعريف ارتباط الجهاز والملف الشخصي، يعني ذلك أنّ المؤسسات التي تدير الجهاز والمستخدم تابعة. لمزيد من المعلومات حول تبعية المستخدمين، يُرجى الانتقال إلى https://support.google.com/chrome/a/answer/12801245?ref_topic=9027936.
`profileAffiliationIds[]`	`string` معرّفات تبعية المؤسسات التابعة للمؤسسة التي تدير حاليًا مستخدم الملف الشخصي على Chrome أو مستخدم ChromeOS.
`builtInDnsClientEnabled`	`boolean` ما إذا كان يتم استخدام عميل نظام أسماء النطاقات المدمَج في Chrome أم لا. بخلاف ذلك، يتم استخدام عميل نظام أسماء النطاقات لنظام التشغيل. قد تتحكّم إحدى سياسات المؤسسة في هذه القيمة: https://chromeenterprise.google/policies/#BuiltInDnsClientEnabled.
`chromeRemoteDesktopAppBlocked`	`boolean` يمكنك اختيار ما إذا كان سيتم حظر الوصول إلى تطبيق "سطح المكتب البعيد من Chrome" من خلال إحدى السياسات.
`safeBrowsingProtectionLevel`	`enum (SafeBrowsingProtectionLevel)` مستوى الحماية في ميزة "التصفّح الآمن" يمكن التحكّم في هذا الإعداد من خلال إحدى سياسات المؤسسة: https://chromeenterprise.google/policies/#SafeBrowsingProtectionLevel.
`siteIsolationEnabled`	`boolean` ما إذا كان إعداد "عزل الموقع" (المعروف أيضًا باسم "الموقع لكل عملية") مفعَّلاً. يمكن التحكّم في هذا الإعداد من خلال إحدى سياسات المؤسسة: https://chromeenterprise.google/policies/#SitePerProcess
`passwordProtectionWarningTrigger`	`enum (PasswordProtectionWarningTrigger)` تحدّد هذه السمة ما إذا كانت ميزة "تحذير حماية كلمة المرور" مفعّلة أم لا. تُنبّه ميزة "حماية كلمة المرور" المستخدمين عند إعادة استخدام كلمات المرور المحمية على مواقع إلكترونية يُحتمل أن تكون مريبة. تتحكَّم إحدى سياسات المؤسسة في هذا الإعداد: https://chromeenterprise.google/policies/#PasswordProtectionWarningTrigger. يُرجى العلم أنّ السياسة التي تم تركها بدون ضبط لا تؤثر في التأثيرات نفسها التي يؤدي إليها ضبط السياسة بشكل صريح على `PASSWORD_PROTECTION_OFF`.
`realtimeUrlCheckMode`	`enum (RealtimeUrlCheckMode)` سواء تم تفعيل فحص عناوين URL غير الآمنة على مستوى المؤسسة (أي المخصّصة) أو لا. قد تتحكَّم إحدى سياسات المؤسسة في هذا الإعداد: https://chromeenterprise.google/policies/#EnterpriseRealTimeUrlCheckMode
`thirdPartyBlockingEnabled`	`boolean` ما إذا كان Chrome يحظر إدخال البرامج الخارجية أم لا. قد تتحكّم هذه السياسة في هذا الإعداد من خلال إحدى سياسات المؤسسة: https://chromeenterprise.google/policies/?policy=ThirdPartyBlockingEnabled. تتوفّر هذه الميزة على نظام التشغيل Windows فقط.
`trigger`	`enum (Trigger)` العامل المشغِّل الذي أنشأ هذه المجموعة من الإشارات.
`profileEnrollmentDomain`	`string` نطاق تسجيل العميل الذي يدير الملف التجاري حاليًا
`crowdStrikeAgent`	`object (CrowdStrikeAgent)` خصائص وكيل Crowdstrike المثبَّتة على الجهاز، إن توفّرت. لا تتوفّر هذه الميزة إلا على نظامَي التشغيل Windows وMacOS.

OperatingSystem

أنظمة التشغيل المتوافقة.

عمليات التعداد
`OPERATING_SYSTEM_UNSPECIFIED`	غير مُحدَّد.
`CHROME_OS`	ChromeOS
`CHROMIUM_OS`	نظام التشغيل Chromium
`WINDOWS`	النوافذ
`MAC_OS_X`	Mac Os X.
`LINUX`	Linux

DiskEncryption

الحالات المحتملة لتشفير القرص الرئيسي.

عمليات التعداد
`DISK_ENCRYPTION_UNSPECIFIED`	غير محدد
`DISK_ENCRYPTION_UNKNOWN`	تعذَّر على Chrome تقييم حالة التشفير.
`DISK_ENCRYPTION_DISABLED`	القرص الرئيسي غير مشفّر.
`DISK_ENCRYPTION_ENCRYPTED`	القرص الرئيسي مشفّر.

OsFirewall

الحالات المحتملة لجدار الحماية على مستوى نظام التشغيل.

عمليات التعداد
`OS_FIREWALL_UNSPECIFIED`	غير محدد
`OS_FIREWALL_UNKNOWN`	لم يتمكن Chrome من تقييم حالة جدار الحماية لنظام التشغيل.
`OS_FIREWALL_DISABLED`	تم إيقاف جدار الحماية لنظام التشغيل.
`OS_FIREWALL_ENABLED`	تم تفعيل جدار الحماية لنظام التشغيل.

ScreenLockSecured

الحالات المحتملة للحماية باستخدام كلمة مرور قفل الشاشة.

عمليات التعداد
`SCREEN_LOCK_SECURED_UNSPECIFIED`	غير محدد
`SCREEN_LOCK_SECURED_UNKNOWN`	تعذّر على Chrome تقييم حالة آلية "قفل الشاشة".
`SCREEN_LOCK_SECURED_DISABLED`	قفل الشاشة غير محمي بكلمة مرور.
`SCREEN_LOCK_SECURED_ENABLED`	قفل الشاشة محمي بكلمة مرور.

SecureBootMode

الحالات المحتملة لوضع "التشغيل الآمن" للجهاز.

عمليات التعداد
`SECURE_BOOT_MODE_UNSPECIFIED`	غير محدد
`SECURE_BOOT_MODE_UNKNOWN`	تعذّر على Chrome تحديد وضع "التشغيل الآمن".
`SECURE_BOOT_MODE_DISABLED`	تم إيقاف التمهيد الآمن في برنامج بدء التشغيل.
`SECURE_BOOT_MODE_ENABLED`	تم تفعيل التمهيد الآمن في برنامج بدء التشغيل.

SafeBrowsingProtectionLevel

القيم المحتملة لمستوى حماية التصفّح الآمن.

عمليات التعداد
`SAFE_BROWSING_PROTECTION_LEVEL_UNSPECIFIED`	غير محدد
`INACTIVE`	ميزة "التصفّح الآمن" غير مفعّلة.
`STANDARD`	تفعيل ميزة "التصفّح الآمن" في الوضع العادي
`ENHANCED`	تفعيل ميزة "التصفّح الآمن" في الوضع المحسَّن

PasswordProtectionWarningTrigger

القيم المحتملة لمشغِّل تحذير حماية كلمة المرور

عمليات التعداد
`PASSWORD_PROTECTION_WARNING_TRIGGER_UNSPECIFIED`	غير محدد
`POLICY_UNSET`	لم يتم ضبط السياسة.
`PASSWORD_PROTECTION_OFF`	لن يتم عرض أي تحذير لحماية كلمة المرور.
`PASSWORD_REUSE`	يتم عرض تحذير حماية كلمة المرور في حال إعادة استخدام كلمة مرور محمية.
`PHISHING_REUSE`	يظهر تحذير حماية كلمة المرور في حال إعادة استخدام كلمة مرور محمية على موقع إلكتروني معروف للتصيّد الاحتيالي.

RealtimeUrlCheckMode

القيم المحتملة لوضع التحقّق من عنوان URL في الوقت الفعلي

عمليات التعداد
`REALTIME_URL_CHECK_MODE_UNSPECIFIED`	غير محدد
`REALTIME_URL_CHECK_MODE_DISABLED`	الزر غير مفعّل. يتم تطبيق عمليات فحص التصفح الآمن للمستهلكين.
`REALTIME_URL_CHECK_MODE_ENABLED_MAIN_FRAME`	تم تفعيل ميزة البحث في الوقت الفعلي عن عناوين URL للإطار الرئيسي.

CrowdStrikeAgent

خصائص وكيل CrowdStrike المثبَّت على الجهاز

تمثيل JSON
{ "agentId": string, "customerId": string }

الحقول

الحقول
`agentId`	`string` معرِّف الوكيل لوكيل Crowdstrike.
`customerId`	`string` الرقم التعريفي للعميل الذي ينتمي إليه الوكيل.

agentId

string

معرِّف الوكيل لوكيل Crowdstrike.

customerId

string

الرقم التعريفي للعميل الذي ينتمي إليه الوكيل.

عامل التفعيل

القيم المحتملة للعامل المشغِّل.

عمليات التعداد
`TRIGGER_UNSPECIFIED`	غير محدد
`TRIGGER_BROWSER_NAVIGATION`	عند الانتقال إلى عنوان URL داخل متصفّح
`TRIGGER_LOGIN_SCREEN`	عند تسجيل الدخول إلى حساب على شاشة تسجيل الدخول في ChromeOS

KeyTrustLevel

مستوى ثقة المفتاح الذي تم التصديق عليه

عمليات التعداد
`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 بدون مفتاح مصادقة