GP card规范学习笔记
9. APDU命令参考
9.1 总的编码规则
A．生命周期状态的编码
可执行的装载文件
|
b8 |
b7 |
b6 |
b5 |
b4 |
b3 |
b2 |
b1 |
含义 |
16进制命令 |
|
0 |
0 |
0 |
0 |
0 |
0 |
0 |
1 |
LOADED |
01 |
应用
|
b8 |
b7 |
b6 |
b5 |
b4 |
b3 |
b2 |
b1 |
含义 |
16进制命令 |
|
0 |
0 |
0 |
0 |
0 |
0 |
1 |
1 |
INSTALLED |
03 |
|
0 |
X |
X |
X |
X |
1 |
1 |
1 |
SELECTABLE |
>07? |
|
1 |
X |
X |
X |
X |
X |
1 |
1 |
LOCKED |
>83？ |
//LOCKED>256?
安全域
|
b8 |
b7 |
b6 |
b5 |
b4 |
b3 |
b2 |
b1 |
含义 |
16进制命令 |
|
0 |
0 |
0 |
0 |
0 |
0 |
1 |
1 |
INSTALLED |
03 |
|
0 |
0 |
0 |
0 |
0 |
1 |
1 |
1 |
SELECTABLE |
07 |
|
0 |
0 |
0 |
0 |
1 |
1 |
1 |
1 |
PERSONALIZED |
0F |
|
1 |
0 |
0 |
0 |
X |
X |
1 |
1 |
LOCKED |
83？ |
主安全域
|
b8 |
b7 |
b6 |
b5 |
b4 |
b3 |
b2 |
b1 |
含义 |
16进制命令 |
|
0 |
0 |
0 |
0 |
0 |
0 |
0 |
1 |
OP_READY |
01 |
|
0 |
0 |
0 |
0 |
0 |
1 |
1 |
1 |
INITIALIZED |
07 |
|
0 |
0 |
0 |
0 |
1 |
1 |
1 |
1 |
SECURED |
0F |
|
0 |
1 |
1 |
1 |
1 |
1 |
1 |
1 |
CARD_LOCKED |
7F |
|
1 |
1 |
1 |
1 |
1 |
1 |
1 |
1 |
TERMINATED |
FF |
B．应用的权限编码
|
b8 |
b7 |
b6 |
b5 |
b4 |
b3 |
b2 |
b1 |
含义 |
|
1 |
X |
X |
X |
X |
X |
X |
X |
安全域 |
|
1 |
1 |
X |
X |
X |
X |
X |
0 |
DAP验证 |
|
1 |
X |
1 |
X |
X |
X |
X |
X |
委托管理 |
|
X |
X |
X |
1 |
X |
X |
X |
X |
卡锁定 |
|
X |
X |
X |
X |
1 |
X |
X |
X |
卡终止 |
|
X |
X |
X |
X |
X |
1 |
X |
X |
缺省选定 |
|
X |
X |
X |
X |
X |
X |
1 |
X |
CVM管理 |
|
1 |
1 |
X |
X |
X |
X |
X |
1 |
强制DAP验证 |
C．一般性的错误情形
|
SW1 |
SW2 |
含义 |
|
‘64’ |
‘00’ |
未指定。 |
|
‘67’ |
‘00’ |
LC中错误的长度。 |
|
’68’ |
‘81’ |
逻辑通道不支持或没有激活。 |
|
‘69’ |
‘82’ |
安全状态不满足。 |
|
‘69’ |
‘85’ |
使用条件不满足。 |
|
‘6A’ |
‘86’ |
P1P2不正确。 |
|
‘6D’ |
‘00’ |
无效的指令（INS）。 |
|
‘6E’ |
‘00’ |
无效的类（CLA）。 |
D．CLASS字节编码
|
CLA |
含义 |
|
‘00’ |
ISO/IEC7816中定义的命令。 |
|
‘80’ |
私有命令。 |
|
‘84’ |
带安全消息的私有命令。 |
E．APDU命令和响应数据
Lc字节被编码为1字节
所有GlobalPlatform命令消息（包括APDU头）在长度上都被限制到255字节。
所有期待有响应数据的GP命令都会具有设置为0的LE字节，表示所有可用的响应数据将被返回。根据ISO/IEC 7816-4，在APDU响应消息中返回的所有GP响应最大长度为256字节。
F．密钥类型编码
|
值 |
含义 |
|
‘00’-‘7F’ |
保留为私用 |
|
‘80’ |
DES – mode (EBC/CBC) implicitly known |
|
‘81’ |
保留（TDES）。 |
|
‘82’ |
CBC模式的TDES。 |
|
‘83’ |
ECB模式的DES。 |
|
‘84’ |
CBC模式的DES。 |
|
‘85’-‘9F’ |
RFU（对称算法） |
|
‘A0’ |
RSA公钥-E（明文）。 |
|
‘A1’ |
RSA公钥-N（明文）。 |
|
‘A2’ |
RSA私钥-N |
|
‘A3’ |
RSA私钥-D |
|
‘A4’ |
RSA私钥-P （中国剩余定理） |
|
‘A5’ |
RSA私钥-Q |
|
‘A6’ |
RSA私钥-PQ |
|
‘A7’ |
RSA私钥-DP1 |
|
‘A8’ |
RSA私钥-DQ1 |
|
‘A9’-‘FE’ |
RFU（非对称算法） |
|
‘FF’ |
不可用 |
G．在委托管理的响应消息中的收条信息
|
长度 |
数据元素 |
|
1 |
收条的长度。 |
|
0-n |
收条。 |
|
1 |
确认信息计数的长度。 |
|
2 |
确认信息的计数值。 |
|
1 |
卡唯一数据的长度。 |
|
1-n |
卡唯一数据。 |
9.2 DELETE命令
A. 命令消息
|
代码 |
值 |
含义 |
|
CLA |
‘80’或‘84’ |
|
|
INS |
‘E4’ |
DELETE |
|
P1 |
‘00’ |
引用控制参数P1。总被设置为00 |
|
P2 |
‘xx’ |
引用控制参数P2。00or80 |
|
Lc |
‘xx’ |
数据字段的长度。 |
|
Data |
‘xxxx…’ |
TLV格式编码的对象（和MAC如果存在）。 |
|
Le |
‘00’ |
|
P1: 删除对象(实例)
P2: 删除对象及相关对象(包)
将被删除的应用或可执行的装载文件的标识将被指定为AID的tag‘4F’后面跟着长度以及应用或可执行装载文件的AID。
例：
80/84 E4 00 00/80 Lc 4F Lc V
80E4 00 80 12 4F 10 A0000000000006002200 0001
|
密钥管理 |
Tag |
长度 |
值 |
|
删除一个密钥标识符 |
‘D0’ |
‘01’ |
密钥标识符。 |
|
删除一个密钥版本号 |
‘D2’ |
‘01’ |
密钥版本号。 |
80E4 00 00 Lc D0 01 KID D2 01 KVN
B. 响应消息
如果主安全域处理DELETE命令，或者一个密钥正在被删除，一个用于指明没有额外的数据存在的单字节‘00’将被返回
|
存在 |
字节长度 |
名字 |
|
强制的 |
1 |
删除确认信息的长度。 |
|
有条件的 |
0-n |
删除确认信息（参见节9.1.7）。 |
一个命令的成功执行将通过状态字‘90’’00’来表示
错误情形：
|
SW1 |
SW2 |
含义 |
|
‘65’ |
‘81’ |
内存故障。 |
|
‘6A’ |
‘88’ |
引用数据未找到。 |
|
’6A’ |
‘82’ |
应用没有找到。 |
|
‘6A’ |
‘80’ |
在命令数据中有不正确的值。 |
|
‘64’ |
‘00’ |
未指定。 |
|
‘67’ |
‘00’ |
LC中错误的长度。 |
|
’68’ |
‘81’ |
逻辑通道不支持或没有激活。 |
|
‘69’ |
‘82’ |
安全状态不满足。 |
|
‘69’ |
‘85’ |
使用条件不满足。 |
|
‘6A’ |
‘86’ |
P1P2不正确。 |
|
‘6D’ |
‘00’ |
无效的指令（INS）。 |
|
‘6E’ |
‘00’ |
无效的类（CLA）。 |
9.3 GET DATA命令（ISD）
A. 命令消息
|
代码 |
值 |
含义 |
|
CLA |
‘00’,‘80’或‘84’ |
|
|
INS |
‘CA’ |
GET DATA |
|
P1 |
‘xx’ |
‘00’或Tag值的高字节部分。 |
|
P2 |
‘xx’ |
Tag值的低字节部分。 |
|
Lc |
‘xx’ |
MAC的长度，否则为空。 |
|
Data |
‘xxxx…’ |
如果存在的话为MAC，否则为空。 |
|
Le |
‘00’ |
|
l Tag‘42’：发行者标识号。
l Tag‘45’：卡Image号。
l Tag‘66’：卡数据。
l Tag‘E0’：密钥信息模板。
l Tag‘C1’：缺省密钥版本号的序列计数值。
卡支持委托管理且要求收条
l Tag‘C2’：确认信息计数值。
一个应用提供者的安全域将至少支持下面的数据对象的Tag：
l Tag‘E0’：密钥信息模板。
l Tag‘C1’：缺省密钥版本号的序列计数值。
l Tag‘73’：卡识别数据。
（勘误文档）对于只支持安全通道协议‘01’的安全域或主安全域， tag ’C1’将会被拒绝
GET DATA响应的数据字段将包含TLV编码的数据对象，这个数据对象是在命令消息的引用控制参数P1和P2中所指定的。
Tag lc value
E0返回密钥信息
|
参数 |
长度 |
编码 |
|
密钥标识符 |
1字节 |
0-255 |
|
密钥版本号 |
1字节 |
0-255 |
|
第一个（或仅有的一个）密钥元素的密钥类型 |
1字节 |
参见节9.1.6-密钥类型编码 |
|
第一个（或仅有的一个）密钥元素的长度 |
1字节 |
1-255 |
|
… |
… |
… |
|
最后一个密钥元素的密钥类型 |
1字节 |
参见节9.1.6-密钥类型编码 |
|
最后一个密钥元素的长度 |
1字节 |
1-255 |
一个命令的成功执行将通过状态字‘90’ ‘00’来表示
|
SW1 |
SW2 |
含义 |
|
‘6A’ |
‘88’ |
引用数据未找到。返回一个或多个 |
|
‘64’ |
‘00’ |
未指定。 |
|
‘67’ |
‘00’ |
LC中错误的长度。 |
|
’68’ |
‘81’ |
逻辑通道不支持或没有激活。 |
|
‘69’ |
‘82’ |
安全状态不满足。 |
|
‘69’ |
‘85’ |
使用条件不满足。 |
|
‘6A’ |
‘86’ |
P1P2不正确。 |
|
‘6D’ |
‘00’ |
无效的指令（INS）。 |
|
‘6E’ |
‘00’ |
无效的类（CLA）。 |
9.4 GET STATUS
|
代码 |
值 |
含义 |
|
CLA |
‘80’或‘84’ |
|
|
INS |
‘F2’ |
GET STATUS |
|
P1 |
‘xx’ |
引用控制参数P1。 |
|
P2 |
‘xx’ |
引用控制参数P2。 |
|
Lc |
‘xx’ |
检索标准（和MAC如果存在）。 |
|
Le |
‘00’ |
|
P1：
80：ISD
40：application&SD
20：包
10：包和相关模块
SD和普通App区别仅限于权限
（额外）
引用控制参数下列组合的值可以应用：
'E0' – 发行者安全域、应用、安全域、可执行装载文件。
'D0' –发行者安全域、应用、安全域、可执行装载文件及它们的可执行模块。
'C0' –发行者安全域、应用、安全域。
'A0' – 发行者安全域、可执行装载文件。
'90' – 发行者安全域、可执行装载文件及它们的可执行模块。
'60' – 应用、安全域、可执行装载文件。
'50' – 应用、安全域、可执行装载文件及它们的可执行模块。
P2:
|
b8 |
b7 |
b6 |
b5 |
b4 |
b3 |
b2 |
b1 |
含义 |
|
X |
X |
X |
X |
X |
X |
|
|
RFU |
|
|
X |
0 |
取得第一个或所有的。 |
|||||
|
X |
1 |
取得下一个。 |
||||||
|
0 |
X |
根据表9-22和表9-24的响应数据结构。 |
||||||
|
1 |
X |
根据表9-23的响应数据结构。 |
||||||
两位数字同时生效：前者决定查找目标，后者决定返回的数据结构
返回消息：基于P1和P2
表9-22
|
长度 |
值 |
含义 |
|
1 |
‘xx’ |
AID的长度。 |
|
1-n |
‘xxxx…’ |
AID。 |
|
1 |
‘xx’ |
生命周期状态。 |
|
1 |
‘xx’ |
应用的权限。 |
GP注册表
|
Tag |
长度 |
值 |
存在 |
|
‘E3’ |
变长 |
GlobalPlatform注册表相关数据。 |
|
|
‘4F’ |
1-n |
AID。 |
|
|
‘9F70’ |
‘01’ |
生命周期状态。 |
|
|
‘C5’ |
‘01’ |
应用权限。 |
条件存在：ISD、SSD、App |
|
‘CE’ |
1-n |
可执行装载文件版本号。 |
可选 |
|
‘84’ |
1-n |
第一个或仅有的一个可执行模块的AID。 |
条件存在：P1=10 |
|
… |
… |
… |
… |
|
‘84’ |
1-n |
最后一个可执行模块的AID。 |
条件存在：P1=10 |
可执行装载文件和可执行模块信息数据：表9-24
|
长度 |
值 |
含义 |
|
1 |
‘xx’ |
可执行装载文件AID的长度。 |
|
1-n |
‘xxxx…’ |
可执行装载文件AID。 |
|
1 |
‘xx’ |
可执行装载文件的生命周期状态。 |
|
1 |
‘00’ |
应用的权限。 |
|
1 |
‘xx’ |
相关的可执行模块的个数。 |
|
1 |
‘xx’ |
可执行模块AID的长度。 |
|
1-n |
‘xxxx…’ |
可执行模块AID。 |
|
… |
… |
… |
|
1 |
‘xx’ |
可执行模块AID的长度。 |
|
1-n |
‘xxxx…’ |
可执行模块AID。 |
处理状态
一个命令的成功执行是通过状态字‘90’ ‘00’来表示的。
|
SW1 |
SW2 |
含义 |
|
‘63’ |
‘10’ |
更多数据可用。 |
GET STATUS [get nextoccurrence(s)]警告
|
SW1 |
SW2 |
含义 |
|
‘63’ |
‘10’ |
更多数据可用。 |
错误
|
SW1 |
SW2 |
含义 |
|
‘6A’ |
‘88’ |
引用数据未找到。 |
|
‘6A’ |
‘80’ |
在命令数据中含有不正确的值。 |
|
‘64’ |
‘00’ |
未指定。 |
|
‘67’ |
‘00’ |
LC中错误的长度。 |
|
’68’ |
‘81’ |
逻辑通道不支持或没有激活。 |
|
‘69’ |
‘82’ |
安全状态不满足。 |
|
‘69’ |
‘85’ |
使用条件不满足。 |
|
‘6A’ |
‘86’ |
P1P2不正确。 |
|
‘6D’ |
‘00’ |
无效的指令（INS）。 |
|
‘6E’ |
‘00’ |
无效的类（CLA）。 |
