4.2.1.3 内部广播接收器

内部广播接收器是广播接收器，它将永远不会收到从内部应用以外发送的任何广播。 它由几个内部应用组成，用于保护内部应用处理的信息或功能。

要点（接收广播）：

  1. 定义内部签名权限来接收广播。

  2. 声明使用内部签名权限来接收结果。

  3. 将导出属性显式设置为true。

  4. 需要静态广播接收器定义的内部签名权限。

  5. 需要内部签名来注册动态广播接收器。

  6. 确认内部签名权限是由内部应用定义的。

  7. 尽管广播是从内部应用发送的，但要小心并安全地处理接收到的意图。

  8. 由于请求应用是内部的，因此可以返回敏感信息。

  9. 导出 APK 时，使用与发送应用相同的开发人员密钥对 APK 进行签名。

内部广播接收器的示例代码可用于静态和动态广播接收器。

InhouseReceiver.java

  1. package org.jssec.android.broadcast.inhousereceiver;
  3. import org.jssec.android.shared.SigPerm;
  4. import org.jssec.android.shared.Utils;
  5. import android.app.Activity;
  6. import android.content.BroadcastReceiver;
  7. import android.content.Context;
  8. import android.content.Intent;
  9. import android.widget.Toast;
  11. public class InhouseReceiver extends BroadcastReceiver {
  13.     // In-house Signature Permission
  14.     private static final String MY_PERMISSION = "org.jssec.android.broadcast.inhousereceiver.MY_PERMISSION";
  15.     // In-house certificate hash value
  16.     private static String sMyCertHash = null;
  18.     private static String myCertHash(Context context) {
  19.         if (sMyCertHash == null) {
  20.             if (Utils.isDebuggable(context)) {
  21.                 // Certificate hash value of "androiddebugkey" in the debug.keystore.
  22.                 sMyCertHash = "0EFB7236 328348A9 89718BAD DF57F544 D5CCB4AE B9DB34BC 1E29DD26 F77C8255";
  23.             } else {
  24.                 // Certificate hash value of "my company key" in the keystore.
  25.                 sMyCertHash = "D397D343 A5CBC10F 4EDDEB7C A10062DE 5690984F 1FB9E88B D7B3A7C2 42E142CA";
  26.             }
  27.         }
  28.         return sMyCertHash;
  29.     }
  31.     private static final String MY_BROADCAST_INHOUSE =
  32.     "org.jssec.android.broadcast.MY_BROADCAST_INHOUSE";
  33.     public boolean isDynamic = false;
  35.     private String getName() {
  36.         return isDynamic ? "In-house Dynamic Broadcast Receiver" : "In-house Static Broadcast Receiver";
  37.     }
  39.     @Override
  40.     public void onReceive(Context context, Intent intent) {
  41.         // *** POINT 6 *** Verify that the in-house signature permission is defined by an in-house application.
  42.         if (!SigPerm.test(context, MY_PERMISSION, myCertHash(context))) {
  43.             Toast.makeText(context, "The in-house signature permission is not declared by in-house application.",
  44.             Toast.LENGTH_LONG).show();
  45.             return;
  46.         }
  47.         // *** POINT 7 *** Handle the received intent carefully and securely,
  48.         // even though the Broadcast was sent from an in-house application..
  49.         // Omitted, since this is a sample. Please refer to "3.2 Handling Input Data Carefully and Securely."
  50.         if (MY_BROADCAST_INHOUSE.equals(intent.getAction())) {
  51.             String param = intent.getStringExtra("PARAM");
  52.             Toast.makeText(context,
  53.             String.format("%s:¥nReceived param: ¥"%s¥"", getName(), param),
  54.             Toast.LENGTH_SHORT).show();
  55.         }
  56.         // *** POINT 8 *** Sensitive information can be returned since the requesting application is inhouse.
  57.         setResultCode(Activity.RESULT_OK);
  58.         setResultData(String.format("Sensitive Info from %s", getName()));
  59.         abortBroadcast();
  60.     }
  61. }

静态广播接收器定义在AndroidManifest.xml中。

