Updated AES Keys (markdown)

Steveice10 2024-03-01 18:30:38 -08:00
parent 0c8766c549
commit 45b7fd009f

@ -3,13 +3,15 @@
Users can provide some additional crypto keys to enable some advanced features in Citra. These keys are not officially provided by Citra due to legal considerations. Users can provide some additional crypto keys to enable some advanced features in Citra. These keys are not officially provided by Citra due to legal considerations.
### Automatically (Recommended) ### Automatically (Recommended)
In this method, you will create ```aes_keys.txt``` and ```seeddb.bin``` files from your console using a GodMode9 script. This will dump all the keys and other secrets you need for game decryption, Miis, amiibo, etc. **This requires your 3DS to be on firmware 11.16.0 or 11.17.0.** In this method, you will create ```aes_keys.txt```, and optionally ```seeddb.bin```, files from your console using a GodMode9 script. This will dump all the keys and other secrets you need for game decryption, Miis, amiibo, etc. **This requires your 3DS to be on firmware 11.16.0 or 11.17.0.**
Note that the ```seeddb.bin``` reflects the seed encryption keys available on your console at the time of dumping. If you ever install and dump new games on your 3DS that use seed encryption, you may need to re-dump this file to acquire their seed keys for Citra. Note that the ```seeddb.bin``` reflects the seed encryption keys available on your console at the time of dumping. If you ever install and dump new games on your 3DS that use seed encryption, you may need to re-dump this file to acquire their seed keys for Citra.
The script may also not output a ```seeddb.bin```, or it may display an error when trying to dumping it, which simply indicates that you do not have any seeds and thus should not need them. If this happens you can ignore it.
1. Download the GodMode9 script [here](https://github.com/citra-emu/citra/raw/master/dist/dumpkeys/DumpKeys.gm9) (Right Click -> Save Link As) and save it to the ```gm9/scripts``` directory on your SD card. 1. Download the GodMode9 script [here](https://github.com/citra-emu/citra/raw/master/dist/dumpkeys/DumpKeys.gm9) (Right Click -> Save Link As) and save it to the ```gm9/scripts``` directory on your SD card.
2. Launch GodMode9 on your 3DS and run the script by pressing HOME, selecting "Scripts", and selecting "DumpKeys". Wait for the script to finish and return you to the GodMode9 menu, then turn off your 3DS. 2. Launch GodMode9 on your 3DS and run the script by pressing HOME, selecting "Scripts", and selecting "DumpKeys". Wait for the script to finish and return you to the GodMode9 menu, then turn off your 3DS.
3. On your SD card you will find ```gm9/aes_keys.txt``` and ```gm9/seeddb.bin```. Copy these files to the ```sysdata``` folder in your Citra user directory. 3. On your SD card you will find ```gm9/aes_keys.txt```, and optionally ```gm9/seeddb.bin```. Copy these files to the ```sysdata``` folder in your Citra user directory.
**If you see an error like ```line 7: read fail``` when dumping in GodMode9, your environment does not have access to the bootrom data and thus cannot dump the required keys. This can occur if you are using fastboot3DS; please launch GodMode9 through a different method.** **If you see an error like ```line 7: read fail``` when dumping in GodMode9, your environment does not have access to the bootrom data and thus cannot dump the required keys. This can occur if you are using fastboot3DS; please launch GodMode9 through a different method.**