createResponseAction: хэрэглэгчийн node дээр хариу арга хэмжээ авах API арга

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

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

Энэ аргыг GravityZone XDR осол (incident) эсвэл өөрийн SOC-ийн үүсгэсэн осолд бүртгэгдсэн хэрэглэгчийн node дээр хариу арга хэмжээ (response action) авахад ашиглана. Хүсэлтийг XDR ослын ID-аар, эсвэл node-д заасан хэрэглэгчийн мэдээллээр гаргаж болно.

Параметрүүд

username — үйл явдалд оролцсон хэрэглэгчийн нэр; төрөл: String. actiontype нь 1, 2, 3, 4, 5, 8, 9 эсвэл 12 үед заавал шаардлагатай. actionType нь 6 үед ослын ID өгөөгүй тохиолдолд л хэрэглэгчийн нэр шаардлагатай. actionType нь 1, 3, 5, 6, 8 эсвэл 9 үед энэ параметр зөв и-мэйл байх ёстой. actionType нь 2 эсвэл 4 үед domain\username форматтай байх ёстой: мөр нь нэг ширхэг ташуу зураас (backslash) агуулж, домэйн ба хэрэглэгчийн нэр гэсэн яг хоёр хэсгээс бүрдэнэ. actionType нь 12 үед хоосон биш дурын мөр байж болно. Жишээ: "username": "user@bitdefender.com"
emailId — хэрэглэгчийн node-той холбогдох и-мэйл ID; төрөл: String. actionType нь 11 үед энэ нь төстэй и-мэйлүүдийг тодорхойлоход ашиглах жишиг и-мэйлийн ID болно. actionType нь 6 үед заавал шаардлагатай. actionType нь 11 бөгөөд incidentId ашиглаж, осолд нэгээс олон и-мэйл нөөц байгаа үед мөн заавал шаардлагатай. actionType нь 11, incidentId ашигласан бөгөөд осолд яг нэг и-мэйл нөөц байвал emailId нь тэр и-мэйлийн ID-г автоматаар авна. Жишээ: "emailId": "AAMkADNiNWU0YTljLTRiYmEtNGFlMi1iNzRhLWI5NDk4Y2QwOWM1NQBGAAAAAAD3LHfFVxR-TIchBqXPMdrxBwAlFp_8PvdsSKRtFCjiDPaqAAAAAAEMAAAlFp_8PvdsSKRtFCjiDPaqAAAQLe0eAAA="
actionType — авах арга хэмжээний төрөл ба түүнийг ямар орчинд хэрэглэх; хүсэлтэд заавал орно; төрөл: Integer. Боломжит утгууд:

- 1 - Microsoft 365 (Office 365) эсвэл Entra ID (Azure AD) хэрэглэгчийн нэвтрэх мэдээллийг шинэчлэх.
- 2 - Active Directory хэрэглэгчийн нэвтрэх мэдээллийг шинэчлэх.
- 3 - Microsoft 365 (Office 365) эсвэл Entra ID (Azure AD) хэрэглэгчийг идэвхгүй болгох.
- 4 - Байгууллагын дотоод (on-premises) Active Directory хэрэглэгчийг идэвхгүй болгох.
- 5 - Microsoft 365 (Office 365) эсвэл Entra ID (Azure AD) хэрэглэгчийг эвдэрсэн (compromised) гэж тэмдэглэх.
- 6 - Microsoft 365 (Office 365) хэрэглэгчийн дансны и-мэйлийг устгах.
- 8 - Google хэрэглэгчийг идэвхгүй болгох.
- 9 - Google хэрэглэгчийн нэвтрэх мэдээллийг шинэчлэх.
- 10 - Microsoft 365 (Office 365) OneDrive эсвэл SharePoint файлыг устгах.
- 11 - Microsoft 365 (Office 365) хэрэглэгчээс жишиг и-мэйлтэй төстэй и-мэйлүүдийг устгах.
- 12 - AWS хэрэглэгчийг идэвхгүй болгох.

Жишээ: "actionType": 4

incidentId — хэрэглэгчийн node-ууд харъяалагдах ослын ID; төрөл: String; нэмэлт шаардлага байхгүй. Хүсэлтэд incidentId эсвэл integrationIdentifiers-ийн аль нэг заавал орно.