AndroidManifest.xml

  1. <?xml version="1.0" encoding="utf-8"?>
  2. <manifest xmlns:android="http://schemas.android.com/apk/res/android"
  3.     package="org.jssec.android.broadcast.inhousereceiver" >
  5.     <!-- *** POINT 1 *** Define an in-house signature permission to receive Broadcasts -->
  6.     <permission
  7.     android:name="org.jssec.android.broadcast.inhousereceiver.MY_PERMISSION"
  8.     android:protectionLevel="signature" />
  9.     <!-- *** POINT 2 *** Declare to use the in-house signature permission to receive results. -->
  10.     <uses-permission
  11.     android:name="org.jssec.android.broadcast.inhousesender.MY_PERMISSION" />
  13.     <application
  14.         android:icon="@drawable/ic_launcher"
  15.         android:label="@string/app_name"
  16.         android:allowBackup="false" >
  18.         <!-- *** POINT 3 *** Explicitly set the exported attribute to true. -->
  19.         <!-- *** POINT 4 *** Require the in-house signature permission by the Static Broadcast Receiver
  20.         definition. -->
  21.         <receiver
  22.             android:name=".InhouseReceiver"
  23.             android:permission="org.jssec.android.broadcast.inhousereceiver.MY_PERMISSION"
  24.             android:exported="true">
  25.             <intent-filter>
  26.                 <action android:name="org.jssec.android.broadcast.MY_BROADCAST_INHOUSE" />
  27.                 </intent-filter>
  28.         </receiver>
  30.         <service
  31.         android:name=".DynamicReceiverService"
  32.         android:exported="false" />
  34.         <activity
  35.             android:name=".InhouseReceiverActivity"
  36.             android:label="@string/app_name"
  37.             android:exported="true" >
  38.             <intent-filter>
  39.                 <action android:name="android.intent.action.MAIN" />
  40.                 <category android:name="android.intent.category.LAUNCHER" />
  41.             </intent-filter>
  42.         </activity>
  43.     </application>
  44. </manifest>

在动态广播接收器中，通过调用程序中的registerReceiver()或unregisterReceiver()来执行注册/注销。 为了通过按钮操作执行注册/注销，该按钮PublicReceiverActivity中定义。 由于动态广播接收器实例的作用域比PublicReceiverActivity长，因此不能将其保存为PublicReceiverActivity的成员变量。 在这种情况下，请将动态广播接收器实例保存为DynamicReceiverService的成员变量，然后从PublicReceiverActivity启动/结束DynamicReceiverService，来间接注册/注销动态广播接收器。

InhouseReceiverActivity.java

  1. package org.jssec.android.broadcast.inhousereceiver;
  3. import android.app.Activity;
  4. import android.content.Intent;
  5. import android.os.Bundle;
  6. import android.view.View;
  8. public class InhouseReceiverActivity extends Activity {
  10.     @Override
  11.     public void onCreate(Bundle savedInstanceState) {
  12.         super.onCreate(savedInstanceState);
  13.         setContentView(R.layout.main);
  14.     }
  16.     public void onRegisterReceiverClick(View view) {
  17.         Intent intent = new Intent(this, DynamicReceiverService.class);
  18.         startService(intent);
  19.     }
  21.     public void onUnregisterReceiverClick(View view) {
  22.         Intent intent = new Intent(this, DynamicReceiverService.class);
  23.         stopService(intent);
  24.     }
  25. }

DynamicReceiverService.java

  1. package org.jssec.android.broadcast.inhousereceiver;
  3. import android.app.Service;
  4. import android.content.Intent;
  5. import android.content.IntentFilter;
  6. import android.os.IBinder;
  7. import android.widget.Toast;
  9. public class DynamicReceiverService extends Service {
  11.     private static final String MY_BROADCAST_INHOUSE =
  12.     "org.jssec.android.broadcast.MY_BROADCAST_INHOUSE";
  13.     private InhouseReceiver mReceiver;
  15.     @Override
  16.     public IBinder onBind(Intent intent) {
  17.         return null;
  18.     }
  20.     @Override
  21.     public void onCreate() {
  22.         super.onCreate();
  23.         mReceiver = new InhouseReceiver();
  24.         mReceiver.isDynamic = true;
  25.         IntentFilter filter = new IntentFilter();
  26.         filter.addAction(MY_BROADCAST_INHOUSE);
  27.         filter.setPriority(1); // Prioritize Dynamic Broadcast Receiver, rather than Static Broadcast Receiver.
  28.         // *** POINT 5 *** When registering a dynamic broadcast receiver, require the in-house signature permission.
  29.         registerReceiver(mReceiver, filter, "org.jssec.android.broadcast.inhousereceiver.MY_PERMISSION", null);
  30.         Toast.makeText(this,
  31.             "Registered Dynamic Broadcast Receiver.",
  32.             Toast.LENGTH_SHORT).show();
  33.     }
  35.     @Override
  36.     public void onDestroy() {
  37.         super.onDestroy();
  39.         unregisterReceiver(mReceiver);
  40.         mReceiver = null;
  41.         Toast.makeText(this,
  42.             "Unregistered Dynamic Broadcast Receiver.",
  43.         Toast.LENGTH_SHORT).show();
  44.     }
  45. }

