Difference between revisions of "UDID"

From The iPhone Wiki
Jump to: navigation, search
(moving udid changing info to the bottom)
(9 intermediate revisions by 4 users not shown)
Line 1: Line 1:
  +
A '''UDID''' (Unique Device Identifier) is a calculated string that is used to identify a device for the purposes of app installation, registration, and MDM enrollment.
[[UDID]] is the short form for '''U'''nique '''D'''evice '''Id'''entifier. It is a 40-character long hex value (20 bytes). The [[UDID]] is being used by developers to register devices for testing their Apps. Only on registered devices developers can run Apps that are not in Apple's AppStore yet. Also, beta firmware can be installed only on registered devices. Developers currently have 100 [[UDID]]s they can register.
 
  +
 
  +
For developers building extensions for jailbroken iOS: it's not recommended to calculate the UDID yourself - instead, use [http://iphonedevwiki.net/index.php/LibMobileGestalt.dylib libMobileGestalt.dylib, as described on the iPhoneDevWiki].
Instead of calculating the value, it can be read from [[iTunes]], when the device is connected, by clicking on '''Serial Number'''.
 
   
 
== Calculation ==
 
== Calculation ==
  +
There are two different formats of UDID, depending on the device.
The [[UDID]] is being calculated like this:
 
*Create a 60-character long or 59-character long (on newer devices) text string (see below)
 
*Calculate the [[wikipedia:SHA-1|SHA1]] hash of the text string. The result is the [[UDID]].
 
   
  +
===September 2018-present===
To create the text string, append the following four strings:
 
  +
With the release of [[Apple Watch Series 4]], [[iPhone XR]], [[iPhone XS]] and [[iPhone XS Max]], the UDID format changed. All devices released after these use the new format:
*11-character long or 12-character long (on newer devices) '''serial number''' (exactly like it is written in the Settings app)
 
  +
#Four zeros, followed by the [[CHIP]], without leading zeros. e.g. <code>8020</code> for [[iPhone XS]].
*one of these:
 
  +
#A hyphen, followed by another three zeros.
**(on older devices) 15-character long '''IMEI number''' (without spaces); empty string for iPod touch and Wi-Fi model iPads
 
  +
#The device's ECID in hexadecimal.
**(on newer devices) 13-character long '''ECID''' in decimal, no leading zeroes
 
*17-character long '''Wi-Fi MAC address''' (letters in lower case, including colons); for the [[N45ap|iPod touch first generation]] use "00:00:00:00:00:00"
 
*17-character long '''Bluetooth MAC address''' (letters in lower case, including colons)
 
   
  +
The general format will be:
=== In short ===
 
  +
0000CHIP-000ECID
On the [[N92ap|Verizon iPhone 4]] and newer:
 
  +
  +
===2007-August 2018===
  +
For devices released before September 2018 ([[Apple TV 4K]] and earlier, [[Apple Watch Series 3]] and earlier, [[iPad (6th generation)]] and earlier, [[iPad mini 4]] and earlier, [[iPhone X]] and earlier, and [[iPod touch (6th generation)]] and earlier), the method to calculate is the following:
  +
  +
#Get the 11- or 12-character long '''serial number''' (exactly like it is written in the Settings app)
  +
#On [[iPhone 4]] and newer, get the '''ECID''' in decimal, no leading zeroes. On earlier devices, get the '''IMEI number''' (without spaces, empty string for iPod touch and Wi-Fi model iPads)
  +
#Get the '''Wi-Fi MAC address''' (letters in lower case, including colons); for the [[N45AP|iPod touch first generation]] use "00:00:00:00:00:00"
  +
#Get the '''Bluetooth MAC address''' (letters in lower case, including colons)
  +
#Calculate a SHA1 hash of these.
  +
  +
The basic formula for this is below:<br />
  +
On the [[N92AP|Verizon iPhone 4]] up to [[iPhone X]] (inclusive):
 
UDID = SHA1(serial + ECID + wifiMac + bluetoothMac)
 
UDID = SHA1(serial + ECID + wifiMac + bluetoothMac)
   
  +
Prior devices:
All else:
 
 
UDID = SHA1(serial + IMEI + wifiMac + bluetoothMac)
 
UDID = SHA1(serial + IMEI + wifiMac + bluetoothMac)
   
