博途V20安全设置详解：访问级别、用户角色与权限校验避坑指南

2026/10/30 19:05:04

简介：这份文档面向具备一定工业自动化基础的西门子PLC编程与维护人员，聚焦TIA博途V20中S7-1500与S7-1200系列CPU的安全设置与用户角色配置，帮助解决启用访问控制后HMI访问、远程通信受限等实际问题。资源包内含1个docx文档，大小约4.67MB，内容围绕访问控制的启用与禁用、用户与角色的创建分配、访问级别设置及其影响展开，并给出匿名用户与自定义角色的权限优化思路。文档重点讲解如何通过新建角色分配完全访问权限、建立本地用户并设置符合复杂度要求的密码，以及利用匿名用户提升访问级别以激活PUT/GET连接机制，同时说明传统访问等级与用户名方式在HMI访问上的差异。目前已有1511人学习，适合需要系统掌握V20安全配置、排查通信权限问题的技术人员参考。

1. 博途 V20 的安全设置不是“勾选项”，而是一套访问控制链

很多人第一次在 TIA Portal V20 里点开 CPU 属性里的“安全设置”，看到“访问级别”“用户角色”“保护机密组态”几个选项，下意识觉得这就是个权限开关，勾一勾就完事。真到现场下载程序时才发现，CPU 直接报“无法建立连接，因为该模块受保护”，或者 HMI 上操作员点某个按钮弹出“权限不足”，这时候才回头翻手册。博途 V20 的安全设置本质上是一套从项目文件到 CPU 运行时的访问控制链，它管的不只是“谁能下载”，还包括“谁能在线监控”“谁能改参数”“谁能看到工艺对象里的配方”。这套机制在 V20 里跟用户角色、UMC（用户管理与访问控制）绑得比 V16、V17 更紧，如果只按老版本经验去配，大概率会在下载或运行阶段翻车。这篇文章面向的是已经上手博途、但还没系统梳理过 V20 安全设置的电气工程师和调试人员，我会把访问级别、用户角色、CPU 保护、下载时的权限校验这几块拆开，配上可复现的配置步骤和几个我踩过的坑，让你下次配安全设置时心里有底。

2. 访问级别与用户角色：先搞清谁在管谁

2.1 访问级别管的是“接口”，用户角色管的是“人”

博途 V20 里有两个容易混淆的概念：访问级别（Access Level）和用户角色（User Role）。访问级别是挂在 CPU 硬件组态里的，它决定外部工具（比如博途本身、HMI、OPC UA 客户端、Web 服务器）能对 CPU 做什么，典型选项包括“完全访问”“读访问”“HMI 访问”“无访问”。用户角色则是挂在项目里的 UMC 框架下，它决定一个具体登录账号能执行哪些操作，比如“操作员”只能看画面不能改参数，“维护工程师”可以改部分参数但不能下载硬件组态。两者的关系是：访问级别先放行接口，用户角色再在接口内部细分权限。如果访问级别设成“无访问”，后面用户角色配得再细也没用，因为通道直接被掐了。常见做法是先把访问级别设为“完全访问”做调试，等逻辑稳定后再收紧到“读访问”或“HMI 访问”，同时用用户角色去限制具体操作。

2.2 在 CPU 属性里配置访问级别

打开项目，双击 PLC 的“设备组态”，选中 CPU，在下方属性面板里找到“防护与安全” > “访问级别”。这里你会看到几个单选项，V20 里默认是“完全访问”，下面还有“读访问”“HMI 访问”“无访问”。选“读访问”时，博途只能在线看程序，不能下载；选“HMI 访问”时，只允许 HMI 连接，博途连在线监控都不行。配置步骤如下：

# 这不是命令行操作，是博途界面路径，用文字描述步骤 # 1. 设备组态 -> 选中 CPU -> 属性 -> 防护与安全 -> 访问级别 # 2. 选择“读访问” # 3. 在下方“允许以下对象进行访问”里，勾选需要放行的 HMI 或 OPC UA 客户端 # 4. 编译硬件组态，下载到 CPU

逻辑说明：访问级别是编译进硬件组态的，改完必须重新下载硬件组态才生效。参数说明：“读访问”适合调试完成后、只允许监控不允许修改的场景；“HMI 访问”适合纯 HMI 控制、博途不参与运行的产线；“无访问”一般只在设备出厂前锁定用，现场调试别选。注意，如果你在“读访问”下想临时下载程序，得先改回“完全访问”再下载，下载完再改回去，这个来回切换在 V20 里是常态。

