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

कनेक्टर कॉन्फ़िगरेशन के टाइप के विकल्प.

Enums
CONNECTOR_TYPE_UNSPECIFIED डिफ़ॉल्ट मान. इस वैल्यू का इस्तेमाल नहीं किया गया है.
REPORTING रिपोर्टिंग कनेक्टर.
DEVICE_TRUST डिवाइस ट्रस्ट कनेक्टर.
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

ज़रूरी नहीं. यह तय करता है कि असुरक्षित एचटीटीपी स्कीम का इस्तेमाल करना है या नहीं. डिफ़ॉल्ट रूप से, यह गलत (एचटीटीपीएस) पर सेट होती है.

host

string

ज़रूरी है. होस्ट, ग्राहक के सर्वर की पहचान करता है, ताकि इवेंट मिल सकें.

portNumber

integer

ज़रूरी नहीं. इस्तेमाल किया जाने वाला पोर्ट नंबर. अगर इसे सेट नहीं किया जाता है, तो Splunk के डिफ़ॉल्ट पोर्ट का इस्तेमाल किया जाता है.

hecToken

string

ज़रूरी है. सिर्फ़ इनपुट के लिए. डेटा इनपुट का एचटीटीपी इवेंट कलेक्टर टोकन, जिसका इस्तेमाल अनुमति हेडर के तौर पर किया जाता है.

source

string

ज़रूरी नहीं. Splunk Admin console में सेट किए गए डिफ़ॉल्ट नाम को बदलने के लिए, सोर्स का नाम (यह ज़रूरी नहीं है).

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

रिपोर्टिंग के डिफ़ॉल्ट इवेंट. ज़्यादा इवेंट जोड़े जा सकते हैं.

Enums
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 संदिग्ध यूआरएल वाला इवेंट.
UNSAFE_SITE_VISIT_EVENT असुरक्षित साइट पर जाने का इवेंट.
URL_FILTERING_INTERSTITIAL_EVENT यूआरएल फ़िल्टर करने से जुड़ी इंटरस्टीशियल चेतावनी वाला इवेंट.

OptInEvent

रिपोर्टिंग इवेंट के लिए ऑप्ट-इन करें. ज़्यादा इवेंट जोड़े जा सकते हैं.

Enums
OPT_IN_EVENT_UNSPECIFIED डिफ़ॉल्ट मान. इस वैल्यू का इस्तेमाल नहीं किया गया है.
ALL_OPT_IN_EVENTS ऑप्ट-इन करने से जुड़े सभी इवेंट.
LOGIN_EVENT लॉगिन इवेंट.
PASSWORD_BREACH_EVENT पासवर्ड लीक होने का इवेंट.
URL_NAVIGATION_EVENT यूआरएल नेविगेशन इवेंट.
EXTENSION_TELEMETRY_EVENT एक्सटेंशन टेलीमेट्री इवेंट.

DeviceEvent

डिवाइस से जुड़े इवेंट. ज़्यादा इवेंट जोड़े जा सकते हैं.

Enums
DEVICE_EVENT_UNSPECIFIED डिफ़ॉल्ट मान. इस वैल्यू का इस्तेमाल नहीं किया गया है.
ALL_DEVICE_EVENTS डिवाइस से जुड़े सभी इवेंट.
ADD_REMOVE_USER_EVENT उपयोगकर्ता को जोड़ने/हटाने से जुड़ा इवेंट.
LOGIN_LOGOUT_EVENT लॉग इन/लॉग आउट इवेंट.
CRD_EVENT CRD इवेंट.
PERIPHERAL_EVENT पेरिफ़ेरल इवेंट.

GoogleSecOpsConfig

Google SecOps कनेक्टर का कॉन्फ़िगरेशन.

JSON के काेड में दिखाना
{
  "apiKey": string,
  "host": string,
  "reportingSettings": {
    object (ReportingSettings)
  }
}
फ़ील्ड
apiKey

string

ज़रूरी है. सिर्फ़ इनपुट के लिए. डेटा ट्रांसफ़र करने वाले एपीआई पर इस्तेमाल करने के लिए एपीआई पासकोड.

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

ज़रूरी है. सिर्फ़ इनपुट के लिए. डेटा ट्रांसफ़र करने वाले एपीआई पर इस्तेमाल करने के लिए एपीआई पासकोड.

