Difference between revisions of "UDID"

From The iPhone Wiki
Jump to: navigation, search
(reflecting i0n1c's tweets)
m
 
(23 intermediate revisions by 9 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. The UDID can actually be changed if your device's MAC address (WiFi or Bluetooth) changes, which isn't likely but still possible.
 
   
  +
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 the text '''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]].
 
   
  +
==={{date|2018|09}}-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)
 
  +
#8 characters of [[CHIP|ChipID]] padded with zeros on the left, without leading zeros. e.g. <code>8020</code> for [[iPhone XS]].
*15-character long '''IMEI number''' (without spaces); empty string for iPod touch and Wi-Fi model iPads (on older devices) OR on newer devices 13-character long "ECID" in decimal (like shown in Xcode)
 
  +
#A hyphen, followed by 16 characters of ECID in hexadecimal padded with zeros on left
*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 ==
 
  +
[0padding]CHIP-[0padding]ECID
For older devices:
 
UDID = SHA1($serial + $IMEI + $WiFiMac + $BluetoothMac)
 
   
  +
Example:
On the [[N92ap|Verizon iPhone 4]] and newer it is instead computed with this formula:
 
  +
00008020-008D4548007B4F26
UDID = SHA1($serial + $ECID + $WiFiMac + $BluetoothMac)
 
  +
  +
===2007-{{date|2018|08}}===
  +
For devices released before {{date|2018|09}}, ([[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)
  +
  +
Prior devices:
  +
UDID = SHA1(serial + IMEI + wifiMac + bluetoothMac)
  +
  +
==== Changing UDID ====
  +
On iOS 8 and lower, 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.
  +
  +
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

Latest revision as of 13:44, 17 September 2021

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. 8 characters of ChipID padded with zeros on the left, without leading zeros. e.g. 8020 for iPhone XS.
  2. A hyphen, followed by 16 characters of ECID in hexadecimal padded with zeros on left

The general format will be:

[0padding]CHIP-[0padding]ECID

Example:

00008020-008D4548007B4F26

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

On iOS 8 and lower, 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