SigPerm.java

  1. package org.jssec.android.shared;
  3. import android.content.Context;
  4. import android.content.pm.PackageManager;
  5. import android.content.pm.PackageManager.NameNotFoundException;
  6. import android.content.pm.PermissionInfo;
  8. public class SigPerm {
  10.     public static boolean test(Context ctx, String sigPermName, String correctHash) {
  11.         if (correctHash == null) return false;
  12.         correctHash = correctHash.replaceAll(" ", "");
  13.         return correctHash.equals(hash(ctx, sigPermName));
  14.     }
  16.     public static String hash(Context ctx, String sigPermName) {
  17.         if (sigPermName == null) return null;
  18.         try {
  19.             // Get the package name of the application which declares a permission named sigPermName.
  20.             PackageManager pm = ctx.getPackageManager();
  21.             PermissionInfo pi;
  22.             pi = pm.getPermissionInfo(sigPermName, PackageManager.GET_META_DATA);
  23.             String pkgname = pi.packageName;
  24.             // Fail if the permission named sigPermName is not a Signature Permission
  25.             if (pi.protectionLevel != PermissionInfo.PROTECTION_SIGNATURE) return null;
  26.             // Return the certificate hash value of the application which declares a permission named sigPermName.
  27.             return PkgCert.hash(ctx, pkgname);
  28.         } catch (NameNotFoundException e) {
  29.             return null;
  30.         }
  31.     }
  32. }

PkgCert.java

  1. package org.jssec.android.shared;
  3. import java.security.MessageDigest;
  4. import java.security.NoSuchAlgorithmException;
  5. import android.content.Context;
  6. import android.content.pm.PackageInfo;
  7. import android.content.pm.PackageManager;
  8. import android.content.pm.PackageManager.NameNotFoundException;
  9. import android.content.pm.Signature;
  11. public class PkgCert {
  13.     public static boolean test(Context ctx, String pkgname, String correctHash) {
  14.         if (correctHash == null) return false;
  15.         correctHash = correctHash.replaceAll(" ", "");
  16.         return correctHash.equals(hash(ctx, pkgname));
  17.     }
  19.     public static String hash(Context ctx, String pkgname) {
  20.         if (pkgname == null) return null;
  21.         try {
  22.             PackageManager pm = ctx.getPackageManager();
  23.             PackageInfo pkginfo = pm.getPackageInfo(pkgname, PackageManager.GET_SIGNATURES);
  24.             if (pkginfo.signatures.length != 1) return null; // Will not handle multiple signatures.
  25.             Signature sig = pkginfo.signatures[0];
  26.             byte[] cert = sig.toByteArray();
  27.             byte[] sha256 = computeSha256(cert);
  28.             return byte2hex(sha256);
  29.         } catch (NameNotFoundException e) {
  30.             return null;
  31.         }
  32.     }
  34.     private static byte[] computeSha256(byte[] data) {
  35.         try {
  36.             return MessageDigest.getInstance("SHA-256").digest(data);
  37.         } catch (NoSuchAlgorithmException e) {
  38.             return null;
  39.         }
  40.     }
  42.     private static String byte2hex(byte[] data) {
  43.         if (data == null) return null;
  44.         final StringBuilder hexadecimal = new StringBuilder();
  45.         for (final byte b : data) {
  46.             hexadecimal.append(String.format("%02X", b));
  47.         }
  48.         return hexadecimal.toString();
  49.     }
  50. }

导出 APK 时，使用与发送应用相同的开发人员密钥对 APK 进行签名。

4.2.1.3.md - 图1

下面，展示了用于向内部广播接收器发送广播的示例代码。

要点（发送广播）：

  1. 定义内部签名权限来接收结果。

  2. 声明使用内部签名权限来接收广播。

  3. 确认内部签名权限是由内部应用定义的。

  4. 由于请求应用是内部应用，因此可以返回敏感信息。

  5. 需要接收器的内部签名权限。

  6. 小心并安全地处理收到的结果数据。

  7. 导出 APK 时，请使用与目标应用相同的开发人员密钥对 APK 进行签名。