> Чухал: incidentId болон integrationIdentifiers хоёуланг нь өгвөл хүсэлтийг зөвхөн incidentId-аар боловсруулна. Энэ тохиолдолд integrationIdentifiers параметрийг үл тооно.

Жишээ: "incidentId": "5b680f6fb1a43d860a7b23c0"

integrationIdentifiers — хэрэглэгчийг импортлоход ашигласан интеграцийг тодорхойлоход шаардлагатай мэдээлэл; төрөл: Object. Доорх integrationIdentifiers хэсгийг үзнэ үү. Жишээ: "integrationIdentifiers": { "companyId": "66b08ace2f15a991ca079343", "officeTenantId": "123e4567-e89b-12d3-a456-426614174000" }
targets — зөвхөн actionType 11-д дэмжигдэнэ. Устгах Microsoft 365 (Office 365)-ийн аль төстэй и-мэйлүүдийг заана. И-мэйл бүрийг хэрэглэгч ба и-мэйл ID-аар, эсвэл төстэй байдлын хэшээр (similarity hash) тодорхойлж болно. integrationIdentifiers ашиглах үед заавал шаардлагатай; incidentId ашиглах үед хамаарахгүй; төрөл: Object эсвэл Array of Objects. Array of Objects бол объект бүр userId ба mailIds-ийг агуулах ба бүх объект дахь и-мэйл ID-ийн нийт тоо 1000-аас хэтэрч болохгүй. Object бол зөвхөн similarityHash-ийг агуулна. Доорх targets хэсгийг үзнэ үү.

- Ижил similarity hash-тай бүх и-мэйлийг устгах: "targets": { "similarityHash": "a1b2c3d4e5f6" }
- Хэрэглэгч ба и-мэйл ID-аар тодорхойлсон жагсаасан и-мэйлүүдийг устгах: "targets": [ { "userId": "d0c55688-45c4-4bfc-a033-c49caa3b3b9d", "mailIds": [ "AAMkADhkNTIyNjYzLTQ1ZmYtNDZlNi1iMjExLWVmZjhlYWRjYzIxNABGAAAAAAB7fiYJE372QbIC-lf_MXEHBwAJPJXoGMjpRYZoFcE4nZMWAAAAAAEPAAAJPJXoGMjpRYZoFcE4nZMWAAPF9SdxAAA=" ] } ]

fileUrl — устгах файлын URL; зөвхөн actionType 10-д дэмжигдэнэ; actionType нь 10 үед заавал шаардлагатай; төрөл: String; нэмэлт шаардлага байхгүй. Жишээ: "fileUrl": "https://example-my.sharepoint.com/personal/xDocuments/x.txt.exe"

Бүх public API аргад нийтлэг параметрүүд

id — хүсэлтийг хариутай нь холбох таниулагч. Хүлээн авагч хариунд ижил утгыг буцаадаг тул дуудлагыг амархан мөрдөнө; хүсэлтэд заавал орно; төрөл: String; нэмэлт шаардлага байхгүй. Жишээ: "id": "ad12cb61-52b3-4209-a87a-93a8530d91cb"
method — хүсэлт илгээж буй аргын нэр; хүсэлтэд заавал орно; төрөл: String; зөв аргын нэр байх ёстой. Жишээ: "method": "methodName"
jsonrpc — хүсэлт ба хариуд хэрэглэх JSON-RPC-ийн хувилбар; хүсэлтэд заавал орно; төрөл: String; цорын ганц боломжит утга нь 2.0. Жишээ: "jsonrpc": "2.0"
params — хүсэлтийн тохиргоог агуулсан объект; хүсэлтэд заавал орно; төрөл: Object; нэмэлт шаардлага байхгүй. Жишээ: "params": {...}

Объектууд

`integrationIdentifiers`

Интеграцийн төрлөөс хамаарч дараах гурван багцын аль нэгийг ашиглана.

Active Directory (adUserSid):

companyId — интеграцийг хийсэн компанийн ID; хүсэлтэд заавал орно; төрөл: String.
adUserSid — зорилтот хэрэглэгчийн Security Identifier (SID); хүсэлтэд заавал орно; төрөл: String. Энэ параметрийн утга зөв SID байх ёстой.

