addProductKey аргаар лицензийн түлхүүр нэмэх

Энэ арга нь одоо байгаа лиценз болон add-on түлхүүрүүдийн жагсаалтад лицензийн эсвэл add-on түлхүүр нэмнэ.

Параметрууд

• licenseKey — төрөл: String; заавал: Тийм. Тохируулах лицензийн түлхүүр. Энэ нь add-on эсвэл үндсэн лиценз байж болно.
• replaceIncompatibleKeys — төрөл: Boolean; заавал биш. Үнэн (true) бол шинэ лицензийн түлхүүртэй нийцэхгүй одоо байгаа бүх үндсэн лиценз эсвэл add-on-ыг устгаж, шинэ лицензийг одоо байгаа үндсэн лиценз эсвэл add-on түлхүүрүүдэд нэмнэ. Үндсэн утга нь true.
• mdrContactInformation — төрөл: Object; заавал биш. Аюулгүй байдлын үйл явдал, эвент болох үед MDR багт ашиглуулах зорилгоор компанийн томилсон яаралтай холбоо барих мэдээллийг агуулсан объект.

- Тэмдэглэл: Энэ мэдээлэл үнэн зөв байх ёстой бөгөөд дараах төрлийн компаниудад заавал шаардлагатай: MDR үйлчилгээг идэвхжүүлэхийг хүсэж буй жилийн лицензтэй аливаа компани.
- Объект дараах талбаруудыг агуулна:
- phoneNumber — компанитай утсаар холбогдоход шаардлагатай холбоо барих мэдээллийг агуулсан объект. Үүнд дараах мэдээлэл багтана:
- countryPrefix — компани байрлах улсын кодыг (prefix) агуулсан string.
> Тэмдэглэл: Өвөрмөц кодгүй улсуудын хувьд countryCode параметрийг бас оруулна. Дараах кодыг олон улс дундаа хэрэглэдэг: +1, +599, +39, +7, +39.
- countryCode — компани байрлах улсын ISO 3166-1 alpha-2 кодыг илэрхийлэх string.
> Тэмдэглэл: Компани утасны кодыг бусад улстай хуваалцдаг бүс нутагт байрладаг үед улсыг тодорхойлохын тулд энэ параметрийг countryPrefix-ийн оронд ашиглана.
- subscriberNumber — улсын код болон улс доторх залгах кодыг оруулалгүй, компанийн утасны дугаарын дотоод хэсгийг илэрхийлэх string.
- fullName — компаниас томилсон яаралтай холбоо барих хүний бүтэн нэрийг агуулсан string.
- email — компаниас томилсон яаралтай холбоо барих хүний и-мэйл хаягийг агуулсан string.
- emailVerificationCode — заасан и-мэйл хаягийн эзэмшлийг баталгаажуулах код (string).
> Тэмдэглэл: Энэ кодыг `generateEmailVerificationCode` аргаар авч болно.
- useDataFromAccount — холбоо барих бүх мэдээллийг (бүтэн нэр, и-мэйл, утасны дугаар) авах GravityZone хэрэглэгчийн дансны ID-г илэрхийлэх string.
> Тэмдэглэл: Энэ параметрийг зааж өгвөл phoneNumber, fullName, email-ийг орлоно. Эдгээр параметр нь useDataFromAccount-тай зэрэг ашиглагдах боломжгүй.
> Заасан хэрэглэгчийн данс өмнө нь баталгаажаагүй бол хүсэлтэд emailVerificationCode-ийг бас оруулна.
- useDataFromCompany — холбоо барих бүх мэдээллийг (бүтэн нэр, и-мэйл, утасны дугаар) авах GravityZone компанийн дансны ID-г илэрхийлэх string.
> Тэмдэглэл: Энэ параметрийг зааж өгвөл phoneNumber, fullName, email-ийг орлоно. Эдгээр параметр болон emailVerificationCode нь useDataFromCompany-тай зэрэг ашиглагдах боломжгүй.

Буцаах утга

Энэ арга ямар ч утга буцаадаггүй.

Жишээ

Хүсэлт:

MDR холбоо барих мэдээллийг гараар зааж лицензийн түлхүүр нэмэх.

{
  "params": {
    "licenseKey": "TNB3AAA",

    "replaceIncompatibleKeys": true,
    "mdrContactInformation": {
      "phoneNumber": {
        "countryPrefix": "+4",
        "subscriberNumber": "112345"
      },
      "fullName": "Contact",
      "email": "mdrcontact@nebula.local",
      "emailVerificationCode": "43728676"
    }
  },
  "jsonrpc": "2.0",
  "method": "addProductKey",
  "id": "48daf1bc-4078-411c-bf44-4f293e68f501"
}

Хэрэглэгчийн дансны мэдээллээс импортолсон MDR холбоо барих мэдээлэл ашиглан лицензийн түлхүүр нэмэх.

{
  "params": {
    "licenseKey": "TNB3AAA",

    "replaceIncompatibleKeys": true,
    "mdrContactInformation": {
      "useDataFromAccount": "user-1234567890",
      "emailVerificationCode": "43728676"
    }
  },
  "jsonrpc": "2.0",
  "method": "addProductKey",
  "id": "48daf1bc-4078-411c-bf44-4f293e68f501"
}

Компанийн дансны мэдээллээс импортолсон MDR холбоо барих мэдээлэл ашиглан лицензийн түлхүүр нэмэх.

{
  "params": {
    "licenseKey": "TNB3AAA",

    "replaceIncompatibleKeys": true,
    "mdrContactInformation": {
      "useDataFromCompany": "company-0987654321"
    }
  },
  "jsonrpc": "2.0",
  "method": "addProductKey",
  "id": "48daf1bc-4078-411c-bf44-4f293e68f501"
}

Хариу:

Тохирох лицензийн түлхүүр нэмэх үеийн хариу.

  {
        "id":"48daf1bc-4078-411c-bf44-4f293e68f501",
        "jsonrpc":"2.0",
        "result": null
}

Bitdefender EDR бүтээгдэхүүний төрөлтэй сарын захиалгат компанид GravityZone CSPM+ add-on нэмэхийг оролдох үеийн хариу.

{
  "jsonrpc": "2.0",
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": {
      "details": "You cannot add a GravityZone CSPM+ add-on license to companies with a monthly subscription using Bitdefender EDR."
    }
  },
  "id": "1603704207"
}