AndroidManifest.xml

  1. <?xml version="1.0" encoding="utf-8"?>
  2. <manifest xmlns:android="http://schemas.android.com/apk/res/android"
  3.     package="org.jssec.android.broadcast.inhousesender" >
  5.     <uses-permission android:name="android.permission.BROADCAST_STICKY"/>
  7.     <!-- *** POINT 10 *** Define an in-house signature permission to receive results. -->
  8.     <permission
  9.     android:name="org.jssec.android.broadcast.inhousesender.MY_PERMISSION"
  10.     android:protectionLevel="signature" />
  12.     <!-- *** POINT 11 *** Declare to use the in-house signature permission to receive Broadcasts. -->
  13.     <uses-permission
  14.     android:name="org.jssec.android.broadcast.inhousereceiver.MY_PERMISSION" />
  16.     <application
  17.         android:icon="@drawable/ic_launcher"
  18.         android:label="@string/app_name"
  19.         android:allowBackup="false" >
  20.         <activity
  21.             android:name="org.jssec.android.broadcast.inhousesender.InhouseSenderActivity"
  22.             android:label="@string/app_name"
  23.             android:exported="true" >
  24.             <intent-filter>
  25.                 <action android:name="android.intent.action.MAIN" />
  26.                 <category android:name="android.intent.category.LAUNCHER" />
  27.             </intent-filter>
  28.         </activity>
  29.     </application>
  30. </manifest>

InhouseSenderActivity.java

  1. package org.jssec.android.broadcast.inhousesender;
  3. import org.jssec.android.shared.SigPerm;
  4. import org.jssec.android.shared.Utils;
  5. import android.app.Activity;
  6. import android.content.BroadcastReceiver;
  7. import android.content.Context;
  8. import android.content.Intent;
  9. import android.os.Bundle;
  10. import android.view.View;
  11. import android.widget.TextView;
  12. import android.widget.Toast;
  14. public class InhouseSenderActivity extends Activity {
  16.     // In-house Signature Permission
  17.     private static final String MY_PERMISSION = "org.jssec.android.broadcast.inhousesender.MY_PERMISSION";
  18.     // In-house certificate hash value
  19.     private static String sMyCertHash = null;
  21.     private static String myCertHash(Context context) {
  22.         if (sMyCertHash == null) {
  23.             if (Utils.isDebuggable(context)) {
  24.                 // Certificate hash value of "androiddebugkey" in the debug.keystore.
  25.                 sMyCertHash = "0EFB7236 328348A9 89718BAD DF57F544 D5CCB4AE B9DB34BC 1E29DD26 F77C8255";
  26.             } else {
  27.                 // Certificate hash value of "my company key" in the keystore.
  28.                 sMyCertHash = "D397D343 A5CBC10F 4EDDEB7C A10062DE 5690984F 1FB9E88B D7B3A7C2 42E142CA";
  29.             }
  30.         }
  31.         return sMyCertHash;
  32.     }
  34.     private static final String MY_BROADCAST_INHOUSE =
  35.     "org.jssec.android.broadcast.MY_BROADCAST_INHOUSE";
  37.     public void onSendNormalClick(View view) {
  38.         // *** POINT 12 *** Verify that the in-house signature permission is defined by an in-house application.
  39.         if (!SigPerm.test(this, MY_PERMISSION, myCertHash(this))) {
  40.             Toast.makeText(this, "The in-house signature permission is not declared by in-house application.",
  41.             Toast.LENGTH_LONG).show();
  42.             return;
  43.         }
  44.         // *** POINT 13 *** Sensitive information can be returned since the requesting application is in-house.
  45.         Intent intent = new Intent(MY_BROADCAST_INHOUSE);
  46.         intent.putExtra("PARAM", "Sensitive Info from Sender");
  47.         // *** POINT 14 *** Require the in-house signature permission to limit receivers.
  48.         sendBroadcast(intent, "org.jssec.android.broadcast.inhousesender.MY_PERMISSION");
  49.     }
  51.     public void onSendOrderedClick(View view) {
  52.         // *** POINT 12 *** Verify that the in-house signature permission is defined by an in-house application.
  53.         if (!SigPerm.test(this, MY_PERMISSION, myCertHash(this))) {
  54.             Toast.makeText(this, "The in-house signature permission is not declared by in-house application.",
  55.             Toast.LENGTH_LONG).show();
  56.             return;
  57.         }
  58.         // *** POINT 13 *** Sensitive information can be returned since the requesting application is in-house.
  59.         Intent intent = new Intent(MY_BROADCAST_INHOUSE);
  60.         intent.putExtra("PARAM", "Sensitive Info from Sender");
  61.         // *** POINT 14 *** Require the in-house signature permission to limit receivers.
  62.         sendOrderedBroadcast(intent, "org.jssec.android.broadcast.inhousesender.MY_PERMISSION",
  63.         mResultReceiver, null, 0, null, null);
  64.     }
  66.     private BroadcastReceiver mResultReceiver = new BroadcastReceiver() {
  68.         @Override
  69.         public void onReceive(Context context, Intent intent) {
  70.             // *** POINT 15 *** Handle the received result data carefully and securely,
  71.             // even though the data came from an in-house application.
  72.             // Omitted, since this is a sample. Please refer to "3.2 Handling Input Data Carefully and Securely."
  73.             String data = getResultData();
  74.             InhouseSenderActivity.this.logLine(String.format("Received result: ¥"%s¥"", data));
  75.         }
  76.     };
  78.     private TextView mLogView;
  80.     @Override
  81.     public void onCreate(Bundle savedInstanceState) {
  82.         super.onCreate(savedInstanceState);
  83.         setContentView(R.layout.main);
  84.         mLogView = (TextView)findViewById(R.id.logview);
  85.     }
  87.     private void logLine(String line) {
  88.         mLogView.append(line);
  89.         mLogView.append("¥n");
  90.     }
  91. }