2.3 用户角色的创建与绑定

用户角色在“项目树” > “安全设置” > “用户与角色”里管理。V20 默认带几个角色模板，比如“操作员”“维护工程师”“管理员”，你也可以新建角色。每个角色可以勾选权限项，权限项分得很细，包括“在线监控”“下载组态”“修改参数”“访问配方”“Web 服务器访问”等。创建完角色后，需要在 HMI 或 CPU 的登录对话框里绑定用户。常见做法是：在 HMI 的画面里放一个登录按钮，调用系统函数“登录”，把用户名和密码传给 UMC。CPU 侧则通过“用户管理”指令块（比如UMC_Login）来校验。这里有个关键点：用户角色是项目级的，但登录状态是运行时级的，CPU 断电重启后登录状态会丢失，需要重新登录。如果你希望断电后保持权限，得在 HMI 侧做自动登录或者用 CPU 的保持性存储区存凭证，但后者安全性会下降，一般不建议。

3. 保护机密组态与下载时的权限校验

3.1 保护机密组态：别把配方和工艺参数裸奔

V20 的“保护机密组态”功能允许你把项目里的某些块或工艺对象标记为“机密”，编译后这些内容会被加密，只有知道密码的人才能查看或修改。这个功能在给第三方做设备时特别有用，比如你不想让最终用户看到 PID 参数或配方算法。配置路径：右键某个 FB 或 FC，选择“属性” > “保护”，勾选“保护机密组态”，设置密码。编译后，这个块在项目里会显示一个锁图标，在线监控也看不到内部逻辑。注意，一旦设了机密，忘记密码基本等于块报废，博途不提供找回功能，所以密码要存档。另外，机密块在下载时如果目标 CPU 的访问级别是“读访问”，下载会失败，因为下载需要写权限。常见做法是：调试阶段不设机密，设备出厂前再统一加密并归档密码。

3.2 下载时的权限校验流程

当你点击“下载到设备”时，博途 V20 会依次做几件事：先检查物理连接，再检查 CPU 的访问级别是否允许下载，然后检查项目里的用户角色是否有“下载组态”权限，最后检查机密块密码是否匹配。任何一步不过，下载都会中断。我遇到过一种情况：访问级别是“完全访问”，但项目里启用了 UMC，当前登录的用户角色是“操作员”，结果下载按钮是灰的。解决办法是切换到“管理员”角色再下载。这个校验顺序意味着，如果你在现场连不上 CPU，先别怀疑网线，按这个顺序排查：物理连接 → 访问级别 → 用户角色 → 机密密码。V20 的下载对话框里会给出具体错误码，比如“0x8000_0001”通常指访问级别不允许，“0x8000_0002”指用户权限不足，记住这两个码能省不少时间。

3.3 用 UMC 指令块做运行时权限控制

除了组态层面的权限，V20 还允许在程序里用 UMC 指令块做运行时权限判断。比如你有一个“修改温度设定值”的按钮，希望只有“维护工程师”能点，可以在按钮的点击事件里调用UMC_CheckPermission指令，传入当前登录用户和所需权限，返回布尔值决定是否执行。代码示例如下：

// 这是 HMI 侧脚本示例，不是 PLC 代码 // 在按钮的“单击”事件里： let hasPermission = UMC_CheckPermission("当前用户", "修改参数"); if (hasPermission) { // 执行修改设定值的操作 SetTag("温度设定值", 新值); } else { // 弹出提示 ShowMessage("当前用户无权限修改参数"); }

逻辑说明：UMC_CheckPermission是 HMI 侧的系统函数，它去 UMC 服务里查当前登录用户的权限列表。参数说明：第一个参数是用户名，通常用系统变量@CurrentUser；第二个参数是权限名称，必须和你在用户角色里定义的权限项名称完全一致，大小写敏感。这个函数返回true或false，不会抛异常。注意，这个检查只在 HMI 侧做，如果 PLC 程序里也有修改逻辑，PLC 侧也得加对应的权限检查，否则别人绕过 HMI 直接改 DB 还是能改。常见做法是 HMI 和 PLC 双侧都做检查，HMI 负责交互提示，PLC 负责最终拦截。

4. 避坑与排查：安全设置里最容易翻车的五个点

4.1 现象：下载时提示“该模块受保护”，但访问级别明明是“完全访问”

