![]() |
![]() |
![]() |
UDisks Reference Manual | ![]() |
---|
Many methods and operations offered by udisks requires the calling user to be sufficiently authorized. Whether the user is authorized is checked using polkit and the administrator can configure polkit's local authority (but note that the system may be using another polkit authority implementation).
There is not necessarily a one-to-one relationship between D-Bus methods and polkit actions - typically the relationship is more complicated and depends on both the context of the process invoking the method, the object the method is acting on and possibly more factors. For example, the Filesystem.Mount() method call may check that the caller is authorized for one of the four actions org.freedesktop.udisks2.filesystem-mount, org.freedesktop.udisks2.filesystem-mount-system, org.freedesktop.udisks2.filesystem-mount-other-seat or org.freedesktop.udisks2.filesystem-mount-fstab depending on circumstances.
Often there will be two polkit actions for one operation -
one for so-called “system devices” and one for
non-system devices. In this context “system
device” refers to the value of the Block:HintSystem
D-Bus property and is normally only
TRUE
for devices not considered
“removable” (devices considered removable
include USB attached storage, Flash media and optical
drives). See udisks(8) for how to control
if a device is considered a system device.
The polkit actions are not considered stable and may change
from release to release so administrators should take notice
when upgrading from one version of udisks to another. For
example, .pkla
files may need to be
updated to match an updated policy.
For reference, the polkit actions defined by udisks 1.97.0
are included here:
<?xml version="1.0" encoding="utf-8"?> <!DOCTYPE policyconfig PUBLIC "-//freedesktop//DTD PolicyKit Policy Configuration 1.0//EN" "http://www.freedesktop.org/standards/PolicyKit/1.0/policyconfig.dtd"> <policyconfig> <vendor>The udisks Project</vendor> <vendor_url>http://udisks.freedesktop.org/</vendor_url> <icon_name>drive-removable-media</icon_name> <!-- ###################################################################### --> <!-- Mounting filesystems --> <action id="org.freedesktop.udisks2.filesystem-mount"> <_description>Mount a filesystem</_description> <_message>Authentication is required to mount the filesystem</_message> <defaults> <allow_any>auth_admin</allow_any> <allow_inactive>auth_admin</allow_inactive> <allow_active>yes</allow_active> </defaults> </action> <!-- mount a device considered a "system device" --> <action id="org.freedesktop.udisks2.filesystem-mount-system"> <_description>Mount a filesystem on a system device</_description> <_message>Authentication is required to mount the filesystem</_message> <defaults> <allow_any>auth_admin</allow_any> <allow_inactive>auth_admin</allow_inactive> <allow_active>auth_admin_keep</allow_active> </defaults> </action> <!-- mount a device attached to another seat --> <action id="org.freedesktop.udisks2.filesystem-mount-other-seat"> <_description>Mount a filesystem from a device plugged into another seat</_description> <_message>Authentication is required to mount the filesystem</_message> <defaults> <allow_any>auth_admin</allow_any> <allow_inactive>auth_admin</allow_inactive> <allow_active>auth_admin_keep</allow_active> </defaults> </action> <!-- mount a device referenced in the /etc/fstab file with the x-udisks-auth option --> <action id="org.freedesktop.udisks2.filesystem-fstab"> <_description>Mount/unmount filesystems defined in the fstab file with the x-udisks-auth option</_description> <_message>Authentication is required to mount/unmount the filesystem</_message> <defaults> <allow_any>auth_admin</allow_any> <allow_inactive>auth_admin</allow_inactive> <allow_active>auth_admin_keep</allow_active> </defaults> </action> <!-- ###################################################################### --> <!-- Unmounting filesystems --> <!-- unmount a filesystem mounted by another user --> <action id="org.freedesktop.udisks2.filesystem-unmount-others"> <_description>Unmount a device mounted by another user</_description> <_message>Authentication is required to unmount a filesystem mounted by another user</_message> <defaults> <allow_any>auth_admin</allow_any> <allow_inactive>auth_admin</allow_inactive> <allow_active>auth_admin_keep</allow_active> </defaults> </action> <!-- ###################################################################### --> <!-- Unlocking encrypted devices --> <action id="org.freedesktop.udisks2.encrypted-unlock"> <_description>Unlock an encrypted device</_description> <_message>Authentication is required to unlock an encrypted device</_message> <defaults> <allow_any>auth_admin</allow_any> <allow_inactive>auth_admin</allow_inactive> <allow_active>yes</allow_active> </defaults> </action> <!-- unlock a device considered a "system device" --> <action id="org.freedesktop.udisks2.encrypted-unlock-system"> <_description>Unlock an encrypted system device</_description> <_message>Authentication is required to unlock an encrypted device</_message> <defaults> <allow_any>auth_admin</allow_any> <allow_inactive>auth_admin</allow_inactive> <allow_active>auth_admin_keep</allow_active> </defaults> </action> <!-- mount a device attached to another seat --> <action id="org.freedesktop.udisks2.encrypted-unlock-other-seat"> <_description>Unlock an encrypted device plugged into another seat</_description> <_message>Authentication is required to unlock an encrypted device</_message> <defaults> <allow_any>auth_admin</allow_any> <allow_inactive>auth_admin</allow_inactive> <allow_active>auth_admin_keep</allow_active> </defaults> </action> <!-- unlock a device referenced in the /etc/crypttab file with the x-udisks-auth option --> <action id="org.freedesktop.udisks2.encrypted-unlock-crypttab"> <_description>Unlock an encrypted device specified in the crypttab file with the x-udisks-auth option</_description> <_message>Authentication is required to unlock an encrypted device</_message> <defaults> <allow_any>auth_admin</allow_any> <allow_inactive>auth_admin</allow_inactive> <allow_active>auth_admin_keep</allow_active> </defaults> </action> <!-- ###################################################################### --> <!-- Locking encrypted devices --> <!-- lock a device unlocked by another user --> <action id="org.freedesktop.udisks2.encrypted-lock-others"> <_description>Lock an encrypted device unlocked by another user</_description> <_message>Authentication is required to lock an encrypted device unlocked by another user</_message> <defaults> <allow_any>auth_admin</allow_any> <allow_inactive>auth_admin</allow_inactive> <allow_active>auth_admin_keep</allow_active> </defaults> </action> <!-- ###################################################################### --> <!-- Changing passphrases on encrypted devices --> <action id="org.freedesktop.udisks2.encrypted-change-passphrase"> <_description>Change passphrase for an encrypted device</_description> <_message>Authentication is required to change the passphrase for an encrypted device</_message> <defaults> <allow_any>auth_admin</allow_any> <allow_inactive>auth_admin</allow_inactive> <allow_active>yes</allow_active> </defaults> </action> <!-- change passphrase on a device considered a "system device" --> <action id="org.freedesktop.udisks2.encrypted-change-passphrase-system"> <_description>Change passphrase for an encrypted device</_description> <_message>Authentication is required to change the passphrase for an encrypted device</_message> <defaults> <allow_any>auth_admin</allow_any> <allow_inactive>auth_admin</allow_inactive> <allow_active>auth_admin_keep</allow_active> </defaults> </action> <!-- ###################################################################### --> <!-- Setting up loop devices --> <action id="org.freedesktop.udisks2.loop-setup"> <_description>Manage loop devices</_description> <_message>Authentication is required to set up a loop device</_message> <defaults> <allow_any>auth_admin</allow_any> <allow_inactive>auth_admin</allow_inactive> <!-- NOTE: this is not a DoS because we are using /dev/loop-control --> <allow_active>yes</allow_active> </defaults> </action> <!-- ###################################################################### --> <!-- Deleting and modifying loop devices --> <action id="org.freedesktop.udisks2.loop-delete-others"> <_description>Delete loop devices</_description> <_message>Authentication is required to delete a loop device set up by another user</_message> <defaults> <allow_any>auth_admin</allow_any> <allow_inactive>auth_admin</allow_inactive> <allow_active>auth_admin_keep</allow_active> </defaults> </action> <action id="org.freedesktop.udisks2.loop-modify-others"> <_description>Modify loop devices</_description> <_message>Authentication is required to modify a loop device set up by another user</_message> <defaults> <allow_any>auth_admin</allow_any> <allow_inactive>auth_admin</allow_inactive> <allow_active>auth_admin_keep</allow_active> </defaults> </action> <!-- ###################################################################### --> <!-- Manage (start/stop) swapspace --> <action id="org.freedesktop.udisks2.manage-swapspace"> <_description>Manage swapspace</_description> <_message>Authentication is required to manage swapspace</_message> <defaults> <allow_any>auth_admin</allow_any> <allow_inactive>auth_admin</allow_inactive> <allow_active>auth_admin_keep</allow_active> </defaults> </action> <!-- ###################################################################### --> <!-- Eject media from a drive --> <action id="org.freedesktop.udisks2.eject-media"> <_description>Eject media</_description> <_message>Authentication is required to eject media</_message> <defaults> <allow_any>auth_admin</allow_any> <allow_inactive>auth_admin</allow_inactive> <allow_active>yes</allow_active> </defaults> </action> <!-- eject media from a drive considered a "system device" --> <action id="org.freedesktop.udisks2.eject-media-system"> <_description>Eject media from a system drive</_description> <_message>Authentication is required to eject media</_message> <defaults> <allow_any>auth_admin</allow_any> <allow_inactive>auth_admin</allow_inactive> <allow_active>auth_admin_keep</allow_active> </defaults> </action> <!-- eject media from a drive attached to another seat --> <action id="org.freedesktop.udisks2.eject-media-other-seat"> <_description>Eject media from a drive attached to another seat</_description> <_message>Authentication is required to eject media from a drive plugged into another seat</_message> <defaults> <allow_any>auth_admin</allow_any> <allow_inactive>auth_admin</allow_inactive> <allow_active>auth_admin_keep</allow_active> </defaults> </action> <!-- ###################################################################### --> <!-- Modify a device (create new filesystem, partitioning, change FS label etc.) --> <action id="org.freedesktop.udisks2.modify-device"> <_description>Modify a device</_description> <_message>Authentication is required to modify a device</_message> <defaults> <allow_any>auth_admin</allow_any> <allow_inactive>auth_admin</allow_inactive> <allow_active>yes</allow_active> </defaults> </action> <!-- modify a device considered a "system device" --> <action id="org.freedesktop.udisks2.modify-device-system"> <_description>Modify a system device</_description> <_message>Authentication is required to modify a device</_message> <defaults> <allow_any>auth_admin</allow_any> <allow_inactive>auth_admin</allow_inactive> <allow_active>auth_admin_keep</allow_active> </defaults> </action> <!-- modify a device attached to another seat --> <action id="org.freedesktop.udisks2.modify-device-other-seat"> <_description>Modify a device</_description> <_message>Authentication is required to modify a device plugged into another seat</_message> <defaults> <allow_any>auth_admin</allow_any> <allow_inactive>auth_admin</allow_inactive> <allow_active>auth_admin_keep</allow_active> </defaults> </action> <!-- ###################################################################### --> <!-- Open a device for reading (for creating / restoring disk images) --> <action id="org.freedesktop.udisks2.open-device"> <_description>Open a device</_description> <_message>Authentication is required to open a device</_message> <defaults> <allow_any>auth_admin</allow_any> <allow_inactive>auth_admin</allow_inactive> <allow_active>auth_admin_keep</allow_active> </defaults> </action> <action id="org.freedesktop.udisks2.open-device-system"> <_description>Open a system device</_description> <_message>Authentication is required to open a device</_message> <defaults> <allow_any>auth_admin</allow_any> <allow_inactive>auth_admin</allow_inactive> <allow_active>auth_admin_keep</allow_active> </defaults> </action> <!-- ###################################################################### --> <!-- Manage system-wide configuration files such as /etc/fstab or /etc/crypttab ... including files referenced by these files. IMPORTANT: It is not secure to automatically grant authority for this action to groups of users. Neither is it secure to to allow a process to retain the authorization (e.g. don't use the _keep variants). --> <action id="org.freedesktop.udisks2.modify-system-configuration"> <_description>Modify system-wide configuration</_description> <_message>Authentication is required to modify system-wide configuration</_message> <defaults> <allow_any>auth_admin</allow_any> <allow_inactive>auth_admin</allow_inactive> <allow_active>auth_admin</allow_active> </defaults> </action> <!-- Get secrets from system-wide configuration files --> <action id="org.freedesktop.udisks2.read-system-configuration-secrets"> <_description>Modify system-wide configuration</_description> <_message>Authentication is required to retrieve secrets from system-wide configuration</_message> <defaults> <allow_any>auth_admin</allow_any> <allow_inactive>auth_admin</allow_inactive> <allow_active>auth_admin</allow_active> </defaults> </action> <!-- ###################################################################### --> <!-- ATA SMART --> <!-- Update/refresh SMART data --> <action id="org.freedesktop.udisks2.ata-smart-update"> <_description>Update SMART data</_description> <_message>Authentication is required to update SMART data</_message> <defaults> <allow_any>auth_admin</allow_any> <allow_inactive>auth_admin</allow_inactive> <allow_active>yes</allow_active> </defaults> </action> <!-- Start and abort SMART self-tests --> <action id="org.freedesktop.udisks2.ata-smart-selftest"> <_description>Run SMART self-test</_description> <_message>Authentication is required to run a SMART self-test</_message> <defaults> <allow_any>auth_admin</allow_any> <allow_inactive>auth_admin</allow_inactive> <allow_active>auth_admin_keep</allow_active> </defaults> </action> </policyconfig>