host

string

ज़रूरी है. होस्ट, ग्राहक के सर्वर की पहचान करता है, ताकि इवेंट मिल सकें.

reportingSettings

object (ReportingSettings)

ज़रूरी है. CrowdStrike कॉन्फ़िगरेशन के लिए रिपोर्टिंग सेटिंग.

CrowdStrikeFalconNextGenConfig

CrowdStrike Falcon Next Gen कनेक्टर का कॉन्फ़िगरेशन.

JSON के काेड में दिखाना
{
  "apiKey": string,
  "host": string,
  "reportingSettings": {
    object (ReportingSettings)
  }
}
फ़ील्ड
apiKey

string

ज़रूरी है. सिर्फ़ इनपुट के लिए. डेटा ट्रांसफ़र करने वाले एपीआई पर इस्तेमाल करने के लिए एपीआई पासकोड.

host

string

ज़रूरी है. होस्ट, ग्राहक के सर्वर की पहचान करता है, ताकि इवेंट मिल सकें.

reportingSettings

object (ReportingSettings)

ज़रूरी है. CrowdStrike Falcon Next Gen कॉन्फ़िगरेशन के लिए रिपोर्टिंग सेटिंग.

PaloAltoNetworksConfig

Palo Alto Networks कनेक्टर का कॉन्फ़िगरेशन.

JSON के काेड में दिखाना
{
  "apiKey": string,
  "host": string,
  "reportingSettings": {
    object (ReportingSettings)
  }
}
फ़ील्ड
apiKey

string

ज़रूरी है. सिर्फ़ इनपुट के लिए. डेटा ट्रांसफ़र करने वाले एपीआई पर इस्तेमाल करने के लिए एपीआई पासकोड.

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

ज़रूरी है. उन यूआरएल की सूची जिन्हें पुष्टि करने की प्रक्रिया में शामिल किया जा सकता है. ऐसा, मशीन से सिग्नल पाने के लिए किया जाता है. यूआरएल में एचटीटीपीएस स्कीम जोड़ना ज़रूरी है. जैसे, "https://example.com". वाइल्डकार्ड, * इस्तेमाल किए जा सकते हैं. मान्य यूआरएल पैटर्न के बारे में ज़्यादा जानकारी पाने के लिए, कृपया https://cloud.google.com/docs/chrome-enterprise/policies/url-patterns पर जाएं.

serviceAccounts[]

string

ज़रूरी है. ऐसे सेवा खातों के ईमेल पतों की सूची जिन्हें Verified Access API को पूरे ऐक्सेस के साथ कॉल करने की अनुमति है.

scope

enum (BrowserEnforcementScope)

ज़रूरी है. वह स्कोप जिस पर यह कॉन्फ़िगरेशन लागू होगा. ध्यान दें कि यह सिर्फ़ Chrome ब्राउज़र पर लागू होता है. ChromeOS में यह हमेशा लागू होता है.

ServiceProvider

डिवाइस ट्रस्ट कनेक्टर की सेवा देने वाली कंपनी.

Enums
SERVICE_PROVIDER_UNSPECIFIED डिफ़ॉल्ट मान.
UNIVERSAL_DEVICE_TRUST यूनिवर्सल डिवाइस ट्रस्ट कनेक्टर.
OKTA Okta सेवा देने वाली कंपनी.
PING_IDENTITY Ping Identity सर्विस प्रोवाइडर.
ONELOGIN OneLogin सेवा देने वाली कंपनी.
DUO Duo की सेवा देने वाली कंपनी.
ZSCALER Zscaler की सेवा देने वाली कंपनी.
OMNISSA Omnissa सेवा देने वाली कंपनी.
JUMPCLOUD JumpCloud सेवा देने वाली कंपनी है.

BrowserEnforcementScope

डिवाइस ट्रस्ट कनेक्टर लागू करने का लेवल.

Enums
BROWSER_ENFORCEMENT_SCOPE_UNSPECIFIED डिफ़ॉल्ट मान. इस वैल्यू का इस्तेमाल नहीं किया गया है.
BROWSERS_ONLY सिर्फ़ ब्राउज़र पर लागू होती हैं.
PROFILES_ONLY सिर्फ़ प्रोफ़ाइलें लागू की जाती हैं.
BROWSERS_AND_PROFILES ब्राउज़र और प्रोफ़ाइल, दोनों पर लागू होती है.

