Soundhax 3DS: Difference between revisions

Soundhax
Soundhax
General
Author	nedwill
Type	Exploits
Version	2020
License	Mixed
Last Updated	2020/12/09
Links
	Download
	Website
	Source

Revision as of 11:28, 25 April 2023

Soundhax is a primary homebrew entrypoint that works on firmwares up to 11.3. It is a new exploit that gives you access to the homebrew launcher without needing a game to exploit. This vulnerability exploits the default sound application preinstalled on all 3DS devices. Soundhax (when combined with the Homebrew Launcher) is compatible with versions 9.0.0 through 11.3.0 in the EUR, JPN, KOR, and USA regions.

About This Exploit

There is a bug in the 3DS Sound application where it uses a memcpy function instead of a unicode strncpy variant to copy a song name from mp4 atom tags onto the heap, potentially causing a buffer overflow. The exploit takes advantage of this overflow to control the malloc header of the next heap chunk, which allows for arbitrary writes to memory. By manipulating the free list and causing a stack overflow, the exploit can turn the arbitrary write primitive into ROP and use the gspwn GPU exploit to write shellcode over the text section of the sound process, allowing for code execution.

Regions and Versions

Version	N3DS/N2DS	O3DS/2DS
US 1.0-11.3	✓	✓
JPN 1.0-11.3	✓	✓
EUR 1.0-11.3	✓	✓
KOR 4.0-11.3	✓	✓
CHN 4.0-11.3	N/A	✓
TWN 4.1-11.3	N/A	✓

All existing versions of Nintendo 3DS Sound prior to Nintendo fixing the vulnerability are now supported.

If your box is checked, then put otherapp.bin on the root of your SD card along with soundhax.m4a and launch the song from the sound player.

It can be used along pre9otherapp to launch an arm9 payload from the SD card on pre 9.0 firms (2.1 - 9.2).

Installation

Download the relevant soundhax-region-console-firmware.m4a file for your device.
Save the soundhax song file and copy to the root of your SD.
Download the otherapp payload for your 3DS version, rename it to otherapp.bin, and copy it to the root of the SD card.
Download the Homebrew Menu and place boot.3dsx in the root of the SD card (if it is not there already).
Insert the SD card into the 3DS and start Nintendo 3DS Sound.
Locate your new song and play it to start the Homebrew Menu!

Fixing the annoying bird: Click through all of the bird tips then close the app normally. When you exploit it it doesn't save the fact that you've opened the app before, so closing and reopening normally seems to fix this.

Media

[3DS] How To Install & Use Soundhax - (DarkFlare)

Thanks

Subv and Citra authors - for help emulating sound, this was invaluable
plutoo - stage 2 shellcode
yellows8 - help with gpu address translation for gspwn, initial JPN support, finished KOR support
smea - homebrew launcher
d3m3vilurr - EUR, JPN, partial KOR support
TuxSH - O3DS offset
Konng - Testing EUR payloads
cakey - advice and support
PPP - teaching me everything I know
geohot, comex, j00ru, loki, project zero - inspiring me to pursue bug hunting

@@ Line 1: / Line 1: @@
 {{Infobox 3DS Homebrews
 |title=Soundhax
-|image=Soundhax.png
+|image=soundhax3ds.png
-|description=Free 3DS Primary Entrypoint <= 11.3�http://soundhax.com
+|description=Free 3DS Primary Entrypoint <= 11.3.
 |author=nedwill
 |lastupdated=2020/12/09
@@ Line 8: / Line 8: @@
 |version=2020
 |license=Mixed
-|download=https://dlhb.gamebrew.org/3dshomebrew/soundhax2020.7z
+|download=http://soundhax.com/
 |website=https://github.com/nedwill/soundhax
 |source=https://github.com/nedwill/soundhax
 }}
