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
	Support Author

Latest revision as of 06:05, 6 Mayıs 2024

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 3DS 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

External Links

Official Site - http://soundhax.com/
Github - https://github.com/nedwill/soundhax

@@ Line 1: / Line 1: @@
 {{Infobox 3DS Homebrews
-| title = Soundhax
+|title=Soundhax
-| image = Soundhax.png|250px
+|image=soundhax3ds.png
-| type = Exploits
+|description=Free 3DS Primary Entrypoint <= 11.3.
-| version=2020
+|author=nedwill
-| lastupdated = 2020/12/09
+|lastupdated=2020/12/09
-| license = Mixed
+|type=Exploits
-| author = nedwill
+|version=2020
-| website = https://github.com/nedwill/soundhax
+|license=Mixed
-| download = https://dlhb.gamebrew.org/3dshomebrew/soundhax2020.7z
+|download=http://soundhax.com/
-| source =  https://github.com/nedwill/soundhax
+|website=http://soundhax.com/
+|source=https://github.com/nedwill/soundhax
+|donation=http://soundhax.com/
 }}
-<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==
+==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.
-A heap overflow in tag processing leads to code execution when a specially- crafted m4a file is loaded by Nintendo 3DS Sound.
+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.
-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.
 == Regions and Versions ==
-{|
+{| class="wikitable"
 ! Version
 ! N3DS/N2DS
@@ Line 55: / Line 56: @@
 If your box is checked, then put [https://smealum.github.io/3ds/#otherapp 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 [https://github.com/hax0kartik/pre9otherapp pre9otherapp] to launch an arm9 payload from the SD card on pre 9.0 firms (2.1 - 9.2).
+It can be used along [[Pre9otherapp 3DS]] 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 [https://smealum.github.io/3ds/ otherapp payload] for your 3DS version, rename it to <code>otherapp.bin</code>, and copy it to the root of the SD card.
-# Download the [https://github.com/fincs/new-hbmenu/releases/latest Homebrew Menu] and place <code>boot.3dsx</code> in the root of the SD card (if it is not there already).
+# Download the [[The Homebrew Launcher 3DS|Homebrew Menu]] and place <code>boot.3dsx</code> 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!
@@ Line 68: / Line 68: @@
 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 106: / Line 83: @@
 * PPP - teaching me everything I know
 * geohot, comex, j00ru, loki, project zero - inspiring me to pursue bug hunting
+==External Links==
+* Official Site - http://soundhax.com/
+* Github - https://github.com/nedwill/soundhax
+[[Category:Exploits for 3DS]]