logo
logo
请输入关键词搜索产品或者文档
中国

中国站

创蓝云智

国际站

Innopaas

SDK合规使用指南

更新时间:2026-11-13 11:24:35

尊敬的开发者,您好!

自 2019 年 12 月 30 日工信部发布《App 违法违规收集使用个人信息行为认定方法》起,数据合法合规的采集及使用规范越来越严格。为了保证您的 App 顺利通过检测,结合当前监管关注重点,我们制作了SDK合规使用指南供开发者参考。

特别地,本SDK处理的居民身份证信息属于敏感个人信息,除本指南外,请您务必同时阅读《中华人民共和国个人信息保护法》关于处理敏感个人信息“单独同意”的规定,确保您的采集和使用行为完全合规。

温馨提示

请您务必确保已经接入/升级至满足监管新规的最新版本身份证NFC读卡SDK(最新版SDK下载页)。

请牢记!合规三步走:

1、您需要确保 App 有《隐私政策》,并且在用户首次启动 App 时就弹出《隐私政策》并取得用户同意。

App 首先需制定一份《隐私政策》,并确保在产品界面中显著展示。《隐私政策》须单独成文,而不是作为用户协议、用户说明等文件中的一部分存在。 App 应在《隐私政策》中明示收集使用个人信息的目的、方式和范围,并确保《隐私政策》链接正常有效,易于访问和阅读。App 应在《隐私政策》中将收集个人信息的业务功能以及每个业务功能所收集的个人信息类型进行逐项列举,不应使用“等、例如 ” 等方式概括说明;同时,App 须对个人敏感信息类型进行显著标识(如字体加粗、标星号、下划线、斜体、颜色等)。如果通过嵌入第三方代码、插件等方式将个人信息传输至第三方服务器,应通过弹窗提示等方式明确告知用户。

就本SDK而言:居民身份证芯片信息(含姓名、公民身份号码、住址、本人相片等)属于敏感个人信息,您应在《隐私政策》中对其作出显著标识,并在读卡前以独立弹窗、单独勾选等可实现“单独同意”的方式另行取得终端用户同意(详见本指南第2条第(5)款)。


2、您务必告知用户您选择 身份证NFC读卡SDK 服务。

请您在《隐私政策》中增加对身份证NFC读卡SDK 名称、公司名称、处理个人信息种类及目的、采集方式、隐私政策链接等内容进行披露。 可以在您 App 的《隐私政策》中,以文字或列表的方式向公众披露身份证NFC读卡SDK 的相关信息。

(1)SDK 业务功能说明

接入说明: 身份证NFC读卡SDK 仅包含基本业务功能,不提供扩展业务功能。

基本功能: 为终端用户提供居民身份证芯片NFC识读能力,实现终端用户以其本人持有的居民身份证在具备NFC功能的设备上完成证件芯片信息的读取,识读结果返回至接入方应用。

所属类型: 设备端证件识读组件。

收集信息名称及可选信息配置方式:

功能区分业务功能功能介绍个人信息类型及处理目的配置方式
基本功能身份证NFC读卡通过NFC读取居民身份证芯片信息,完成证件识读并将结果返回至接入方应用 必要个人信息:
• 居民身份证芯片信息:依照《中华人民共和国居民身份证法》第三条确定的登记项目,实际包括姓名、性别、民族、出生日期、住址、公民身份号码、签发机关、有效期限等登记项目及证件照片图像(属于个人敏感信息)。用于完成证件识读并向接入方返回识读结果;其中证件照片图像仅在接入方开启“返回身份证照片”配置时随结果返回,请按最小必要原则配置。(Android)
• 网络类型、网络状态:用于判断设备网络是否可用,并建立与证件识读服务端的网络连接,完成芯片信息解码与结果返回。(Android)
• 设备标识信息(包括OAID(如设备支持)、ANDROID_ID、设备序列号(SN)):在SDK初始化时通过无需系统权限的接口采集,用于接入鉴权、维持服务连接及防止接口调用滥用。(Android)

