Difference between revisions of "SceSblAuthMgr"

From Vita Development Wiki
Jump to navigation Jump to search
 
(54 intermediate revisions by 4 users not shown)
Line 1: Line 1:
 +
'''S'''ecure '''Bl'''ock Authentication Manager
 +
 
== Module ==
 
== Module ==
  
=== Known NIDs ===
 
 
{| class="wikitable"
 
{| class="wikitable"
 
|-
 
|-
! Version !! Name !! World !! Privilege !! NID
+
! Version !! World !! Privilege
|-
 
| 1.69 || SceSblAuthMgr || Non-secure || Kernel || 0xEA5DFC93
 
|-
 
| 3.57 || SceSblAuthMgr || Non-secure || Kernel || 0xA1BFE33C
 
 
|-
 
|-
| 3.60 || SceSblAuthMgr || Non-secure || Kernel || 0x1773372D
+
| 0.931.010-3.740.011 || Non-secure || Kernel
 
|}
 
|}
  
Line 21: Line 18:
 
! Version !! Name !! World !! Visibility !! NID
 
! Version !! Name !! World !! Visibility !! NID
 
|-
 
|-
| 1.69-3.60 || [[SceSblAuthMgr#SceSblAuthMgrForKernel|SceSblAuthMgrForKernel]] || Non-secure || Kernel || 0x7ABF5135
+
| 0.931.010-3.740.011 || [[SceSblAuthMgr#SceSblAuthMgrForKernel|SceSblAuthMgrForKernel]] || Non-secure || Kernel || 0x7ABF5135
 
|-
 
|-
| 1.69-3.60 || [[SceSblAuthMgr#SceSblAuthMgrForDriver|SceSblAuthMgrForDriver]] || Non-secure || Kernel || 0x4EB2B1BB
+
| 0.931.010-3.740.011 || [[SceSblAuthMgr#SceSblAuthMgrForDriver|SceSblAuthMgrForDriver]] || Non-secure || Kernel || 0x4EB2B1BB
 
|}
 
|}
  
Line 30: Line 27:
 
These functions are used for [[SceKernelModulemgr#Decrypt_SELF_ELF_Program|SELF decryption]].
 
These functions are used for [[SceKernelModulemgr#Decrypt_SELF_ELF_Program|SELF decryption]].
  
=== sceSblAuthMgrInvokeSMForKernel ===
+
=== sceSblAuthMgrOpenForKernel ===
 
{| class="wikitable"
 
{| class="wikitable"
 
! Version !! NID
 
! Version !! NID
 
|-
 
|-
| 3.60 || 0xA9CD2A09
+
| 0.931.010-3.740.011 || 0xA9CD2A09
 
|}
 
|}
 +
 +
Temp name was sceSblAuthMgrInvokeSMForKernel, sceSblAuthMgrSmStartForKernel.
  
 
<source lang="C">
 
<source lang="C">
// if initialization is successful - ctx will be initialized to 1
+
// If initialization is successful - pHandle will be initialized to 1
int sceSblAuthMgrInvokeSMForKernel(int* ctx);
+
int sceSblAuthMgrOpenForKernel(int *pHandle);
 
</source>
 
</source>
  
=== sceSblAuthMgrStopSMForKernel ===
+
=== sceSblAuthMgrCloseForKernel ===
 
{| class="wikitable"
 
{| class="wikitable"
 
! Version !! NID
 
! Version !! NID
 
|-
 
|-
| 3.60 || 0x026ACBAD
+
| 0.931.010-3.740.011 || 0x026ACBAD
 
|}
 
|}
  
Issued [[F00D_Commands#Request_Buffer|F00D command -1]]
+
Temp name was sceSblAuthMgrStopSMForKernel, sceSblAuthMgrSmStopForKernel.
 +
 
 +
Issues [[Secure_Modules_Functions#Request_Buffer|kprx_auth_sm command -1]].
  
 
<source lang="C">
 
<source lang="C">
// ctx - obtained with sceSblAuthMgrInvokeSMForKernel. Should equal 1 for successful deinit.
+
// handle - obtained with sceSblAuthMgrOpenForKernel. Handle must equal 1 for successful close.
int sceSblAuthMgrStopSMForKernel(int ctx);
+
int sceSblAuthMgrCloseForKernel(int handle);
 
</source>
 
</source>
 +
 +
=== sceSblAuthMgrStartForKernel ===
 +
{| class="wikitable"
 +
! Version !! NID
 +
|-
 +
| 0.931.010-0.996.090 || 0xCAA38DF7
 +
|-
 +
| 1.000.071-3.740.011 || not present
 +
|}
 +
 +
Creates SceSblAuthMgrZlibHeap.
 +
 +
<source lang="C">int sceSblAuthMgrStartForKernel(void);</source>
 +
 +
=== sceSblAuthMgrStopForKernel ===
 +
{| class="wikitable"
 +
! Version !! NID
 +
|-
 +
| 0.931.010-0.996.090 || 0x6C1F5048
 +
|-
 +
| 1.000.071-3.740.011 || not present
 +
|}
 +
 +
Deletes SceSblAuthMgrZlibHeap.
 +
 +
<source lang="C">int sceSblAuthMgrStopForKernel(void);</source>
  
 
=== sceSblAuthMgrAuthHeaderForKernel ===
 
=== sceSblAuthMgrAuthHeaderForKernel ===
Line 60: Line 87:
 
! Version !! NID
 
! Version !! NID
 
|-
 
|-
| 3.60 || 0xF3411881
+
| 0.931.010-3.740.011 || 0xF3411881
 
|}
 
|}
  
Issues [[F00D_Commands#0x10001|F00D command 0x10001]]
+
Issues [[Secure_Modules_Functions#0x10001_-_sceSblAuthMgrAuthHeader|kprx_auth_sm command 0x10001]]
  
<code>SceSblSmCommContext130</code> type is defined in [[SceKernelModulemgr#Types|SceKernelModulemgr]].
+
<code>SceSblSmCommContext130</code> type is defined in [[SceSblSsSmComm#Types|SceSblSsSmComm]].
  
Read caller SELF Info using sceKernelGetSelfInfoForKernel then writes it to context_130->caller_self_info.
+
?Read caller SELF Info using sceKernelGetSelfAuthInfoForKernel? then writes it to context_130->caller_self_auth_info.
  
Calls smc_137 and smc_134 that interact with F00D. F00D set context_130->called_self_info.
+
Calls smc_137 and smc_134 that interact with Cmep. Cmep sets context_130->called_self_auth_info.
  
 
<source lang="C">
 
<source lang="C">
//ctx - obtained with sceSblAuthMgrSmStartForKernel
+
// handle - obtained with sceSblAuthMgrOpenForKernel
int sceSblAuthMgrAuthHeaderForKernel(int ctx, char *header, int header_size, SceSblSmCommContext130 *context_130);
+
int sceSblAuthMgrAuthHeaderForKernel(int handle, const void *self_header_addr, SceSize SelfHeaderSize, SceSblSmCommContext130 *auth_info);
 
</source>
 
</source>
  
=== sceSblAuthMgrLoadSelfSegmentForKernel ===
+
=== sceSblAuthMgrSetupAuthSegmentForKernel ===
 
{| class="wikitable"
 
{| class="wikitable"
 
! Version !! NID
 
! Version !! NID
 
|-
 
|-
| 3.60 || 0x89CCDA2C
+
| 0.931.010-3.740.011 || 0x89CCDA2C
 
|}
 
|}
  
Issues [[F00D_Commands#0x20001|F00D command 0x20001]]
+
Temp name was sceSblAuthMgrLoadSelfSegmentForKernel, sceSblAuthMgrLoadSegmentForKernel.
 +
 
 +
Issues [[Secure_Modules_Functions#0x20001_-_sceSblAuthMgrSetupAuthSegment|kprx_auth_sm command 0x20001]].
  
 
<source lang="C">
 
<source lang="C">
// ctx - obtained with sceSblAuthMgrSmStartForKernel
+
// handle - obtained with sceSblAuthMgrOpenForKernel
int sceSblAuthMgrLoadSelfSegmentForKernel(int ctx, int segment_number, int segment_size, void output_buffer, int program_size);
+
 
 +
0.931.010-1.500
 +
int sceSblAuthMgrSetupAuthSegmentForKernel(int handle, int segment_number, SceSize segment_size, void *output_buffer, SceSize program_size);
 +
 
 +
3.600.011-3.740.011
 +
int sceSblAuthMgrSetupAuthSegmentForKernel(int handle, int segment_number);
 
</source>
 
</source>
  
=== sceSblAuthMgrLoadSelfBlockForKernel ===
+
=== sceSblAuthMgrAuthSegmentForKernel ===
 
{| class="wikitable"
 
{| class="wikitable"
 
! Version !! NID
 
! Version !! NID
 
|-
 
|-
| 3.60 || 0xBC422443
+
| 0.990.000-3.740.011 || 0xBC422443
 
|}
 
|}
  
Issues [[F00D_Commands#0x30001|F00D command 0x30001]]
+
Temp name was sceSblAuthMgrLoadSelfBlockForKernel, sceSblAuthMgrLoadBlockForKernel.
 +
 
 +
Issues [[Secure_Modules_Functions#0x30001_-_sceSblAuthMgrLoadBlock|kprx_auth_sm command 0x30001]]
 +
 
 +
<source lang="C">
 +
// handle - obtained with sceSblAuthMgrOpenForKernel
 +
int sceSblAuthMgrAuthSegmentForKernel(int handle, void *buffer, SceSize len);
 +
</source>
 +
 
 +
=== sceSblAuthMgrLoadSegmentInternalForKernel ===
 +
{| class="wikitable"
 +
! Version !! NID
 +
|-
 +
| 0.990.000-1.692.000 || 0x15248FB4
 +
|-
 +
| 1.800.071-3.740.011 || not present
 +
|}
  
 
<source lang="C">
 
<source lang="C">
// ctx - obtained with sceSblAuthMgrSmStartForKernel
+
// handle - obtained with sceSblAuthMgrOpenForKernel
int sceSblAuthMgrLoadSelfBlockForKernel(int ctx, char *buffer, int offset);
+
int sceSblAuthMgrLoadSegmentInternalForKernel(int handle, int a2, unsigned int a3);
 
</source>
 
</source>
  
Line 108: Line 158:
 
! Version !! NID
 
! Version !! NID
 
|-
 
|-
| 1.05 || 0x122ACDEA
+
| 0.990.000-3.740.011 || 0x122ACDEA
|-
 
| 3.60 || 0x122ACDEA
 
 
|}
 
|}
  
Issues [[F00D_Commands#0x50001_sceSblAuthMgrSetDmac5KeyForKernel|F00D command 0x50001]]
+
Issues [[Secure_Modules_Functions#0x50001_-_sceSblAuthMgrSetDmac5KeyForKernel|kprx_auth_sm command 0x50001]].
  
 
<source lang="C">
 
<source lang="C">
 
// key_size - in bytes
 
// key_size - in bytes
int sceSblAuthMgrSetDmac5KeyForKernel(char *key, int key_size, int slot_id, int key_id);
+
int sceSblAuthMgrSetDmac5KeyForKernel(const void *key, SceSize key_size, int slot_id, int key_id);
 
</source>
 
</source>
  
Line 124: Line 172:
 
! Version !! NID
 
! Version !! NID
 
|-
 
|-
| 1.05 || 0xF2BB723E
+
| 0.990.000-3.740.011 || 0xF2BB723E
|-
 
| 3.60 || 0xF2BB723E
 
 
|}
 
|}
  
Issues [[F00D_Commands#0x60001_sceSblAuthMgrClearDmac5KeyForKernel|F00D command 0x60001]]
+
Issues [[Secure_Modules_Functions#0x60001_-_sceSblAuthMgrClearDmac5KeyForKernel|kprx_auth_sm command 0x60001]].
  
 
<source lang="C">int sceSblAuthMgrClearDmac5KeyForKernel(int unk0, int unk1);</source>
 
<source lang="C">int sceSblAuthMgrClearDmac5KeyForKernel(int unk0, int unk1);</source>
Line 137: Line 183:
 
! Version !! NID
 
! Version !! NID
 
|-
 
|-
| 3.60 || 0x2A83A012
+
| 1.800.071-3.740.011 || 0x2A83A012
 
|}
 
|}
  
Returns 0. May be an old function kept for compatibility.
+
Not implemented and returns 0. Maybe implemented in some internal System Software versions.
  
 
<source lang="C">int SceSblAuthMgrForKernel_2A83A012(void);</source>
 
<source lang="C">int SceSblAuthMgrForKernel_2A83A012(void);</source>
Line 148: Line 194:
 
! Version !! NID
 
! Version !! NID
 
|-
 
|-
| 3.60 || 0xABAB8466
+
| 0.931.010-0.996.090 || not present
 +
|-
 +
| 1.000.071-3.740.011 || 0xABAB8466
 
|}
 
|}
  
Aligns version on 12 bits then compares to the hardcoded current firmware version (example: 0x03600000 or 0x03650000).
+
Aligns version on 12 bits then compares to the hardcoded current firmware version (example: 0x03600000 on FW 3.60).
  
 
<source lang="C">int sceSblAuthMgrCompareSwVersionForKernel(int version);</source>
 
<source lang="C">int sceSblAuthMgrCompareSwVersionForKernel(int version);</source>
Line 161: Line 209:
 
! Version !! NID
 
! Version !! NID
 
|-
 
|-
| 1.05 || 0x868B9E9A
+
| 0.990.000-3.740.011 || 0x868B9E9A
|-
 
| 3.60 || 0x868B9E9A
 
 
|}
 
|}
  
EKc = Encrypted Key License (also called klicensee)
+
EKc might mean Encrypted Klicensee.
  
Issues [[F00D_Commands#0x40001_sceSblAuthMgrGetEKcForDriver|F00D command 0x40001]]
+
Issues [[Secure_Modules_Functions#0x40001_-_sceSblAuthMgrGetEKcForDriver|kprx_auth_sm command 0x40001]].
  
<source lang="C">int sceSblAuthMgrGetEKcForDriver(void* data, int size, int key_id);</source>
+
<source lang="C">int sceSblAuthMgrGetEKcForDriver(void *data, SceSize size, int key_id);</source>
  
 
=== sceSblAuthMgrDecBindDataForDriver ===
 
=== sceSblAuthMgrDecBindDataForDriver ===
Line 176: Line 222:
 
! Version !! NID
 
! Version !! NID
 
|-
 
|-
| 1.05 || 0x41DAEA12
+
| 0.990.000-3.740.011 || 0x41DAEA12
|-
 
| 3.60 || 0x41DAEA12
 
 
|}
 
|}
  
Issues [[F00D_Commands#0x70001_sceSblAuthMgrDecBindDataForDriver|F00D command 0x70001]]
+
Issues [[Secure_Modules_Functions#0x70001_-_sceSblAuthMgrDecBindDataForDriver|kprx_auth_sm command 0x70001]].
  
 
<source lang="C">
 
<source lang="C">
Line 189: Line 233:
 
</source>
 
</source>
  
=== sceSblAuthMgrVerifySpfsoCtxForDriver ===
+
=== sceSblAuthMgrVerifySpsfoForDriver ===
 
{| class="wikitable"
 
{| class="wikitable"
 
! Version !! NID
 
! Version !! NID
 
|-
 
|-
| 3.60 || 0x24C4CE64
+
| 0.931.010-0.990.000 || not present
 +
|-
 +
| 0.996.090-3.740.011 || 0x24C4CE64
 
|}
 
|}
  
Used by [[SceSblPostSsMgr#sceSblPostSsMgrVerifySpfsoCtxForDriver|sceSblPostSsMgrVerifySpfsoCtxForDriver]]
+
Used by [[SceSblPostSsMgr#sceSblSpsfoMgrVerifyForDriver|sceSblSpsfoMgrVerifyForDriver]].
 +
 
 +
Issues [[Secure_Modules_Functions#0x80001_-_sceSblAuthMgrVerifySpsfo|kprx_auth_sm command 0x80001]].
 +
 
 +
Spsfo (signed param.sfo) file is located in game cartridge at path gro0:gc/param.sfo. It can also be loaded from host0: on DevKit. It has 3 parts: CF header and certification, plain SceSpsfoHeader and plain SFO (maybe reduced).
 +
 
 +
<source lang="C">
 +
typedef struct SceSpsfoHeader { // size is 0x200 usually
 +
    int version;                  // ex: 1
 +
    SceSize size;                // header size
 +
    uint64_t system_version;      // ex: 0x0330000000000110
 +
    char titleid[0x20];
 +
    uint64_t parent_authority_id; // ex: 0x2800000000000030
 +
    uint64_t process_authority_id;
 +
    char reserved[0x1C0];
 +
} SceSpsfoHeader;
  
Issues [[F00D_Commands#0x80001|F00D command 0x80001]]
+
Note : SceSpsfoHeader and spsfo_ctx may be different
 +
</source>
  
<source lang="C">int sceSblAuthMgrVerifySpfsoCtxForDriver(spsfo_ctx *ctx);</source>
+
<source lang="C">int sceSblAuthMgrVerifySpsfoForDriver(spsfo_ctx *ctx);</source>
  
  
 +
[[Category:ARM]]
 +
[[Category:Kernel]]
 
[[Category:Modules]]
 
[[Category:Modules]]
[[Category:Kernel]]
+
[[Category:Library]]

Latest revision as of 22:25, 16 July 2023

Secure Block Authentication Manager

Module

Version World Privilege
0.931.010-3.740.011 Non-secure Kernel

Libraries

Known NIDs

Version Name World Visibility NID
0.931.010-3.740.011 SceSblAuthMgrForKernel Non-secure Kernel 0x7ABF5135
0.931.010-3.740.011 SceSblAuthMgrForDriver Non-secure Kernel 0x4EB2B1BB

SceSblAuthMgrForKernel

These functions are used for SELF decryption.

sceSblAuthMgrOpenForKernel

Version NID
0.931.010-3.740.011 0xA9CD2A09

Temp name was sceSblAuthMgrInvokeSMForKernel, sceSblAuthMgrSmStartForKernel.

// If initialization is successful - pHandle will be initialized to 1
int sceSblAuthMgrOpenForKernel(int *pHandle);

sceSblAuthMgrCloseForKernel

Version NID
0.931.010-3.740.011 0x026ACBAD

Temp name was sceSblAuthMgrStopSMForKernel, sceSblAuthMgrSmStopForKernel.

Issues kprx_auth_sm command -1.

// handle - obtained with sceSblAuthMgrOpenForKernel. Handle must equal 1 for successful close.
int sceSblAuthMgrCloseForKernel(int handle);

sceSblAuthMgrStartForKernel

Version NID
0.931.010-0.996.090 0xCAA38DF7
1.000.071-3.740.011 not present

Creates SceSblAuthMgrZlibHeap.

int sceSblAuthMgrStartForKernel(void);

sceSblAuthMgrStopForKernel

Version NID
0.931.010-0.996.090 0x6C1F5048
1.000.071-3.740.011 not present

Deletes SceSblAuthMgrZlibHeap.

int sceSblAuthMgrStopForKernel(void);

sceSblAuthMgrAuthHeaderForKernel

Version NID
0.931.010-3.740.011 0xF3411881

Issues kprx_auth_sm command 0x10001

SceSblSmCommContext130 type is defined in SceSblSsSmComm.

?Read caller SELF Info using sceKernelGetSelfAuthInfoForKernel? then writes it to context_130->caller_self_auth_info.

Calls smc_137 and smc_134 that interact with Cmep. Cmep sets context_130->called_self_auth_info.

// handle - obtained with sceSblAuthMgrOpenForKernel
int sceSblAuthMgrAuthHeaderForKernel(int handle, const void *self_header_addr, SceSize SelfHeaderSize, SceSblSmCommContext130 *auth_info);

sceSblAuthMgrSetupAuthSegmentForKernel

Version NID
0.931.010-3.740.011 0x89CCDA2C

Temp name was sceSblAuthMgrLoadSelfSegmentForKernel, sceSblAuthMgrLoadSegmentForKernel.

Issues kprx_auth_sm command 0x20001.

// handle - obtained with sceSblAuthMgrOpenForKernel

0.931.010-1.500
int sceSblAuthMgrSetupAuthSegmentForKernel(int handle, int segment_number, SceSize segment_size, void *output_buffer, SceSize program_size);

3.600.011-3.740.011
int sceSblAuthMgrSetupAuthSegmentForKernel(int handle, int segment_number);

sceSblAuthMgrAuthSegmentForKernel

Version NID
0.990.000-3.740.011 0xBC422443

Temp name was sceSblAuthMgrLoadSelfBlockForKernel, sceSblAuthMgrLoadBlockForKernel.

Issues kprx_auth_sm command 0x30001

// handle - obtained with sceSblAuthMgrOpenForKernel
int sceSblAuthMgrAuthSegmentForKernel(int handle, void *buffer, SceSize len);

sceSblAuthMgrLoadSegmentInternalForKernel

Version NID
0.990.000-1.692.000 0x15248FB4
1.800.071-3.740.011 not present
// handle - obtained with sceSblAuthMgrOpenForKernel
int sceSblAuthMgrLoadSegmentInternalForKernel(int handle, int a2, unsigned int a3);

sceSblAuthMgrSetDmac5KeyForKernel

Version NID
0.990.000-3.740.011 0x122ACDEA

Issues kprx_auth_sm command 0x50001.

// key_size - in bytes
int sceSblAuthMgrSetDmac5KeyForKernel(const void *key, SceSize key_size, int slot_id, int key_id);

sceSblAuthMgrClearDmac5KeyForKernel

Version NID
0.990.000-3.740.011 0xF2BB723E

Issues kprx_auth_sm command 0x60001.

int sceSblAuthMgrClearDmac5KeyForKernel(int unk0, int unk1);

SceSblAuthMgrForKernel_2A83A012

Version NID
1.800.071-3.740.011 0x2A83A012

Not implemented and returns 0. Maybe implemented in some internal System Software versions.

int SceSblAuthMgrForKernel_2A83A012(void);

sceSblAuthMgrCompareSwVersionForKernel

Version NID
0.931.010-0.996.090 not present
1.000.071-3.740.011 0xABAB8466

Aligns version on 12 bits then compares to the hardcoded current firmware version (example: 0x03600000 on FW 3.60).

int sceSblAuthMgrCompareSwVersionForKernel(int version);

SceSblAuthMgrForDriver

sceSblAuthMgrGetEKcForDriver

Version NID
0.990.000-3.740.011 0x868B9E9A

EKc might mean Encrypted Klicensee.

Issues kprx_auth_sm command 0x40001.

int sceSblAuthMgrGetEKcForDriver(void *data, SceSize size, int key_id);

sceSblAuthMgrDecBindDataForDriver

Version NID
0.990.000-3.740.011 0x41DAEA12

Issues kprx_auth_sm command 0x70001.

// request should contain pair of keys and rif data

int sceSblAuthMgrDecBindDataForDriver(char* klicensee, int klicensee_len, char* request, int request_len, int zero);

sceSblAuthMgrVerifySpsfoForDriver

Version NID
0.931.010-0.990.000 not present
0.996.090-3.740.011 0x24C4CE64

Used by sceSblSpsfoMgrVerifyForDriver.

Issues kprx_auth_sm command 0x80001.

Spsfo (signed param.sfo) file is located in game cartridge at path gro0:gc/param.sfo. It can also be loaded from host0: on DevKit. It has 3 parts: CF header and certification, plain SceSpsfoHeader and plain SFO (maybe reduced).

typedef struct SceSpsfoHeader { // size is 0x200 usually
    int version;                  // ex: 1
    SceSize size;                 // header size
    uint64_t system_version;      // ex: 0x0330000000000110
    char titleid[0x20];
    uint64_t parent_authority_id; // ex: 0x2800000000000030
    uint64_t process_authority_id;
    char reserved[0x1C0];
} SceSpsfoHeader;

Note : SceSpsfoHeader and spsfo_ctx may be different
int sceSblAuthMgrVerifySpsfoForDriver(spsfo_ctx *ctx);