权限和授权项
如果您需要对您所拥有的企业搜索服务进行精细的权限管理,您可以使用统一身份认证服务(Identity and Access Management,简称IAM)。如果华为帐号已经能满足您的要求,不需要创建独立的IAM用户,您可以跳过本章节,不影响您使用企业搜索服务的其它功能。
在创建IAM用户时,需要勾选“访问方式>编程访问”,勾选后该IAM用户才有权限访问API。
默认情况下,新建的IAM用户没有任何权限,您需要将其加入用户组,并给用户组授予策略(以JSON格式描述权限集的语言),才能使用户组中的用户获得策略定义的权限,这一过程称为授权。授权后,用户就可以基于策略对云服务进行操作。关于策略的语法结构及示例,请参见权限管理章节。
根据授权的精细程度,分为角色和策略。角色以服务为粒度,是IAM最初提供的一种根据用户的工作职能定义权限的粗粒度授权机制。策略以API接口为粒度进行权限拆分,授权更加精细,可以精确到某个操作、资源和条件,能够满足企业对权限最小化的安全管控要求。
企业搜索服务系统策略说明请参考企业搜索服务《产品介绍》中的“权限管理”章节。
如果您需要允许或者禁止某个接口的操作权限,请使用策略。
华为帐号具备所有接口的调用权限,如果使用帐号下的IAM用户发起API请求时,该IAM用户必须具备调用该接口所需的权限,否则,API请求将调用失败。每个接口所需要的权限,与各个接口所对应的授权项相对应,只有发起请求的IAM用户被授予授权项所对应的策略,该用户才能成功调用该接口。例如,IAM用户要调用接口来搜索数据集,那么这个IAM用户被授予的策略中必须包含允许“KooSearch:experience:use”的授权项,该接口才能调用成功。
支持的授权项
细粒度策略支持的操作与API相对应,授权项列表说明如下:
- 权限:自定义策略中授权项定义的内容即为权限。
- 对应API接口:自定义策略实际调用的API接口。
- 授权项:自定义策略中支持的Action,在自定义策略中的Action中写入授权项,可以实现授权项对应的权限功能。
- 授权范围:自定义策略的授权范围,包括IAM项目与企业项目。授权范围如果同时支持IAM项目和企业项目,表示此授权项对应的自定义策略,可以在IAM和企业管理两个服务中给用户组授权并生效。如果仅支持IAM项目,不支持企业项目,表示仅能在IAM中给用户组授权并生效,如果在企业管理中授权,则该自定义策略不生效。关于IAM项目与企业项目的区别,详情请参见:IAM项目和企业项目的区别。
企业搜索服务管理控制操作相关的授权项,明细如下表所示。用户调用如下API时,需要获取对应的权限。权限获取请参考统一身份认证服务(IAM)的帮助指导。
“√”表示支持,“x”表示暂不支持。
权限描述 |
授权项(Action) |
对应的API |
IAM项目(Project) |
企业项目(Enterprise Project) |
---|---|---|---|---|
上传数据 |
KooSearch:experience:manage |
POST /v1/{project_id}/data-collections/{dataCollectionName} |
√ |
× |
搜索数据 |
KooSearch:experience:use |
POST /v1/{project_id}/search/query |
√ |
× |
查询热搜词 |
KooSearch:experience:use |
POST /v1/{project_id}/search/hotword |
√ |
× |
开通服务 |
KooSearch:*:* |
GET /v1/provision/serviceSubscription?scenario=e-commerce |
√ |
× |
查询服务开通状态 |
KooSearch:*:* |
GET /v1/provision/queryServiceStatus |
√ |
× |
创建搜索配置 |
KooSearch:experience:manage |
POST /console-backend/v2/search-config/configs |
√ |
× |
修改搜索配置 |
KooSearch:experience:manage |
PUT /console-backend/v2/search-config/configs |
√ |
× |
查询搜索配置列表 |
KooSearch:experience:manage |
GET /console-backend/v2/search-conf/configs |
√ |
× |
查询搜索配置详情 |
KooSearch:experience:manage |
GET /console-backend/v2/search-config/configs/{config-id} |
√ |
× |
查询搜索配置模板列表 |
KooSearch:experience:manage |
GET /console-backend/v2/search-config/templates/{template-id} |
√ |
× |
应用搜索配置 |
KooSearch:experience:manage |
POST /console-backend/v2/search-config/configs/{config-id}/application |
√ |
× |
删除搜索配置 |
KooSearch:experience:manage |
DELETE /console-backend/v2/search-config/configs/{config-id} |
√ |
× |