/* * Copyright (C) 2013 The Android Open Source Project * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ package android.nfc.cardemulation; import android.annotation.Nullable; import android.compat.annotation.UnsupportedAppUsage; import android.content.ComponentName; import android.content.pm.PackageManager; import android.content.pm.PackageManager.NameNotFoundException; import android.content.pm.ResolveInfo; import android.content.pm.ServiceInfo; import android.content.res.Resources; import android.content.res.Resources.NotFoundException; import android.content.res.TypedArray; import android.content.res.XmlResourceParser; import android.graphics.drawable.Drawable; import android.os.Parcel; import android.os.Parcelable; import android.util.AttributeSet; import android.util.Log; import android.util.Xml; import android.util.proto.ProtoOutputStream; import org.xmlpull.v1.XmlPullParser; import org.xmlpull.v1.XmlPullParserException; import java.io.FileDescriptor; import java.io.IOException; import java.io.PrintWriter; import java.util.ArrayList; import java.util.HashMap; import java.util.List; import java.util.Map; /** * @hide */ public final class ApduServiceInfo implements Parcelable { static final String TAG = "ApduServiceInfo"; /** * The service that implements this */ @UnsupportedAppUsage final ResolveInfo mService; /** * Description of the service */ final String mDescription; /** * Whether this service represents AIDs running on the host CPU */ final boolean mOnHost; /** * Offhost reader name. * eg: SIM, eSE etc */ String mOffHostName; /** * Offhost reader name from manifest file. * Used for unsetOffHostSecureElement() */ final String mStaticOffHostName; /** * Mapping from category to static AID group */ @UnsupportedAppUsage final HashMap mStaticAidGroups; /** * Mapping from category to dynamic AID group */ @UnsupportedAppUsage final HashMap mDynamicAidGroups; /** * Whether this service should only be started when the device is unlocked. */ final boolean mRequiresDeviceUnlock; /** * Whether this service should only be started when the device is screen on. */ final boolean mRequiresDeviceScreenOn; /** * The id of the service banner specified in XML. */ final int mBannerResourceId; /** * The uid of the package the service belongs to */ final int mUid; /** * Settings Activity for this service */ final String mSettingsActivityName; /** * @hide */ @UnsupportedAppUsage public ApduServiceInfo(ResolveInfo info, boolean onHost, String description, ArrayList staticAidGroups, ArrayList dynamicAidGroups, boolean requiresUnlock, int bannerResource, int uid, String settingsActivityName, String offHost, String staticOffHost) { this(info, onHost, description, staticAidGroups, dynamicAidGroups, requiresUnlock, onHost ? true : false, bannerResource, uid, settingsActivityName, offHost, staticOffHost); } /** * @hide */ public ApduServiceInfo(ResolveInfo info, boolean onHost, String description, ArrayList staticAidGroups, ArrayList dynamicAidGroups, boolean requiresUnlock, boolean requiresScreenOn, int bannerResource, int uid, String settingsActivityName, String offHost, String staticOffHost) { this.mService = info; this.mDescription = description; this.mStaticAidGroups = new HashMap(); this.mDynamicAidGroups = new HashMap(); this.mOffHostName = offHost; this.mStaticOffHostName = staticOffHost; this.mOnHost = onHost; this.mRequiresDeviceUnlock = requiresUnlock; this.mRequiresDeviceScreenOn = requiresScreenOn; for (AidGroup aidGroup : staticAidGroups) { this.mStaticAidGroups.put(aidGroup.category, aidGroup); } for (AidGroup aidGroup : dynamicAidGroups) { this.mDynamicAidGroups.put(aidGroup.category, aidGroup); } this.mBannerResourceId = bannerResource; this.mUid = uid; this.mSettingsActivityName = settingsActivityName; } @UnsupportedAppUsage public ApduServiceInfo(PackageManager pm, ResolveInfo info, boolean onHost) throws XmlPullParserException, IOException { ServiceInfo si = info.serviceInfo; XmlResourceParser parser = null; try { if (onHost) { parser = si.loadXmlMetaData(pm, HostApduService.SERVICE_META_DATA); if (parser == null) { throw new XmlPullParserException("No " + HostApduService.SERVICE_META_DATA + " meta-data"); } } else { parser = si.loadXmlMetaData(pm, OffHostApduService.SERVICE_META_DATA); if (parser == null) { throw new XmlPullParserException("No " + OffHostApduService.SERVICE_META_DATA + " meta-data"); } } int eventType = parser.getEventType(); while (eventType != XmlPullParser.START_TAG && eventType != XmlPullParser.END_DOCUMENT) { eventType = parser.next(); } String tagName = parser.getName(); if (onHost && !"host-apdu-service".equals(tagName)) { throw new XmlPullParserException( "Meta-data does not start with tag"); } else if (!onHost && !"offhost-apdu-service".equals(tagName)) { throw new XmlPullParserException( "Meta-data does not start with tag"); } Resources res = pm.getResourcesForApplication(si.applicationInfo); AttributeSet attrs = Xml.asAttributeSet(parser); if (onHost) { TypedArray sa = res.obtainAttributes(attrs, com.android.internal.R.styleable.HostApduService); mService = info; mDescription = sa.getString( com.android.internal.R.styleable.HostApduService_description); mRequiresDeviceUnlock = sa.getBoolean( com.android.internal.R.styleable.HostApduService_requireDeviceUnlock, false); mRequiresDeviceScreenOn = sa.getBoolean( com.android.internal.R.styleable.HostApduService_requireDeviceScreenOn, true); mBannerResourceId = sa.getResourceId( com.android.internal.R.styleable.HostApduService_apduServiceBanner, -1); mSettingsActivityName = sa.getString( com.android.internal.R.styleable.HostApduService_settingsActivity); mOffHostName = null; mStaticOffHostName = mOffHostName; sa.recycle(); } else { TypedArray sa = res.obtainAttributes(attrs, com.android.internal.R.styleable.OffHostApduService); mService = info; mDescription = sa.getString( com.android.internal.R.styleable.OffHostApduService_description); mRequiresDeviceUnlock = sa.getBoolean( com.android.internal.R.styleable.OffHostApduService_requireDeviceUnlock, false); mRequiresDeviceScreenOn = sa.getBoolean( com.android.internal.R.styleable.OffHostApduService_requireDeviceScreenOn, false); mBannerResourceId = sa.getResourceId( com.android.internal.R.styleable.OffHostApduService_apduServiceBanner, -1); mSettingsActivityName = sa.getString( com.android.internal.R.styleable.HostApduService_settingsActivity); mOffHostName = sa.getString( com.android.internal.R.styleable.OffHostApduService_secureElementName); if (mOffHostName != null) { if (mOffHostName.equals("eSE")) { mOffHostName = "eSE1"; } else if (mOffHostName.equals("SIM")) { mOffHostName = "SIM1"; } } mStaticOffHostName = mOffHostName; sa.recycle(); } mStaticAidGroups = new HashMap(); mDynamicAidGroups = new HashMap(); mOnHost = onHost; final int depth = parser.getDepth(); AidGroup currentGroup = null; // Parsed values for the current AID group while (((eventType = parser.next()) != XmlPullParser.END_TAG || parser.getDepth() > depth) && eventType != XmlPullParser.END_DOCUMENT) { tagName = parser.getName(); if (eventType == XmlPullParser.START_TAG && "aid-group".equals(tagName) && currentGroup == null) { final TypedArray groupAttrs = res.obtainAttributes(attrs, com.android.internal.R.styleable.AidGroup); // Get category of AID group String groupCategory = groupAttrs.getString( com.android.internal.R.styleable.AidGroup_category); String groupDescription = groupAttrs.getString( com.android.internal.R.styleable.AidGroup_description); if (!CardEmulation.CATEGORY_PAYMENT.equals(groupCategory)) { groupCategory = CardEmulation.CATEGORY_OTHER; } currentGroup = mStaticAidGroups.get(groupCategory); if (currentGroup != null) { if (!CardEmulation.CATEGORY_OTHER.equals(groupCategory)) { Log.e(TAG, "Not allowing multiple aid-groups in the " + groupCategory + " category"); currentGroup = null; } } else { currentGroup = new AidGroup(groupCategory, groupDescription); } groupAttrs.recycle(); } else if (eventType == XmlPullParser.END_TAG && "aid-group".equals(tagName) && currentGroup != null) { if (currentGroup.aids.size() > 0) { if (!mStaticAidGroups.containsKey(currentGroup.category)) { mStaticAidGroups.put(currentGroup.category, currentGroup); } } else { Log.e(TAG, "Not adding with empty or invalid AIDs"); } currentGroup = null; } else if (eventType == XmlPullParser.START_TAG && "aid-filter".equals(tagName) && currentGroup != null) { final TypedArray a = res.obtainAttributes(attrs, com.android.internal.R.styleable.AidFilter); String aid = a.getString(com.android.internal.R.styleable.AidFilter_name). toUpperCase(); if (CardEmulation.isValidAid(aid) && !currentGroup.aids.contains(aid)) { currentGroup.aids.add(aid); } else { Log.e(TAG, "Ignoring invalid or duplicate aid: " + aid); } a.recycle(); } else if (eventType == XmlPullParser.START_TAG && "aid-prefix-filter".equals(tagName) && currentGroup != null) { final TypedArray a = res.obtainAttributes(attrs, com.android.internal.R.styleable.AidFilter); String aid = a.getString(com.android.internal.R.styleable.AidFilter_name). toUpperCase(); // Add wildcard char to indicate prefix aid = aid.concat("*"); if (CardEmulation.isValidAid(aid) && !currentGroup.aids.contains(aid)) { currentGroup.aids.add(aid); } else { Log.e(TAG, "Ignoring invalid or duplicate aid: " + aid); } a.recycle(); } else if (eventType == XmlPullParser.START_TAG && tagName.equals("aid-suffix-filter") && currentGroup != null) { final TypedArray a = res.obtainAttributes(attrs, com.android.internal.R.styleable.AidFilter); String aid = a.getString(com.android.internal.R.styleable.AidFilter_name). toUpperCase(); // Add wildcard char to indicate suffix aid = aid.concat("#"); if (CardEmulation.isValidAid(aid) && !currentGroup.aids.contains(aid)) { currentGroup.aids.add(aid); } else { Log.e(TAG, "Ignoring invalid or duplicate aid: " + aid); } a.recycle(); } } } catch (NameNotFoundException e) { throw new XmlPullParserException("Unable to create context for: " + si.packageName); } finally { if (parser != null) parser.close(); } // Set uid mUid = si.applicationInfo.uid; } public ComponentName getComponent() { return new ComponentName(mService.serviceInfo.packageName, mService.serviceInfo.name); } public String getOffHostSecureElement() { return mOffHostName; } /** * Returns a consolidated list of AIDs from the AID groups * registered by this service. Note that if a service has both * a static (manifest-based) AID group for a category and a dynamic * AID group, only the dynamically registered AIDs will be returned * for that category. * @return List of AIDs registered by the service */ public List getAids() { final ArrayList aids = new ArrayList(); for (AidGroup group : getAidGroups()) { aids.addAll(group.aids); } return aids; } public List getPrefixAids() { final ArrayList prefixAids = new ArrayList(); for (AidGroup group : getAidGroups()) { for (String aid : group.aids) { if (aid.endsWith("*")) { prefixAids.add(aid); } } } return prefixAids; } public List getSubsetAids() { final ArrayList subsetAids = new ArrayList(); for (AidGroup group : getAidGroups()) { for (String aid : group.aids) { if (aid.endsWith("#")) { subsetAids.add(aid); } } } return subsetAids; } /** * Returns the registered AID group for this category. */ public AidGroup getDynamicAidGroupForCategory(String category) { return mDynamicAidGroups.get(category); } public boolean removeDynamicAidGroupForCategory(String category) { return (mDynamicAidGroups.remove(category) != null); } /** * Returns a consolidated list of AID groups * registered by this service. Note that if a service has both * a static (manifest-based) AID group for a category and a dynamic * AID group, only the dynamically registered AID group will be returned * for that category. * @return List of AIDs registered by the service */ public ArrayList getAidGroups() { final ArrayList groups = new ArrayList(); for (Map.Entry entry : mDynamicAidGroups.entrySet()) { groups.add(entry.getValue()); } for (Map.Entry entry : mStaticAidGroups.entrySet()) { if (!mDynamicAidGroups.containsKey(entry.getKey())) { // Consolidate AID groups - don't return static ones // if a dynamic group exists for the category. groups.add(entry.getValue()); } } return groups; } /** * Returns the category to which this service has attributed the AID that is passed in, * or null if we don't know this AID. */ public String getCategoryForAid(String aid) { ArrayList groups = getAidGroups(); for (AidGroup group : groups) { if (group.aids.contains(aid.toUpperCase())) { return group.category; } } return null; } public boolean hasCategory(String category) { return (mStaticAidGroups.containsKey(category) || mDynamicAidGroups.containsKey(category)); } @UnsupportedAppUsage public boolean isOnHost() { return mOnHost; } @UnsupportedAppUsage public boolean requiresUnlock() { return mRequiresDeviceUnlock; } /** * Returns whether this service should only be started when the device is screen on. */ public boolean requiresScreenOn() { return mRequiresDeviceScreenOn; } @UnsupportedAppUsage public String getDescription() { return mDescription; } @UnsupportedAppUsage public int getUid() { return mUid; } public void setOrReplaceDynamicAidGroup(AidGroup aidGroup) { mDynamicAidGroups.put(aidGroup.getCategory(), aidGroup); } /** * Sets the off host Secure Element. * @param offHost Secure Element to set. Only accept strings with prefix SIM or prefix eSE. * Ref: GSMA TS.26 - NFC Handset Requirements * TS26_NFC_REQ_069: For UICC, Secure Element Name SHALL be SIM[smartcard slot] * (e.g. SIM/SIM1, SIM2… SIMn). * TS26_NFC_REQ_070: For embedded SE, Secure Element Name SHALL be eSE[number] * (e.g. eSE/eSE1, eSE2, etc.). */ public void setOffHostSecureElement(String offHost) { mOffHostName = offHost; } /** * Resets the off host Secure Element to statically defined * by the service in the manifest file. */ public void unsetOffHostSecureElement() { mOffHostName = mStaticOffHostName; } public CharSequence loadLabel(PackageManager pm) { return mService.loadLabel(pm); } public CharSequence loadAppLabel(PackageManager pm) { try { return pm.getApplicationLabel(pm.getApplicationInfo( mService.resolvePackageName, PackageManager.GET_META_DATA)); } catch (PackageManager.NameNotFoundException e) { return null; } } public Drawable loadIcon(PackageManager pm) { return mService.loadIcon(pm); } @UnsupportedAppUsage public Drawable loadBanner(PackageManager pm) { Resources res; try { res = pm.getResourcesForApplication(mService.serviceInfo.packageName); Drawable banner = res.getDrawable(mBannerResourceId); return banner; } catch (NotFoundException e) { Log.e(TAG, "Could not load banner."); return null; } catch (NameNotFoundException e) { Log.e(TAG, "Could not load banner."); return null; } } @UnsupportedAppUsage public String getSettingsActivityName() { return mSettingsActivityName; } @Override public String toString() { StringBuilder out = new StringBuilder("ApduService: "); out.append(getComponent()); out.append(", UID: " + mUid); out.append(", description: " + mDescription); out.append(", Static AID Groups: "); for (AidGroup aidGroup : mStaticAidGroups.values()) { out.append(aidGroup.toString()); } out.append(", Dynamic AID Groups: "); for (AidGroup aidGroup : mDynamicAidGroups.values()) { out.append(aidGroup.toString()); } return out.toString(); } @Override public boolean equals(@Nullable Object o) { if (this == o) return true; if (!(o instanceof ApduServiceInfo)) return false; ApduServiceInfo thatService = (ApduServiceInfo) o; return thatService.getComponent().equals(this.getComponent()) && thatService.getUid() == this.getUid(); } @Override public int hashCode() { return getComponent().hashCode(); } @Override public int describeContents() { return 0; } @Override public void writeToParcel(Parcel dest, int flags) { mService.writeToParcel(dest, flags); dest.writeString(mDescription); dest.writeInt(mOnHost ? 1 : 0); dest.writeString(mOffHostName); dest.writeString(mStaticOffHostName); dest.writeInt(mStaticAidGroups.size()); if (mStaticAidGroups.size() > 0) { dest.writeTypedList(new ArrayList(mStaticAidGroups.values())); } dest.writeInt(mDynamicAidGroups.size()); if (mDynamicAidGroups.size() > 0) { dest.writeTypedList(new ArrayList(mDynamicAidGroups.values())); } dest.writeInt(mRequiresDeviceUnlock ? 1 : 0); dest.writeInt(mRequiresDeviceScreenOn ? 1 : 0); dest.writeInt(mBannerResourceId); dest.writeInt(mUid); dest.writeString(mSettingsActivityName); }; @UnsupportedAppUsage public static final @android.annotation.NonNull Parcelable.Creator CREATOR = new Parcelable.Creator() { @Override public ApduServiceInfo createFromParcel(Parcel source) { ResolveInfo info = ResolveInfo.CREATOR.createFromParcel(source); String description = source.readString(); boolean onHost = source.readInt() != 0; String offHostName = source.readString(); String staticOffHostName = source.readString(); ArrayList staticAidGroups = new ArrayList(); int numStaticGroups = source.readInt(); if (numStaticGroups > 0) { source.readTypedList(staticAidGroups, AidGroup.CREATOR); } ArrayList dynamicAidGroups = new ArrayList(); int numDynamicGroups = source.readInt(); if (numDynamicGroups > 0) { source.readTypedList(dynamicAidGroups, AidGroup.CREATOR); } boolean requiresUnlock = source.readInt() != 0; boolean requiresScreenOn = source.readInt() != 0; int bannerResource = source.readInt(); int uid = source.readInt(); String settingsActivityName = source.readString(); return new ApduServiceInfo(info, onHost, description, staticAidGroups, dynamicAidGroups, requiresUnlock, requiresScreenOn, bannerResource, uid, settingsActivityName, offHostName, staticOffHostName); } @Override public ApduServiceInfo[] newArray(int size) { return new ApduServiceInfo[size]; } }; public void dump(FileDescriptor fd, PrintWriter pw, String[] args) { pw.println(" " + getComponent() + " (Description: " + getDescription() + ")" + " (UID: " + getUid() + ")"); if (mOnHost) { pw.println(" On Host Service"); } else { pw.println(" Off-host Service"); pw.println(" " + "Current off-host SE:" + mOffHostName + " static off-host SE:" + mStaticOffHostName); } pw.println(" Static AID groups:"); for (AidGroup group : mStaticAidGroups.values()) { pw.println(" Category: " + group.category); for (String aid : group.aids) { pw.println(" AID: " + aid); } } pw.println(" Dynamic AID groups:"); for (AidGroup group : mDynamicAidGroups.values()) { pw.println(" Category: " + group.category); for (String aid : group.aids) { pw.println(" AID: " + aid); } } pw.println(" Settings Activity: " + mSettingsActivityName); pw.println(" Requires Device Unlock: " + mRequiresDeviceUnlock); pw.println(" Requires Device ScreenOn: " + mRequiresDeviceScreenOn); } /** * Dump debugging info as ApduServiceInfoProto * * If the output belongs to a sub message, the caller is responsible for wrapping this function * between {@link ProtoOutputStream#start(long)} and {@link ProtoOutputStream#end(long)}. * See proto definition in frameworks/base/core/proto/android/nfc/apdu_service_info.proto * * @param proto the ProtoOutputStream to write to */ public void dumpDebug(ProtoOutputStream proto) { Utils.dumpDebugComponentName(getComponent(), proto, ApduServiceInfoProto.COMPONENT_NAME); proto.write(ApduServiceInfoProto.DESCRIPTION, getDescription()); proto.write(ApduServiceInfoProto.ON_HOST, mOnHost); if (!mOnHost) { proto.write(ApduServiceInfoProto.OFF_HOST_NAME, mOffHostName); proto.write(ApduServiceInfoProto.STATIC_OFF_HOST_NAME, mStaticOffHostName); } for (AidGroup group : mStaticAidGroups.values()) { long token = proto.start(ApduServiceInfoProto.STATIC_AID_GROUPS); group.dump(proto); proto.end(token); } for (AidGroup group : mDynamicAidGroups.values()) { long token = proto.start(ApduServiceInfoProto.STATIC_AID_GROUPS); group.dump(proto); proto.end(token); } proto.write(ApduServiceInfoProto.SETTINGS_ACTIVITY_NAME, mSettingsActivityName); } }