== Changing UDID ==
+
==== Changing UDID ====
  +
This form of UDID can be changed by running the command below, followed by a DFU restore. If the DFU restore is not performed, many applications will break, including iTunes. '''It is very important to first write down the original MAC address and keep that information in a safe place so that you can revert this change if necessary.''' This hack is shown on an [http://twitpic.com/9015lw iPod touch (4th generation)].
   
  +
'''It is also very important to not change this to an invalid MAC address.''' If you change your device's MAC address to something invalid, your internet won't work again until you fix the MAC address (using MobileTerminal or similar). This persists even if you restore -- so you can make this really really hard to fix (you can call it a form of [[bricked|bricking]]) if you restore and there's no jailbreak available, if the available jailbreaks don't include afc2 and other workarounds aren't working.
The UDID can technically be changed and back again if you run this command followed by a DFU restore or else iTunes cannot read the device (corruption?). Keep a backup, you can always revert the change with the original MAC. As shown on an [http://twitpic.com/9015lw iPod touch 4G]. Command:
 
   
  +
Note that changing your UDID can have weird side effects in general, including that you'll have to log in again to everything, including Apple apps.
nvram wifiaddr=ma:ca:dd:re:as
 
   
  +
If you're still willing to risk this, this is the command:
- User notice: This will change your UDID, anything UDID related will need to be re-"logined", Apple related apps will always need to be logined.
 
  +
  +
nvram wifiaddr=ma:ca:dd:re:as

Revision as of 14:35, 22 November 2018

A UDID (Unique Device Identifier) is a calculated string that is used to identify a device for the purposes of app installation, registration, and MDM enrollment.

For developers building extensions for jailbroken iOS: it's not recommended to calculate the UDID yourself - instead, use libMobileGestalt.dylib, as described on the iPhoneDevWiki.

Calculation

There are two different formats of UDID, depending on the device.

September 2018-present

With the release of Apple Watch Series 4, iPhone XR, iPhone XS and iPhone XS Max, the UDID format changed. All devices released after these use the new format:

  1. Four zeros, followed by the CHIP, without leading zeros. e.g. 8020 for iPhone XS.
  2. A hyphen, followed by another three zeros.
  3. The device's ECID in hexadecimal.

The general format will be:

0000CHIP-000ECID

2007-August 2018

For devices released before September 2018 (Apple TV 4K and earlier, Apple Watch Series 3 and earlier, iPad (6th generation) and earlier, iPad mini 4 and earlier, iPhone X and earlier, and iPod touch (6th generation) and earlier), the method to calculate is the following:

  1. Get the 11- or 12-character long serial number (exactly like it is written in the Settings app)
  2. On iPhone 4 and newer, get the ECID in decimal, no leading zeroes. On earlier devices, get the IMEI number (without spaces, empty string for iPod touch and Wi-Fi model iPads)
  3. Get the Wi-Fi MAC address (letters in lower case, including colons); for the iPod touch first generation use "00:00:00:00:00:00"
  4. Get the Bluetooth MAC address (letters in lower case, including colons)
  5. Calculate a SHA1 hash of these.

The basic formula for this is below:
On the Verizon iPhone 4 up to iPhone X (inclusive):

UDID = SHA1(serial + ECID + wifiMac + bluetoothMac)

Prior devices:

UDID = SHA1(serial + IMEI + wifiMac + bluetoothMac)

Changing UDID

This form of UDID can be changed by running the command below, followed by a DFU restore. If the DFU restore is not performed, many applications will break, including iTunes. It is very important to first write down the original MAC address and keep that information in a safe place so that you can revert this change if necessary. This hack is shown on an iPod touch (4th generation).

It is also very important to not change this to an invalid MAC address. If you change your device's MAC address to something invalid, your internet won't work again until you fix the MAC address (using MobileTerminal or similar). This persists even if you restore -- so you can make this really really hard to fix (you can call it a form of bricking) if you restore and there's no jailbreak available, if the available jailbreaks don't include afc2 and other workarounds aren't working.

Note that changing your UDID can have weird side effects in general, including that you'll have to log in again to everything, including Apple apps.

If you're still willing to risk this, this is the command:

nvram wifiaddr=ma:ca:dd:re:as