安全剪贴板处理

OWASP 类别： MASVS-CODE：代码质量

概述

Android 提供了一个称为 剪贴板 的强大框架，用于在应用程序之间复制和粘贴数据。此功能的实现不当可能会将用户相关数据暴露给未经授权的恶意攻击者或应用程序。

与剪贴板数据暴露相关的特定风险取决于应用程序的性质以及它处理的个人身份信息 (PII)。对于金融应用程序，其影响尤其大，因为它们可能会泄露支付数据，或者处理双因素身份验证 (2FA) 代码的应用程序。

为了泄露剪贴板数据而可能利用的攻击媒介因 Android 版本而异。

  • Android 10（API 级别 29）之前的版本 允许后台应用程序访问前台应用程序剪贴板信息，这可能允许恶意攻击者直接访问任何复制的数据。
  • 从 Android 12 及更高版本（API 级别 31）开始，每次应用程序访问剪贴板中的数据并粘贴时，都会向用户显示一条提示消息，从而使攻击更难以不被察觉。此外，为了保护 PII，Android 支持 ClipDescription.EXTRA_IS_SENSITIVE 或 android.content.extra.IS_SENSITIVE 特殊标志。这允许开发人员在键盘 GUI 中视觉上模糊剪贴板内容预览，防止复制的数据以明文形式显示，并可能被恶意应用程序窃取。实际上，如果不实现上述标志之一，攻击者可能会通过窥探或通过在后台运行的恶意应用程序（截取屏幕截图或录制合法用户活动的视频）来泄露复制到剪贴板的敏感数据。

影响

利用不正确的剪贴板处理可能会导致用户相关的敏感或财务数据被恶意攻击者泄露。这可能有助于攻击者采取进一步行动，例如网络钓鱼活动或身份盗窃。

缓解措施

标记敏感数据

此解决方案用于在键盘 GUI 中视觉上模糊剪贴板内容预览。任何可以复制的敏感数据（例如密码或信用卡数据）都应在调用 ClipboardManager.setPrimaryClip() 之前使用 ClipDescription.EXTRA_IS_SENSITIVE 或 android.content.extra.IS_SENSITIVE 进行标记。

Kotlin

// If your app is compiled with the API level 33 SDK or higher.
clipData.apply {
    description.extras = PersistableBundle().apply {
        putBoolean(ClipDescription.EXTRA_IS_SENSITIVE, true)
    }
}

// If your app is compiled with API level 32 SDK or lower.
clipData.apply {
    description.extras = PersistableBundle().apply {
        putBoolean("android.content.extra.IS_SENSITIVE", true)
    }
}

Java

// If your app is compiled with the API level 33 SDK or higher.
PersistableBundle extras = new PersistableBundle();
extras.putBoolean(ClipDescription.EXTRA_IS_SENSITIVE, true);
clipData.getDescription().setExtras(extras);

// If your app is compiled with API level 32 SDK or lower.
PersistableBundle extras = new PersistableBundle();
extras.putBoolean("android.content.extra.IS_SENSITIVE", true);
clipData.getDescription().setExtras(extras);

强制执行最新 Android 版本

强制应用在 Android 10（API 29）或更高版本的 Android 上运行，可以防止后台进程访问前台应用程序中的剪贴板数据。

要强制应用程序仅在 Android 10（API 29）或更高版本上运行，请在 Android Studio 中的项目内的 Gradle 构建文件中设置版本设置的以下值。

Groovy

android {
      namespace 'com.example.testapp'
      compileSdk [SDK_LATEST_VERSION]

      defaultConfig {
          applicationId "com.example.testapp"
          minSdk 29
          targetSdk [SDK_LATEST_VERSION]
          versionCode 1
          versionName "1.0"
          ...
      }
      ...
    }
    ...

Kotlin

android {
      namespace = "com.example.testapp"
      compileSdk = [SDK_LATEST_VERSION]

      defaultConfig {
          applicationId = "com.example.testapp"
          minSdk = 29
          targetSdk = [SDK_LATEST_VERSION]
          versionCode = 1
          versionName = "1.0"
          ...
      }
      ...
    }
    ...

在定义的时间段后删除剪贴板内容

如果应用程序旨在在低于 Android 10（API 级别 29）的 Android 版本上运行，则任何后台应用程序都可以访问剪贴板数据。为了降低此风险，实现一个在特定时间段后清除复制到剪贴板的任何数据的函数非常有用。此功能从 Android 13（API 级别 33）开始自动执行。对于较旧的 Android 版本，可以通过在应用程序代码中包含以下代码段来执行此删除操作。

Kotlin

//The Executor makes this task Asynchronous so that the UI continues being responsive
backgroundExecutor.schedule({
    //Creates a clip object with the content of the Clipboard
    val clipboard = getSystemService(Context.CLIPBOARD_SERVICE) as ClipboardManager
    val clip = clipboard.primaryClip
    //If SDK version is higher or equal to 28, it deletes Clipboard data with clearPrimaryClip()
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.P) {
        clipboard.clearPrimaryClip()
    } else if (Build.VERSION.SDK_INT < Build.VERSION_CODES.P) {
    //If SDK version is lower than 28, it will replace Clipboard content with an empty value
        val newEmptyClip = ClipData.newPlainText("EmptyClipContent", "")
        clipboard.setPrimaryClip(newEmptyClip)
     }
//The delay after which the Clipboard is cleared, measured in seconds
}, 5, TimeUnit.SECONDS)

Java

//The Executor makes this task Asynchronous so that the UI continues being responsive

ScheduledExecutorService backgroundExecutor = Executors.newSingleThreadScheduledExecutor();

backgroundExecutor.schedule(new Runnable() {
    @Override
    public void run() {
        //Creates a clip object with the content of the Clipboard
        ClipboardManager clipboard = (ClipboardManager)getSystemService(Context.CLIPBOARD_SERVICE);
        ClipData clip = clipboard.getPrimaryClip();
        //If SDK version is higher or equal to 28, it deletes Clipboard data with clearPrimaryClip()
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.P) {
            clipboard.clearPrimaryClip();
            //If SDK version is lower than 28, it will replace Clipboard content with an empty value
        } else if (Build.VERSION.SDK_INT < Build.VERSION_CODES.P) {
            ClipData newEmptyClip = ClipData.newPlainText("EmptyClipContent", "");
            clipboard.setPrimaryClip(newEmptyClip);
        }
    //The delay after which the Clipboard is cleared, measured in seconds
    }, 5, TimeUnit.SECONDS);

资源