Push event JSON RPC мессежүүд (Push event JSON RPC messages)

Bitdefender-ийн албан ёсны баримтаас орчуулавАнгли эх (EN) · Орчуулсан: 2026.11.10

Энэ хуудсыг AI-аар орчуулж, автоматаар шалгасан. Нарийн тохиргоо хийхээсээ өмнө англи эхтэй тулгаж болно.

Үйл явдлыг "addEvents" функцийн дуудлагаар илгээнэ. Энэ функц нэг параметр авна: "events" — доор тайлбарласан үйл явдлын объектуудын массив.

HTTP хүсэлтийг Event-Push-Service-Md5 толгойгоор (header) баталгаажуулж болно. Толгойн утгыг API түлхүүр болон мессежийн агуулгыг дараах байдлаар хэшлэж гаргана: header_value = md5(api_key, md5(message_body))

$gzapikey = "a247bf167a48d899b7a64aced0d6cebdbd5d474578c26cd023505b2c26******";
$message = file_get_contents('php://input');
$servermd5 = $_SERVER['HTTP_EVENT_PUSH_SERVICE_MD5'];
$resultmd5 = md5($apikey.md5($message));

Cloud AD Integration (Cloud AD нэгтгэл)

Энэ үйл явдал Control Center нь Active Directory домэйнтэй синхрончилж байх үед үүснэ.

Параметрүүд:

module — string; заавал; Үйл явдлын төрлийн тодорхойлогч. Утга: adcloud
companyId — string; заавал; Компанийн тодорхойлогч
syncerId — string; заавал; AD Integrator-ийн тодорхойлогч
issueType — integer; заавал; AD синхрончлолын асуудлын төрөл. Боломжит утгууд:

- 0 – LDAP лавлагааны асуудлаас болж удирдагдаж буй AD төгсгөлийн төхөөрөмжүүдтэй холбогдож чадсангүй. AD сервер хэвийн ажиллаж байгаа эсэх, AD Integrator домэйн дотроо хэвээр байгаа эсэхийг шалгана уу.
- 1 – AD Integrator-ийг устгасан тул удирдагдаж буй AD төгсгөлийн төхөөрөмжүүдтэй холбогдож чадсангүй. Өөр төгсгөлийн төхөөрөмжийг AD Integrator болгон заах шаардлагатай.
- 2 – Шинэ тайлан алга. Удирдагдаж буй AD төгсгөлийн төхөөрөмжүүдтэй холбогдож чадсангүй. AD Integrator унтарсан, аюулгүй байдлын агент (security agent) нь хуучирсан эсвэл сүлжээгээр хүрэх боломжгүй байгаа нь шалтгаан байж болно.

isProtectedEntityId — integer; заавал биш; Хамгаалагдсан объектын ID эсэх (зөвхөн устгах үед)
lastAdReportDate — timestamp; заавал биш; AD-ийн сүүлийн синхрончлолын огноо

Жишээ:

 {
    "jsonrpc": "2.0",
    "method": "addEvents",
    "params": {
        "events": [
            {
                "companyId": "59a14b271da197c6108b4567",
                "syncerId": "59b7d9bfa849af3a1465b7e3",
                "issueType": 0,
                "lastAdReportDate": "2017-09-14T08:03:49.671Z",
                "module": "adcloud"
            }
        ]
    },
    "id": 1505376232077
}

Antiphishing (Фишингээс хамгаалалт)

Энэ мэдэгдэл нь төгсгөлийн төхөөрөмжийн агент вэб хуудас руу хандах үед мэдэгдэж буй фишинг оролдлогыг илрүүлэх болгонд ирнэ.

Параметрүүд:

module — string; заавал; Үйл явдлын төрлийн тодорхойлогч. Утга: aph
product_installed — string; заавал; Суулгасан GravityZone бүрэлдэхүүн хэсгийн тодорхойлогч
companyId — string; заавал; Компанийн тодорхойлогч
computer_name — string; заавал; Компьютерийн нэр
computer_fqdn — string; заавал; IP хаяг
computer_id — string; заавал; GravityZone өгөгдлийн санд буй төгсгөлийн төхөөрөмжийн давтагдашгүй тодорхойлогч
aph_type — string; заавал; Утгууд: phishing, fraud, untrust
url — string; заавал; Хортой URL
status — string; заавал; Утгууд: aph_blocked, reportOnly
last_blocked — timestamp; заавал; Энэ хортой зүйлийг хамгийн сүүлд хаасан цаг
count — integer; заавал; Энэ хортой зүйл хэдэн удаа илэрсэн

Жишээ:

{
    "jsonrpc": "2.0",
    "method": "addEvents",
    "params": {
        "events": [
            {
                "companyId": "59a14b271da197c6108b4567",
                "computer_name": "FC-EXCHANGE-01",
                "computer_fqdn": "fc-exchange-01.fc.dom",
                "computer_ip": "192.168.0.1",
                "computer_id": "59b7d9bfa849af3a1465b7e4",
                "product_installed": "BEST",
                "aph_type": "phishing",
                "url": "http://example.com/account/support/",
                "status": "aph_blocked",
                "last_blocked": "2017-09-14T08:49:43.000Z",
                "count": 1,
                "module": "aph"
            }
        ]
    },
    "id": 1505378984190
}

Antimalware (Хортой программаас хамгаалалт)

Энэ үйл явдал Bitdefender таны сүлжээн дэх төгсгөлийн төхөөрөмж дээр хортой программ илрүүлэх бүрд үүснэ.

Параметрүүд:

module — string; заавал; Үйл явдлын төрлийн тодорхойлогч. Утга: av
product_installed — string; заавал; Суулгасан GravityZone бүрэлдэхүүн хэсгийн тодорхойлогч
companyId — string; заавал; Компанийн тодорхойлогч
computer_name — string; заавал; Компьютерийн нэр
computer_fqdn — string; заавал; FQDN
computer_ip — string; заавал; IP хаяг
computer_id — string; заавал; GravityZone өгөгдлийн санд буй төгсгөлийн төхөөрөмжийн давтагдашгүй тодорхойлогч
malware_type — string; заавал; Илэрсэн хортой программын төрөл: file, http, cookie, pop3, smtp, process, boot, registry, stream
malware_name — string; заавал; Хортой программын нэр
hash — string; заавал биш; Хортой файлын sha256 хэш
final_status — string; заавал; Файлд хийсэн үйлдлийн эцсийн төлөв: ignored, still present, deleted, blocked, quarantined, disinfected, restored
container_id — string; заавал биш; Контейнер объектын тодорхойлогч
container_host — string; заавал биш; Контейнер объектыг удирдаж буй хостын нэр
file_path — string; заавал; Хортой файлын зам
timestamp — timestamp; заавал; Хортой программ илэрсэн цаг
signaturesNumber — string; заавал биш; Дохионы (signature) тоо
taskScanType — integer; заавал биш; taskScanType
scanEngineType — integer; заавал биш; scanEngineType
cleaned — integer; заавал биш; Нэг минутын дотор ижил төрлийн олон үйл явдал үүсгэсэн файлыг хэдэн удаа цэвэрлэсэн
blocked — integer; заавал биш; Нэг минутын дотор ижил төрлийн олон үйл явдал үүсгэсэн программ эсвэл файлыг хэдэн удаа хаасан
deleted — integer; заавал биш; Нэг минутын дотор ижил төрлийн олон үйл явдал үүсгэсэн файлыг хэдэн удаа устгасан
quarantined — integer; заавал биш; Нэг минутын дотор ижил төрлийн олон үйл явдал үүсгэсэн файлыг хэдэн удаа хорио (Quarantine)-д шилжүүлсэн
ignored — integer; заавал биш; Нэг минутын дотор ижил төрлийн олон үйл явдал үүсгэсэн файл эсвэл программд аюул илэрсэн ч үл тоомсорлосон тоо
present — integer; заавал биш; Нэг минутын дотор ижил төрлийн олон үйл явдал үүсгэсэн файл эсвэл программд аюул хэдэн удаа илэрсэн

Жишээ:

{
    "jsonrpc": "2.0",
    "method": "addEvents",
    "params": {
        "events": [
            {
                "module": "av",
                "product_installed": "BEST",
                "user": {
                    "id": "S-1-5-21-1493276475-1689882908-858204327-1001",
                    "name": "testadmin"
                },
                "companyId": "63920a01070088b57f0be1d2",
                "computer_name": "IRU-WIN10X64-A",
                "computer_fqdn": "iru-win10x64-a",
                "computer_ip": "10.17.40.189",
                "computer_id": "65030d040a2422770e0022b5",
                "malware_type": "file",
                "malware_name": "EICAR-Test-File (not a virus)",
                "hash": "8b3f191819931d1f2cef7289239b5f77c00b079847b9c2636e56854d1e5eff71",
                "final_status": "quarantined",
                "file_path": "C:\\Users\\testadmin\\AppData\\Local\\VirtualStore\\eicar0000001.txt",
                "timestamp": "2023-09-14T14:16:30.000Z",
                "signaturesNumber": "7.95265",
                "scanEngineType": 3,
                "cleaned": 0,
                "blocked": 0,
                "deleted": 0,
                "quarantined": 2,
                "ignored": 0,
                "present": 0
            }
        ]
    },
    "id": 1694701009244
}

Advanced Threat Control (ATC) (Ахисан аюулын хяналт)

Энэ үйл явдал аюултай байж болзошгүй программ илрэн, төгсгөлийн төхөөрөмж дээр хаагдах бүрд үүснэ.