-<youtube>Uysb6oQ7Bag</youtube>
+Soundhax is a primary homebrew entrypoint that works on firmwares up to 11.3. It is a new exploit that gives you access to the homebrew launcher without needing a game to exploit. This vulnerability exploits the default sound application preinstalled on all 3DS devices. Soundhax (when combined with the Homebrew Launcher) is compatible with versions 9.0.0 through 11.3.0 in the EUR, JPN, KOR, and USA regions.
-==Soundhax==
-A heap overflow in tag processing leads to code execution when a specially- crafted m4a file is loaded by Nintendo 3DS Sound.
-This bug is particularly good, because as far as I can tell it is the first ever homebrew exploit that is free, offline, and works on every version of the firmware for which the sound app is available.
+==About This Exploit==
+There is a bug in the 3DS Sound application where it uses a <code>memcpy</code> function instead of a unicode <code>strncpy</code> variant to copy a song name from mp4 atom tags onto the heap, potentially causing a buffer overflow. The exploit takes advantage of this overflow to control the malloc header of the next heap chunk, which allows for arbitrary writes to memory. By manipulating the free list and causing a stack overflow, the exploit can turn the arbitrary write primitive into ROP and use the gspwn GPU exploit to write shellcode over the text section of the sound process, allowing for code execution.
 == Regions and Versions ==
-{|
+{| class="wikitable"
 ! Version
 ! N3DS/N2DS
@@ Line 59: / Line 56: @@
 == Installation ==
 # Download the relevant soundhax-region-console-firmware.m4a file for your device.
 # Save the soundhax song file and copy to the root of your SD.
@@ Line 69: / Line 65: @@
 Fixing the annoying bird: Click through all of the bird tips then close the app normally. When you exploit it it doesn't save the fact that you've opened the app before, so closing and reopening normally seems to fix this.
-== Build ==
+==Media==
+'''[3DS] How To Install & Use Soundhax - ([https://www.youtube.com/watch?v=Uysb6oQ7Bag  DarkFlare])'''<br>
-Install [https://python.org Python 2.7] and [https://devkitpro.org/wiki/Getting_Started devkitARM].
+<youtube>Uysb6oQ7Bag</youtube>
-Then run <code>python exp.py &lt;usa/eur/jpn/kor/chn/twl&gt; &lt;new/old&gt; &lt;pre21/v21and22/v3xand4x/post5&gt;</code> to generate <code>soundhax-*.m4a</code>.
-== Build ==
-Install [https://python.org Python 2.7] and [https://sourceforge.net/projects/devkitpro/ devkitpro]. Then run <code>python exp.py &lt;usa/eur/jpn/kor&gt; &lt;new/old&gt; &lt;pre5/post5&gt;</code> to generate <code>soundhax-*.m4a</code>.
-== Writeup ==
-=== The Bug ===
-DS Sound mallocs a buffer of 256 bytes to hold the name of song as described in its mp4 atom tags. This is sensible since it's the maximum allowed size according to the spec. When parsing an ascii title, <code>strncpy(dst, src, 256)</code> is used, which is safe and correct. However, because unicode strings contain null bytes, rather than using a unicode <code>strncpy</code> variant, the application simply <code>memcpy</code>s the name bytes onto the heap using the user provided size, which can be arbitrarily large.
-=== Exploit ===
-I overflow my data onto the next heap chunk, which lets me fully control the malloc header of that chunk, which happens to be allocated at the time of the overflow. When that chunk is freed, a heap unlink is performed, which allows me to do an arbitrary write. This means I can write a dword to the stack and control PC.
-Unfortunately, there aren't any usable gadgets (trust me, I looked), so I had to use a more advanced technique to exploit the bug. I used the arbitrary write to overwrite the free list header with a stack address, while setting the start and end fields of the chunk being freed to cause the block to appear undersized, thus causing it to not be added to the free list and so the stack address I just wrote is used on the next malloc.
-Because malloc jumps through the free list looking for a suitable block, I had to find a stack address at which there appears to be a valid heap chunk header with a large enough size for the requested allocation and null pointers for the next and prev entries in the list, so that my stack chunk is chosen as the 'best' one.
-Once all of these conditions are met, the next malloc returns the stack address as the 'heap' location to write my next tag data, which lets me turn the arbitrary write primitive into ROP.
-From there I use the gspwn GPU exploit to write my stage2 shellcode over the text section of the sound process, before finally jumping to it.
-In summary, the process looks like this:
-heap overflow -> arbitrary write to free list -> stack overflow -> gspwn -> code execution
 == Thanks ==
 * Subv and Citra authors - for help emulating sound, this was invaluable
 * plutoo - stage 2 shellcode
@@ Line 107: / Line 80: @@
 * PPP - teaching me everything I know
 * geohot, comex, j00ru, loki, project zero - inspiring me to pursue bug hunting
+[[Category:3DS homebrew loaders]]
+[[Category:Exploits for 3DS]]