1 | /* |
---|
2 | Tibisay Movil |
---|
3 | |
---|
4 | Copyright (C) 2013 Antonio Araujo (aaraujo@cenditel.gob.ve), Jose Ruiz |
---|
5 | (jruiz@cenditel.gob.ve), Fundacion Centro Nacional de Desarrollo e |
---|
6 | Investigacion en Tecnologias Libres - CENDITEL. |
---|
7 | |
---|
8 | La Fundación CENDITEL concede permiso para usar, copiar, distribuir y/o |
---|
9 | modificar este programa, reconociendo el derecho que la humanidad posee al |
---|
10 | libre acceso al conocimiento, bajo los términos de la licencia de software |
---|
11 | GPL versión 2.0 de la Free Software Foundation. |
---|
12 | |
---|
13 | Este programa se distribuye con la esperanza de que sea util, pero SIN |
---|
14 | NINGUNA GARANTIA; tampoco las implicitas garantias de MERCANTILIDAD o |
---|
15 | ADECUACION A UN PROPOSITO PARTICULAR. |
---|
16 | |
---|
17 | Para mayor información sobre los términos de la licencia ver el archivo |
---|
18 | llamado "gpl-2.0.txt" en ingles. |
---|
19 | */ |
---|
20 | |
---|
21 | package ve.gob.cenditel.tibisaymovil; |
---|
22 | |
---|
23 | import java.io.Serializable; |
---|
24 | import java.security.PrivateKey; |
---|
25 | import java.security.cert.X509Certificate; |
---|
26 | |
---|
27 | import android.os.Build; |
---|
28 | import android.os.Build.VERSION_CODES; |
---|
29 | |
---|
30 | /** |
---|
31 | * Accesses the KeyChain in a unified way both in Android versions post and pre 4.0. Android 4.0 and later has an |
---|
32 | * operating system level keychain. This keychain is shared across the operating system and all applications. In prior |
---|
33 | * versions a custom, application private keychain will be used. |
---|
34 | * |
---|
35 | * @author José M. Prieto (jmprieto@emergya.com) |
---|
36 | */ |
---|
37 | public abstract class KeyChainStrategy implements Serializable { |
---|
38 | |
---|
39 | private static final long serialVersionUID = -5156264665372692833L; |
---|
40 | protected static KeyChainStrategy theInstance = null; |
---|
41 | |
---|
42 | protected static KeyChainClientActivity activity; |
---|
43 | |
---|
44 | public static KeyChainStrategy getInstance() { |
---|
45 | |
---|
46 | if (theInstance == null) { |
---|
47 | if (Build.VERSION.SDK_INT < VERSION_CODES.ICE_CREAM_SANDWICH) { |
---|
48 | // < Android 4.0. Does not have KeyChain API |
---|
49 | return CustomKeyChain.getInstance(); |
---|
50 | } else { |
---|
51 | // >= Android 4.0. KeyChain available! |
---|
52 | return AndroidKeyChain.getInstance(); |
---|
53 | } |
---|
54 | } |
---|
55 | return theInstance; |
---|
56 | } |
---|
57 | |
---|
58 | /** |
---|
59 | * Set the KeyChainClientActivity that will be notified of the alias selected by the user. The notification is done |
---|
60 | * via the {@link KeyChainClientActivity#setAlias(String)} callback. |
---|
61 | * |
---|
62 | * @param activity the receiver of notifications |
---|
63 | */ |
---|
64 | public void setClientActivity(KeyChainClientActivity activity) { |
---|
65 | KeyChainStrategy.activity = activity; |
---|
66 | } |
---|
67 | |
---|
68 | /** |
---|
69 | * Launches an Activity for the user to select the alias for a private key and certificate pair for authentication. |
---|
70 | * The selected alias or null will be returned to the {@link KeyChainClientActivity} passed to the previous call to |
---|
71 | * {@link #setClientActivity(KeyChainClientActivity)} via the |
---|
72 | * {@link KeyChainClientActivity#setAlias(String)} callback. |
---|
73 | */ |
---|
74 | public abstract void choosePrivateKeyAlias(); |
---|
75 | |
---|
76 | |
---|
77 | /** |
---|
78 | * Same as before, but only to modify alias list. |
---|
79 | */ |
---|
80 | public abstract void choosePrivateKeyList(); |
---|
81 | |
---|
82 | |
---|
83 | /** |
---|
84 | * Get a certificate chain from the keystore. |
---|
85 | * This method requires the caller to hold the permission USE_CREDENTIALS on Android >= 4.0. |
---|
86 | * |
---|
87 | * @param alias The alias of the desired certificate chain |
---|
88 | * @return the X509Certificate chain for the requested alias, or null if no there is no result |
---|
89 | * @throws InterruptedException if the operation has been interrupted before completion |
---|
90 | * @throws KeystoreException when there is some error accessing the keystore |
---|
91 | */ |
---|
92 | public abstract X509Certificate[] getCertificateChain(String alias) |
---|
93 | throws InterruptedException, KeystoreException; |
---|
94 | |
---|
95 | /** |
---|
96 | * Get a private key from the keystore. |
---|
97 | * |
---|
98 | * @param alias the alias of the desired private key |
---|
99 | * @return the PrivateKey for the requested alias, or null if no there is no result |
---|
100 | * @throws InterruptedException if the operation has been interrupted before completion |
---|
101 | * @throws KeystoreException when there is some error accessing the keystore |
---|
102 | */ |
---|
103 | public abstract PrivateKey getPrivateKey(String alias) |
---|
104 | throws InterruptedException, KeystoreException; |
---|
105 | |
---|
106 | |
---|
107 | |
---|
108 | |
---|
109 | /** |
---|
110 | * Delete a certificate from the keystore. |
---|
111 | * |
---|
112 | * @param alias the alias of the certificate chain to delete |
---|
113 | * @throws InterruptedException if the operation has been interrupted before completion |
---|
114 | * @throws KeystoreException when there is some error accessing the keystore |
---|
115 | */ |
---|
116 | public abstract int deleteCertificate(String alias) |
---|
117 | throws InterruptedException, KeystoreException; |
---|
118 | |
---|
119 | |
---|
120 | |
---|
121 | } |
---|