Microsoft 365 (Office 365) (officeTenantId):

companyId — интеграцийг хийсэн компанийн ID; хүсэлтэд заавал орно; төрөл: String.
officeTenantId — интеграци үүсгэхэд ашигласан Microsoft 365 (Office 365) таниулагч; хүсэлтэд заавал орно; төрөл: String. Энэ параметрийн утга зөв GUID байх ёстой.

Google (sensorIdentifier):

companyId — интеграцийг хийсэн компанийн ID; хүсэлтэд заавал орно; төрөл: String.
sensorIdentifier — интеграци үүсгэхэд ашигласан Google client и-мэйл; хүсэлтэд заавал орно; төрөл: String. Энэ параметр зөв и-мэйл форматтай байх ёстой.

AWS хэрэглэгчийг идэвхгүй болгох

companyId — интеграцийг хийсэн компанийн ID; хүсэлтэд заавал орно; төрөл: String.
accessKeyId — AWS интеграцийг тохируулахад ашигласан AWS Access Key ID. Идэвхгүй болгох хүсэлтийг гүйцэтгэх AWS дансыг тодорхойлно. Ингэснээр Deactivate AWS user үйлдэл зөв AWS орчинд хэрэгжинэ; хүсэлтэд заавал орно; төрөл: String. Энэ параметр AWS түлхүүрийн зөв форматтай байх ёстой.

`targets`

similarityHash — төстэй и-мэйлүүдийг тодорхойлоход ашиглах төстэй байдлын хэш; заавал биш; төрөл: String.
userId — устгах и-мэйлийг хүлээн авсан эсвэл илгээсэн хэрэглэгчийн гадаад ID; mailIds-тай хамт ашиглахад шаардлагатай; similarityHash заасан бол хамаарахгүй; төрөл: String.
mailIds — userId-аар тодорхойлогдсон хэрэглэгчид хамаарах, устгах и-мэйлүүдийн ID; userId-тай хамт ашиглахад шаардлагатай; similarityHash заасан бол хамаарахгүй; төрөл: Array of Strings.

Буцаах утга

result — String; үүсгэсэн хариу арга хэмжээний ID.

Жишээнүүд

Хүсэлт

Ослын ID-аар хариу арга хэмжээ үүсгэх:

{
      "params": {
          "username": "username",
          "actionType": 1,
          "incidentId": "5b680f6fb1a43d860a7b23c0"
      },
      "jsonrpc": "2.0",
      "method": "createResponseAction",
      "id": "7d2864e9-c67b-48a2-9ba3-0a11d47e83c8"
}

{
      "params": {
          "username": "username",
          "actionType": 2,
          "incidentId": "5b680f6fb1a43d860a7b23c0"
      },
      "jsonrpc": "2.0",
      "method": "createResponseAction",
      "id": "7d2864e9-c67b-48a2-9ba3-0a11d47e83c8"
}

{
      "params": {
          "username": "username",
          "actionType": 3,
          "incidentId": "5b680f6fb1a43d860a7b23c0"
      },
      "jsonrpc": "2.0",
      "method": "createResponseAction",
      "id": "7d2864e9-c67b-48a2-9ba3-0a11d47e83c8"
}

{
      "params": {
          "username": "username",
          "actionType": 4,
          "incidentId": "5b680f6fb1a43d860a7b23c0"
      },
      "jsonrpc": "2.0",
      "method": "createResponseAction",
      "id": "7d2864e9-c67b-48a2-9ba3-0a11d47e83c8"
}

{
      "params": {
          "username": "username",
          "actionType": 5,
          "incidentId": "5b680f6fb1a43d860a7b23c0"
      },
      "jsonrpc": "2.0",
      "method": "createResponseAction",
      "id": "7d2864e9-c67b-48a2-9ba3-0a11d47e83c8"
}

{
      "params": {
          "emailId": "AAMkAGRlNjg4ZjM4LTNjNWMtNDdiOS04OWE5LTMzYT=",
          "username": "username",
          "actionType": 6,
          "incidentId": "5b680f6fb1a43d860a7b23c0"
      },
      "jsonrpc": "2.0",
      "method": "createResponseAction",
      "id": "7d2864e9-c67b-48a2-9ba3-0a11d47e83c8"
}

