mirror of
https://github.com/DarkMatterCore/nxdumptool.git
synced 2024-12-29 11:56:01 +00:00
54c5677cd0
* codebase: remove all references to Lockpick / Lockpick_RCM. * keys: retrieve Atmosphère's key generation in keysLoadKeyset(). * keys: replace all "key_gen_val" references with "mkey_index". * keys: move latest master key checks in keysReadKeysFromFile() to keysDeriveMasterKeys(). * keys: update latest master key checks to determine if nxdumptool's hardcoded master key vectors are outdated, using the key generation value from Atmosphère. If the master key vectors are outdated, and the newer master key(s) are not available, an error will be displayed. * nxdt_utils: update logic in utilsReplaceIllegalCharacters() to replace consecutive illegal characters with a single underscore. * nxdt_utils: move servicesGetExosphereApiVersion() to nxdt_utils as utilsGetExosphereApiVersion(). * nxdt_utils: define internal UtilsExosphereApiVersion struct, which is used to parse the output from utilsGetExosphereApiVersion(). * nxdt_utils: add utilsGetAtmosphereVersion(), utilsGetAtmosphereKeyGeneration() and utilsGetAtmosphereTargetFirmware() functions. * services: remove servicesGetExosphereApiVersion(). * services: Atmosphère version is now retrieved via utilsGetAtmosphereVersion().
58 lines
2.3 KiB
C
58 lines
2.3 KiB
C
/*
|
|
* keys.h
|
|
*
|
|
* Copyright (c) 2018-2020, SciresM.
|
|
* Copyright (c) 2019, shchmue.
|
|
* Copyright (c) 2020-2023, DarkMatterCore <pabloacurielz@gmail.com>.
|
|
*
|
|
* This file is part of nxdumptool (https://github.com/DarkMatterCore/nxdumptool).
|
|
*
|
|
* nxdumptool is free software: you can redistribute it and/or modify
|
|
* it under the terms of the GNU General Public License as published by
|
|
* the Free Software Foundation, either version 3 of the License, or
|
|
* (at your option) any later version.
|
|
*
|
|
* nxdumptool is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
* GNU General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU General Public License
|
|
* along with this program. If not, see <https://www.gnu.org/licenses/>.
|
|
*/
|
|
|
|
#pragma once
|
|
|
|
#ifndef __KEYS_H__
|
|
#define __KEYS_H__
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
/// Loads (and derives) keydata from sysmodule program memory, a keys file and hardcoded/obfuscated information.
|
|
/// Must be called (and succeed) before calling any of the functions below.
|
|
bool keysLoadKeyset(void);
|
|
|
|
/// Returns a pointer to the AES-128-XTS NCA header key, or NULL if keydata hasn't been loaded.
|
|
const u8 *keysGetNcaHeaderKey(void);
|
|
|
|
/// Returns a pointer to an AES-128-ECB NCA key area encryption key using the provided key area encryption key index and key generation values, or NULL if keydata hasn't been loaded.
|
|
const u8 *keysGetNcaKeyAreaEncryptionKey(u8 kaek_index, u8 key_generation);
|
|
|
|
/// Decrypts a RSA-OAEP wrapped titlekey using console-specific keydata.
|
|
/// 'rsa_wrapped_titlekey' must have a size of at least 0x100 bytes. 'out_titlekey' must have a size of at least AES_128_KEY_SIZE.
|
|
/// Returns false if an error occurs or if keydata hasn't been loaded.
|
|
bool keysDecryptRsaOaepWrappedTitleKey(const void *rsa_wrapped_titlekey, void *out_titlekey);
|
|
|
|
/// Returns a pointer to an AES-128-ECB ticket common key using the provided key generation value, or NULL if keydata hasn't been loaded.
|
|
const u8 *keysGetTicketCommonKey(u8 key_generation);
|
|
|
|
/// Returns a pointer to the AES-128-CBC CardInfo area key for gamecard headers, or NULL if keydata hasn't been loaded.
|
|
const u8 *keysGetGameCardInfoKey(void);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif /* __KEYS_H__ */
|