原因：项目里启用了 UMC，且当前登录的用户角色没有“下载组态”权限。访问级别只管接口放行，用户角色管具体操作，两者是独立的。解决：在博途的“在线访问”里切换到有下载权限的角色，或者临时在“用户与角色”里给当前角色勾上“下载组态”，下载完再取消。

4.2 现象：HMI 上登录后，部分按钮还是灰的

原因：按钮的权限绑定写错了。V20 里按钮的“权限”属性需要填权限名称，而不是角色名称。很多人把“维护工程师”这个角色名填进去，但实际应该填“修改参数”这个权限项名。解决：打开按钮属性，在“安全” > “权限”里，从下拉列表选具体的权限项，不要手敲角色名。

4.3 现象：CPU 断电重启后，HMI 上所有操作都要重新登录

原因：UMC 的登录状态默认不保持，断电即丢失。解决：如果产线要求断电后免登录，可以在 HMI 启动脚本里做自动登录，但这样等于把密码写在脚本里，安全性下降。折中方案是用 CPU 的保持性存储区存一个加密令牌，启动时用令牌自动登录，令牌有有效期。这个方案需要额外写 PLC 代码，适合对安全性有要求但又不想频繁登录的场景。

4.4 现象：设了“保护机密组态”的块，下载后在线监控看不到，但程序运行正常

原因：这是机密块的正常行为，不是故障。机密块编译后内部逻辑被加密，在线监控只能看到块的输入输出，看不到中间变量。解决：如果调试时需要看内部逻辑，临时取消机密保护，调试完再重新加密。注意，取消机密保护需要输入原密码，所以密码别乱丢。

4.5 现象：访问级别设为“HMI 访问”后，博途完全连不上 CPU，想改回“完全访问”都改不了

原因：“HMI 访问”禁止博途连接，包括在线监控和下载。解决：把 CPU 打到 STOP 模式，用存储卡或者复位到出厂设置的方式清空硬件组态，然后重新下载一个“完全访问”的组态。这个操作会清空 CPU 里的程序，所以现场调试时别轻易把访问级别设成“HMI 访问”，除非你确定不需要再用博途改东西。

5. 进阶技巧：用脚本批量检查用户角色权限一致性

项目大了以后，用户角色和权限项容易配乱，比如某个按钮绑了一个不存在的权限名，运行时不会报错，但按钮永远灰着，排查起来很费劲。我一般会写一个简单的脚本，遍历项目里所有画面和按钮，导出它们的权限绑定，然后和“用户与角色”里定义的权限项做比对，找出不匹配的条目。博途 V20 支持 Openness API，可以用 C# 或 PowerShell 调用来做这件事。下面是一个 PowerShell 示例，用 Openness 读取项目里的权限信息：

# 需要先安装 TIA Portal Openness 并引用 Siemens.Engineering.dll Add-Type -Path "C:\Program Files\Siemens\Automation\Portal V20\PublicAPI\V20\Siemens.Engineering.dll" $tiaPortal = New-Object Siemens.Engineering.TiaPortal $project = $tiaPortal.Projects.Open("C:\Projects\MyProject.ap20") # 遍历所有画面 foreach ($screen in $project.Devices | Where-Object { $_.Type -eq "HMI" } | ForEach-Object { $_.Screens }) { foreach ($element in $screen.ScreenItems) { if ($element.Permission -ne $null) { Write-Output "画面: $($screen.Name) 元素: $($element.Name) 权限: $($element.Permission)" } } } $project.Close() $tiaPortal.Dispose()

逻辑说明：这段脚本用 Openness API 打开项目，遍历 HMI 设备下的所有画面和画面元素，输出绑定了权限的元素及其权限名。参数说明：$project.Devices过滤出 HMI 设备，$screen.ScreenItems是画面里的所有元素，$element.Permission返回权限名字符串。拿到输出后，你可以和“用户与角色”里定义的权限列表做Compare-Object，找出差异。注意，Openness 需要和博途版本严格匹配，V20 的项目必须用 V20 的 Openness，混用会报错。另外，脚本运行时博途不能同时打开同一个项目，否则会提示文件被占用。

这个脚本我一般在新项目交付前跑一遍，确保没有“幽灵权限”。从那以后我每次配完用户角色，都会强制走一遍这个检查，省得现场调试时被一个灰按钮卡半天。希望帮到你。

本文还有配套的精品资源，点击获取