From 78f58a0004e799f9400be5252838fde4236fc9c0 Mon Sep 17 00:00:00 2001 From: estkme <145633413+estkme@users.noreply.github.com> Date: Sun, 3 Mar 2024 18:50:53 +0800 Subject: [PATCH] update --- .gitignore | 3 +- {content => backup}/basics/_index.en.md | 0 {content => backup}/basics/_index.md | 0 {content => backup}/estk_me/_index.md | 0 .../estk_me/lpa-guide/5ber/_index.md | 0 .../estk_me/lpa-guide/_index.md | 0 .../estk_me/lpa-guide/esim-me/_index.md | 0 .../estk_me/lpa-guide/infilpa/_index.md | 0 .../lpa-guide/infilpa/download and compile.md | 0 .../lpa-guide/infilpa/usage instructions.md | 0 .../estk_me/lpa-guide/truphone-lpa/_index.md | 0 {content => backup}/estk_me/others/_index.md | 0 {content => backup}/estk_me/others/faq.md | 0 content/_index.en.md | 23 -------- content/_index.md | 31 ++++------- content/estk_me/quickstart/activate-lic.md | 10 ---- content/estk_me/quickstart/android.md | 5 -- content/estk_me/quickstart/pc.md | 5 -- content/estk_me/stk/profiles/delete.md | 29 ----------- content/estk_me/stk/profiles/enable.md | 23 -------- content/estk_me/stk/settings/ara-m-sha1.md | 52 ------------------- content/estk_me/stk/settings/hint-mode.md | 27 ---------- content/estk_me/stk/settings/motd-mode.md | 23 -------- content/estk_me/stk/settings/sku-mode.md | 10 ---- content/estk_me/stk/settings/virtual-eid.md | 33 ------------ content/estk_me/stk/tools/bypass-stk.md | 11 ---- content/lpac/_index.md | 4 -- content/{estk_me => }/quickstart/_index.md | 0 content/quickstart/omapi.md | 5 ++ content/quickstart/pcsc.md | 5 ++ content/quickstart/stk.md | 5 ++ content/{estk_me => }/stk/_index.md | 0 content/{estk_me => }/stk/about-estk_me.md | 0 content/{estk_me => }/stk/profiles/_index.md | 8 +-- content/stk/profiles/delete.md | 22 ++++++++ content/stk/profiles/enable.md | 18 +++++++ .../{estk_me => }/stk/profiles/nickname.md | 9 +--- content/stk/remotelpa/_index.md | 5 ++ content/stk/remotelpa/download-profile.md | 5 ++ .../stk/remotelpa/process-notifications.md | 5 ++ content/stk/remotelpa/remote-management.md | 5 ++ content/{estk_me => }/stk/settings/_index.md | 6 +-- content/stk/settings/ara-m-sha1.md | 34 ++++++++++++ .../{estk_me => }/stk/settings/atr-mode.md | 19 ++++--- .../{estk_me => }/stk/settings/ecasd-mode.md | 12 ++--- .../{estk_me => }/stk/settings/isd-r-mode.md | 9 +++- content/stk/settings/motd-mode.md | 22 ++++++++ content/stk/settings/virtual-eid.md | 27 ++++++++++ content/{estk_me => }/stk/tools/_index.md | 0 content/stk/tools/bypass-stk-menu.md | 26 ++++++++++ content/{estk_me => }/stk/tools/reboot.md | 4 +- .../{estk_me => }/stk/tools/service-code.md | 0 52 files changed, 228 insertions(+), 312 deletions(-) rename {content => backup}/basics/_index.en.md (100%) rename {content => backup}/basics/_index.md (100%) rename {content => backup}/estk_me/_index.md (100%) rename {content => backup}/estk_me/lpa-guide/5ber/_index.md (100%) rename {content => backup}/estk_me/lpa-guide/_index.md (100%) rename {content => backup}/estk_me/lpa-guide/esim-me/_index.md (100%) rename {content => backup}/estk_me/lpa-guide/infilpa/_index.md (100%) rename {content => backup}/estk_me/lpa-guide/infilpa/download and compile.md (100%) rename {content => backup}/estk_me/lpa-guide/infilpa/usage instructions.md (100%) rename {content => backup}/estk_me/lpa-guide/truphone-lpa/_index.md (100%) rename {content => backup}/estk_me/others/_index.md (100%) rename {content => backup}/estk_me/others/faq.md (100%) delete mode 100644 content/estk_me/quickstart/activate-lic.md delete mode 100644 content/estk_me/quickstart/android.md delete mode 100644 content/estk_me/quickstart/pc.md delete mode 100644 content/estk_me/stk/profiles/delete.md delete mode 100644 content/estk_me/stk/profiles/enable.md delete mode 100644 content/estk_me/stk/settings/ara-m-sha1.md delete mode 100644 content/estk_me/stk/settings/hint-mode.md delete mode 100644 content/estk_me/stk/settings/motd-mode.md delete mode 100644 content/estk_me/stk/settings/sku-mode.md delete mode 100644 content/estk_me/stk/settings/virtual-eid.md delete mode 100644 content/estk_me/stk/tools/bypass-stk.md delete mode 100644 content/lpac/_index.md rename content/{estk_me => }/quickstart/_index.md (100%) create mode 100644 content/quickstart/omapi.md create mode 100644 content/quickstart/pcsc.md create mode 100644 content/quickstart/stk.md rename content/{estk_me => }/stk/_index.md (100%) rename content/{estk_me => }/stk/about-estk_me.md (100%) rename content/{estk_me => }/stk/profiles/_index.md (67%) create mode 100644 content/stk/profiles/delete.md create mode 100644 content/stk/profiles/enable.md rename content/{estk_me => }/stk/profiles/nickname.md (63%) create mode 100644 content/stk/remotelpa/_index.md create mode 100644 content/stk/remotelpa/download-profile.md create mode 100644 content/stk/remotelpa/process-notifications.md create mode 100644 content/stk/remotelpa/remote-management.md rename content/{estk_me => }/stk/settings/_index.md (66%) create mode 100644 content/stk/settings/ara-m-sha1.md rename content/{estk_me => }/stk/settings/atr-mode.md (57%) rename content/{estk_me => }/stk/settings/ecasd-mode.md (66%) rename content/{estk_me => }/stk/settings/isd-r-mode.md (74%) create mode 100644 content/stk/settings/motd-mode.md create mode 100644 content/stk/settings/virtual-eid.md rename content/{estk_me => }/stk/tools/_index.md (100%) create mode 100644 content/stk/tools/bypass-stk-menu.md rename content/{estk_me => }/stk/tools/reboot.md (76%) rename content/{estk_me => }/stk/tools/service-code.md (100%) diff --git a/.gitignore b/.gitignore index f87e175..5e576bb 100644 --- a/.gitignore +++ b/.gitignore @@ -1,3 +1,4 @@ public/ resources/_gen -.hugo_build.lock \ No newline at end of file +.hugo_build.lock +hugo.exe diff --git a/content/basics/_index.en.md b/backup/basics/_index.en.md similarity index 100% rename from content/basics/_index.en.md rename to backup/basics/_index.en.md diff --git a/content/basics/_index.md b/backup/basics/_index.md similarity index 100% rename from content/basics/_index.md rename to backup/basics/_index.md diff --git a/content/estk_me/_index.md b/backup/estk_me/_index.md similarity index 100% rename from content/estk_me/_index.md rename to backup/estk_me/_index.md diff --git a/content/estk_me/lpa-guide/5ber/_index.md b/backup/estk_me/lpa-guide/5ber/_index.md similarity index 100% rename from content/estk_me/lpa-guide/5ber/_index.md rename to backup/estk_me/lpa-guide/5ber/_index.md diff --git a/content/estk_me/lpa-guide/_index.md b/backup/estk_me/lpa-guide/_index.md similarity index 100% rename from content/estk_me/lpa-guide/_index.md rename to backup/estk_me/lpa-guide/_index.md diff --git a/content/estk_me/lpa-guide/esim-me/_index.md b/backup/estk_me/lpa-guide/esim-me/_index.md similarity index 100% rename from content/estk_me/lpa-guide/esim-me/_index.md rename to backup/estk_me/lpa-guide/esim-me/_index.md diff --git a/content/estk_me/lpa-guide/infilpa/_index.md b/backup/estk_me/lpa-guide/infilpa/_index.md similarity index 100% rename from content/estk_me/lpa-guide/infilpa/_index.md rename to backup/estk_me/lpa-guide/infilpa/_index.md diff --git a/content/estk_me/lpa-guide/infilpa/download and compile.md b/backup/estk_me/lpa-guide/infilpa/download and compile.md similarity index 100% rename from content/estk_me/lpa-guide/infilpa/download and compile.md rename to backup/estk_me/lpa-guide/infilpa/download and compile.md diff --git a/content/estk_me/lpa-guide/infilpa/usage instructions.md b/backup/estk_me/lpa-guide/infilpa/usage instructions.md similarity index 100% rename from content/estk_me/lpa-guide/infilpa/usage instructions.md rename to backup/estk_me/lpa-guide/infilpa/usage instructions.md diff --git a/content/estk_me/lpa-guide/truphone-lpa/_index.md b/backup/estk_me/lpa-guide/truphone-lpa/_index.md similarity index 100% rename from content/estk_me/lpa-guide/truphone-lpa/_index.md rename to backup/estk_me/lpa-guide/truphone-lpa/_index.md diff --git a/content/estk_me/others/_index.md b/backup/estk_me/others/_index.md similarity index 100% rename from content/estk_me/others/_index.md rename to backup/estk_me/others/_index.md diff --git a/content/estk_me/others/faq.md b/backup/estk_me/others/faq.md similarity index 100% rename from content/estk_me/others/faq.md rename to backup/estk_me/others/faq.md diff --git a/content/_index.en.md b/content/_index.en.md index 4cfa156..c6af3e6 100644 --- a/content/_index.en.md +++ b/content/_index.en.md @@ -5,26 +5,3 @@ date = 2023-12-16T23:01:40+08:00 ## What is eSTK.me -- eSTK.me 是我们团队打造的 eUICC 产品。 -- 支持在不支持 eUICC 的平台使用,管理。 -- 支持固件升级。 -- 提供完善的文档支持(WIP) - -> “领先绝大多数商业实现,支持大陆国行 iOS 设备,功能机设备。” - -## LPAC ? LPA ? - -- LPAC 是我们开发的一款开源的 LPA 管理器,功能和性能均在业内领先,目前并高速开发中。 -- LPAC 支持多种驱动,适应多种场景。 -- 全平台支持输出请求流级别的 Debug 模式。 -- 提供比较完善的 es9+ / es10 支持。 - -> “相容商业实现,但是整体更好” - -### 致谢 - -- 感谢所有人的支持! -- 感谢各类脚本、客户端支持...感谢所有帮忙完善生态的大佬们! -- 感谢为 eSTK.me 网站和文档添砖加瓦的朋友们. -- 感谢提出有意义的建议和意见的朋友们. -- 感谢 Telegram 群每一位帮助群友的朋友. diff --git a/content/_index.md b/content/_index.md index 1164b3a..22483b7 100644 --- a/content/_index.md +++ b/content/_index.md @@ -1,29 +1,16 @@ +++ -title = "eSTK.me 文档" +title = "eSTK.me 操作文档" +++ -## eSTK.me 是啥? +## 欢迎查阅eSTK.me操作文档 -- eSTK.me 是我们团队打造的 eUICC 产品。 -- 支持在不支持 eUICC 的平台使用,管理。 -- 支持固件升级。 -- 提供完善的文档支持(WIP) +eSTK.me致力于提供创新性的可移除eUICC体验。 -> “领先绝大多数商业实现,支持大陆国行 iOS 设备,功能机设备。” +这个文档库包含了与eSTK COS相关的技术信息,位于左侧的导航栏可供于自由浏览,或者,跟随向导流程逐步探索。 -## LPAC ? LPA ? +## 推荐向导 -- LPAC 是我们开发的一款开源的 LPA 管理器,功能和性能均在业内领先,目前并高速开发中。 -- LPAC 支持多种驱动,适应多种场景。 -- 全平台支持输出请求流级别的 Debug 模式。 -- 提供比较完善的 es9+ / es10 支持。 - -> “相容商业实现,但是整体更好” - -### 致谢 - -- 感谢所有人的支持! -- 感谢各类脚本、客户端支持...感谢所有帮忙完善生态的大佬们! -- 感谢为 eSTK.me 网站和文档添砖加瓦的朋友们. -- 感谢提出有意义的建议和意见的朋友们. -- 感谢 Telegram 群每一位帮助群友的朋友. +### 快速启动 +- [我希望在iPhone、iPad或WindowsPhone上使用eSTK.me](./quickstart/stk.md) +- [我希望在出厂时搭载Android 9及以上版本的智能手机上使用eSTK.me](./quickstart/omapi.md) +- [我希望在Raspberry Pi、Windows PC、Linux SBC等智能硬件上管理eSTK.me](./quickstart/pcsc.md) \ No newline at end of file diff --git a/content/estk_me/quickstart/activate-lic.md b/content/estk_me/quickstart/activate-lic.md deleted file mode 100644 index eb3d894..0000000 --- a/content/estk_me/quickstart/activate-lic.md +++ /dev/null @@ -1,10 +0,0 @@ -+++ -title = "激活授权(可选)" -date = 2023-12-17T00:20:07+08:00 -weight = 10 -hidden = true -+++ - -{{% notice style="warning" %}} -在固件版本 1.2.5 后,该操作已被废弃 -{{% /notice %}} diff --git a/content/estk_me/quickstart/android.md b/content/estk_me/quickstart/android.md deleted file mode 100644 index 099ea71..0000000 --- a/content/estk_me/quickstart/android.md +++ /dev/null @@ -1,5 +0,0 @@ -+++ -title = "使用 Android 设备完成" -date = 2023-12-17T00:17:46+08:00 -weight = 5 -+++ diff --git a/content/estk_me/quickstart/pc.md b/content/estk_me/quickstart/pc.md deleted file mode 100644 index cb99306..0000000 --- a/content/estk_me/quickstart/pc.md +++ /dev/null @@ -1,5 +0,0 @@ -+++ -title = "使用 PC 设备完成" -date = 2023-12-17T00:17:42+08:00 -weight = 5 -+++ diff --git a/content/estk_me/stk/profiles/delete.md b/content/estk_me/stk/profiles/delete.md deleted file mode 100644 index 277fded..0000000 --- a/content/estk_me/stk/profiles/delete.md +++ /dev/null @@ -1,29 +0,0 @@ -+++ -title = "Delete Profile" -date = 2023-12-17T21:23:18+08:00 -weight = 3 -+++ - -## 删除选定的配置文件 - -{{% notice style="warning" %}} -删除配置文件是一个**危险操作** -{{% /notice %}} - -1. 该操作的结果在大部分情况下是不可逆转的,一次性的。 -2. 你需要非常清楚自己正在操作什么,不应盲目接受他人建议。 -3. 在STK内进行删除是 “离线删除”,这意味着管理服务器不会接收到删除通知。 - -点击该菜单项后,会自动执行如下步骤 - -1. 弹出删除二次确认输入框以及风险提示 -2. 弹出操作成功或被取消的提示框 -3. 向终端设备发起重启 eSTK.me 本身的指令。 - -{{% notice style="warning" %}} -STK 并不会丢弃本应发送至管理服务器的 “删除通知”,它实际上仍保存在 eSE 芯片内,可由 LPA 软件在连接到互联网时再次发送到管理服务器上用于完成 “在线删除”。但是需要注意的是:**大部分 LPA 未经测试是否正确的实现了该功能。** -{{% /notice %}} - -{{% notice style="note" title="注意" %}} -虽然重启 eSTK.me 的指令符合业界标准规范,经过测试从2008年到最新出厂的终端设备均广泛支持,但仍有可能被极个别不遵守规范或过度 “优化” 的厂商破坏了该指令的兼容性,请重启终端设备以应用新的配置文件。 -{{% /notice %}} diff --git a/content/estk_me/stk/profiles/enable.md b/content/estk_me/stk/profiles/enable.md deleted file mode 100644 index a5cbf8b..0000000 --- a/content/estk_me/stk/profiles/enable.md +++ /dev/null @@ -1,23 +0,0 @@ -+++ -title = "Enable Profile" -date = 2023-12-17T21:21:44+08:00 -weight = 1 -+++ - -## 激活选定的配置文件 - -激活配置文件是一个可靠操作,这意味着: - -1. 你可以自由尝试该功能。 -2. 该操作的结果是可逆的,或至少有一种恢复先前状态的方法。 - -点击该菜单项后,会自动执行如下步骤 - -1. 禁用掉当前激活的配置文件 -2. 启动被选择的配置文件 -3. 弹出提示框 -4. 向终端设备发起重启 eSTK.me 本身的指令。 - -{{% notice style="note" title="注意" %}} -虽然重启 eSTK.me 的指令符合业界标准规范,经过测试从2008年到最新出厂的终端设备均广泛支持,但仍有可能被极个别不遵守规范或过度 “优化” 的厂商破坏了该指令的兼容性,请重启终端设备以应用新的配置文件。 -{{% /notice %}} diff --git a/content/estk_me/stk/settings/ara-m-sha1.md b/content/estk_me/stk/settings/ara-m-sha1.md deleted file mode 100644 index e261431..0000000 --- a/content/estk_me/stk/settings/ara-m-sha1.md +++ /dev/null @@ -1,52 +0,0 @@ -+++ -title = "ARA-M SHA-1" -date = 2023-12-17T21:48:31+08:00 -weight = 1 -+++ - -## 授予 APP 访问权限 - -ARA-M 作为智能卡的一个特殊属性,用于在现代操作系统上控制何种用户应用可以访问智能卡接口。目前已经在支持 OMAPI 的 Android 操作系统上广泛应用。 -智能卡使用 ARA-M 通过开发者证书的 SHA-1 或者 SHA-256 的值来通知操作系统来自哪个开发者的应用可以访问自身。 - -修改 ARA-M SHA-1 是一个需要额外注意操作,这意味着: - -1. 你可以自由尝试该功能。 -2. 该操作的结果是可逆的,或至少有一种恢复先前状态的方法。 -3. 不正确的 ARA-M SHA-1 的值会导致 LPA 应用无法管理 eUICC,需要确保你可以正常访问 STK 或拥有 PCSC 读卡器。 - -点击该菜单项后,会自动执行如下步骤 - -1. 弹出输入 SHA-1 值的输入框和提示文字 -2. 弹出修改成功提示框 -3. 向终端设备发起重启 eSTK.me 本身的指令。 - -{{% notice style="note" title="注意" %}} -当错误地修改了 ARA-M SHA-1 值,又恰好无法正常访问 STK 菜单,那么你需要构造如下 APDU 命令以通过 PCSC 读卡器来设置 ARA-M SHA-1 的值 -{{% /notice %}} - -{{% notice style="note" title="注意" %}} -在固件版本 1.2.3 中,ARA-M 可填入多个值,请根据固件版本使用不同的 APDU 命令,请参考 “[关于 eSTK.me 的信息](../about-estk_me)” -{{% /notice %}} - -{{% expand title="在 1.2.3 固件以前"%}} -发送以下 APDU 将设置 `A8BE3C101F840C5025C8A3D8DAF5531DD91B1134` 为 ARA-M SHA-1 值 - -```apdu -80 14 00 00 30 81 03 E3 23 00 8D 29 00 61 38 62 65 33 63 31 30 31 66 38 34 30 63 35 30 32 35 63 38 61 33 64 38 64 61 66 35 35 33 31 64 64 39 31 62 31 31 33 34 -``` - -其中,固定头部为 - -```apdu -80 14 00 00 30 81 03 E3 23 00 8D 29 00 -``` - -这一部分代表了接下来要发送40个 ASCII 字符,并作为 ARA-M 的 SHA-1 值来处理 - -```apdu -61 38 62 65 33 63 31 30 31 66 38 34 30 63 35 30 32 35 63 38 61 33 64 38 64 61 66 35 35 33 31 64 64 39 31 62 31 31 33 34 -``` - -这一部分是 SHA-1 字符串的十六进制值,即 `A8BE3C101F840C5025C8A3D8DAF5531DD91B1134` 这个字符串的十六进制表示。 -{{% /expand %}} diff --git a/content/estk_me/stk/settings/hint-mode.md b/content/estk_me/stk/settings/hint-mode.md deleted file mode 100644 index c0604e1..0000000 --- a/content/estk_me/stk/settings/hint-mode.md +++ /dev/null @@ -1,27 +0,0 @@ -+++ -title = "Hint Mode" -date = 2023-12-17T21:54:11+08:00 -weight = 7 -hidden = true -+++ - -## 开启或者关闭欢迎语 - -{{% notice style="warning" %}} -本功能于固件版本 1.2.5.1 中被更名为 [MOTD Mode](./motd-mode),现已废弃。 -{{% /notice %}} - -{{% notice style="note" title="注意" %}} -本功能于 1.2.3.1 版本固件中加入。 -{{% /notice %}} - -Hint 用于在 eSTK.me 插入设备后提示用户 eSTK.me 已被识别,用户将在重启设备或 eSTK.me 插入时看到 `HelloWorld! eSTK.me` 的提示。 -配置 Hint 是一个可靠操作,这意味着: - -1. 你可以自由尝试该功能。 -2. 该操作的结果是可逆的,或至少有一种恢复先前状态的方法。 - ->当前可供选择的 Hint 模式 - -1. Enabled : 启用欢迎语功能 -2. Disabled : 禁用欢迎语功能 diff --git a/content/estk_me/stk/settings/motd-mode.md b/content/estk_me/stk/settings/motd-mode.md deleted file mode 100644 index 452bd3e..0000000 --- a/content/estk_me/stk/settings/motd-mode.md +++ /dev/null @@ -1,23 +0,0 @@ -+++ -title = "MOTD Mode" -date = 2023-12-17T21:54:11+08:00 -weight = 7 -+++ - -## 开启或者关闭欢迎语 - -{{% notice style="note" title="注意" %}} -[Hint Mode](./hint-mode) 于固件版本 1.2.3.1 中加入,于固件版本 1.2.5.1 中更名为 MOTD Mode。 -eSTK.me 固件版本信息在固件版本 1.2.6 中加入。 -{{% /notice %}} - -MOTD 用于在 eSTK.me 插入设备后提示用户 eSTK.me 已被识别,用户将在重启设备或 eSTK.me 插入时看到 `HelloWorld!` 提示与当前 eSTK.me 的固件版本号。 -配置 MOTD 是一个可靠操作,这意味着: - -1. 你可以自由尝试该功能。 -2. 该操作的结果是可逆的,或至少有一种恢复先前状态的方法。 - ->当前可供选择的 MOTD 模式 - -1. Enabled : 启用欢迎语功能 -2. Disabled : 禁用欢迎语功能 diff --git a/content/estk_me/stk/settings/sku-mode.md b/content/estk_me/stk/settings/sku-mode.md deleted file mode 100644 index 8ea4366..0000000 --- a/content/estk_me/stk/settings/sku-mode.md +++ /dev/null @@ -1,10 +0,0 @@ -+++ -title = "SKU Mode" -date = 2023-12-17T21:54:07+08:00 -weight = 6 -hidden = true -+++ - -{{% notice style="warning" %}} -在固件版本 1.2.5 后,该操作已被废弃 -{{% /notice %}} \ No newline at end of file diff --git a/content/estk_me/stk/settings/virtual-eid.md b/content/estk_me/stk/settings/virtual-eid.md deleted file mode 100644 index b1e9557..0000000 --- a/content/estk_me/stk/settings/virtual-eid.md +++ /dev/null @@ -1,33 +0,0 @@ -+++ -title = "Virtual EID" -date = 2023-12-17T21:53:42+08:00 -weight = 2 -+++ - -## 配置虚拟 EID 的值 - -配置一个虚拟的 EID 有很多理由,可能为了规避恶意软件的追踪,为了验证某种技术的可行性,或者仅仅是找乐子,此功能可以使 eUICC 管理软件 (LPA) 获取到用户指定的值而并非 eSE 中永久固化的序列号。 -{{% notice style="note" title="注意" %}} -需要注意的是,当与 Profile 下载服务器 (SM-DP+) 进行通信时,由于 GSMA PKI 证书系统的存在,虚拟 EID 无法生效,SM-DP+ 总是能获取到 eUICC 的真实 EID 序列号。 -{{% /notice %}} - -设置 Virtual EID 是一个需要额外注意操作,这意味着: - -1. 你可以自由尝试该功能。 -2. 该操作的结果是可逆的,或至少有一种恢复先前状态的方法。 -3. 特殊的 EID 可能会使一些管理软件异常,确保你可以正常访问 STK 菜单时再进行更改 - -点击该菜单项后,会自动执行如下步骤 - -1. 弹出 EID 输入框和提示文字,如果你什么都不输入,意味着关闭该功能 -2. 弹出修改成功提示框 -3. 向终端设备发起重启 eSTK.me 本身的指令。 - -{{% notice style="note" title="注意" %}} -Virtual EID 功能默认仅针对 ISD-R 域有效,如果你需要覆盖 ECASD 域的 EID 读取行为,需要进一步参考 “[ECASD Mode](ecasd-mode)” -{{% /notice %}} - -{{% notice style="tip" %}} -~~Virtual EID 的设置值无法在 STK 菜单中获取,如果你需要读出,请参考 “[LPA 操作手册](estk_me/lpa-guide)”~~ -Virtual EID 信息在固件版本 1.2.5 中添加,如果你需要读出,请参考 “[About eSTK.me](../about-estk_me)” -{{% /notice %}} diff --git a/content/estk_me/stk/tools/bypass-stk.md b/content/estk_me/stk/tools/bypass-stk.md deleted file mode 100644 index d8d8468..0000000 --- a/content/estk_me/stk/tools/bypass-stk.md +++ /dev/null @@ -1,11 +0,0 @@ -+++ -title = "Bypass STK Menu" -date = 2023-12-17T18:43:34+08:00 -weight = 1 -+++ - -## 直通下层 STK 菜单 - -部分 Profile 可能存在额外的 STK 应用程序,此功能可以暂时关闭 eSTK.me 的菜单并切换至 Profile 的 STK 应用菜单。 -当 Profile 不存在 STK 菜单时,将提示“无下层菜单可用”,当 Profile 存在 STK 菜单时,将弹出提示与确认菜单,点选 `! YES !` 将执行菜单直通操作。 -一旦 eSTK.me 的菜单被直通,则需要一次重启或插拔 eSTK.me 才能恢复。 diff --git a/content/lpac/_index.md b/content/lpac/_index.md deleted file mode 100644 index 0d33f38..0000000 --- a/content/lpac/_index.md +++ /dev/null @@ -1,4 +0,0 @@ -+++ -title = "LPAC" -date = 2023-12-16T23:01:40+08:00 -+++ diff --git a/content/estk_me/quickstart/_index.md b/content/quickstart/_index.md similarity index 100% rename from content/estk_me/quickstart/_index.md rename to content/quickstart/_index.md diff --git a/content/quickstart/omapi.md b/content/quickstart/omapi.md new file mode 100644 index 0000000..742bc98 --- /dev/null +++ b/content/quickstart/omapi.md @@ -0,0 +1,5 @@ ++++ +title = "Android OMAPI" +date = 2023-12-17T00:17:46+08:00 +weight = 2 ++++ diff --git a/content/quickstart/pcsc.md b/content/quickstart/pcsc.md new file mode 100644 index 0000000..64dbe4e --- /dev/null +++ b/content/quickstart/pcsc.md @@ -0,0 +1,5 @@ ++++ +title = "PC/SC" +date = 2023-12-17T00:17:42+08:00 +weight = 3 ++++ diff --git a/content/quickstart/stk.md b/content/quickstart/stk.md new file mode 100644 index 0000000..fb75552 --- /dev/null +++ b/content/quickstart/stk.md @@ -0,0 +1,5 @@ ++++ +title = "STK Menu" +date = 2023-12-17T00:17:42+08:00 +weight = 1 ++++ diff --git a/content/estk_me/stk/_index.md b/content/stk/_index.md similarity index 100% rename from content/estk_me/stk/_index.md rename to content/stk/_index.md diff --git a/content/estk_me/stk/about-estk_me.md b/content/stk/about-estk_me.md similarity index 100% rename from content/estk_me/stk/about-estk_me.md rename to content/stk/about-estk_me.md diff --git a/content/estk_me/stk/profiles/_index.md b/content/stk/profiles/_index.md similarity index 67% rename from content/estk_me/stk/profiles/_index.md rename to content/stk/profiles/_index.md index 97a3532..2cbbe15 100644 --- a/content/estk_me/stk/profiles/_index.md +++ b/content/stk/profiles/_index.md @@ -21,10 +21,6 @@ weight = 1 - [设置昵称](./nickname) - [删除配置文件](./delete) -{{% notice style="note" title="注意" %}} -Profiles 功能目前仅能管理不大于15个配置文件,当 eSE 中存储了超过15个配置文件后,Profiles 功能无法保证正常工作,请参考 “[LPA 操作手册](estk_me/lpa-guide)” 进行管理。 -{{% /notice %}} - -{{% notice style="info" title="注:" %}} -管理 Profile 不支持禁用,因为完全关闭 Profile 会导致 STK 菜单无法访问,如果确实需要关闭全部配置文件,请参考 “[LPA 操作手册](estk_me/lpa-guide)” 进行管理。 +{{% notice style="info" title="为什么没有 “禁用” 功能" %}} +完全关闭 Profile 会导致 在大部分设备上 STK 菜单无法访问,因此不会提供 “禁用配置文件” 选项,如果确实需要关闭全部配置文件,请参考 “[LPA 操作手册](estk_me/lpa-guide)” 进行管理。 {{% /notice %}} diff --git a/content/stk/profiles/delete.md b/content/stk/profiles/delete.md new file mode 100644 index 0000000..7fd95cb --- /dev/null +++ b/content/stk/profiles/delete.md @@ -0,0 +1,22 @@ ++++ +title = "Delete Profile" +date = 2023-12-17T21:23:18+08:00 +weight = 3 ++++ + +## 删除选定的配置文件 + +{{% notice style="warning" title="危险操作" %}} +1. 该操作的结果在大部分情况下是不可逆转的,一次性的。 +2. 你需要非常清楚自己正在操作什么,不应盲目接受他人建议。 +3. 在STK内进行删除是 “离线删除”,这意味着管理服务器在删除就不会立刻收到通知。 +{{% /notice %}} + +点击该菜单项后,会自动执行如下步骤 + +1. 弹出删除二次确认输入框以及风险提示 +2. 弹出操作成功或被取消的提示框 + +{{% notice style="info" title="关于删除通知" %}} +STK 并不会丢弃本应发送至管理服务器的 “删除通知”,它实际上仍保存在芯片内,可由 LPA 软件在连接到互联网时再次发送到管理服务器上用于完成 “在线删除”。 +{{% /notice %}} diff --git a/content/stk/profiles/enable.md b/content/stk/profiles/enable.md new file mode 100644 index 0000000..2756023 --- /dev/null +++ b/content/stk/profiles/enable.md @@ -0,0 +1,18 @@ ++++ +title = "Enable Profile" +date = 2023-12-17T21:21:44+08:00 +weight = 1 ++++ + +## 激活选定的配置文件 + +{{% notice style="tip" title="可靠操作" %}} +1. 你可以自由尝试该功能。 +2. 该操作的结果是可逆的,或至少有一种恢复先前状态的方法。 +{{% /notice %}} + +点击该菜单项后,会自动执行如下步骤 + +1. 禁用掉当前激活的配置文件 +2. 启动被选择的配置文件 +3. 弹出提示框 diff --git a/content/estk_me/stk/profiles/nickname.md b/content/stk/profiles/nickname.md similarity index 63% rename from content/estk_me/stk/profiles/nickname.md rename to content/stk/profiles/nickname.md index da6bd5b..98cb6c1 100644 --- a/content/estk_me/stk/profiles/nickname.md +++ b/content/stk/profiles/nickname.md @@ -6,21 +6,16 @@ weight = 2 ## 为选定的配置文件设置昵称 -修改昵称是一个可靠操作,这意味着: - +{{% notice style="tip" title="可靠操作" %}} 1. 你可以自由尝试该功能。 2. 该操作的结果是可逆的,或至少有一种恢复先前状态的方法。 +{{% /notice %}} 点击该菜单项后,会自动执行如下步骤 1. 弹出 “输入新昵称的输入框” 2. 弹出修改成功提示框 -3. 向终端设备发起重启 eSTK.me 本身的指令。 如果未向 “输入新昵称的输入框” 内提交任何字符,等同于删除已经存在的昵称,此时 Profiles 菜单界面将优先展示 “提供商”。 由于 eSTK.me 自身性能的限制,STK 菜单内的输入长度被限制在16个字符,如果需要达到 SGP.22 标准长度,请参考 “[LPA 操作手册](estk_me/lpa-guide)” 进行管理。 - -{{% notice style="note" title="注意" %}} -虽然重启 eSTK.me 的指令符合业界标准规范,经过测试从2008年到最新出厂的终端设备均广泛支持,但仍有可能被极个别不遵守规范或过度 “优化” 的厂商破坏了该指令的兼容性,请重启终端设备以应用新的配置文件。 -{{% /notice %}} diff --git a/content/stk/remotelpa/_index.md b/content/stk/remotelpa/_index.md new file mode 100644 index 0000000..cdb1f70 --- /dev/null +++ b/content/stk/remotelpa/_index.md @@ -0,0 +1,5 @@ ++++ +title = "Remote LPA" +date = 2023-12-17T18:29:42+08:00 +weight = 2 ++++ \ No newline at end of file diff --git a/content/stk/remotelpa/download-profile.md b/content/stk/remotelpa/download-profile.md new file mode 100644 index 0000000..cf37ec8 --- /dev/null +++ b/content/stk/remotelpa/download-profile.md @@ -0,0 +1,5 @@ ++++ +title = "Download Profile" +date = 2023-12-17T21:48:31+08:00 +weight = 1 ++++ diff --git a/content/stk/remotelpa/process-notifications.md b/content/stk/remotelpa/process-notifications.md new file mode 100644 index 0000000..9d1c761 --- /dev/null +++ b/content/stk/remotelpa/process-notifications.md @@ -0,0 +1,5 @@ ++++ +title = "Process Notifications" +date = 2023-12-17T21:48:31+08:00 +weight = 2 ++++ diff --git a/content/stk/remotelpa/remote-management.md b/content/stk/remotelpa/remote-management.md new file mode 100644 index 0000000..2438de7 --- /dev/null +++ b/content/stk/remotelpa/remote-management.md @@ -0,0 +1,5 @@ ++++ +title = "Remote Management" +date = 2023-12-17T21:48:31+08:00 +weight = 3 ++++ diff --git a/content/estk_me/stk/settings/_index.md b/content/stk/settings/_index.md similarity index 66% rename from content/estk_me/stk/settings/_index.md rename to content/stk/settings/_index.md index 93bb37d..9ce745a 100644 --- a/content/estk_me/stk/settings/_index.md +++ b/content/stk/settings/_index.md @@ -4,15 +4,11 @@ date = 2023-12-17T18:30:12+08:00 weight = 10 +++ -一些修改 eSTK.me 行为的功能。 -{{% notice style="note" title="注意" %}} -SKU Mode 功能在固件版本 1.2.5 后移除 -{{% /notice %}} +一些修改 eSTK.me 行为的功能。 - [授予 APP 访问权限](./ara-m-sha1) - [配置虚拟 EID 的值](./virtual-eid) - [配置 eSTK.me 的 ATR 响应](./atr-mode) - [配置 ISD-R 域的工作模式](./isd-r-mode) - [配置 ECASD 管理域的行为](./ecasd-mode) -- [~~SKU Mode~~](./sku-mode) - [开启或者关闭欢迎语](./hint-mode) diff --git a/content/stk/settings/ara-m-sha1.md b/content/stk/settings/ara-m-sha1.md new file mode 100644 index 0000000..2aed30c --- /dev/null +++ b/content/stk/settings/ara-m-sha1.md @@ -0,0 +1,34 @@ ++++ +title = "ARA-M SHA-1" +date = 2023-12-17T21:48:31+08:00 +weight = 1 ++++ + +## 授予 APP 访问权限 + +ARA-M 作为智能卡的一个特殊属性,用于在现代操作系统上控制何种应用可以访问智能卡接口。目前已经在支持 OMAPI 的 Android 操作系统上广泛应用。 +智能卡使用 ARA-M 通过开发者证书的 SHA-1 或者 SHA-256 的值来通知操作系统来自哪个开发者的应用可以访问自身。 + +{{% notice style="note" title="额外注意操作" %}} +1. 你可以自由尝试该功能。 +2. 该操作的结果是可逆的,或至少有一种恢复先前状态的方法。 +3. 不正确的 ARA-M SHA-1 的值会导致 LPA 应用无法管理 eUICC,需要确保你可以正常访问 STK 或拥有 PCSC 读卡器。 +{{% /notice %}} + +点击该菜单项后,会列出5个已经存储在卡片内的ARA-M值,若从未设置过,则会显示全零。 + +点选任意一个值则进入编辑模式,编辑模式下有如下两种操作: + +1. 输入预期的SHA-1值,此值将保存在卡片内。 +2. 未输入任何信息并提交,先前选择的值将被清零。 + +{{% notice style="note" title="注意" %}} +当错误地修改了 ARA-M SHA-1 值,又恰好无法正常访问 STK 菜单,那么你需要参考“固件升级”一节,将设置还原为出厂状态。 +{{% /notice %}} + +{{% notice style="tip" title="提示" %}} +eSTK.me目前支持最多5个不同的ARA-M。这意味着你可以授权最多来自5个不同开发者的APP用于管理卡片。 +{{% /notice %}} + +{{% expand title="在 1.2.3 固件以前"%}} +{{% /expand %}} diff --git a/content/estk_me/stk/settings/atr-mode.md b/content/stk/settings/atr-mode.md similarity index 57% rename from content/estk_me/stk/settings/atr-mode.md rename to content/stk/settings/atr-mode.md index 7934206..076992f 100644 --- a/content/estk_me/stk/settings/atr-mode.md +++ b/content/stk/settings/atr-mode.md @@ -7,17 +7,22 @@ weight = 3 ## 配置 eSTK.me 的 ATR 响应 ATR 是智能卡发送给终端的第一段数据,其中包含了从通信方式到数据结构的多种关键信息。 -{{% notice style="note" title="注意" %}} -虽然 eSTK.me 具有完全自定义 ATR 的能力,但错误的 ATR 可以轻易的造成软件损坏甚至硬件永久损伤,最终用户仅可在经过安全测试的预设 ATR 数据中进行选择。 -{{% /notice %}} - -切换 ATR 设置是一个可靠操作,这意味着: +{{% notice style="tip" title="可靠操作" %}} 1. 你可以自由尝试该功能。 2. 该操作的结果是可逆的,或至少有一种恢复先前状态的方法。 +{{% /notice %}} “ATR 选择菜单” 具有 "< >" 或 "<\*>" 字符表示的前缀,其中 "<\*>" 前缀代表的是当前激活的配置。 + > 当前可供选择的 ATR 模式 +1. Generic:通用的智能卡ATR通告。 +2. eUICC:包含eUICC功能的智能卡。 -1. eUICC(Default):这个是默认的 ATR 数据,它包含了除通讯时序约束外,包含了 eUICC 功能的通告。 -2. Generic(Legacy):在此模式下,将在 eUICC 模式的基础上不再通告 eUICC 功能。 +{{% notice style="warning" title="注意" %}} +如果将 “[ISD-R 模式](./isd-r-mode)” 设置为 “关闭” 的情况下同时通告 eUICC ATR,有可能导致部分终端提示 “智能卡已损坏” +{{% /notice %}} + +{{% notice style="info" title="功能限制" %}} +虽然 eSTK.me 具有完全自定义 ATR 的能力,但错误的 ATR 可以轻易的造成软件损坏甚至硬件永久损伤,最终用户仅可在经过安全测试的预设 ATR 数据中进行选择。对于OEM用户,eSTK.me可以提供更丰富的ATR自定义功能并协助测试ATR的可靠性。 +{{% /notice %}} diff --git a/content/estk_me/stk/settings/ecasd-mode.md b/content/stk/settings/ecasd-mode.md similarity index 66% rename from content/estk_me/stk/settings/ecasd-mode.md rename to content/stk/settings/ecasd-mode.md index 9a614d5..12914c1 100644 --- a/content/estk_me/stk/settings/ecasd-mode.md +++ b/content/stk/settings/ecasd-mode.md @@ -7,14 +7,14 @@ weight = 5 ## 配置 ECASD 管理域的行为 ECASD 是一个特殊的管理域,与 ISD-R 不同,ECASD 保存着 eUICC 最关键的证书与密钥数据,可以理解为是 eUICC 的后端,通常情况下,除了 eSE 的制造方,无需访问 ECASD 域。 -配置 ECASD 是一个可靠操作,这意味着: +{{% notice style="tip" title="配置 ECASD 是一个可靠操作" %}} 1. 你可以自由尝试该功能。 2. 该操作的结果是可逆的,或至少有一种恢复先前状态的方法。 +{{% /notice %}} -“ECASD 选择菜单” 具有 "< >" 或 "<\*>" 字符表示的前缀,其中 "<\*>" 前缀代表的是当前激活的配置。 ->当前可供选择的 ECASD 模式 +“ECASD 选择菜单” 具有 "< >" 或 "<\*>" 字符表示的前缀,其中 "<\*>" 前缀代表的是当前激活的配置。 -1. Enabled:默认模式,ECASD 被正常访问。 -2. Virtual EID:应用虚拟EID模式,即使是通过 ECASD 也无法读取真实 EID。 -3. Disabled:禁用模式,在此状态下终端设备无法访问 ECASD 域。 +> 当前可供选择的 ECASD 模式 +1. Enabled:默认模式,ECASD 可被正常访问。 +2. Disabled:禁用模式,在此状态下终端设备无法访问 ECASD 域。 diff --git a/content/estk_me/stk/settings/isd-r-mode.md b/content/stk/settings/isd-r-mode.md similarity index 74% rename from content/estk_me/stk/settings/isd-r-mode.md rename to content/stk/settings/isd-r-mode.md index 273b95f..ecf7d0c 100644 --- a/content/estk_me/stk/settings/isd-r-mode.md +++ b/content/stk/settings/isd-r-mode.md @@ -7,15 +7,20 @@ weight = 4 ## 配置 ISD-R 域的工作模式 ISD-R 是 LPA 与 eUICC 进行交互的主要接口,配置文件的管理(包括下载,切换,删除,重命名等)、eUICC 信息的获取,均以该管理域为入口。 -修改 ISD-R 的工作模式需要额外注意操作,这意味着: +{{% notice style="note" title="额外注意操作" %}} 1. 你可以自由尝试该功能。 2. 该操作的结果是可逆的,或至少有一种恢复先前状态的方法。 3. 非预期的 ISD-R 工作模式会导致 LPA 应用无法管理 eUICC,需要确保你可以正常访问 STK 或拥有 PCSC 读卡器。 +{{% /notice %}} “ISD-R 选择菜单” 具有 "< >" 或 "<\*>" 字符表示的前缀,其中 "<\*>" 前缀代表的是当前激活的配置。 ->当前可供选择的 ISD-R 模式 +> 当前可供选择的 ISD-R 模式 1. Shared:默认模式,ISD-R 域可被共享访问,所有访问请求均被允许。 2. Exclusive:独占访问模式,必须等待当前操作主动让出才可接受其他访问请求。 3. Disabled:禁用模式,在此状态下终端设备无法访问 ISD-R 域。 + +{{% notice style="warning" title="注意" %}} +如果将 “[ATR 模式](./atr-mode)” 设置为 “eUICC” 的情况下同时 “禁用 ISD-R” ,有可能导致部分终端提示 “智能卡已损坏” +{{% /notice %}} diff --git a/content/stk/settings/motd-mode.md b/content/stk/settings/motd-mode.md new file mode 100644 index 0000000..1fb03a2 --- /dev/null +++ b/content/stk/settings/motd-mode.md @@ -0,0 +1,22 @@ ++++ +title = "MOTD Mode" +date = 2023-12-17T21:54:11+08:00 +weight = 7 ++++ + +## 开启或者关闭欢迎语 + +设置eSTK.me的欢迎语,即,卡片正常启动后弹出的信息。该功能可用于提示用户 eSTK.me 已被识别,或监测意料之外的重启。 + +{{% notice style="tip" title="可靠操作" %}} +1. 你可以自由尝试该功能。 +2. 该操作的结果是可逆的,或至少有一种恢复先前状态的方法。 +{{% /notice %}} + +点击该菜单项后,将会弹出: +1. 现有MOTD的值,点选将弹出输入框用于更新。 +2. MOTD 工作模式选项。 + +> 当前可供选择的 MOTD 模式 +1. Enabled : 启用欢迎语功能 +2. Disabled : 禁用欢迎语功能 diff --git a/content/stk/settings/virtual-eid.md b/content/stk/settings/virtual-eid.md new file mode 100644 index 0000000..6059c33 --- /dev/null +++ b/content/stk/settings/virtual-eid.md @@ -0,0 +1,27 @@ ++++ +title = "Virtual EID" +date = 2023-12-17T21:53:42+08:00 +weight = 2 ++++ + +## 配置虚拟 EID 的值 + +此功能可以使 eUICC 管理软件 (LPA) 获取到用户指定的值而并非 eSE 中永久固化的序列号。 + +{{% notice style="tip" title="可靠操作" %}} +1. 你可以自由尝试该功能。 +2. 该操作的结果是可逆的,或至少有一种恢复先前状态的方法。 +3. 特殊的 EID 可能会使一些管理软件异常。 +{{% /notice %}} + +点击该菜单项后,将会弹出: +1. 现有VirtualEID的值,点选将弹出输入框用于更新 +2. Virtual EID 工作模式选项 + +> 当前可供选择的 Virtual EID 模式 +1. Enabled:启用 Virtual EID 功能,此时从ISD-R中读取EID将被替换为VirtualEID所设定的值。 +2. Disabled:不启用Virtual EID功能。 + +{{% notice style="note" title="注意" %}} +需要注意的是,当与 Profile 下载服务器 (SM-DP+) 进行通信时,由于 GSMA PKI 证书系统的存在,虚拟 EID 无法生效,SM-DP+ 总是能获取到 eUICC 的真实 EID 序列号。 +{{% /notice %}} diff --git a/content/estk_me/stk/tools/_index.md b/content/stk/tools/_index.md similarity index 100% rename from content/estk_me/stk/tools/_index.md rename to content/stk/tools/_index.md diff --git a/content/stk/tools/bypass-stk-menu.md b/content/stk/tools/bypass-stk-menu.md new file mode 100644 index 0000000..792c559 --- /dev/null +++ b/content/stk/tools/bypass-stk-menu.md @@ -0,0 +1,26 @@ ++++ +title = "Bypass STK Menu" +date = 2023-12-17T18:43:34+08:00 +weight = 1 ++++ + +## 直通下层 STK 菜单 + +少部分Profile提供了自身的STK菜单功能,使用该工具可在eSTK.me的环境下访问这些STK菜单。 + +{{% notice style="tip" title="可靠操作" %}} +1. 你可以自由尝试该功能。 +2. 该操作的结果是可逆的,或至少有一种恢复先前状态的方法。 +{{% /notice %}} + +点选该功能后: +1. 若无可用的下层STK菜单,将弹出提示并返回eSTK.me。 +2. 若存在可用的下层STK菜单,会再次确认是否需要直通,点选 `! YES !` 后将展示下层STK菜单。 + +{{% notice style="note" title="注意" %}} +一旦 eSTK.me 的菜单被直通,则需要重启一次终端设备或拔插一次 eSTK.me 才能恢复。 +{{% /notice %}} + +{{% notice style="info" title="提示" %}} +以iPhone为代表的部分终端设备需要切出STK菜单再进入才会应用新的菜单。 +{{% /notice %}} diff --git a/content/estk_me/stk/tools/reboot.md b/content/stk/tools/reboot.md similarity index 76% rename from content/estk_me/stk/tools/reboot.md rename to content/stk/tools/reboot.md index 192671b..8f2f90f 100644 --- a/content/estk_me/stk/tools/reboot.md +++ b/content/stk/tools/reboot.md @@ -6,10 +6,12 @@ weight = 3 ## 重启 -Reboot 是一个可靠操作,这意味着: +重启卡片,可用于 “修改了[系统设置](../settings/)后” 或 “卡片偶发工作不正常时的缓解”。 +{{% notice style="tip" title="可靠操作" %}} 1. 你可以自由尝试该功能。 2. 该操作的结果是可逆的,或至少有一种恢复先前状态的方法。 +{{% /notice %}} {{% notice style="note" title="注意" %}} eSTK.me 并非直接重启了自身 COS 系统,而是请求并等待终端设备进行 “断电-上电” 流程。 diff --git a/content/estk_me/stk/tools/service-code.md b/content/stk/tools/service-code.md similarity index 100% rename from content/estk_me/stk/tools/service-code.md rename to content/stk/tools/service-code.md