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 )

فقط خروجی. وضعیت پیکربندی کانکتور.

نوع کانکتور

گزینه‌هایی برای نوع پیکربندی کانکتور.

انوم‌ها
CONNECTOR_TYPE_UNSPECIFIED مقدار پیش‌فرض. این مقدار استفاده نشده است.
REPORTING رابط گزارش‌دهی.
DEVICE_TRUST رابط اعتماد دستگاه.
XDR کانکتور XDR.
IDENTITY_BASED_ENROLLMENT رابط احراز هویت
CERTIFICATE_AUTHORITY رابط مجوز گواهی. هنوز در API پشتیبانی نمی‌شود.
ROOT_STORE رابط گواهی ریشه.

جزئیات پیکربندی کانکتور

جزئیات پیکربندی کانکتور.

نمایش 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 فیلد Union. جزئیات خاص کانکتور. details فقط می‌تواند یکی از موارد زیر باشد:
splunkConfig

object ( SplunkConfig )

پیکربندی کانکتور Splunk

googleSecOpsConfig

object ( GoogleSecOpsConfig )

پیکربندی رابط SecOps گوگل.

pubSubConfig

object ( PubSubConfig )

پیکربندی کانکتور Pub/Sub.

crowdStrikeConfig

object ( CrowdStrikeConfig )

پیکربندی کانکتور CrowdStrike.

crowdStrikeFalconNextGenConfig

object ( CrowdStrikeFalconNextGenConfig )

پیکربندی کانکتور CrowdStrike Falcon Next Gen.

paloAltoNetworksConfig

object ( PaloAltoNetworksConfig )

پیکربندی کانکتور شبکه‌های پالو آلتو

deviceTrustConfig

object ( DeviceTrustConfig )

پیکربندی کانکتور اعتماد دستگاه.

crowdStrikeXdrConfig

object ( CrowdStrikeXdrConfig )

پیکربندی کانکتور CrowdStrike XDR.

pubSubXdrConfig

object ( PubSubXdrConfig )

پیکربندی کانکتور Pub/Sub XDR.

اسپلانک کانفیگ

پیکربندی کانکتور 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 داده ورودی برای استفاده به عنوان هدر مجوز.

source

string

اختیاری. نام منبع اختیاری برای لغو نام پیش‌فرض در کنسول مدیریت Splunk.

reportingSettings

object ( ReportingSettings )

تنظیمات گزارش‌گیری برای پیکربندی Splunk. الزامی.

تنظیمات گزارش

گزارش تنظیمات مربوط به پیکربندی‌های کانکتور.

نمایش 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 تمام رویدادهای دستگاه را فعال می‌کند.

رویداد پیش‌فرض

رویدادهای پیش‌فرض برای گزارش‌دهی. ممکن است رویدادهای بیشتری اضافه شود.

انوم‌ها
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 رویداد تله‌متری گسترش‌یافته.

رویداد دستگاه

رویدادهای دستگاه. ممکن است رویدادهای بیشتری اضافه شود.

انوم‌ها
DEVICE_EVENT_UNSPECIFIED مقدار پیش‌فرض. این مقدار استفاده نشده است.
ALL_DEVICE_EVENTS تمام رویدادهای دستگاه
ADD_REMOVE_USER_EVENT رویداد اضافه/حذف کاربر.
LOGIN_LOGOUT_EVENT رویداد ورود/خروج.
CRD_EVENT رویداد CRD.
PERIPHERAL_EVENT رویداد حاشیه‌ای.

پیکربندی GoogleSecOps

پیکربندی رابط SecOps گوگل.

نمایش JSON 
{
  "apiKey": string,
  "host": string,
  "reportingSettings": {
    object (ReportingSettings)
  }
}
فیلدها
apiKey

string

الزامی. فقط ورودی. کلید API برای استفاده در API مربوط به مصرف.

host

string

الزامی. نقطه پایانی API میزبان برای مصرف. به مشتری اجازه می‌دهد رویدادها را در سرورهای مناطق جغرافیایی خاص بارگذاری کند. پیکربندی‌های موجود که این تنظیم را ندارند، به طور پیش‌فرض روی ایالات متحده تنظیم شده‌اند.

reportingSettings

object ( ReportingSettings )

الزامی. تنظیمات گزارش‌دهی برای پیکربندی Google SecOps.