Параметрүүд:

module — string; заавал; Үйл явдлын төрлийн тодорхойлогч. Утга: avc
product_installed — string; заавал; Суулгасан GravityZone бүрэлдэхүүн хэсгийн тодорхойлогч
companyId — string; заавал; Компанийн тодорхойлогч
computer_name — string; заавал; Компьютерийн нэр
computer_fqdn — string; заавал; FQDN
computer_ip — string; заавал; IP хаяг
computer_id — string; заавал; GravityZone өгөгдлийн санд буй төгсгөлийн төхөөрөмжийн давтагдашгүй тодорхойлогч
exploit_type — string; заавал; Утгууд: IDS APP, AVC APP, AVC Exploit
exploit_path — string; заавал; Exploit файлын зам
process_command_line — string; заавал биш; Илэрсэн процессын командын мөрийн параметрүүд
parent_process_id — integer; заавал биш; Илэрсэн процессын эцэг процессын pid
parent_process_path — string; заавал биш; Илэрсэн процессын эцэг процессын зам
status — string; заавал; Утгууд: avc_blocked, avc_allowed, avc_disinfected
last_blocked — timestamp; заавал; Энэ программ/exploit-ыг хамгийн сүүлд хаасан цаг
count — integer; заавал; Энэ программ/exploit хэдэн удаа илэрсэн

Жишээ:

{
    "jsonrpc": "2.0",
    "method": "addEvents",
    "params": {
        "events": [
            {
                "companyId": "59a14b271da197c6108b4567",
                "computer_name": "FC-WIN7-X64-01",
                "computer_fqdn": "fc-win7-x64-01",
                "computer_ip": "192.168.0.1",
                "computer_id": "59a1604e60369e06733f8abb",
                "product_installed": "BEST",
                "exploit_type": "AVC Blocked Exploit",
                "exploit_path": "C:\\Users\\admin\\Desktop\\Tools\\avcsim\\win32\\avcsim32.exe",
                "status": "avc_blocked",
                "last_blocked": "2017-09-14T07:56:33.000Z",
                "count": 1,
                "module": "avc"
            }
        ]
    },
    "id": 1505375801845
}

Data Protection (Өгөгдлийн хамгаалалт)

Энэ үйл явдал өгөгдлийн хамгаалалтын дүрмийн дагуу төгсгөлийн төхөөрөмж дээрх өгөгдлийн урсгалыг хаах бүрд үүснэ.

Параметрүүд:

module — string; заавал; Үйл явдлын төрлийн тодорхойлогч. Утга: dp
product_installed — string; заавал; Суулгасан GravityZone бүрэлдэхүүн хэсгийн тодорхойлогч
companyId — string; заавал; Компанийн тодорхойлогч
computer_name — string; заавал; Компьютерийн нэр
computer_fqdn — string; заавал; FQDN
computer_ip — string; заавал; IP хаяг
computer_id — string; заавал; GravityZone өгөгдлийн санд буй төгсгөлийн төхөөрөмжийн давтагдашгүй тодорхойлогч
target_type — string; заавал; Хортой зүйлийн төрөл: mail, http
blocking_rule_name — string; заавал; Өгөгдлийн хамгаалалтын дүрмийн нэр
url — string; заавал; Url
status — string; заавал; Үргэлж "data_protection_blocked"
last_blocked — timestamp; заавал; Энэ и-мэйл/url-ыг хамгийн сүүлд хаасан цаг
count — integer; заавал; Энэ хортой зүйл хэдэн удаа илэрсэн

Жишээ:

{
    "jsonrpc": "2.0",
    "method": "addEvents",
    "params": {
        "events": [
            {
                "companyId": "59a14b271da197c6108b4567",
                "computer_name": "FC-WIN7-X64-01",
                "computer_fqdn": "fc-win7-x64-01",
                "computer_ip": "192.168.0.1",
                "computer_id": "59a1604e60369e06733f8abb",
                "product_installed": "BEST",
                "target_type": "http",
                "blocking_rule_name": "dv",
                "url": "http://example.com/",
                "status": "data_protection_blocked",
                "last_blocked": "2017-09-11T10:23:43.000Z",
                "count": 1,
                "module": "dp"
            }
        ]
    },
    "id": 1505125464691
}

Exchange Malware Detection (Exchange дэх хортой программ илрүүлэлт)

Энэ үйл явдал Bitdefender таны сүлжээн дэх Exchange сервер дээр хортой программ илрүүлэхэд үүснэ.

Параметрүүд:

module — string; заавал; Үйл явдлын төрлийн тодорхойлогч. Утга: exchange-malware
product_installed — string; заавал; Компанийн тодорхойлогч
computer_name — string; заавал; Компьютерийн нэр
computer_fqdn — string; заавал; FQDN
computer_ip — string; заавал; IP хаяг
computer_id — string; заавал; GravityZone өгөгдлийн санд буй төгсгөлийн төхөөрөмжийн давтагдашгүй тодорхойлогч
endpointId — string; заавал; GravityZone өгөгдлийн санд буй удирдагдаж буй төгсгөлийн төхөөрөмжийн тодорхойлогч
serverName — string; заавал; Серверийн нэр
sender — string; заавал; И-мэйл илгээгч
recipients — array; заавал; И-мэйл хүлээн авагчдын жагсаалт (string-үүдийн массив)
subject — string; заавал; И-мэйлийн сэдэв
detectionTime — timestamp; заавал; Илрүүлсэн цаг
malware — array; заавал; Илэрсэн хортой программуудын жагсаалт (array of {"malwareName": string, "malwareType": string, "actionTaken": string, "infectedObject": string})

Жишээ:

{
    "jsonrpc": "2.0",
    "method": "addEvents",
    "params": {
        "events": [
            {
                "companyId": "59a14b271da197c6108b4567",
                "computer_name": "FC- EXCHANGE - 01",
                "computer_fqdn": "fc- exchange - 01.fc.dom",
                "computer_ip": "192.168.0.1",
                "computer_id": "59b7d9bfa849af3a1465b7e4",
                "product_installed": "BEST",
                "endpointId": "59b7d9bfa849af3a1465b7e3",
                "serverName": "FC- EXCHANGE - 01",
                "sender": "fc_test01@fc.dom",
                "recipients": [
                    "fc_test02@fc.dom"
                ],
                "subject": "Emailing Sending.. WL - cbe100c9f42a20ef9a4b1c20ed1a59f9 - 0",
                "detectionTime": "2017- 09 - 13T14: 20:37.000Z",
                "malware": [
                    {
                        "malwareName": "Trojan.Generic.KD.874127",
                        "malwareType": "virus",
                        "actionTaken": "quarantine",
                        "infectedObject": "WL- cbe100c9f42a20ef9a4b1c20ed1a59f9 - 0"
                    }
                ],
                "module": "exchange-malware"
            }
        ]
    },
    "id": 1505312459584
}

Exchange License Usage Limit Has Been Reached (Exchange лицензийн ашиглалтын хязгаарт хүрсэн)

Энэ үйл явдал Exchange лицензийн хязгаарт хүрэхэд үүснэ.

Параметрүүд:

module — string; заавал; Үйл явдлын төрлийн тодорхойлогч. Утга: exchange-organization-info
companyId — string; заавал; Компанийн тодорхойлогч

Жишээ:

 {
    "jsonrpc": "2.0",
    "method": "addEvents",
    "params": {
        "events": [
            {
                "companyId": "59a14b271da197c6108b4567",
                "endpointId": "59b7d9bfa849af3a1465b7e3",
                "module": "exchange-organization-info",
                "mailboxes":8,
                "license_limit":5,
                "license_key":"5IMI111"
            }
        ]
    },
    "id": 1505387661508
}

Exchange User Credentials (Exchange хэрэглэгчийн нэвтрэх мэдээлэл)

Энэ үйл явдал нэвтрэх мэдээлэл буруу байсны улмаас зорилтот Exchange сервер дээр шаардлагаар хийх шалгалтын (on-demand scan) даалгавар эхэлж чадаагүй үед үүснэ. Даалгаврыг гүйцээхийн тулд Exchange-ийн нэвтрэх мэдээллээ солих шаардлагатай.

Параметрүүд:

module — string; заавал; Үйл явдлын төрлийн тодорхойлогч. Утга: exchange-user-credentials
companyId — string; заавал; Компанийн тодорхойлогч
endpointId — string; заавал; GravityZone өгөгдлийн санд буй удирдагдаж буй төгсгөлийн төхөөрөмжийн тодорхойлогч

Жишээ:

 {
    "jsonrpc": "2.0",
    "method": "addEvents",
    "params": {
        "events": [
            {
                "companyId": "59a14b271da197c6108b4567",
                "endpointId": "59b7d9bfa849af3a1465b7e3",
                "module": "exchange-user-credentials"
            }
        ]
    },
    "id": 1505387661508
}

Бусад хэсэг

Энэ хуудсанд гарсан нэр томъёо

Control Center: GravityZone-ийн удирдлагын вэб консол
Security agent: Төхөөрөмж дээр суулгадаг Bitdefender-ийн хамгаалалтын программ (BEST)
Quarantine: Хорио: сэжигтэй файлыг тусгаарлаж хадгалдаг газар
Incidents: Илэрсэн халдлага, түүний алхмуудын бүртгэл (EDR/XDR)

Асуулт байна уу?AI туслах GravityZone-ийн монгол баримтаас хайна. Нарийн асуудлыг таны гэрээт борлуулагч, Bitdefender Mongolia-ийн инженер шийднэ.