本SDK不读取、不采集居民身份证芯片中的指纹信息。
必要个人信息为实现基本功能所必需,无法关闭;可选行为配置详见“SDK 可选个人信息配置说明”。
基本功能其他卡片识别终端用户误贴非居民身份证IC卡时,向接入方返回卡号以便提示换卡 可选个人信息:
• 其他非居民身份证IC卡的卡号:仅在终端用户误贴非身份证卡片时被动返回,不主动发起采集。
默认生效,接入方可在 onReadICCardSuccess 回调中忽略该结果;无需配置。
可选功能识读结果本地缓存开启后最近一次识读结果缓存于终端设备的应用私有目录,同一证件重复识读时加快返回 不新增采集个人信息类型,属于识读结果的设备端暂存:缓存仅存在于终端设备本地,不上传服务端、不离开设备;终端用户可通过系统“清除应用数据”予以删除;接入方未开启则不产生任何缓存。 Android端
开启、关闭示例:
CLReadCardManager.builder(context).buildOpenLocalCache(false);
参数说明:
true:开启;false:关闭。
请按业务实际需要配置;开启后接入方应向终端用户提供清除缓存或删除数据的途径。
可选功能调试日志输出SDK内部流程日志至系统日志(logcat),用于接入开发阶段排查问题 不新增采集个人信息类型;调试日志可能输出证件信息(如身份证件号码),仅限接入方开发调试使用,生产环境必须关闭。 Android端
开启、关闭示例:
CLReadCardManager.setDebug(true);
参数说明:
true:开启;false:关闭;默认:false。
建议接入方使用 BuildConfig.DEBUG 控制,确保正式包恒为 false。

SDK 可选个人信息配置说明: 接入说明:对于身份证NFC读卡SDK 可选行为与可选个人信息的控制,开发者可以通过 SDK 可选个人信息配置示例说明进行配置。关闭相关配置不会影响身份证芯片识读基本功能的实现,请开发者结合业务实际需要按最小必要原则进行合理配置。

可选个⼈信息配置示例说明

个人信息类型个人信息采集目的配置方式
居民身份证证件照片图像证件照片属于证件信息的一部分;仅当接入方业务确需展示或留存照片时开启,随识读结果返回给接入方应用。 Android端
开启、关闭示例:
在 builder 链式配置中调用 buildNeedIdCardPhoto(false);
参数说明:
true:开启(随结果返回照片);false:关闭。
请按最小必要原则配置;另有 buildDelIdCardPhotoWhiteBg(true) 可对返回照片去除白边(仅影响图像处理效果,不改变采集范围)。
识读结果本地缓存用于同一证件重复识读时加快返回;缓存仅存于终端设备应用私有目录,不上传服务端。 Android端
开启、关闭示例:
在 builder 链式配置中调用 buildOpenLocalCache(false);
参数说明:
true:开启;false:关闭。
开启后接入方应向终端用户提供清除缓存或删除数据的途径(如系统“清除应用数据”)。
证件信息的日志输出(调试日志)用于接入开发阶段排查问题;调试日志可能将证件信息(如身份证件号码)输出至系统日志。 Android端
开启、关闭示例:
CLReadCardManager.setDebug(false);
参数说明:
true:开启;false:关闭;默认:false。
生产环境必须为 false,建议使用 BuildConfig.DEBUG 控制。

(2)身份证NFC读卡SDK隐私政策披露示例

SDK 名称: 身份证NFC读卡SDK SDK 开发者: 上海璟梦信息科技有限公司 SDK 包名: com.chuanglan.nfc.sdk SDK 用途: 为APP提供居民身份证芯片NFC识读能力,读取证件信息并将识读结果返回至接入方应用。 SDK 信息处理类型: 必要个人信息:居民身份证芯片信息(姓名、性别、民族、出生日期、住址、公民身份号码、签发机关、有效期限、证件照片图像)、网络类型、网络状态、设备标识信息(包括OAID(如设备支持)、ANDROID_ID、设备序列号(SN))。可选个人信息:其他非居民身份证IC卡的卡号。 数据处理方式: 芯片密文数据经加密传输至证件识读服务端完成解码,服务端处理完成即删除、不存储;证件照片于终端设备本地完成解码;SDK 自行采集。 隐私协议: (请替换为《身份证NFC读卡SDK隐私政策》正式发布链接)

本SDK以单一SDK形式由上海璟梦信息科技有限公司向接入方提供并负责,接入方按上述示例在本节完成披露即可,无需再另行拆分披露其他第三方SDK信息。


