REST Resource: customers.connectorConfigs

المورد: ConnectorConfig

تمثيل لإعدادات الموصّل

تمثيل JSON 
{
  "name": string,
  "displayName": string,
  "type": enum (ConnectorType),
  "details": {
    object (ConnectorConfigDetails)
  },
  "status": {
    object (ConnectorConfigStatus)
  }
}
الحقول
name

string

المعرّف. التنسيق: customers/{customer}/connectorConfigs/{connectorConfig}
displayName

string

الحقل مطلوب. الاسم المعروض للإعداد.
type

enum (ConnectorType)

الحقل مطلوب. تمثّل هذه السمة نوع الموصّل.
details

object (ConnectorConfigDetails)

الحقل مطلوب. تفاصيل إعدادات الموصل
status

object (ConnectorConfigStatus)

النتائج فقط. حالة إعدادات الموصّل

ConnectorType

خيارات لنوع إعدادات الموصّل

عمليات التعداد
CONNECTOR_TYPE_UNSPECIFIED القيمة التلقائية هذه القيمة غير مستخدَمة.
REPORTING وصلة إعداد التقارير
DEVICE_TRUST موصّل الثقة في الجهاز
XDR موصّل XDR
IDENTITY_BASED_ENROLLMENT موصّل المصادقة
CERTIFICATE_AUTHORITY موصّل هيئة إصدار الشهادات هذه الميزة غير متاحة بعد في واجهة برمجة التطبيقات.
ROOT_STORE موصّل شهادة الجذر

ConnectorConfigDetails

تفاصيل إعدادات الموصل

تمثيل JSON 
{

  // Union field details can be only one of the following:
  "splunkConfig": {
    object (SplunkConfig)
  },
  "googleSecOpsConfig": {
    object (GoogleSecOpsConfig)
  },
  "pubSubConfig": {
    object (PubSubConfig)
  },
  "crowdStrikeConfig": {
    object (CrowdStrikeConfig)
  },
  "crowdStrikeFalconNextGenConfig": {
    object (CrowdStrikeFalconNextGenConfig)
  },
  "paloAltoNetworksConfig": {
    object (PaloAltoNetworksConfig)
  },
  "deviceTrustConfig": {
    object (DeviceTrustConfig)
  },
  "crowdStrikeXdrConfig": {
    object (CrowdStrikeXdrConfig)
  },
  "pubSubXdrConfig": {
    object (PubSubXdrConfig)
  }
  // End of list of possible types for union field details.
}
الحقول
حقل الربط details تفاصيل خاصة بالموصّل يمكن أن يكون التعليق details إحدى القيم التالية فقط:
splunkConfig

object (SplunkConfig)

إعداد موصّل Splunk
googleSecOpsConfig

object (GoogleSecOpsConfig)

إعدادات موصّل Google SecOps
pubSubConfig

object (PubSubConfig)

إعدادات موصّل Pub/Sub
crowdStrikeConfig

object (CrowdStrikeConfig)

إعدادات موصِّل CrowdStrike
crowdStrikeFalconNextGenConfig

object (CrowdStrikeFalconNextGenConfig)

إعدادات موصِّل CrowdStrike Falcon Next Gen
paloAltoNetworksConfig

object (PaloAltoNetworksConfig)

إعدادات موصِّل Palo Alto Networks
deviceTrustConfig

object (DeviceTrustConfig)

إعدادات موصّل الثقة في الجهاز
crowdStrikeXdrConfig

object (CrowdStrikeXdrConfig)

إعدادات موصِّل CrowdStrike XDR
pubSubXdrConfig

object (PubSubXdrConfig)

إعدادات موصّل Pub/Sub XDR

SplunkConfig

إعداد موصّل Splunk

تمثيل JSON 
{
  "unsecureScheme": boolean,
  "host": string,
  "portNumber": integer,
  "hecToken": string,
  "source": string,
  "reportingSettings": {
    object (ReportingSettings)
  }
}
الحقول
unsecureScheme

boolean

اختياريّ. تحديد ما إذا كان سيتم استخدام مخطط HTTP غير آمن القيمة التلقائية هي false (HTTPS).
host

string

الحقل مطلوب. المضيف لتحديد الخادم الخاص بالعميل الذي سيتلقّى الأحداث.
portNumber

integer

اختياريّ. رقم المنفذ المطلوب استخدامه. في حال عدم ضبط هذه السياسة، يتم استخدام منفذ Splunk التلقائي.
hecToken

string

الحقل مطلوب. الإدخال فقط رمز HTTP Event Collector الخاص بإدخال البيانات الذي سيتم استخدامه كعنوان Authorization
source

string

اختياريّ. اسم المصدر الاختياري لتجاوز الاسم التلقائي الذي تم ضبطه في "وحدة تحكّم المشرف" في Splunk
reportingSettings

