跳至主要内容

setLicenseKey

此方法用于为公司设置独立或附加的许可证密钥。

参数

参数

类型

可选

描述

licenseKey

字符串

待设置的许可证密钥。

companyId

字符串

待设置许可证的公司ID。若未传值,将默认选择用户所属公司。

MDR联系信息

对象

包含公司指定紧急联系人详细信息的对象,供MDR团队在安全事件或事故时使用。

注意

该信息必须有效且对以下公司类型为必填项:

  • 任何需要启用MDR服务的年度许可证持有公司。

该对象包含以下字段:

  • 电话号码 ,包含通过电话联系公司所需联系方式的对象。其包含以下信息:

    • 国家区号 ,表示公司所在国家电话区号的整数。

      注意

      对于没有唯一区号的国家,需同时包含 国家代码 参数。

      以下区号由多个国家共用: +1 , +599 , +39 , +7 , +39 .

    • countryCode ,表示公司所在国家的ISO 3166-1 alpha-2代码的字符串。

      注意

      仅当公司所在地区与其他国家共用电话前缀时,才应使用此参数来标识国家。

    • subscriberNumber ,表示公司电话号码的本地部分(不含国家前缀或国内拨号代码)的字符串。

  • fullName ,包含公司指定紧急联系人全名的字符串。

  • email ,包含公司指定紧急联系人电子邮件地址的字符串。

  • emailVerificationCode ,用于验证指定电子邮件地址所有权的字符串或数字代码。

    注意

    可通过调用 generateEmailVerificationCode 方法获取此代码。

  • useDataFromAccount ——表示 GravityZone 用户账户ID的字符串,将从此账户导入所有相关联系信息(包括全名、电子邮件和电话号码)。

    注意

    指定此参数时,将覆盖 phoneNumber , fullNameemail 参数。这些参数与 useDataFromAccount .

    若指定用户账户此前未经验证, emailVerificationCode 则请求中必须同时包含该字段。

  • useDataFromCompany - 表示 GravityZone 公司账户ID的环形参数,用于导入所有相关联系信息(包括全名、电子邮箱及电话号码)。

    注意

    指定此参数时,它将替代 phoneNumber , fullName 及email字段。这些参数与 emailVerificationCode 均不得与 useDataFromCompany .

返回值

本方法不返回任何值。

示例

请求 :

{
       "params": {
          "licenseKey" : "TNB3AAA","companyId" : "5493dcd2b1a43df00b7b23c6","mdrContactInformation": {
              "phoneNumber": {
                  "countryPrefix": "+4",     
                  "subscriberNumber": "112345"
              },
              "fullName": "联系人",
              "email": "mdrcontact@nebula.local",
              "emailVerificationCode": "43728676"
          }
       },
       "jsonrpc": "2.0",
       "method": "setLicenseKey",
       "id": "48daf1bc-4078-411c-bf44-4f293e68f501"
  }

响应 :

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