Package org.webpki.crypto

Class DeviceID

java.lang.Object

org.webpki.crypto.DeviceID

public class DeviceID
extends Object

Device ID generator.

A Device ID is a cryptographically secured 36-character identifier where the last 4 characters represent a (SHA1-based) checksum of the 160-bit SHA1 hash of the argument which is the actual identity. The identity used as input may be an IMEI-code, Device Certificate, Apple-ID, etc.

The scheme also supports a truncated 20-character Device ID-variant which presumably is sufficient for most real-world usages.

The checksum makes it easy verifying that the user has typed in the correct Device ID.

To further reduce mistakes the character-set has been limited to 32 visually distinguishable characters:
ABCDEFGHJKLMNPQRSTUVWXYZ23456789

A user-display would typically show a 36-character Device ID like the following:

     CCCC-CCCC-CCCC-CCCC
     CCCC-CCCC-CCCC-CCCC
     CCCC

Method Summary

Modifier and Type	Method	Description
static String	getDeviceId(byte[] identityBlobOrNull, boolean longVersion)
static String	getDeviceId(X509Certificate deviceCertificateOrNull, boolean longVersion)
static void	main(String[] args)
static void	validateDeviceID(String deviceId)

Methods inherited from class java.lang.Object

clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Details

getDeviceId

public static String getDeviceId(byte[] identityBlobOrNull,
 boolean longVersion)

getDeviceId

public static String getDeviceId(X509Certificate deviceCertificateOrNull,
 boolean longVersion)

validateDeviceID

public static void validateDeviceID(String deviceId)

main

public static void main(String[] args)
                 throws IOException,
GeneralSecurityException

Throws:

IOException

GeneralSecurityException