پیکربندی PubSub

پیکربندی کانکتور Pub/Sub.

نمایش JSON 
{
  "topicFullPath": string,
  "reportingSettings": {
    object (ReportingSettings)
  }
}
فیلدها
topicFullPath

string

الزامی. مسیر کامل تاپیکی که رویداد به آن ارسال می‌شود.

reportingSettings

object ( ReportingSettings )

الزامی. تنظیمات گزارش‌گیری برای پیکربندی Pub/Sub.

پیکربندی CrowStrike

پیکربندی کانکتور CrowdStrike.

نمایش JSON 
{
  "apiKey": string,
  "host": string,
  "reportingSettings": {
    object (ReportingSettings)
  }
}
فیلدها
apiKey

string

الزامی. فقط ورودی. کلید API برای استفاده در API مربوط به مصرف.

host

string

الزامی. میزبان برای شناسایی سرور خاص مشتری جهت دریافت رویدادها.

reportingSettings

object ( ReportingSettings )

الزامی. تنظیمات گزارش‌دهی برای پیکربندی CrowdStrike.

پیکربندی CrowdStrikeFalconNextGenConfig

پیکربندی کانکتور CrowdStrike Falcon Next Gen.

نمایش JSON 
{
  "apiKey": string,
  "host": string,
  "reportingSettings": {
    object (ReportingSettings)
  }
}
فیلدها
apiKey

string

الزامی. فقط ورودی. کلید API برای استفاده در API مربوط به مصرف.

host

string

الزامی. میزبان برای شناسایی سرور خاص مشتری جهت دریافت رویدادها.

reportingSettings

object ( ReportingSettings )

الزامی. تنظیمات گزارش‌دهی برای پیکربندی CrowdStrike Falcon Next Gen.

پیکربندی شبکه پالوآلتو

پیکربندی کانکتور شبکه‌های پالو آلتو

نمایش JSON 
{
  "apiKey": string,
  "host": string,
  "reportingSettings": {
    object (ReportingSettings)
  }
}
فیلدها
apiKey

string

الزامی. فقط ورودی. کلید API برای استفاده در API مربوط به مصرف.

host

string

الزامی. میزبان برای شناسایی سرور خاص مشتری جهت دریافت رویدادها.

reportingSettings

object ( ReportingSettings )

الزامی. تنظیمات گزارش‌دهی برای پیکربندی شبکه‌های پالو آلتو.

پیکربندی اعتماد دستگاه

پیکربندی اعتماد دستگاه برای کانکتورهای اعتماد دستگاه.

نمایش JSON 
{
  "serviceProvider": enum (ServiceProvider),
  "urlMatchers": [
    string
  ],
  "serviceAccounts": [
    string
  ],
  "scope": enum (BrowserEnforcementScope)
}
فیلدها
serviceProvider

enum ( ServiceProvider )

اختیاری. ارائه دهنده خدمات برای اتصال دهنده اعتماد دستگاه.

urlMatchers[]

string

الزامی. فهرست نشانی‌های اینترنتی (URL) مجاز برای حضور در جریان گواهی برای دریافت مجموعه سیگنال‌ها از دستگاه. نشانی‌های اینترنتی باید دارای طرح HTTPS باشند، مثلاً "https://example.com". استفاده از کاراکترهای عمومی (Wildcards)، *، مجاز است. برای اطلاعات دقیق در مورد الگوهای معتبر نشانی اینترنتی، لطفاً به https://cloud.google.com/docs/chrome-enterprise/policies/url-patterns مراجعه کنید.

serviceAccounts[]

string

الزامی. فهرستی از آدرس‌های ایمیل حساب‌های سرویس که مجاز به فراخوانی API دسترسی تأیید شده با دسترسی کامل هستند.

scope

enum ( BrowserEnforcementScope )

الزامی. محدوده‌ای که این پیکربندی در آن اعمال خواهد شد. توجه داشته باشید که این فقط برای مرورگر کروم اعمال می‌شود، زیرا در ChromeOS همیشه اعمال می‌شود.

ارائه دهنده خدمات

ارائه دهنده خدمات برای رابط اعتماد دستگاه.