SigPerm.java

  1. package org.jssec.android.shared;
  3. import android.content.Context;
  4. import android.content.pm.PackageManager;
  5. import android.content.pm.PackageManager.NameNotFoundException;
  6. import android.content.pm.PermissionInfo;
  8. public class SigPerm {
  10.     public static boolean test(Context ctx, String sigPermName, String correctHash) {
  11.         if (correctHash == null) return false;
  12.         correctHash = correctHash.replaceAll(" ", "");
  13.         return correctHash.equals(hash(ctx, sigPermName));
  14.     }
  16.     public static String hash(Context ctx, String sigPermName) {
  17.         if (sigPermName == null) return null;
  18.         try {
  19.             // Get the package name of the application which declares a permission named sigPermName.
  20.             PackageManager pm = ctx.getPackageManager();
  21.             PermissionInfo pi;
  22.             pi = pm.getPermissionInfo(sigPermName, PackageManager.GET_META_DATA);
  23.             String pkgname = pi.packageName;
  24.             // Fail if the permission named sigPermName is not a Signature Permission
  25.             if (pi.protectionLevel != PermissionInfo.PROTECTION_SIGNATURE) return null;
  26.             // Return the certificate hash value of the application which declares a permission named sigPermName.
  27.             return PkgCert.hash(ctx, pkgname);
  28.         } catch (NameNotFoundException e) {
  29.             return null;
  30.         }
  31.     }
  32. }

PkgCert.java

  1. package org.jssec.android.shared;
  3. import java.security.MessageDigest;
  4. import java.security.NoSuchAlgorithmException;
  5. import android.content.Context;
  6. import android.content.pm.PackageInfo;
  7. import android.content.pm.PackageManager;
  8. import android.content.pm.PackageManager.NameNotFoundException;
  9. import android.content.pm.Signature;
  11. public class PkgCert {
  13.     public static boolean test(Context ctx, String pkgname, String correctHash) {
  14.         if (correctHash == null) return false;
  15.         correctHash = correctHash.replaceAll(" ", "");
  16.         return correctHash.equals(hash(ctx, pkgname));
  17.     }
  19.     public static String hash(Context ctx, String pkgname) {
  20.     if (pkgname == null) return null;
  21.         try {
  22.             PackageManager pm = ctx.getPackageManager();
  23.             PackageInfo pkginfo = pm.getPackageInfo(pkgname, PackageManager.GET_SIGNATURES);
  24.             if (pkginfo.signatures.length != 1) return null; // Will not handle multiple signatures.
  25.             Signature sig = pkginfo.signatures[0];
  26.             byte[] cert = sig.toByteArray();
  27.             byte[] sha256 = computeSha256(cert);
  28.             return byte2hex(sha256);
  29.         } catch (NameNotFoundException e) {
  30.             return null;
  31.         }
  32.     }
  34.     private static byte[] computeSha256(byte[] data) {
  35.         try {
  36.             return MessageDigest.getInstance("SHA-256").digest(data);
  37.         } catch (NoSuchAlgorithmException e) {
  38.             return null;
  39.         }
  40.     }
  42.     private static String byte2hex(byte[] data) {
  43.         if (data == null) return null;
  44.         final StringBuilder hexadecimal = new StringBuilder();
  45.         for (final byte b : data) {
  46.             hexadecimal.append(String.format("%02X", b));
  47.         }
  48.         return hexadecimal.toString();
  49.     }
  50. }

导出 APK 时，使用与发送应用相同的开发人员密钥对 APK 进行签名。

4.2.1.3.md - 图2