object (ReportingSettings)

الحقل مطلوب. إعدادات إعداد التقارير لإعدادات Splunk.

ReportingSettings

إعدادات إعداد التقارير لإعدادات الموصل.

تمثيل JSON 
{
  "enabledDefaultEvents": [
    enum (DefaultEvent)
  ],
  "enabledOptInEvents": [
    enum (OptInEvent)
  ],
  "enabledDeviceEvents": [
    enum (DeviceEvent)
  ]
}
الحقول
enabledDefaultEvents[]

enum (DefaultEvent)

اختياريّ. قائمة بأحداث المستخدم والمتصفّح التي تم تفعيلها لموصّل التطبيقات هذا تؤدي القائمة الفارغة إلى إيقاف جميع الأحداث التلقائية، وسيؤدي استخدام ALL_DEFAULT_EVENTS إلى تفعيل جميع الأحداث التلقائية.
enabledOptInEvents[]

enum (OptInEvent)

اختياريّ. قائمة أحداث الموافقة التي تم تفعيلها لهذا الإعداد تؤدي القائمة الفارغة إلى إيقاف جميع الأحداث التي تتطلّب الموافقة، وسيؤدي استخدام ALL_OPT_IN_EVENTS إلى تفعيل جميع الأحداث التي تتطلّب الموافقة.
enabledDeviceEvents[]

enum (DeviceEvent)

اختياريّ. قائمة أحداث الجهاز التي تم تفعيلها في هذا الإعداد. تؤدي القائمة الفارغة إلى إيقاف جميع أحداث الجهاز، وسيؤدي استخدام ALL_DEVICE_EVENTS إلى تفعيل جميع أحداث الجهاز.

DefaultEvent

أحداث إعداد التقارير التلقائية قد تتم إضافة المزيد من الأحداث.

عمليات التعداد
DEFAULT_EVENT_UNSPECIFIED القيمة التلقائية هذه القيمة غير مستخدَمة.
ALL_DEFAULT_EVENTS جميع الأحداث التلقائية
BROWSER_CRASH_EVENT حدث تعطُّل المتصفّح
BROWSER_EXTENSION_INSTALL_EVENT حدث تثبيت إضافة المتصفّح
CONTENT_TRANSFER_EVENT حدث نقل المحتوى
CONTENT_UNSCANNED_EVENT حدث محتوى لم يتم فحصه
DATA_ACCESS_CONTROL_EVENT حدث التحكّم في الوصول إلى البيانات
MALWARE_TRANSFER_EVENT حدث نقل البرامج الضارة
PASSWORD_CHANGED_EVENT حدث تغيير كلمة المرور
PASSWORD_REUSE_EVENT حدث إعادة استخدام كلمة المرور
SENSITIVE_DATA_TRANSFER_EVENT حدث نقل البيانات الحسّاسة
SUSPICIOUS_URL_EVENT حدث عنوان URL مريب
UNSAFE_SITE_VISIT_EVENT حدث زيارة موقع إلكتروني غير آمن
URL_FILTERING_INTERSTITIAL_EVENT حدث بينيّ لفلترة عناوين URL

OptInEvent

الموافقة على إعداد تقارير الأحداث قد تتم إضافة المزيد من الأحداث.

عمليات التعداد
OPT_IN_EVENT_UNSPECIFIED القيمة التلقائية هذه القيمة غير مستخدَمة.
ALL_OPT_IN_EVENTS جميع أحداث الموافقة
LOGIN_EVENT حدث تسجيل الدخول
PASSWORD_BREACH_EVENT حدث اختراق كلمة المرور
URL_NAVIGATION_EVENT حدث التنقّل باستخدام عنوان URL
EXTENSION_TELEMETRY_EVENT حدث قياس الإضافات عن بُعد

DeviceEvent

أحداث الجهاز قد تتم إضافة المزيد من الأحداث.

عمليات التعداد
DEVICE_EVENT_UNSPECIFIED القيمة التلقائية هذه القيمة غير مستخدَمة.
ALL_DEVICE_EVENTS جميع أحداث الجهاز
ADD_REMOVE_USER_EVENT حدث إضافة أو إزالة مستخدم
LOGIN_LOGOUT_EVENT حدث تسجيل الدخول/الخروج
CRD_EVENT حدث "سطح المكتب البعيد من Chrome"
PERIPHERAL_EVENT حدث الجهاز الملحق

GoogleSecOpsConfig

إعدادات موصّل Google SecOps

تمثيل JSON 
{
  "apiKey": string,
  "host": string,
  "reportingSettings": {
    object (ReportingSettings)
  }
}
الحقول
apiKey

string

