summaryrefslogtreecommitdiff
path: root/keystore/java/android/security/AppUriAuthenticationPolicy.java
diff options
context:
space:
mode:
Diffstat (limited to 'keystore/java/android/security/AppUriAuthenticationPolicy.java')
-rw-r--r--keystore/java/android/security/AppUriAuthenticationPolicy.java9
1 files changed, 9 insertions, 0 deletions
diff --git a/keystore/java/android/security/AppUriAuthenticationPolicy.java b/keystore/java/android/security/AppUriAuthenticationPolicy.java
index df79912128fe..b3a89710cb06 100644
--- a/keystore/java/android/security/AppUriAuthenticationPolicy.java
+++ b/keystore/java/android/security/AppUriAuthenticationPolicy.java
@@ -18,6 +18,7 @@ package android.security;
import android.annotation.NonNull;
import android.annotation.Nullable;
+import android.app.Activity;
import android.net.Uri;
import android.os.Parcel;
import android.os.Parcelable;
@@ -27,6 +28,7 @@ import org.xmlpull.v1.XmlPullParserException;
import org.xmlpull.v1.XmlSerializer;
import java.io.IOException;
+import java.security.Principal;
import java.util.HashMap;
import java.util.HashSet;
import java.util.Map;
@@ -89,6 +91,13 @@ public final class AppUriAuthenticationPolicy implements Parcelable {
* <p>
* If this method is called with a package name and URI that was previously added, the
* previous alias will be overwritten.
+ * <p>
+ * When the system tries to determine which alias to return to a requesting app calling
+ * {@code KeyChain.choosePrivateKeyAlias}, it will choose the alias whose associated URI
+ * exactly matches the URI provided in {@link KeyChain#choosePrivateKeyAlias(
+ * Activity, KeyChainAliasCallback, String[], Principal[], Uri, String)} or the URI
+ * built from the host and port provided in {@link KeyChain#choosePrivateKeyAlias(
+ * Activity, KeyChainAliasCallback, String[], Principal[], String, int, String)}.
*
* @param appPackageName The app's package name to authenticate the user to.
* @param uri The URI to authenticate the user to.