文档智能自定义权限策略参考_文档智能(Document Mind)-阿里云帮助中心

如果系统权限策略不能满足您的要求，您可以创建自定义权限策略实现最小授权。使用自定义权限策略有助于实现权限的精细化管控，是提升资源访问安全的有效手段。本文介绍文档智能使用自定义权限策略的场景和策略示例。

什么是自定义权限策略

在基于RAM的访问控制体系中，自定义权限策略是指在系统权限策略之外，您可以自主创建、更新和删除的权限策略。自定义权限策略的版本更新需由您来维护。

创建自定义权限策略后，需为RAM用户、用户组或RAM角色绑定权限策略，这些RAM身份才能获得权限策略中指定的访问权限。
已创建的权限策略支持删除，但删除前需确保该策略未被引用。如果该权限策略已被引用，您需要在该权限策略的引用记录中移除授权。
自定义权限策略支持版本控制，您可以按照RAM规定的版本管理机制来管理您创建的自定义权限策略版本。

操作文档

授权信息参考

使用自定义权限策略，您需要了解业务的权限管控需求，并了解文档智能的授权信息。

授权信息

访问控制（RAM）是阿里云提供的管理用户身份与资源访问权限的服务。使用RAM可以让您避免与其他用户共享阿里云账号密钥，并可按需为用户授予最小权限。RAM中使用权限策略描述授权的具体内容。

本文为您介绍文档智能（docmind）为RAM权限策略定义的操作（Action）、资源（Resource）和条件（Condition）。文档智能（docmind）的RAM代码（RamCode）为docmind，支持的授权粒度为OPERATION。

权限策略通用结构

权限策略支持JSON格式，其通用结构如下：

{  "Version": "1",  "Statement": [    {      "Effect": "<Effect>",      "Action": "<Action>",      "Resource": "<Resource>",      "Condition": {        "<Condition_operator>": {          "<Condition_key>": [            "<Condition_value>"          ]        }      }    }  ]}

各字段含义如下：

Effect：权限策略效果。取值：Allow（允许）、Deny（拒绝）。
Action：授予允许或拒绝权限的具体操作。具体信息，请参见操作（Action）。
Resource：受操作影响的具体对象，您可以使用资源ARN来描述指定资源。具体信息，请参见资源（Resource）
Condition：指授权生效的条件。可选字段。具体信息，请参见条件（Condition）
- Condition_operator：条件运算符，不同类型的条件对应不同的条件运算符。具体信息，请参见权限策略基本元素。
- Condition_key：条件关键字。
- Condition_value：条件关键字对应的值。

操作（Action）

下表是文档智能（docmind）定义的操作，这些操作可以在RAM权限策略语句的Action元素中使用，用来授予执行该操作的权限。下面对表中的具体项提供说明：

操作：是指具体的权限点。
API：是指操作对应的API接口。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用背景高亮的方式表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。该列不体现适用于任何操作的通用条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作	API	访问级别	资源类型	条件关键字	关联操作
docmind:SubmitDocStructureJob	SubmitDocStructureJob	Write	全部资源 *	无	无
docmind:SubmitTableUnderstandingJob	SubmitTableUnderstandingJob	Write	全部资源 *	无	无
docmind:SubmitDocumentExtractJob	SubmitDocumentExtractJob	Write	全部资源 *	无	无
docmind:SubmitConvertPdfToWordJob	SubmitConvertPdfToWordJob	Write	全部资源 *	无	无
docmind:SubmitConvertImageToWordJob	SubmitConvertImageToWordJob	Write	全部资源 *	无	无
docmind:SubmitConvertPdfToExcelJob	SubmitConvertPdfToExcelJob	Write	全部资源 *	无	无
docmind:SubmitConvertImageToExcelJob	SubmitConvertImageToExcelJob	Write	全部资源 *	无	无
docmind:SubmitConvertPdfToImageJob	SubmitConvertPdfToImageJob	Write	全部资源 *	无	无
docmind:SubmitConvertImageToPdfJob	SubmitConvertImageToPdfJob	Write	全部资源 *	无	无
docmind:SubmitConvertPdfToMarkdownJob	SubmitConvertPdfToMarkdownJob	Write	全部资源 *	无	无
docmind:SubmitConvertImageToMarkdownJob	SubmitConvertImageToMarkdownJob	Write	全部资源 *	无	无

资源（Resource）

文档智能（docmind）不支持在RAM权限策略语句的Resource中指定资源ARN。如果要允许对文档智能（docmind）的访问权限，请在策略语句中指定"Resource": "*"。

条件（Condition）

文档智能（docmind）未定义产品级别的条件关键字。如需查看适用于所有云产品的通用条件关键字，请参见通用条件关键字。