الحقل مطلوب. الإدخال فقط مفتاح واجهة برمجة التطبيقات (API) المطلوب استخدامه في واجهة برمجة التطبيقات الخاصة بنقل البيانات
host

string

الحقل مطلوب. مضيف نقطة النهاية لواجهة برمجة تطبيقات النقل تسمح هذه السمة للعميل بتحميل الأحداث إلى الخوادم في مناطق جغرافية معيّنة. سيتم تلقائيًا ضبط الإعدادات الحالية التي لا تتضمّن هذا الإعداد على الولايات المتحدة.
reportingSettings

object (ReportingSettings)

الحقل مطلوب. إعدادات إعداد التقارير في إعدادات Google SecOps

PubSubConfig

إعدادات موصّل Pub/Sub

تمثيل JSON 
{
  "topicFullPath": string,
  "reportingSettings": {
    object (ReportingSettings)
  }
}
الحقول
topicFullPath

string

الحقل مطلوب. المسار الكامل للموضوع الذي سيتم إرسال الحدث إليه.
reportingSettings

object (ReportingSettings)

الحقل مطلوب. إعدادات إعداد التقارير في إعدادات Pub/Sub

CrowdStrikeConfig

إعدادات موصِّل CrowdStrike

تمثيل JSON 
{
  "apiKey": string,
  "host": string,
  "reportingSettings": {
    object (ReportingSettings)
  }
}
الحقول
apiKey

string

الحقل مطلوب. الإدخال فقط مفتاح واجهة برمجة التطبيقات (API) المطلوب استخدامه في واجهة برمجة التطبيقات الخاصة بنقل البيانات
host

string

الحقل مطلوب. المضيف لتحديد الخادم الخاص بالعميل الذي سيتلقّى الأحداث.
reportingSettings

object (ReportingSettings)

الحقل مطلوب. إعدادات إعداد التقارير في إعدادات CrowdStrike

CrowdStrikeFalconNextGenConfig

إعدادات موصِّل CrowdStrike Falcon Next Gen

تمثيل JSON 
{
  "apiKey": string,
  "host": string,
  "reportingSettings": {
    object (ReportingSettings)
  }
}
الحقول
apiKey

string

الحقل مطلوب. الإدخال فقط مفتاح واجهة برمجة التطبيقات (API) المطلوب استخدامه في واجهة برمجة التطبيقات الخاصة بنقل البيانات
host

string

الحقل مطلوب. المضيف لتحديد الخادم الخاص بالعميل الذي سيتلقّى الأحداث.
reportingSettings

object (ReportingSettings)

الحقل مطلوب. إعدادات إعداد التقارير الخاصة بإعدادات CrowdStrike Falcon Next Gen

PaloAltoNetworksConfig

إعدادات موصِّل Palo Alto Networks

تمثيل JSON 
{
  "apiKey": string,
  "host": string,
  "reportingSettings": {
    object (ReportingSettings)
  }
}
الحقول
apiKey

string

الحقل مطلوب. الإدخال فقط مفتاح واجهة برمجة التطبيقات (API) المطلوب استخدامه في واجهة برمجة التطبيقات الخاصة بنقل البيانات
host

string

الحقل مطلوب. المضيف لتحديد الخادم الخاص بالعميل الذي سيتلقّى الأحداث.
reportingSettings

object (ReportingSettings)

الحقل مطلوب. إعدادات إعداد التقارير لإعدادات Palo Alto Networks

DeviceTrustConfig

إعدادات الثقة في الجهاز لموصّلات الثقة في الجهاز

تمثيل JSON 
{
  "serviceProvider": enum (ServiceProvider),
  "urlMatchers": [
    string
  ],
  "serviceAccounts": [
    string
  ],
  "scope": enum (BrowserEnforcementScope)
}
الحقول
serviceProvider

enum (ServiceProvider)

اختياريّ. مقدّم خدمة موصّل الثقة في الجهاز
urlMatchers[]

string

الحقل مطلوب. قائمة بعناوين URL المسموح لها بأن تكون جزءًا من مسار المصادقة للحصول على مجموعة الإشارات من الجهاز. يجب أن تتضمّن عناوين URL مخطّط HTTPS، مثل https://example.com. يُسمح باستخدام أحرف البدل (*). لمزيد من التفاصيل حول أنماط عناوين URL الصالحة، يُرجى الاطّلاع على https://cloud.google.com/docs/chrome-enterprise/policies/url-patterns.
serviceAccounts[]

string

الحقل مطلوب. قائمة بعناوين البريد الإلكتروني لحسابات الخدمة المسموح لها باستدعاء واجهة برمجة التطبيقات التحقّق من الوصول بإذن وصول كامل
scope

enum (BrowserEnforcementScope)

