Ticket #10098 (new defect)
Wrong manual entries for setting up VRDP authentication in the VBox end-user documentation
|Reported by:||gu99roax||Owned by:|
Filenames appears to have been changed since this manual was written. One problem is that the procedure for configuring RDP Authentication varies with the version of VirtualBox.
As for VirtualBox 3.2.14 which was updated recently, if using the VBoxAuthSimple module, the password does not use a hash whereas 4.0 and later does use this. This is not addressed properly in the documentation.
The names of the external modules are wrong. The documentation refers to VBoxAuth and VBoxAuthSimple which don't exist in /opt/VirtualBox/amd64/ of the 3.2.14 installation. Their proper names are instead VRDPAuth and VRDPAuthSimple. This means that the suggested commands in the manual are wrong:
VBoxManage setproperty vrdeauthlibrary "VBoxAuthSimple"
VBoxManage setextradata <vm> "VBoxAuthSimple/users/<user>" <hash>
First of all there is no such thing as vrdeauthlibrary in 3.2.14, it should be named vrdpauthlibrary and VBoxAuthSimple should be changed to VRDPAuthSimple. Also 3.2.14 does not use <hash> but has the passwords expressed explicitly as mentioned above. So a correct set up would instead be:
VBoxManage setextradata <vm> "VRDPAuthSimple/users/<user>" "<password>"
Perhaps the documentation is proper for 4.x users but for users who opt to use 3.2.x (for stability or compatibility reasons) this documentation is very unhelpful for setting up VRDP authentication.