{
    "params": {
        "actionType": 8,
        "username": "example@bitdefender.com",
        "incidentId": "6851e28bc26a4618fe061101"
    },
    "jsonrpc": "2.0",
    "method": "createResponseAction",
    "id": "0df7568c-59c1-48e0-a31b-18d83e6d9810"
}

{
    "params": {
        "actionType": 9,
        "username": "example@bitdefender.com",
        "incidentId": "6851e28bc26a4618fe061101"
    },
    "jsonrpc": "2.0",
    "method": "createResponseAction",
    "id": "0df7568c-59c1-48e0-a31b-18d83e6d9810"
}

{
    "id": "7d2864e9-c67b-48a2-9ba3-0a11d47e83c8",
    "jsonrpc": "2.0",
    "method": "createResponseAction",
    "params": {
        "actionType": 10,
        "incidentId": "693b9615d3ea526e60ed7c99",
        "fileUrl": "https://example-my.sharepoint.com/personal/xDocuments/x.txt.exe"
    }
}

{
    "params": {
        "actionType": 11,
        "incidentId": "6908d87294d8ed19804f8544",
        "emailId": "AAMkADNiNWU0YTljLTRiYmEtNGFlMi1iNzRhLWI5NDk4Y2QwOWM1NQBGAAAAAAD3LHfFVxR-TIchBqXPMdrxBwAlFp_8PvdsSKRtFCjiDPaqAAAAAAEMAAAlFp_8PvdsSKRtFCjiDPaqAAAQLe0eAAA="
    },
    "jsonrpc": "2.0",
    "method": "createResponseAction",
    "id": "7d2864e9-c67b-48a2-9ba3-0a11d47e83c8"
}

{
    "id": "request-id",
    "jsonrpc": "2.0",
    "method": "createResponseAction",
    "params": {
        "actionType": 12,
        "username": "aws-username-example",
        "incidentId": "68f769507b3655a5f4e42d0e"
    }
}

Компанийн ID болон интеграцийн таниулагчаар хүсэлт үүсгэх:

{
     "params": {
          "username": "user@bitdefender.com",
          "actionType": 1,
          "integrationIdentifiers": {
             "companyId": "5b680f6fb1a43d860a7b23c8",
             "officeTenantId": "123e4567-e89b-12d3-a456-426614174000"
          }
     },
     "jsonrpc": "2.0",
     "method": "createResponseAction",
     "id": "7d2864e9-c67b-48a2-9ba3-0a11d47e83c8"
}

{
  "params": {
      "username": "domain\\user",
      "actionType": 2,
      "integrationIdentifiers": {
          "companyId": "5b680f6fb1a43d860a7b23c8",
          "adUserSid": "S-1-5-21-3623811015-3361044348-30300820-1013"
      }
  },
  "jsonrpc": "2.0",
  "method": "createResponseAction",
  "id": "7d2864e9-c67b-48a2-9ba3-0a11d47e83c8"
}

{
     "params": {
          "username": "user@bitdefender.com",
          "actionType": 3,
          "integrationIdentifiers": {
             "companyId": "5b680f6fb1a43d860a7b23c8",
             "officeTenantId": "123e4567-e89b-12d3-a456-426614174000"
          }
     },
     "jsonrpc": "2.0",
     "method": "createResponseAction",
     "id": "7d2864e9-c67b-48a2-9ba3-0a11d47e83c8"
}

{
  "params": {
      "username": "domain\\user",
      "actionType": 4,
      "integrationIdentifiers": {
          "companyId": "5b680f6fb1a43d860a7b23c8",
          "adUserSid": "S-1-5-21-3623811015-3361044348-30300820-1013"
      }
  },
  "jsonrpc": "2.0",
  "method": "createResponseAction",
  "id": "7d2864e9-c67b-48a2-9ba3-0a11d47e83c8"
}

{
     "params": {
          "username": "user@bitdefender.com",
          "actionType": 5,
          "integrationIdentifiers": {
             "companyId": "5b680f6fb1a43d860a7b23c8",
             "officeTenantId": "123e4567-e89b-12d3-a456-426614174000"
          }
     },
     "jsonrpc": "2.0",
     "method": "createResponseAction",
     "id": "7d2864e9-c67b-48a2-9ba3-0a11d47e83c8"
}