(3)申请权限及使用场景说明

您可以参考如下表格详细了解身份证NFC读卡SDK使用相关权限与各业务功能的关系及其申请时机,因相关权限的不申请将会对其对应的功能造成影响,您可以结合业务实际需要进行合理配置。特别提示:NFC权限属于设备敏感能力权限,请您仅在终端用户明确触发读卡动作时申请,不得在应用启动、后台或与业务无关的场景下静默申请。

平台权限使用场景使用目的申请时机
Androidandroid.permission.NFC(必选)NFC读卡允许应用程序访问设备NFC控制器,用于读取居民身份证芯片信息调用NFC读卡时申请
android.permission.INTERNET(必选)网络通信允许应用程序联网,用于将读取的芯片信息传输至证件识读服务端完成解码并取回结果调用NFC读卡时申请
android.permission.ACCESS_NETWORK_STATE(必选)查看网络状态获取网络状态,判断当前网络是否可用,并在网络不可用时提示终端用户调用功能接口的前置检查
Harmonyohos.permission.NFC_TAG(必选)NFC读卡允许应用程序访问NFC标签能力,用于读取居民身份证芯片信息调用NFC读卡时申请
ohos.permission.INTERNET(必选)网络通信允许应用程序联网,用于访问证件识读服务并取回解码结果调用NFC读卡时申请
ohos.permission.GET_NETWORK_INFO(必选)查看网络状态获取网络状态,判断当前网络是否可用,并在网络不可用时提示终端用户调用功能接口的前置检查
iOSNFC读卡能力(CoreNFC,必选)证件读卡调用系统NFC会话读取居民身份证芯片信息,读卡过程由系统提供独立界面并需用户确认调用读卡接口时由系统弹出
蜂窝网络/无线局域网访问(系统级授权,必选)网络通信用于访问证件识读服务并取回解码结果;iOS 不产生可枚举的网络权限声明项,由系统蜂窝数据开关或无线局域网连接状态控制首次联网时由系统判定

(4)SDK 个人信息收集频次、精度说明

我们将严格遵循最小必要原则,仅在实现相关业务功能所必需时收集用户个人信息。在收集频次方面,身份证NFC读卡SDK 仅在终端用户主动触发读卡(贴卡)时一次性采集当次识读所必需的信息,不进行后台持续或高频收集,SDK 初始化亦应在终端用户进入读卡业务时进行。目前,该触发机制由 SDK 功能逻辑统一管理,不提供频次相关参数供 App 开发者配置,因此我们未对外提供频次配置选项或示例。在精度方面,证件信息按居民身份证芯片内的原始登记项目返回,不额外扩大采集范围;设备标识信息仅用于接入鉴权、维持服务连接及防止接口调用滥用。

(5)最终用户同意授权方式的说明及示例

App 首次运行时应当有隐私弹窗,隐私弹窗中应公示简版隐私政策内容并附完整版隐私政策链接,并明确提示最终用户阅读并选择是否同意隐私政策;隐私弹窗应提供同意按钮和拒绝同意的按钮,并由最终用户主动选择。

特别地,居民身份证信息属于敏感个人信息,依据《中华人民共和国个人信息保护法》,您应当在终端用户触发读卡动作前,以独立弹窗、单独勾选或其他可实现“单独同意”的方式,向终端用户单独告知处理敏感个人信息的必要性、对个人权益的影响,并取得终端用户的单独同意;不得以概括授权、默认勾选、与其他业务捆绑授权的方式获取。读卡行为应由终端用户本人主动发起(主动点击并贴卡),您不得在终端用户不知情或未主动操作的情况下后台静默读卡。

隐私政策授权弹窗及读卡前敏感个人信息单独同意弹窗示例:(此处可补充您应用内的弹窗示例图)


(6)最终用户撤回同意授权及行使权力说明

如您的终端用户不希望我们进行前述处理,可以选择不同意隐私政策且退出APP;已同意的终端用户,可以通过系统设置关闭“NFC权限”、断开网络连接,或通过系统“清除应用数据/存储”(同时删除SDK在本地的识读结果缓存与鉴权凭据)撤回同意并停止相关处理。开发者应在其 App 中为最终用户提供便捷的撤回同意路径,并在撤回后停止调用本SDK相关功能。