CrowdStrikeXdrConfig

CrowdStrike XDR कनेक्टर का कॉन्फ़िगरेशन.

JSON के काेड में दिखाना
{
  "apiKey": string,
  "host": string,
  "xdrSettings": {
    object (XdrSettings)
  }
}
फ़ील्ड
apiKey

string

ज़रूरी है. सिर्फ़ इनपुट के लिए. डेटा ट्रांसफ़र करने वाले एपीआई पर इस्तेमाल करने के लिए एपीआई पासकोड.

host

string

ज़रूरी है. होस्ट, ग्राहक के सर्वर की पहचान करता है, ताकि इवेंट मिल सकें.

xdrSettings

object (XdrSettings)

ज़रूरी है. CrowdStrike XDR कॉन्फ़िगरेशन के लिए एक्सडीआर सेटिंग.

XdrSettings

कनेक्टर कॉन्फ़िगरेशन के लिए एक्सडीआर सेटिंग.

JSON के काेड में दिखाना
{
  "enableAllXdrEvents": boolean
}
फ़ील्ड
enableAllXdrEvents

boolean

ज़रूरी है. सभी एक्सडीआर इवेंट को चालू करना है या नहीं.

PubSubXdrConfig

Pub/Sub XDR कनेक्टर का कॉन्फ़िगरेशन.

JSON के काेड में दिखाना
{
  "topicFullPath": string,
  "xdrSettings": {
    object (XdrSettings)
  }
}
फ़ील्ड
topicFullPath

string

ज़रूरी है. इवेंट भेजने के लिए, विषय का पूरा पाथ.

xdrSettings

object (XdrSettings)

ज़रूरी है. Pub/Sub XDR कॉन्फ़िगरेशन के लिए XDR सेटिंग.

ConnectorConfigStatus

कनेक्टर के कॉन्फ़िगरेशन का स्टेटस.

JSON के काेड में दिखाना
{
  "state": enum (ConfigState),
  "failureStartTime": string,
  "updateTime": string
}
फ़ील्ड
state

enum (ConfigState)

सिर्फ़ आउटपुट के लिए. कनेक्टर कॉन्फ़िगरेशन की स्थिति. अगर कनेक्टर ने पिछले 24 घंटों में कोई इवेंट नहीं भेजा है, तो कनेक्टर की स्थिति 'बंद है' पर सेट हो जाती है.

failureStartTime

string (Timestamp format)

सिर्फ़ आउटपुट के लिए. पिछली बार सफलता से रिकॉर्डिंग होने के बाद, सबसे पहले फ़ेल होने का समय. इस फ़ील्ड को सिर्फ़ तब सेट किया जाता है, जब स्थिति DISABLED_BY_FAILURES हो.

यह आरएफ़सी 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 के लिए, यह इस कॉन्फ़िगरेशन को इवेंट भेजने की सबसे हाल ही की कोशिश का समय है.

यह आरएफ़सी 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

कनेक्टर कॉन्फ़िगरेशन की स्थिति. इसमें और राज्य जोड़े जा सकते हैं.

Enums
CONFIG_STATE_UNKNOWN डिफ़ॉल्ट मान.
ENABLED कनेक्टर कॉन्फ़िगरेशन चालू है.
DISABLED_BY_FAILURES गड़बड़ियों की वजह से, कनेक्टर कॉन्फ़िगरेशन को कुछ समय के लिए बंद कर दिया गया है.

तरीके

create

यह कुकी, कनेक्टर कॉन्फ़िगरेशन बनाती है.

delete

इस तरीके का इस्तेमाल करके, कनेक्टर कॉन्फ़िगरेशन मिटाया जा सकता है.

get

इस फ़ंक्शन से, ग्राहक आईडी और कॉन्फ़िगरेशन आईडी के साथ कनेक्टर कॉन्फ़िगरेशन मिलता है.

list

यह किसी ग्राहक के कनेक्टर कॉन्फ़िगरेशन की सूची बनाता है.

patch

कनेक्टर के कॉन्फ़िगरेशन को अपडेट करता है.