الحقل مطلوب. نطاق تطبيق هذا الإعداد يُرجى العِلم أنّ هذا الإعداد ينطبق على متصفّح Chrome فقط، ويتم تطبيقه دائمًا في ChromeOS.

ServiceProvider

مقدّم خدمة موصّل الثقة في الجهاز

عمليات التعداد
SERVICE_PROVIDER_UNSPECIFIED القيمة التلقائية
UNIVERSAL_DEVICE_TRUST موصل الثقة العام بالجهاز
OKTA مقدّم خدمة Okta
PING_IDENTITY موفِّر خدمة Ping Identity
ONELOGIN مقدّم خدمة OneLogin
DUO مقدّم خدمة Duo
ZSCALER مقدّم خدمة Zscaler
OMNISSA مقدّم خدمة Omnissa
JUMPCLOUD مقدّم خدمة JumpCloud

BrowserEnforcementScope

مستوى تنفيذ موصّل الثقة في الجهاز

عمليات التعداد
BROWSER_ENFORCEMENT_SCOPE_UNSPECIFIED القيمة التلقائية هذه القيمة غير مستخدَمة.
BROWSERS_ONLY يتم فرض استخدام المتصفّحات فقط.
PROFILES_ONLY يتم فرض الملفات الشخصية فقط.
BROWSERS_AND_PROFILES يتم فرض استخدام كل من المتصفّحات والملفات الشخصية.

CrowdStrikeXdrConfig

إعدادات موصِّل CrowdStrike XDR

تمثيل JSON 
{
  "apiKey": string,
  "host": string,
  "xdrSettings": {
    object (XdrSettings)
  }
}
الحقول
apiKey

string

الحقل مطلوب. الإدخال فقط مفتاح واجهة برمجة التطبيقات (API) المطلوب استخدامه في واجهة برمجة التطبيقات الخاصة بنقل البيانات
host

string

الحقل مطلوب. المضيف لتحديد الخادم الخاص بالعميل الذي سيتلقّى الأحداث.
xdrSettings

object (XdrSettings)

الحقل مطلوب. إعدادات "الرصد والاستجابة الموسّعَين (XDR)" لإعدادات CrowdStrike XDR

XdrSettings

إعدادات XDR لإعدادات الموصّل

تمثيل JSON 
{
  "enableAllXdrEvents": boolean
}
الحقول
enableAllXdrEvents

boolean

الحقل مطلوب. تحديد ما إذا كان سيتم تفعيل جميع أحداث XDR.

PubSubXdrConfig

إعدادات موصّل Pub/Sub XDR

تمثيل JSON 
{
  "topicFullPath": string,
  "xdrSettings": {
    object (XdrSettings)
  }
}
الحقول
topicFullPath

string

الحقل مطلوب. المسار الكامل للموضوع الذي سيتم إرسال الحدث إليه.
xdrSettings

object (XdrSettings)

الحقل مطلوب. إعدادات XDR لإعدادات Pub/Sub XDR

ConnectorConfigStatus

حالة إعدادات الموصّل

تمثيل JSON 
{
  "state": enum (ConfigState),
  "failureStartTime": string,
  "updateTime": string
}
الحقول
state

enum (ConfigState)

النتائج فقط. حالة إعدادات الموصّل. يتم إيقاف حالة الموصّل إذا لم يرسل الموصّل حدثًا بنجاح خلال آخر 24 ساعة.
failureStartTime

string (Timestamp format)

النتائج فقط. وقت تسجيل الحقل لأول عطل منذ آخر حدث ناجح لا يتم ضبط هذا الحقل إلا عندما تكون الحالة DISABLED_BY_FAILURES.

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

النتائج فقط. وقت تسجيل الحقل لآخر تعديل للحالة بالنسبة إلى ENABLED، هذا هو الوقت الذي تم فيه تغيير الحالة إلى ENABLED. بالنسبة إلى DISABLED_BY_FAILURES، هذا هو وقت آخر محاولة فاشلة لإرسال حدث إلى هذا الإعداد.

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".

ConfigState

حالة إعدادات الموصّل. قد تتم إضافة المزيد من الولايات.

عمليات التعداد
CONFIG_STATE_UNKNOWN القيمة التلقائية
ENABLED تم تفعيل إعدادات الموصّل.
DISABLED_BY_FAILURES تم إيقاف إعدادات الموصّل مؤقتًا بسبب حدوث أخطاء.

الطُرق

create

 تنشئ هذه الطريقة إعدادات موصّل.

delete

 يحذف هذا الإجراء إعدادات الموصل.

get

 يحصل على إعدادات الموصل مع رقم تعريف العميل ورقم تعريف الإعدادات.

list

 تعرض هذه الطريقة إعدادات موصّل القوائم لأحد العملاء.

patch

 تعديل إعدادات موصّل