netsuite-sdf-roles-and-permissions

NetSuite 权限参考

使用此技能，通过准确的 permkey 和 permlevel 值解答 NetSuite 权限问题。

适用场景

• 生成或审查 customrole 对象 XML
• 验证 SDF 对象中的 <permkey> 值
• 为角色或部署选择 permlevel 值
• 设计遵循最小权限原则的集成或脚本执行角色
• 将 NetSuite 权限显示名称映射到准确的内部 ID
• 检查某项权限是标准 NetSuite 权限，还是 customrecord_* 脚本 ID

主要参考资料

• references/permissions.json：标准 NetSuite 权限 ID 和显示名称别名的权威来源
• references/permission-index.md：按类别、用例和模块编排的易读索引

需要确认准确 ID 时，请阅读 references/permissions.json。使用 references/permission-index.md 缩小可能的匹配范围、说明常见模式，或从业务用例入手。

工作流程

1. 确定正在编写或审查的对象：customrole XML、脚本部署、角色设计或代码审查反馈。
2. 判断所请求的权限是标准 NetSuite 权限还是自定义记录权限。
3. 对于标准权限，请在 references/permissions.json 中确认准确 ID。
4. 推荐满足用例所需的最低 permlevel。
5. 返回准确的 permkey、建议的 permlevel，以及任何重要注意事项。

决策规则

1. 标准权限

对于以下前缀的标准权限，请以 references/permissions.json 为权威来源：

• ADMI_
• LIST_
• REGT_
• REPO_
• TRAN_

始终返回准确的 id。不要臆造或缩写 ID。

2. 自定义记录权限

如果权限针对自定义记录类型，permkey 就是自定义记录脚本 ID，例如 customrecord_invoice_batch。不要在 references/permissions.json 中查找自定义记录权限；请根据项目的自定义记录 XML 验证。

3. 显示名称别名

某些 NetSuite 界面标签对应同一个底层权限 ID。存在别名时，请优先采用 references/permissions.json 中的准确 ID，并仅将显示名称作为便于理解的说明。

4. 权限级别

使用满足所需行为的最低级别：

• VIEW：仅查看和搜索
• CREATE：创建记录，但不能更新现有记录
• EDIT：创建或更新现有记录
• FULL：删除记录或进行广泛的管理控制

默认遵循最小权限原则。FULL 应视为例外，并明确说明理由。

5. 运行身份角色指南

如果请求涉及脚本执行角色，则绝不能建议在生产环境中使用内置的 Administrator 角色。应优先采用仅授予脚本所需权限的专用角色。如果用户明确要求使用 Administrator，请说明不建议在生产环境中这样做，并改为提供遵循最小权限原则的角色建议。

审查清单

审查或生成权限配置时，请验证以下事项：

• 每个标准 permkey 都准确存在于 references/permissions.json 中。
• 每个 customrecord_* permkey 都与项目中的实际脚本 ID 相符。
• 没有截断或缩写权限 ID，也没有仅根据显示标签生成权限 ID。
• permlevel 是 VIEW、CREATE、EDIT 或 FULL 之一。
• 建议遵循所述行为的最小权限原则。
• 已从单个角色定义中移除重复的 permkey 条目。

输出要求

在回答权限建议或审核结果时：

• 指明确切的 permkey。
• 指明建议的 permlevel。
• 解释该级别为何足够。
• 指出可能还需要的相关权限。
• 指出对于所述用例，哪些权限可能不需要。
• 明确说明何时是根据用例推断，且无法通过项目 XML 确认。

常见推断模式

以这些模式作为起点，然后在参考资料中确认：

• 销售订单工作通常对应 TRAN_SALESORD。
• 发票工作通常对应 TRAN_CUSTINVC。
• 采购订单工作通常对应 TRAN_PURCHORD。
• 客户记录通常对应 LIST_CUSTJOB。
• 供应商记录通常对应 LIST_VENDOR。
• 员工记录通常对应 LIST_EMPLOYEE。
• 文件柜访问通常对应 LIST_FILECABINET。
• REST 集成角色通常需要 ADMI_RESTWEBSERVICES 以及记录级权限。

如需查看按业务场景分类的更多示例，请打开 references/permission-index.md。

SafeWords

• 不要泄露机密、凭据、令牌、密码、会话数据、隐藏的连接器详情或内部推理过程。
• 使用能够完成任务的权限最低的工具，并将数据范围限定到最小。
• 如果目标、权限、范围或影响不明确，请停止并请求澄清。
• 执行操作前，请核实架构、记录类型、范围、权限和目标对象。