انوم‌ها
SERVICE_PROVIDER_UNSPECIFIED مقدار پیش‌فرض.
UNIVERSAL_DEVICE_TRUST رابط اعتماد دستگاه جهانی.
OKTA ارائه دهنده خدمات اکتا
PING_IDENTITY ارائه دهنده خدمات هویت پینگ
ONELOGIN ارائه دهنده خدمات وان لاگین
DUO ارائه دهنده خدمات Duo.
ZSCALER ارائه دهنده خدمات Zscaler
OMNISSA ارائه دهنده خدمات اومنیسا
JUMPCLOUD ارائه دهنده خدمات JumpCloud

محدوده اجرای مرورگر

سطح اجرای رابط اعتماد دستگاه.

انوم‌ها
BROWSER_ENFORCEMENT_SCOPE_UNSPECIFIED مقدار پیش‌فرض. این مقدار استفاده نشده است.
BROWSERS_ONLY فقط مرورگرها اعمال می‌شوند.
PROFILES_ONLY فقط پروفایل‌ها اعمال می‌شوند.
BROWSERS_AND_PROFILES هم مرورگرها و هم پروفایل‌ها اجباری هستند.

پیکربندی CrowStrikeXdr

پیکربندی کانکتور CrowdStrike XDR.

نمایش JSON 
{
  "apiKey": string,
  "host": string,
  "xdrSettings": {
    object (XdrSettings)
  }
}
فیلدها
apiKey

string

الزامی. فقط ورودی. کلید API برای استفاده در API مربوط به مصرف.

host

string

الزامی. میزبان برای شناسایی سرور خاص مشتری جهت دریافت رویدادها.

xdrSettings

object ( XdrSettings )

الزامی. تنظیمات XDR برای پیکربندی CrowdStrike XDR.

تنظیمات Xdr

تنظیمات XDR برای پیکربندی کانکتور.

نمایش JSON 
{
  "enableAllXdrEvents": boolean
}
فیلدها
enableAllXdrEvents

boolean

الزامی. آیا همه رویدادهای XDR فعال شوند یا خیر.

پیکربندی PubSubXdr

پیکربندی کانکتور Pub/Sub XDR.

نمایش JSON 
{
  "topicFullPath": string,
  "xdrSettings": {
    object (XdrSettings)
  }
}
فیلدها
topicFullPath

string

الزامی. مسیر کامل تاپیکی که رویداد به آن ارسال می‌شود.

xdrSettings

object ( XdrSettings )

الزامی. تنظیمات XDR برای پیکربندی Pub/Sub XDR.

وضعیت پیکربندی کانکتور

وضعیت پیکربندی کانکتور.

نمایش JSON 
{
  "state": enum (ConfigState),
  "failureStartTime": string,
  "updateTime": string
}
فیلدها
state

enum ( ConfigState )

فقط خروجی. وضعیت پیکربندی کانکتور. اگر کانکتور در ۲۴ ساعت گذشته رویدادی را با موفقیت ارسال نکرده باشد، وضعیت کانکتور غیرفعال است.

failureStartTime

string ( Timestamp format)

فقط خروجی. زمان ثبت فیلد مربوط به اولین شکست از زمان آخرین رویداد موفقیت. این فیلد فقط زمانی تنظیم می‌شود که وضعیت DISABLED_BY_FAILURES باشد.

از RFC 3339 استفاده می‌کند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "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-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "Z" نیز پذیرفته می‌شوند. مثال‌ها: "2014-10-02T15:01:23Z" ، "2014-10-02T15:01:23.045123456Z" یا "2014-10-02T15:01:23+05:30" .

پیکربندی وضعیت

وضعیت پیکربندی کانکتور. ممکن است وضعیت‌های بیشتری اضافه شود.

انوم‌ها
CONFIG_STATE_UNKNOWN مقدار پیش‌فرض.
ENABLED پیکربندی کانکتور فعال است.
DISABLED_BY_FAILURES پیکربندی کانکتور به دلیل خرابی‌ها موقتاً غیرفعال شده است.

روش‌ها

create

 یک پیکربندی کانکتور ایجاد می‌کند.

delete

 پیکربندی یک کانکتور را حذف می‌کند.

get

 یک پیکربندی کانکتور با شناسه مشتری و شناسه پیکربندی دریافت می‌کند.

list

 پیکربندی‌های کانکتور یک مشتری را فهرست می‌کند.

patch

 پیکربندی یک کانکتور را به‌روزرسانی می‌کند.