/wdpassport-utils

WD Passport Ultra Linux Utilities

Primary LanguagePythonGNU General Public License v2.0GPL-2.0

wdpassport-utils

WD Passport Ultra Complete Utilities for Linux.

Intro

This script let you unlock, change password and erase Western Digital Passport devices on Linux platform. Modified to run on python3

Install

Dependencies from OS repository

For example on Ubuntu you can install the missing dependencies with

sudo apt-get install python3-pip python3-dev lsscsi

For Fedora these are dependencies:

sudo dnf install python3-pip python3-devel lsscsi

Now you need to get py3_sg

Easy way:

# Use sudo. py3_sg must land somewhere in /usr/local/lib64/python3.7/site-packages,
# not in /home folder!
sudo pip3 install py3_sg
sudo pip3 show py3_sg

Hard way: clone the repo using command below and follow installation guide from README.md

git clone git@github.com:tvladyslav/py3_sg.git

Usage

Run script as root.

There are few options:

-h, --help            show this help message and exit

Lists all possible arguments.

-s, --status          Check device status and encryption type

Get device encryption status and cipher suites used.

-u, --unlock          Unlock

You will be asked to enter the unlock password. If everything is fine device will be unlocked.

-m, --mount           Enable mount point for an unlocked device

After unlock, your operating system still thinks that your device is a strange thing attached to his usb port and he don't know how to manage. You need this option to force the O.S. to rescan the device and handle it as a normal external usb harddrive.

-c, --change_passwd   Change (or disable) password

This option let you to encrypt your device, remove password protection and change your current password. If device is "without lock" and you want it to be password protect leave the "OLD password" field empty and choose insert the new password. If the device is password protected and you want to be as a normal unencrypted device, inser the old password and leave the "NEW password" field empty. If you only want to change password do it as usual.

-e, --erase           Secure erase device

"Erase" the device. This will remove the internal key associated to you password and all your data will be unaccessible. You will also lose your partition table and you will need to create a new one (you can use fdisk and mkfs).

-d DEVICE, --device DEVICE  Force device path (ex. /dev/sdb). Usually you don't need this option.

The script will try to auto detect the current device path of your WD Passport device. If something is wrong or you want to manually specify the device path yourself you can use this option.

Disclaimer

I based my research on Dan Lukes (FreeBSD version) and KenMacD (very simple unlocker) works. I'm in no way sponsored by or connected with Western Digital. Use any of the information contained in this repository at your own risk. I accept no responsibility.