{
  "params": {
    "emailId": "AAMkAGRlNjg4ZjM4LTNjNWMtNDdiOS04OWE5LTMzYT=",
    "username": "user@bitdefender.com",
    "actionType": 6,
    "integrationIdentifiers": {
      "companyId": "66b08ace2f15a991ca079343",
      "officeTenantId": "123e4567-e89b-12d3-a456-426614174000"
    }
  },
  "jsonrpc": "2.0",
  "method": "createResponseAction",
  "id": "7d2864e9-c67b-48a2-9ba3-0a11d47e83c8"
}

{
    "params": {
        "username": "targetuser@bitdefender.com",
        "actionType": 8,
        "integrationIdentifiers": {
            "companyId": "6851e78bc26a4618fe061802",
            "sensorIdentifier": "googleclient@bitdefender.com"
        }
    },
    "jsonrpc": "2.0",
    "method": "createResponseAction",
    "id": "0df7568c-59c1-48e0-a31b-18d83e6d9810"
}

{
    "params": {
        "username": "targetuser@bitdefender.com",
        "actionType": 9,
        "integrationIdentifiers": {
            "companyId": "6851e78bc26a4618fe061802",
            "sensorIdentifier": "googleclient@bitdefender.com"
        }
    },
    "jsonrpc": "2.0",
    "method": "createResponseAction",
    "id": "0df7568c-59c1-48e0-a31b-18d83e6d9810"
}

{
    "params": {
        "actionType": 10,
        "fileUrl": "https://example-my.sharepoint.com/personal/xDocuments/x.txt.exe",
        "integrationIdentifiers": {
            "companyId": "7037077785c907e4ca044812",
            "officeTenantId": "8ddf1a13-957f-4d11-927e-5a140590f249"
        }
    },
    "jsonrpc": "2.0",
    "method": "createResponseAction",
    "id": "7d2864e9-c67b-48a2-9ba3-0a11d47e83c8"
}

{
    "params": {
        "actionType": 11,
        "integrationIdentifiers": {
            "companyId": "5b680f6fb1a43d860a7b23c8",
            "officeTenantId": "3b8624b5-06e7-45fc-8b56-4e24a9909bc0"
        },
        "targets": {
            "similarityHash": "a1b2c3d4e5f6"
        }
    },
    "jsonrpc": "2.0",
    "method": "createResponseAction",
    "id": "7d2864e9-c67b-48a2-9ba3-0a11d47e83c8"
}

{
    "params": {
        "actionType": 11,
        "integrationIdentifiers": {
            "companyId": "5b680f6fb1a43d860a7b23c8",
            "officeTenantId": "3b8624b5-06e7-45fc-8b56-4e24a9909bc0"
        },
        "targets": [
            {
                "userId": "d0c55688-45c4-4bfc-a033-c49caa3b3b9d",
                "mailIds": [
                    "AAMkADhkNTIyNjYzLTQ1ZmYtNDZlNi1iMjExLWVmZjhlYWRjYzIxNABGAAAAAAB7fiYJE372QbIC-lf_MXEHBwAJPJXoGMjpRYZoFcE4nZMWAAAAAAEPAAAJPJXoGMjpRYZoFcE4nZMWAAPF9SdxAAA="
                ]
            }
        ]
    },
    "jsonrpc": "2.0",
    "method": "createResponseAction",
    "id": "7d2864e9-c67b-48a2-9ba3-0a11d47e83c8"
}

{
    "id": "request-id",
    "jsonrpc": "2.0",
    "method": "createResponseAction",
    "params": {
        "actionType": 12,
        "username": "aws-username-example",
        "integrationIdentifiers": {
            "companyId": "68ee48a6b99deb23920d66f2",
            "accessKeyId": "AAAAAAAAAAAAAAAAAAAA"
        }
    }
}

Хариу

{
    "id": "7d2864e9-c67b-48a2-9ba3-0a11d47e83c8",
    "jsonrpc": "2.0",
    "result": "6560a95884f89d6eca0b61b1"
}

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

Incidents: Илэрсэн халдлага, түүний алхмуудын бүртгэл (EDR/XDR)

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