开发者在其 App 中集成身份证NFC读卡SDK 后,应根据相关法律法规为最终用户提供行使个人信息主体权利的路径或功能,需身份证NFC读卡SDK 配合的,您或者您的终端用户可以通过下文隐私保护机制列明的联系方式与我们及时进行联系,我们将与开发者协同妥善解决最终用户的诉求。

3、SDK初始化及各项业务功能接口合规调用时机

  • 您应确保在 App 首次运行时通过明显方式提示终端用户阅读您的《隐私政策》,并取得终端用户的合法授权后,再初始化身份证NFC读卡SDK及调用SDK其他方法。如果终端用户不同意您的隐私政策,则不能初始化SDK,也无法使用相应 SDK 对应功能,您应避免私自采集和上报个人信息。

  • 鉴于本SDK处理的居民身份证信息属于敏感个人信息,您应在取得终端用户对敏感个人信息的单独同意后、且终端用户实际进入读卡业务(触发读卡动作)时,再初始化SDK并发起网络请求;请勿在 App 启动(Application onCreate)或其他与读卡业务无关的时机初始化SDK。

Android初始化

// 鉴权 token 必须由您的业务服务端调用获取授权Token接口后下发,
// 严禁在 APP 内使用 appKey 换取 token(避免密钥暴露在客户端)
CLReadCardOutMethod manager = CLReadCardManager.builder(context)
        .buildAppID(appId)              // 业务方 appID(必配)
        .buildAuthToken(token)          // 服务端下发的鉴权 token(必配)
        .buildNeedIdCardPhoto(false)    // 证件照片按最小必要原则配置
        .buildOpenLocalCache(false)     // 本地缓存按业务需要配置
        .buildCreate();
manager.init((code, msg) -> {
    // code == 1001(ININ_OK)表示初始化成功
});

HarmonyOS / iOS 初始化:请参见对应平台《身份证NFC读卡SDK集成文档》。

  • 调试日志开关应在初始化前设置,且仅限开发调试使用:
CLReadCardManager.setDebug(BuildConfig.DEBUG); // 生产环境必须为 false,日志可能输出证件号码
  • 如果终端用户不同意您的隐私政策,不得调用其它任何身份证NFC读卡SDK 接口,也无法使用相应 SDK 对应功能。

  • 初始化成功后,读卡应由终端用户主动贴卡触发,在 NFC 感知回调(onNewIntent)中拿到 Tag 后调用读卡接口;当次识读完成或失败后调用 readCardStop() 结束;退出读卡业务或不再使用时调用 readCardReleaseDestory() 释放资源:

manager.readCardStart(tag, listener);   // 终端用户贴卡后调用
manager.readCardStop();                 // 当次读卡结束/取消时调用
manager.readCardReleaseDestory();       // 退出读卡业务时调用,释放后再次使用需重新初始化
  • 一旦 App 获取到《隐私政策》的用户授权,后续每次进入读卡业务时,开发者应该保证按上述时机调用初始化方法。读卡方法可以按需调用。

4、隐私保护机制

如果您对您的账户信息、个人信息或其他文档技术有疑问、意见和建议,或者因为需要我们协助关闭某项权限采集能力,可以通过发送邮件至clsdk@253.com或其他特别说明的方式联系我们行使您的权利。

电子邮件:clsdk@253.com

电话:021-37890213

联系地址:上海市松江区广富林东路199号4号楼9-12楼

您还可以随时通过访问我们官网在线客服系统与我们联系,一般情况下,我们将在15日内回复,确保隐私保护机制的落实和执行。

5、合规文件指引

为了更及时高效地落实合规要求,我们建议各位开发者充分了解现有以及陆续将发布的有关个人信息保护的法律、法规、政策、标准等,以下资料供您参考:

《GB/T 35273-2020 信息安全技术 个人信息安全规范》

《App 违法违规收集使用个人信息行为认定方法》

此外,与居民身份证信息处理直接相关的《中华人民共和国个人信息保护法》《中华人民共和国居民身份证法》《中华人民共和国反电信网络诈骗法》中与证件信息收集使用有关的强制性规定,请您一并遵守。