添加polkit.message后调用CheckAuthorization报错，如何无错传递message？

问题原因 #

PolicyKit 的 CheckAuthorization 方法中，以 polkit. 为前缀的详情键（比如 polkit.message）属于受保护字段，只有可信调用者（UID 0 的进程、动作定义的所有者进程）才能设置。普通用户进程直接传递这类字段会触发权限校验错误。

可行解决方法 #

方法1：以 root 身份运行程序 #

如果你的程序允许获取 root 权限，直接用 sudo 或其他方式以 root 身份运行脚本即可。此时进程属于可信调用者，传递 polkit.message 不会触发错误。

方法2：自定义 PolicyKit 动作（无需提权） #

通过自定义 PolicyKit 动作文件，将提示信息内置到动作定义中，不需要在 details 参数里传递 polkit.message：

1. 创建自定义动作配置文件
   在 /usr/share/polkit-1/actions/ 目录下新建文件（比如 com.yourapp.customaction.policy），内容如下：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE policyconfig PUBLIC
 "-//freedesktop//DTD PolicyKit Policy Configuration 1.0//EN"
 "https://www.freedesktop.org/standards/PolicyKit/1/policyconfig.dtd">
<policyconfig>
  <action id="com.yourapp.customaction">
    <description>自定义操作描述</description>
    <message>test</message> <!-- 这里填写你需要的提示信息 -->
    <defaults>
      <allow_any>auth_self</allow_any>
      <allow_inactive>auth_self</allow_inactive>
      <allow_active>auth_self</allow_active>
    </defaults>
  </action>
</policyconfig>

2. 修改代码适配自定义动作
   调整代码中的动作 ID，并移除 details 里的 polkit.message：

class LinuxLocalAuth:
    def __init__(self) -> None:
        import dbus

        self.dbus = dbus

        bus = dbus.SystemBus()
        proxy = bus.get_object(
            "org.freedesktop.PolicyKit1", "/org/freedesktop/PolicyKit1/Authority"
        )
        self.authority = dbus.Interface(
            proxy, dbus_interface="org.freedesktop.PolicyKit1.Authority"
        )

        system_bus_name = bus.get_unique_name()

        self.subject = ("system-bus-name", {"name": system_bus_name})
        self.action_id = "com.yourapp.customaction"  # 替换为自定义动作ID
        self.details = {}  # 无需传递polkit.message
        self.flags = 1  # AllowUserInteraction flag
        self.cancellation_id = ""  # No cancellation id

    def authenticate_linux(self):
        result = self.authority.CheckAuthorization(
            self.subject, self.action_id, self.details, self.flags, self.cancellation_id
        )

        return result[0]


LinuxLocalAuth().authenticate_linux()

这样调用时，PolicyKit 会自动从自定义动作的 message 字段读取提示信息，普通用户进程也能正常执行，不会触发权限错误。

内容的提问来源于stack exchange，提问作者vv2006-mc