创建公司
此方法用于创建客户或合作伙伴公司账户。
参数
|
参数 |
类型 |
可选 |
描述 |
||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
|
数字 |
否 |
公司类型。可选值:
|
||||||||||
|
|
字符串 |
否 |
公司名称。必须唯一。 |
||||||||||
|
|
字符串 |
是 |
母公司合作伙伴的ID。 |
||||||||||
|
|
字符串 |
是 |
公司的实际地址。 |
||||||||||
|
|
字符串 |
是 |
公司运营所在国家。取值必须符合
ISO 3166格式
。默认值:
|
||||||||||
|
|
字符串 |
是 |
公司运营所在国家的州/省。取值必须符合
ISO 3166格式
。默认值:
|
||||||||||
|
|
字符串 |
是 |
公司的电话号码。 |
||||||||||
|
|
整数 |
是 |
公司所属行业。可能的值:
默认值:
|
||||||||||
|
|
布尔型 |
是 |
用于定义新公司安全是否可由其合作伙伴公司管理的选项。可选值:
|
||||||||||
|
|
布尔型 |
是 |
该参数定义公司内所有
GravityZone
用户账户是否强制启用双因素认证(2FA)。该值始终为
|
||||||||||
|
|
数值型 |
是 |
以天为单位定义的期限,在此期间公司用户可免于在认证时提供双因素代码。可选值:
|
||||||||||
|
|
字符串 |
是 |
待关联至新公司的新用户账户邮箱。若参数
|
||||||||||
|
|
字符串 |
是 |
待关联至新公司的新用户账户全名。当参数
|
||||||||||
|
|
对象 |
是 |
包含公司指定联系人的相关信息。该对象包含以下字段:
|
||||||||||
|
|
字符串 |
是 |
要关联到新公司的新用户账户的时区。默认值为
|
||||||||||
|
|
字符串 |
是 |
要关联到新公司的新用户账户的用户界面语言。默认值为
|
||||||||||
|
|
对象 |
是 |
包含许可证详细信息的对象:
若未指定,公司将以许可证订阅类型
|
||||||||||
|
|
对象 |
否 注意创建合作伙伴公司或其他类型许可证的公司时为必填项。 |
包含公司指定紧急联系信息的对象,供MDR团队在安全事件或事故时使用。 注意此信息必须有效,且对以下公司类型为必填项:
包含以下详细信息:
|
||||||||||
|
|
对象 |
是 |
包含公司自定义字段值的对象。 |
返回值
此方法返回一个字符串:新创建公司的ID。
示例
请求 :
一个使用月度订阅许可证的合作伙伴公司,具有端点安全产品类型和按需保护模型:
{
"params": {
"type": 0,
"name": "Partner LTD",
"parentId": "64babaafab366c53d20c83ca",
"address": "Str Example No 1",
"country": "US",
"state": "US-CA",
"phone": "0040740000000",
"industry": 2,
"canBeManagedByAbove": true,
"enforce2FA": true,
"skip2FAPeriod": 3,
"accountEmail": "partner@example.com",
"accountFullName": "Partner account",
"contactPerson": {
"fullName": "Stephen Johnson",
"email": "stephen.johnson@example.email.com",
"phoneNumber": "0040740000001",
"companyRole": "Owner / President"
},
"licenseSubscription": {
"type": 3,
"reservedSlots": 120,
"endSubscription": "2028-04-14",
"autoRenewPeriod": 12,
"manageExchange": false,
"manageEncryption": false,
"managePatchManagement": false,
"manageIntegrityMonitoring": true,
"imDataRetention": 2,
"manageEmailSecurity": true,
"manageMobileSecurity": true,
"edrDataRetention": 2,
"ownUse": {
"manageXDRIdentityProviders": true,
"manageXDRProductivityApps": true,
"manageXDRNetwork": true,
"manageXDRCloudWorkloads": true,
"manageRemoteEnginesScanning": true,
"manageContainerProtection": true,
"manageHyperDetect": true,
"manageSandboxAnalyzer": true,
"manageEventCorrelator": true,
"manageComplianceManager": true
},
"resell": {
"manageXDRResell": true,
"manageRemoteEnginesScanningResell": true,
"manageContainerProtectionResell": true,
"manageHyperDetectResell": true,
"manageSandboxAnalyzerResell": true,
"manageEventCorrelatorResell": true,
"manageComplianceManagerResell": true
},
"minimumUsage": {
"endpointMonthlyUsage": 120
},
"assignedProductType": 0,
"additionalProductTypes": [
0
],
"assignedProtectionModel": "aLaCarte",
"additionalProtectionModels": [
"aLaCarte",
"mspSecure",
"mspSecurePlus",
"mspSecureExtra"
],
"licensedServices": {
"mdrServiceOwnUse": 1
}
},
"mdrContactInformation": {
"phoneNumber": {
"countryPrefix": "+4",
"subscriberNumber": "112345"
},
"fullName": "Contact",
"email": "mdrcontact@nebula.local",
"emailVerificationCode": "43728676"
},
"customFields": {
"referenceID": "004562",
"vertical": "healthcare",
"partner_type": "platinum",
"security_level": "high",
"payment_status": "goodstanding"
}
},
"jsonrpc": "2.0",
"method": "createCompany",
"id": "e249c22c-0ada-4772-a9f1-ee1cbb322588"
}
一个使用月度订阅许可证的合作伙伴公司,具有端点安全产品类型和安全保护模型:
{
"params": {
"type": 0,
"name": "合作伙伴有限公司",
"parentId": "64babaafab366c53d20c83ca",
"address": "示例街道1号",
"country": "美国",
"state": "美国-加利福尼亚州",
"phone": "0040740000000",
"industry": 2,
"canBeManagedByAbove": true,
"enforce2FA": true,
"skip2FAPeriod": 3,
"accountEmail": "partner@example.com",
"accountFullName": "合作伙伴账户",
"contactPerson": {
"fullName": "斯蒂芬·约翰逊",
"email": "stephen.johnson@example.email.com",
"phoneNumber": "0040740000001",
"companyRole": "所有者/总裁"
},
"licenseSubscription": {
"type": 3,
"reservedSlots": 120,
"endSubscription": "2028-04-14",
"autoRenewPeriod": 12,
"manageExchange": false,
"manageEncryption": false,
"managePatchManagement": false,
"manageIntegrityMonitoring": true,
"imDataRetention": 2,
"manageEmailSecurity": true,
"manageMobileSecurity": true,
"edrDataRetention": 2,
"ownUse": {
"manageXDRIdentityProviders": true,
"manageXDRProductivityApps": true,
"manageXDRNetwork": true,
"manageXDRCloudWorkloads": true,
"manageHyperDetect": true,
"manageSandboxAnalyzer": true,
"manageEventCorrelator": true,
"managePHASR": false,
"manageEASM": false,
"manageComplianceManager": true
},
"resell": {
"manageXDRResell": true,
"manageHyperDetectResell": true,
"manageSandboxAnalyzerResell": true,
"manageEventCorrelatorResell": true,
"managePHASRResell": true,
"manageEASMResell": true,
"manageComplianceManagerResell": true
},
"minimumUsage": {
"endpointMonthlyUsage": 120
},
"assignedProductType": 0,
"additionalProductTypes": [
0
],
"assignedProtectionModel": "mspSecure",
"additionalProtectionModels": [
"mspSecure",
],
"licensedServices": {
"mdrServiceOwnUse": 1
}
},
"mdrContactInformation": {
"phoneNumber": {
"countryPrefix": "+4",
"subscriberNumber": "112345"
},
"fullName": "联系人",
"email": "mdrcontact@nebula.local",
"emailVerificationCode": "43728676"
},
"customFields": {
"referenceID": "004562",
"vertical": "医疗保健",
"partner_type": "白金级",
"security_level": "高",
"payment_status": "信用良好"
}
},
"jsonrpc": "2.0",
"method": "createCompany",
"id": "e249c22c-0ada-4772-a9f1-ee1cbb322588"
}
一家使用年度许可的客户公司,具有:
{
"params": {
"type": 0,
"name": "客户有限公司",
"address": "示例街1号",
"country": "美国",
"state": "美国-加利福尼亚州",
"phone": "0040740000000",
"industry": 2,
"enforce2FA": true,
"skip2FAPeriod": 3,
"accountEmail": "customer@example.com",
"accountFullName": "客户账户",
"contactPerson": {
"fullName": "斯蒂芬·约翰逊",
"email": "stephen.johnson@example.email.com",
"phoneNumber": "0040740000001",
"companyRole": "所有者/总裁"
},
"licenseSubscription": {
"type": 2,
"licenseKey": "1b2b3c",
"reservedSlots": 120,
"endSubscription": "2028-04-14",
"autoRenewPeriod": 12
},
"mdrContactInformation": {
"phoneNumber": {
"countryPrefix": "+4",
"subscriberNumber": "112345"
},
"fullName": "联系人",
"email": "mdrcontact@nebula.local",
"emailVerificationCode": "43728676"
},
"customFields": {
"referenceID": "004562",
"vertical": "医疗保健",
"partner_type": "白金",
"security_level": "高",
"payment_status": "良好"
}
},
"jsonrpc": "2.0",
"method": "createCompany",
"id": "e249c22c-0ada-4772-a9f1-ee1cbb322588"
}
响应 :
{
"id": "e249c22c-0ada-4772-a9f1-ee1cbb322588",
"jsonrpc": "2.0",
"result": "5493dcd2b1a43df00b7b23c6"
}