jdk/src/windows/classes/sun/security/mscapi/KeyStore.java
author jjg
Mon, 15 Aug 2011 11:48:20 -0700
changeset 10336 0bb1999251f8
parent 9508 310b4f6c8e61
child 23582 d5fa3327ab3a
permissions -rw-r--r--
7064075: Security libraries don't build with javac -Xlint:all,-deprecation -Werror Reviewed-by: xuelei, mullan Contributed-by: alexandre.boulgakov@oracle.com
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
     1
/*
9508
310b4f6c8e61 6732372: Some MSCAPI native methods not returning correct exceptions.
vinnie
parents: 5506
diff changeset
     2
 * Copyright (c) 2005, 2011, Oracle and/or its affiliates. All rights reserved.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
     3
 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
90ce3da70b43 Initial load
duke
parents:
diff changeset
     4
 *
90ce3da70b43 Initial load
duke
parents:
diff changeset
     5
 * This code is free software; you can redistribute it and/or modify it
90ce3da70b43 Initial load
duke
parents:
diff changeset
     6
 * under the terms of the GNU General Public License version 2 only, as
5506
202f599c92aa 6943119: Rebrand source copyright notices
ohair
parents: 2
diff changeset
     7
 * published by the Free Software Foundation.  Oracle designates this
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
     8
 * particular file as subject to the "Classpath" exception as provided
5506
202f599c92aa 6943119: Rebrand source copyright notices
ohair
parents: 2
diff changeset
     9
 * by Oracle in the LICENSE file that accompanied this code.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
    10
 *
90ce3da70b43 Initial load
duke
parents:
diff changeset
    11
 * This code is distributed in the hope that it will be useful, but WITHOUT
90ce3da70b43 Initial load
duke
parents:
diff changeset
    12
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
90ce3da70b43 Initial load
duke
parents:
diff changeset
    13
 * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
90ce3da70b43 Initial load
duke
parents:
diff changeset
    14
 * version 2 for more details (a copy is included in the LICENSE file that
90ce3da70b43 Initial load
duke
parents:
diff changeset
    15
 * accompanied this code).
90ce3da70b43 Initial load
duke
parents:
diff changeset
    16
 *
90ce3da70b43 Initial load
duke
parents:
diff changeset
    17
 * You should have received a copy of the GNU General Public License version
90ce3da70b43 Initial load
duke
parents:
diff changeset
    18
 * 2 along with this work; if not, write to the Free Software Foundation,
90ce3da70b43 Initial load
duke
parents:
diff changeset
    19
 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
90ce3da70b43 Initial load
duke
parents:
diff changeset
    20
 *
5506
202f599c92aa 6943119: Rebrand source copyright notices
ohair
parents: 2
diff changeset
    21
 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
202f599c92aa 6943119: Rebrand source copyright notices
ohair
parents: 2
diff changeset
    22
 * or visit www.oracle.com if you need additional information or have any
202f599c92aa 6943119: Rebrand source copyright notices
ohair
parents: 2
diff changeset
    23
 * questions.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
    24
 */
90ce3da70b43 Initial load
duke
parents:
diff changeset
    25
90ce3da70b43 Initial load
duke
parents:
diff changeset
    26
package sun.security.mscapi;
90ce3da70b43 Initial load
duke
parents:
diff changeset
    27
90ce3da70b43 Initial load
duke
parents:
diff changeset
    28
import java.io.ByteArrayInputStream;
90ce3da70b43 Initial load
duke
parents:
diff changeset
    29
import java.io.IOException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
    30
import java.io.InputStream;
90ce3da70b43 Initial load
duke
parents:
diff changeset
    31
import java.io.OutputStream;
90ce3da70b43 Initial load
duke
parents:
diff changeset
    32
import java.security.AccessController;
9508
310b4f6c8e61 6732372: Some MSCAPI native methods not returning correct exceptions.
vinnie
parents: 5506
diff changeset
    33
import java.security.InvalidKeyException;
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
    34
import java.security.KeyStoreSpi;
90ce3da70b43 Initial load
duke
parents:
diff changeset
    35
import java.security.KeyStoreException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
    36
import java.security.UnrecoverableKeyException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
    37
import java.security.NoSuchAlgorithmException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
    38
import java.security.SecurityPermission;
90ce3da70b43 Initial load
duke
parents:
diff changeset
    39
import java.security.cert.X509Certificate;
90ce3da70b43 Initial load
duke
parents:
diff changeset
    40
import java.security.cert.Certificate;
90ce3da70b43 Initial load
duke
parents:
diff changeset
    41
import java.security.cert.CertificateException;
90ce3da70b43 Initial load
duke
parents:
diff changeset
    42
import java.security.cert.CertificateFactory;
90ce3da70b43 Initial load
duke
parents:
diff changeset
    43
import java.security.interfaces.RSAPrivateCrtKey;
90ce3da70b43 Initial load
duke
parents:
diff changeset
    44
import java.util.ArrayList;
90ce3da70b43 Initial load
duke
parents:
diff changeset
    45
import java.util.Collection;
90ce3da70b43 Initial load
duke
parents:
diff changeset
    46
import java.util.Date;
90ce3da70b43 Initial load
duke
parents:
diff changeset
    47
import java.util.Enumeration;
90ce3da70b43 Initial load
duke
parents:
diff changeset
    48
import java.util.Iterator;
90ce3da70b43 Initial load
duke
parents:
diff changeset
    49
import java.util.UUID;
90ce3da70b43 Initial load
duke
parents:
diff changeset
    50
90ce3da70b43 Initial load
duke
parents:
diff changeset
    51
import sun.security.action.GetPropertyAction;
90ce3da70b43 Initial load
duke
parents:
diff changeset
    52
90ce3da70b43 Initial load
duke
parents:
diff changeset
    53
/**
90ce3da70b43 Initial load
duke
parents:
diff changeset
    54
 * Implementation of key store for Windows using the Microsoft Crypto API.
90ce3da70b43 Initial load
duke
parents:
diff changeset
    55
 *
90ce3da70b43 Initial load
duke
parents:
diff changeset
    56
 * @since 1.6
90ce3da70b43 Initial load
duke
parents:
diff changeset
    57
 */
90ce3da70b43 Initial load
duke
parents:
diff changeset
    58
abstract class KeyStore extends KeyStoreSpi {
90ce3da70b43 Initial load
duke
parents:
diff changeset
    59
90ce3da70b43 Initial load
duke
parents:
diff changeset
    60
    public static final class MY extends KeyStore {
90ce3da70b43 Initial load
duke
parents:
diff changeset
    61
        public MY() {
90ce3da70b43 Initial load
duke
parents:
diff changeset
    62
            super("MY");
90ce3da70b43 Initial load
duke
parents:
diff changeset
    63
        }
90ce3da70b43 Initial load
duke
parents:
diff changeset
    64
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
    65
90ce3da70b43 Initial load
duke
parents:
diff changeset
    66
    public static final class ROOT extends KeyStore {
90ce3da70b43 Initial load
duke
parents:
diff changeset
    67
        public ROOT() {
90ce3da70b43 Initial load
duke
parents:
diff changeset
    68
            super("ROOT");
90ce3da70b43 Initial load
duke
parents:
diff changeset
    69
        }
90ce3da70b43 Initial load
duke
parents:
diff changeset
    70
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
    71
90ce3da70b43 Initial load
duke
parents:
diff changeset
    72
    class KeyEntry
90ce3da70b43 Initial load
duke
parents:
diff changeset
    73
    {
90ce3da70b43 Initial load
duke
parents:
diff changeset
    74
        private Key privateKey;
90ce3da70b43 Initial load
duke
parents:
diff changeset
    75
        private X509Certificate certChain[];
90ce3da70b43 Initial load
duke
parents:
diff changeset
    76
        private String alias;
90ce3da70b43 Initial load
duke
parents:
diff changeset
    77
90ce3da70b43 Initial load
duke
parents:
diff changeset
    78
        KeyEntry(Key key, X509Certificate[] chain) {
90ce3da70b43 Initial load
duke
parents:
diff changeset
    79
            this(null, key, chain);
90ce3da70b43 Initial load
duke
parents:
diff changeset
    80
        }
90ce3da70b43 Initial load
duke
parents:
diff changeset
    81
90ce3da70b43 Initial load
duke
parents:
diff changeset
    82
        KeyEntry(String alias, Key key, X509Certificate[] chain) {
90ce3da70b43 Initial load
duke
parents:
diff changeset
    83
            this.privateKey = key;
90ce3da70b43 Initial load
duke
parents:
diff changeset
    84
            this.certChain = chain;
90ce3da70b43 Initial load
duke
parents:
diff changeset
    85
            /*
90ce3da70b43 Initial load
duke
parents:
diff changeset
    86
             * The default alias for both entry types is derived from a
90ce3da70b43 Initial load
duke
parents:
diff changeset
    87
             * hash value intrinsic to the first certificate in the chain.
90ce3da70b43 Initial load
duke
parents:
diff changeset
    88
             */
90ce3da70b43 Initial load
duke
parents:
diff changeset
    89
             if (alias == null) {
90ce3da70b43 Initial load
duke
parents:
diff changeset
    90
                 this.alias = Integer.toString(chain[0].hashCode());
90ce3da70b43 Initial load
duke
parents:
diff changeset
    91
             } else {
90ce3da70b43 Initial load
duke
parents:
diff changeset
    92
                 this.alias = alias;
90ce3da70b43 Initial load
duke
parents:
diff changeset
    93
             }
90ce3da70b43 Initial load
duke
parents:
diff changeset
    94
        }
90ce3da70b43 Initial load
duke
parents:
diff changeset
    95
90ce3da70b43 Initial load
duke
parents:
diff changeset
    96
        /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
    97
         * Gets the alias for the keystore entry.
90ce3da70b43 Initial load
duke
parents:
diff changeset
    98
         */
90ce3da70b43 Initial load
duke
parents:
diff changeset
    99
        String getAlias()
90ce3da70b43 Initial load
duke
parents:
diff changeset
   100
        {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   101
            return alias;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   102
        }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   103
90ce3da70b43 Initial load
duke
parents:
diff changeset
   104
        /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
   105
         * Sets the alias for the keystore entry.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   106
         */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   107
        void setAlias(String alias)
90ce3da70b43 Initial load
duke
parents:
diff changeset
   108
        {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   109
            // TODO - set friendly name prop in cert store
90ce3da70b43 Initial load
duke
parents:
diff changeset
   110
            this.alias = alias;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   111
        }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   112
90ce3da70b43 Initial load
duke
parents:
diff changeset
   113
        /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
   114
         * Gets the private key for the keystore entry.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   115
         */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   116
        Key getPrivateKey()
90ce3da70b43 Initial load
duke
parents:
diff changeset
   117
        {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   118
            return privateKey;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   119
        }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   120
90ce3da70b43 Initial load
duke
parents:
diff changeset
   121
        /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
   122
         * Sets the private key for the keystore entry.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   123
         */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   124
        void setPrivateKey(RSAPrivateCrtKey key)
9508
310b4f6c8e61 6732372: Some MSCAPI native methods not returning correct exceptions.
vinnie
parents: 5506
diff changeset
   125
            throws InvalidKeyException, KeyStoreException
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   126
        {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   127
            byte[] modulusBytes = key.getModulus().toByteArray();
90ce3da70b43 Initial load
duke
parents:
diff changeset
   128
90ce3da70b43 Initial load
duke
parents:
diff changeset
   129
            // Adjust key length due to sign bit
90ce3da70b43 Initial load
duke
parents:
diff changeset
   130
            int keyBitLength = (modulusBytes[0] == 0)
90ce3da70b43 Initial load
duke
parents:
diff changeset
   131
                ? (modulusBytes.length - 1) * 8
90ce3da70b43 Initial load
duke
parents:
diff changeset
   132
                : modulusBytes.length * 8;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   133
90ce3da70b43 Initial load
duke
parents:
diff changeset
   134
            byte[] keyBlob = generatePrivateKeyBlob(
90ce3da70b43 Initial load
duke
parents:
diff changeset
   135
                keyBitLength,
90ce3da70b43 Initial load
duke
parents:
diff changeset
   136
                modulusBytes,
90ce3da70b43 Initial load
duke
parents:
diff changeset
   137
                key.getPublicExponent().toByteArray(),
90ce3da70b43 Initial load
duke
parents:
diff changeset
   138
                key.getPrivateExponent().toByteArray(),
90ce3da70b43 Initial load
duke
parents:
diff changeset
   139
                key.getPrimeP().toByteArray(),
90ce3da70b43 Initial load
duke
parents:
diff changeset
   140
                key.getPrimeQ().toByteArray(),
90ce3da70b43 Initial load
duke
parents:
diff changeset
   141
                key.getPrimeExponentP().toByteArray(),
90ce3da70b43 Initial load
duke
parents:
diff changeset
   142
                key.getPrimeExponentQ().toByteArray(),
90ce3da70b43 Initial load
duke
parents:
diff changeset
   143
                key.getCrtCoefficient().toByteArray());
90ce3da70b43 Initial load
duke
parents:
diff changeset
   144
90ce3da70b43 Initial load
duke
parents:
diff changeset
   145
            privateKey = storePrivateKey(keyBlob,
90ce3da70b43 Initial load
duke
parents:
diff changeset
   146
                "{" + UUID.randomUUID().toString() + "}", keyBitLength);
90ce3da70b43 Initial load
duke
parents:
diff changeset
   147
        }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   148
90ce3da70b43 Initial load
duke
parents:
diff changeset
   149
        /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
   150
         * Gets the certificate chain for the keystore entry.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   151
         */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   152
        X509Certificate[] getCertificateChain()
90ce3da70b43 Initial load
duke
parents:
diff changeset
   153
        {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   154
            return certChain;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   155
        }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   156
90ce3da70b43 Initial load
duke
parents:
diff changeset
   157
        /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
   158
         * Sets the certificate chain for the keystore entry.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   159
         */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   160
        void setCertificateChain(X509Certificate[] chain)
9508
310b4f6c8e61 6732372: Some MSCAPI native methods not returning correct exceptions.
vinnie
parents: 5506
diff changeset
   161
            throws CertificateException, KeyStoreException
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   162
        {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   163
            for (int i = 0; i < chain.length; i++) {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   164
                byte[] encoding = chain[i].getEncoded();
90ce3da70b43 Initial load
duke
parents:
diff changeset
   165
                if (i == 0 && privateKey != null) {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   166
                    storeCertificate(getName(), alias, encoding,
90ce3da70b43 Initial load
duke
parents:
diff changeset
   167
                        encoding.length, privateKey.getHCryptProvider(),
90ce3da70b43 Initial load
duke
parents:
diff changeset
   168
                        privateKey.getHCryptKey());
90ce3da70b43 Initial load
duke
parents:
diff changeset
   169
90ce3da70b43 Initial load
duke
parents:
diff changeset
   170
                } else {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   171
                    storeCertificate(getName(), alias, encoding,
90ce3da70b43 Initial load
duke
parents:
diff changeset
   172
                        encoding.length, 0L, 0L); // no private key to attach
90ce3da70b43 Initial load
duke
parents:
diff changeset
   173
                }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   174
            }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   175
            certChain = chain;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   176
        }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   177
    };
90ce3da70b43 Initial load
duke
parents:
diff changeset
   178
90ce3da70b43 Initial load
duke
parents:
diff changeset
   179
    /*
90ce3da70b43 Initial load
duke
parents:
diff changeset
   180
     * An X.509 certificate factory.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   181
     * Used to create an X.509 certificate from its DER-encoding.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   182
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   183
    private CertificateFactory certificateFactory = null;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   184
90ce3da70b43 Initial load
duke
parents:
diff changeset
   185
    /*
90ce3da70b43 Initial load
duke
parents:
diff changeset
   186
     * Compatibility mode: for applications that assume keystores are
90ce3da70b43 Initial load
duke
parents:
diff changeset
   187
     * stream-based this mode tolerates (but ignores) a non-null stream
90ce3da70b43 Initial load
duke
parents:
diff changeset
   188
     * or password parameter when passed to the load or store methods.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   189
     * The mode is enabled by default.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   190
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   191
    private static final String KEYSTORE_COMPATIBILITY_MODE_PROP =
90ce3da70b43 Initial load
duke
parents:
diff changeset
   192
        "sun.security.mscapi.keyStoreCompatibilityMode";
90ce3da70b43 Initial load
duke
parents:
diff changeset
   193
    private final boolean keyStoreCompatibilityMode;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   194
90ce3da70b43 Initial load
duke
parents:
diff changeset
   195
    /*
90ce3da70b43 Initial load
duke
parents:
diff changeset
   196
     * The keystore entries.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   197
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   198
    private Collection<KeyEntry> entries = new ArrayList<KeyEntry>();
90ce3da70b43 Initial load
duke
parents:
diff changeset
   199
90ce3da70b43 Initial load
duke
parents:
diff changeset
   200
    /*
90ce3da70b43 Initial load
duke
parents:
diff changeset
   201
     * The keystore name.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   202
     * Case is not significant.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   203
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   204
    private final String storeName;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   205
90ce3da70b43 Initial load
duke
parents:
diff changeset
   206
    KeyStore(String storeName) {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   207
        // Get the compatibility mode
90ce3da70b43 Initial load
duke
parents:
diff changeset
   208
        String prop =
90ce3da70b43 Initial load
duke
parents:
diff changeset
   209
            AccessController.doPrivileged(
90ce3da70b43 Initial load
duke
parents:
diff changeset
   210
                new GetPropertyAction(KEYSTORE_COMPATIBILITY_MODE_PROP));
90ce3da70b43 Initial load
duke
parents:
diff changeset
   211
90ce3da70b43 Initial load
duke
parents:
diff changeset
   212
        if ("false".equalsIgnoreCase(prop)) {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   213
            keyStoreCompatibilityMode = false;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   214
        } else {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   215
            keyStoreCompatibilityMode = true;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   216
        }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   217
90ce3da70b43 Initial load
duke
parents:
diff changeset
   218
        this.storeName = storeName;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   219
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   220
90ce3da70b43 Initial load
duke
parents:
diff changeset
   221
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
   222
     * Returns the key associated with the given alias.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   223
     * <p>
90ce3da70b43 Initial load
duke
parents:
diff changeset
   224
     * A compatibility mode is supported for applications that assume
90ce3da70b43 Initial load
duke
parents:
diff changeset
   225
     * a password must be supplied. It permits (but ignores) a non-null
90ce3da70b43 Initial load
duke
parents:
diff changeset
   226
     * <code>password</code>.  The mode is enabled by default.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   227
     * Set the
90ce3da70b43 Initial load
duke
parents:
diff changeset
   228
     * <code>sun.security.mscapi.keyStoreCompatibilityMode</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
   229
     * system property to <code>false</code> to disable compatibility mode
90ce3da70b43 Initial load
duke
parents:
diff changeset
   230
     * and reject a non-null <code>password</code>.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   231
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   232
     * @param alias the alias name
90ce3da70b43 Initial load
duke
parents:
diff changeset
   233
     * @param password the password, which should be <code>null</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
   234
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   235
     * @return the requested key, or null if the given alias does not exist
90ce3da70b43 Initial load
duke
parents:
diff changeset
   236
     * or does not identify a <i>key entry</i>.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   237
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   238
     * @exception NoSuchAlgorithmException if the algorithm for recovering the
90ce3da70b43 Initial load
duke
parents:
diff changeset
   239
     * key cannot be found,
90ce3da70b43 Initial load
duke
parents:
diff changeset
   240
     * or if compatibility mode is disabled and <code>password</code> is
90ce3da70b43 Initial load
duke
parents:
diff changeset
   241
     * non-null.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   242
     * @exception UnrecoverableKeyException if the key cannot be recovered.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   243
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   244
    public java.security.Key engineGetKey(String alias, char[] password)
90ce3da70b43 Initial load
duke
parents:
diff changeset
   245
        throws NoSuchAlgorithmException, UnrecoverableKeyException
90ce3da70b43 Initial load
duke
parents:
diff changeset
   246
    {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   247
        if (alias == null) {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   248
            return null;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   249
        }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   250
90ce3da70b43 Initial load
duke
parents:
diff changeset
   251
        if (password != null && !keyStoreCompatibilityMode) {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   252
            throw new UnrecoverableKeyException("Password must be null");
90ce3da70b43 Initial load
duke
parents:
diff changeset
   253
        }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   254
90ce3da70b43 Initial load
duke
parents:
diff changeset
   255
        if (engineIsKeyEntry(alias) == false)
90ce3da70b43 Initial load
duke
parents:
diff changeset
   256
            return null;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   257
90ce3da70b43 Initial load
duke
parents:
diff changeset
   258
        for (KeyEntry entry : entries) {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   259
            if (alias.equals(entry.getAlias())) {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   260
                return entry.getPrivateKey();
90ce3da70b43 Initial load
duke
parents:
diff changeset
   261
            }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   262
        }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   263
90ce3da70b43 Initial load
duke
parents:
diff changeset
   264
        return null;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   265
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   266
90ce3da70b43 Initial load
duke
parents:
diff changeset
   267
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
   268
     * Returns the certificate chain associated with the given alias.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   269
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   270
     * @param alias the alias name
90ce3da70b43 Initial load
duke
parents:
diff changeset
   271
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   272
     * @return the certificate chain (ordered with the user's certificate first
90ce3da70b43 Initial load
duke
parents:
diff changeset
   273
     * and the root certificate authority last), or null if the given alias
90ce3da70b43 Initial load
duke
parents:
diff changeset
   274
     * does not exist or does not contain a certificate chain (i.e., the given
90ce3da70b43 Initial load
duke
parents:
diff changeset
   275
     * alias identifies either a <i>trusted certificate entry</i> or a
90ce3da70b43 Initial load
duke
parents:
diff changeset
   276
     * <i>key entry</i> without a certificate chain).
90ce3da70b43 Initial load
duke
parents:
diff changeset
   277
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   278
    public Certificate[] engineGetCertificateChain(String alias)
90ce3da70b43 Initial load
duke
parents:
diff changeset
   279
    {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   280
        if (alias == null) {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   281
            return null;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   282
        }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   283
90ce3da70b43 Initial load
duke
parents:
diff changeset
   284
        for (KeyEntry entry : entries) {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   285
            if (alias.equals(entry.getAlias())) {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   286
                X509Certificate[] certChain = entry.getCertificateChain();
90ce3da70b43 Initial load
duke
parents:
diff changeset
   287
90ce3da70b43 Initial load
duke
parents:
diff changeset
   288
                return certChain.clone();
90ce3da70b43 Initial load
duke
parents:
diff changeset
   289
            }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   290
        }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   291
90ce3da70b43 Initial load
duke
parents:
diff changeset
   292
        return null;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   293
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   294
90ce3da70b43 Initial load
duke
parents:
diff changeset
   295
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
   296
     * Returns the certificate associated with the given alias.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   297
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   298
     * <p>If the given alias name identifies a
90ce3da70b43 Initial load
duke
parents:
diff changeset
   299
     * <i>trusted certificate entry</i>, the certificate associated with that
90ce3da70b43 Initial load
duke
parents:
diff changeset
   300
     * entry is returned. If the given alias name identifies a
90ce3da70b43 Initial load
duke
parents:
diff changeset
   301
     * <i>key entry</i>, the first element of the certificate chain of that
90ce3da70b43 Initial load
duke
parents:
diff changeset
   302
     * entry is returned, or null if that entry does not have a certificate
90ce3da70b43 Initial load
duke
parents:
diff changeset
   303
     * chain.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   304
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   305
     * @param alias the alias name
90ce3da70b43 Initial load
duke
parents:
diff changeset
   306
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   307
     * @return the certificate, or null if the given alias does not exist or
90ce3da70b43 Initial load
duke
parents:
diff changeset
   308
     * does not contain a certificate.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   309
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   310
    public Certificate engineGetCertificate(String alias)
90ce3da70b43 Initial load
duke
parents:
diff changeset
   311
    {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   312
        if (alias == null) {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   313
            return null;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   314
        }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   315
90ce3da70b43 Initial load
duke
parents:
diff changeset
   316
        for (KeyEntry entry : entries) {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   317
            if (alias.equals(entry.getAlias()))
90ce3da70b43 Initial load
duke
parents:
diff changeset
   318
            {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   319
                X509Certificate[] certChain = entry.getCertificateChain();
90ce3da70b43 Initial load
duke
parents:
diff changeset
   320
                return certChain[0];
90ce3da70b43 Initial load
duke
parents:
diff changeset
   321
            }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   322
        }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   323
90ce3da70b43 Initial load
duke
parents:
diff changeset
   324
        return null;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   325
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   326
90ce3da70b43 Initial load
duke
parents:
diff changeset
   327
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
   328
     * Returns the creation date of the entry identified by the given alias.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   329
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   330
     * @param alias the alias name
90ce3da70b43 Initial load
duke
parents:
diff changeset
   331
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   332
     * @return the creation date of this entry, or null if the given alias does
90ce3da70b43 Initial load
duke
parents:
diff changeset
   333
     * not exist
90ce3da70b43 Initial load
duke
parents:
diff changeset
   334
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   335
    public Date engineGetCreationDate(String alias) {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   336
        if (alias == null) {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   337
            return null;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   338
        }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   339
        return new Date();
90ce3da70b43 Initial load
duke
parents:
diff changeset
   340
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   341
90ce3da70b43 Initial load
duke
parents:
diff changeset
   342
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
   343
     * Stores the given private key and associated certificate chain in the
90ce3da70b43 Initial load
duke
parents:
diff changeset
   344
     * keystore.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   345
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   346
     * <p>The given java.security.PrivateKey <code>key</code> must
90ce3da70b43 Initial load
duke
parents:
diff changeset
   347
     * be accompanied by a certificate chain certifying the
90ce3da70b43 Initial load
duke
parents:
diff changeset
   348
     * corresponding public key.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   349
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   350
     * <p>If the given alias already exists, the keystore information
90ce3da70b43 Initial load
duke
parents:
diff changeset
   351
     * associated with it is overridden by the given key and certificate
90ce3da70b43 Initial load
duke
parents:
diff changeset
   352
     * chain. Otherwise, a new entry is created.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   353
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   354
     * <p>
90ce3da70b43 Initial load
duke
parents:
diff changeset
   355
     * A compatibility mode is supported for applications that assume
90ce3da70b43 Initial load
duke
parents:
diff changeset
   356
     * a password must be supplied. It permits (but ignores) a non-null
90ce3da70b43 Initial load
duke
parents:
diff changeset
   357
     * <code>password</code>.  The mode is enabled by default.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   358
     * Set the
90ce3da70b43 Initial load
duke
parents:
diff changeset
   359
     * <code>sun.security.mscapi.keyStoreCompatibilityMode</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
   360
     * system property to <code>false</code> to disable compatibility mode
90ce3da70b43 Initial load
duke
parents:
diff changeset
   361
     * and reject a non-null <code>password</code>.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   362
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   363
     * @param alias the alias name
90ce3da70b43 Initial load
duke
parents:
diff changeset
   364
     * @param key the private key to be associated with the alias
90ce3da70b43 Initial load
duke
parents:
diff changeset
   365
     * @param password the password, which should be <code>null</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
   366
     * @param chain the certificate chain for the corresponding public
90ce3da70b43 Initial load
duke
parents:
diff changeset
   367
     *        key (only required if the given key is of type
90ce3da70b43 Initial load
duke
parents:
diff changeset
   368
     *        <code>java.security.PrivateKey</code>).
90ce3da70b43 Initial load
duke
parents:
diff changeset
   369
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   370
     * @exception KeyStoreException if the given key is not a private key,
90ce3da70b43 Initial load
duke
parents:
diff changeset
   371
     * cannot be protected, or if compatibility mode is disabled and
90ce3da70b43 Initial load
duke
parents:
diff changeset
   372
     * <code>password</code> is non-null, or if this operation fails for
90ce3da70b43 Initial load
duke
parents:
diff changeset
   373
     * some other reason.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   374
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   375
    public void engineSetKeyEntry(String alias, java.security.Key key,
90ce3da70b43 Initial load
duke
parents:
diff changeset
   376
        char[] password, Certificate[] chain) throws KeyStoreException
90ce3da70b43 Initial load
duke
parents:
diff changeset
   377
    {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   378
        if (alias == null) {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   379
            throw new KeyStoreException("alias must not be null");
90ce3da70b43 Initial load
duke
parents:
diff changeset
   380
        }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   381
90ce3da70b43 Initial load
duke
parents:
diff changeset
   382
        if (password != null && !keyStoreCompatibilityMode) {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   383
            throw new KeyStoreException("Password must be null");
90ce3da70b43 Initial load
duke
parents:
diff changeset
   384
        }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   385
90ce3da70b43 Initial load
duke
parents:
diff changeset
   386
        if (key instanceof RSAPrivateCrtKey) {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   387
90ce3da70b43 Initial load
duke
parents:
diff changeset
   388
            KeyEntry entry = null;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   389
            boolean found = false;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   390
90ce3da70b43 Initial load
duke
parents:
diff changeset
   391
            for (KeyEntry e : entries) {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   392
                if (alias.equals(e.getAlias())) {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   393
                    found = true;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   394
                    entry = e;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   395
                    break;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   396
                }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   397
            }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   398
90ce3da70b43 Initial load
duke
parents:
diff changeset
   399
            if (! found) {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   400
                entry =
90ce3da70b43 Initial load
duke
parents:
diff changeset
   401
                    //TODO new KeyEntry(alias, key, (X509Certificate[]) chain);
90ce3da70b43 Initial load
duke
parents:
diff changeset
   402
                    new KeyEntry(alias, null, (X509Certificate[]) chain);
90ce3da70b43 Initial load
duke
parents:
diff changeset
   403
                entries.add(entry);
90ce3da70b43 Initial load
duke
parents:
diff changeset
   404
            }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   405
90ce3da70b43 Initial load
duke
parents:
diff changeset
   406
            entry.setAlias(alias);
90ce3da70b43 Initial load
duke
parents:
diff changeset
   407
90ce3da70b43 Initial load
duke
parents:
diff changeset
   408
            try {
9508
310b4f6c8e61 6732372: Some MSCAPI native methods not returning correct exceptions.
vinnie
parents: 5506
diff changeset
   409
                entry.setPrivateKey((RSAPrivateCrtKey) key);
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   410
                entry.setCertificateChain((X509Certificate[]) chain);
90ce3da70b43 Initial load
duke
parents:
diff changeset
   411
90ce3da70b43 Initial load
duke
parents:
diff changeset
   412
            } catch (CertificateException ce) {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   413
                throw new KeyStoreException(ce);
9508
310b4f6c8e61 6732372: Some MSCAPI native methods not returning correct exceptions.
vinnie
parents: 5506
diff changeset
   414
310b4f6c8e61 6732372: Some MSCAPI native methods not returning correct exceptions.
vinnie
parents: 5506
diff changeset
   415
            } catch (InvalidKeyException ike) {
310b4f6c8e61 6732372: Some MSCAPI native methods not returning correct exceptions.
vinnie
parents: 5506
diff changeset
   416
                throw new KeyStoreException(ike);
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   417
            }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   418
90ce3da70b43 Initial load
duke
parents:
diff changeset
   419
        } else {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   420
            throw new UnsupportedOperationException(
90ce3da70b43 Initial load
duke
parents:
diff changeset
   421
                "Cannot assign the key to the given alias.");
90ce3da70b43 Initial load
duke
parents:
diff changeset
   422
        }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   423
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   424
90ce3da70b43 Initial load
duke
parents:
diff changeset
   425
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
   426
     * Assigns the given key (that has already been protected) to the given
90ce3da70b43 Initial load
duke
parents:
diff changeset
   427
     * alias.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   428
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   429
     * <p>If the protected key is of type
90ce3da70b43 Initial load
duke
parents:
diff changeset
   430
     * <code>java.security.PrivateKey</code>, it must be accompanied by a
90ce3da70b43 Initial load
duke
parents:
diff changeset
   431
     * certificate chain certifying the corresponding public key. If the
90ce3da70b43 Initial load
duke
parents:
diff changeset
   432
     * underlying keystore implementation is of type <code>jks</code>,
90ce3da70b43 Initial load
duke
parents:
diff changeset
   433
     * <code>key</code> must be encoded as an
90ce3da70b43 Initial load
duke
parents:
diff changeset
   434
     * <code>EncryptedPrivateKeyInfo</code> as defined in the PKCS #8 standard.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   435
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   436
     * <p>If the given alias already exists, the keystore information
90ce3da70b43 Initial load
duke
parents:
diff changeset
   437
     * associated with it is overridden by the given key (and possibly
90ce3da70b43 Initial load
duke
parents:
diff changeset
   438
     * certificate chain).
90ce3da70b43 Initial load
duke
parents:
diff changeset
   439
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   440
     * @param alias the alias name
90ce3da70b43 Initial load
duke
parents:
diff changeset
   441
     * @param key the key (in protected format) to be associated with the alias
90ce3da70b43 Initial load
duke
parents:
diff changeset
   442
     * @param chain the certificate chain for the corresponding public
90ce3da70b43 Initial load
duke
parents:
diff changeset
   443
     * key (only useful if the protected key is of type
90ce3da70b43 Initial load
duke
parents:
diff changeset
   444
     * <code>java.security.PrivateKey</code>).
90ce3da70b43 Initial load
duke
parents:
diff changeset
   445
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   446
     * @exception KeyStoreException if this operation fails.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   447
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   448
    public void engineSetKeyEntry(String alias, byte[] key,
90ce3da70b43 Initial load
duke
parents:
diff changeset
   449
                                  Certificate[] chain)
90ce3da70b43 Initial load
duke
parents:
diff changeset
   450
        throws KeyStoreException
90ce3da70b43 Initial load
duke
parents:
diff changeset
   451
    {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   452
        throw new UnsupportedOperationException(
90ce3da70b43 Initial load
duke
parents:
diff changeset
   453
            "Cannot assign the encoded key to the given alias.");
90ce3da70b43 Initial load
duke
parents:
diff changeset
   454
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   455
90ce3da70b43 Initial load
duke
parents:
diff changeset
   456
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
   457
     * Assigns the given certificate to the given alias.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   458
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   459
     * <p>If the given alias already exists in this keystore and identifies a
90ce3da70b43 Initial load
duke
parents:
diff changeset
   460
     * <i>trusted certificate entry</i>, the certificate associated with it is
90ce3da70b43 Initial load
duke
parents:
diff changeset
   461
     * overridden by the given certificate.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   462
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   463
     * @param alias the alias name
90ce3da70b43 Initial load
duke
parents:
diff changeset
   464
     * @param cert the certificate
90ce3da70b43 Initial load
duke
parents:
diff changeset
   465
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   466
     * @exception KeyStoreException if the given alias already exists and does
90ce3da70b43 Initial load
duke
parents:
diff changeset
   467
     * not identify a <i>trusted certificate entry</i>, or this operation
90ce3da70b43 Initial load
duke
parents:
diff changeset
   468
     * fails for some other reason.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   469
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   470
    public void engineSetCertificateEntry(String alias, Certificate cert)
90ce3da70b43 Initial load
duke
parents:
diff changeset
   471
        throws KeyStoreException
90ce3da70b43 Initial load
duke
parents:
diff changeset
   472
    {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   473
        if (alias == null) {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   474
            throw new KeyStoreException("alias must not be null");
90ce3da70b43 Initial load
duke
parents:
diff changeset
   475
        }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   476
90ce3da70b43 Initial load
duke
parents:
diff changeset
   477
        if (cert instanceof X509Certificate) {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   478
90ce3da70b43 Initial load
duke
parents:
diff changeset
   479
            // TODO - build CryptoAPI chain?
90ce3da70b43 Initial load
duke
parents:
diff changeset
   480
            X509Certificate[] chain =
90ce3da70b43 Initial load
duke
parents:
diff changeset
   481
                new X509Certificate[]{ (X509Certificate) cert };
90ce3da70b43 Initial load
duke
parents:
diff changeset
   482
            KeyEntry entry = null;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   483
            boolean found = false;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   484
90ce3da70b43 Initial load
duke
parents:
diff changeset
   485
            for (KeyEntry e : entries) {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   486
                if (alias.equals(e.getAlias())) {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   487
                    found = true;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   488
                    entry = e;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   489
                    break;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   490
                }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   491
            }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   492
90ce3da70b43 Initial load
duke
parents:
diff changeset
   493
            if (! found) {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   494
                entry =
90ce3da70b43 Initial load
duke
parents:
diff changeset
   495
                    new KeyEntry(alias, null, chain);
90ce3da70b43 Initial load
duke
parents:
diff changeset
   496
                entries.add(entry);
90ce3da70b43 Initial load
duke
parents:
diff changeset
   497
90ce3da70b43 Initial load
duke
parents:
diff changeset
   498
            }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   499
            if (entry.getPrivateKey() == null) { // trusted-cert entry
90ce3da70b43 Initial load
duke
parents:
diff changeset
   500
                entry.setAlias(alias);
90ce3da70b43 Initial load
duke
parents:
diff changeset
   501
90ce3da70b43 Initial load
duke
parents:
diff changeset
   502
                try {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   503
                    entry.setCertificateChain(chain);
90ce3da70b43 Initial load
duke
parents:
diff changeset
   504
90ce3da70b43 Initial load
duke
parents:
diff changeset
   505
                } catch (CertificateException ce) {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   506
                    throw new KeyStoreException(ce);
90ce3da70b43 Initial load
duke
parents:
diff changeset
   507
                }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   508
            }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   509
90ce3da70b43 Initial load
duke
parents:
diff changeset
   510
        } else {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   511
            throw new UnsupportedOperationException(
90ce3da70b43 Initial load
duke
parents:
diff changeset
   512
                "Cannot assign the certificate to the given alias.");
90ce3da70b43 Initial load
duke
parents:
diff changeset
   513
        }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   514
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   515
90ce3da70b43 Initial load
duke
parents:
diff changeset
   516
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
   517
     * Deletes the entry identified by the given alias from this keystore.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   518
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   519
     * @param alias the alias name
90ce3da70b43 Initial load
duke
parents:
diff changeset
   520
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   521
     * @exception KeyStoreException if the entry cannot be removed.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   522
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   523
    public void engineDeleteEntry(String alias)
90ce3da70b43 Initial load
duke
parents:
diff changeset
   524
        throws KeyStoreException
90ce3da70b43 Initial load
duke
parents:
diff changeset
   525
    {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   526
        if (alias == null) {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   527
            throw new KeyStoreException("alias must not be null");
90ce3da70b43 Initial load
duke
parents:
diff changeset
   528
        }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   529
90ce3da70b43 Initial load
duke
parents:
diff changeset
   530
        for (KeyEntry entry : entries) {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   531
            if (alias.equals(entry.getAlias())) {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   532
90ce3da70b43 Initial load
duke
parents:
diff changeset
   533
                // Get end-entity certificate and remove from system cert store
90ce3da70b43 Initial load
duke
parents:
diff changeset
   534
                X509Certificate[] certChain = entry.getCertificateChain();
90ce3da70b43 Initial load
duke
parents:
diff changeset
   535
                if (certChain != null) {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   536
90ce3da70b43 Initial load
duke
parents:
diff changeset
   537
                    try {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   538
90ce3da70b43 Initial load
duke
parents:
diff changeset
   539
                        byte[] encoding = certChain[0].getEncoded();
90ce3da70b43 Initial load
duke
parents:
diff changeset
   540
                        removeCertificate(getName(), alias, encoding,
90ce3da70b43 Initial load
duke
parents:
diff changeset
   541
                            encoding.length);
90ce3da70b43 Initial load
duke
parents:
diff changeset
   542
9508
310b4f6c8e61 6732372: Some MSCAPI native methods not returning correct exceptions.
vinnie
parents: 5506
diff changeset
   543
                    } catch (CertificateException e) {
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   544
                        throw new KeyStoreException("Cannot remove entry: " +
90ce3da70b43 Initial load
duke
parents:
diff changeset
   545
                            e);
90ce3da70b43 Initial load
duke
parents:
diff changeset
   546
                    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   547
                }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   548
                Key privateKey = entry.getPrivateKey();
90ce3da70b43 Initial load
duke
parents:
diff changeset
   549
                if (privateKey != null) {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   550
                    destroyKeyContainer(
90ce3da70b43 Initial load
duke
parents:
diff changeset
   551
                        Key.getContainerName(privateKey.getHCryptProvider()));
90ce3da70b43 Initial load
duke
parents:
diff changeset
   552
                }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   553
90ce3da70b43 Initial load
duke
parents:
diff changeset
   554
                entries.remove(entry);
90ce3da70b43 Initial load
duke
parents:
diff changeset
   555
                break;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   556
            }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   557
        }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   558
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   559
90ce3da70b43 Initial load
duke
parents:
diff changeset
   560
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
   561
     * Lists all the alias names of this keystore.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   562
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   563
     * @return enumeration of the alias names
90ce3da70b43 Initial load
duke
parents:
diff changeset
   564
     */
10336
0bb1999251f8 7064075: Security libraries don't build with javac -Xlint:all,-deprecation -Werror
jjg
parents: 9508
diff changeset
   565
    public Enumeration<String> engineAliases() {
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   566
10336
0bb1999251f8 7064075: Security libraries don't build with javac -Xlint:all,-deprecation -Werror
jjg
parents: 9508
diff changeset
   567
        final Iterator<KeyEntry> iter = entries.iterator();
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   568
10336
0bb1999251f8 7064075: Security libraries don't build with javac -Xlint:all,-deprecation -Werror
jjg
parents: 9508
diff changeset
   569
        return new Enumeration<String>()
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   570
        {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   571
            public boolean hasMoreElements()
90ce3da70b43 Initial load
duke
parents:
diff changeset
   572
            {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   573
                return iter.hasNext();
90ce3da70b43 Initial load
duke
parents:
diff changeset
   574
            }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   575
10336
0bb1999251f8 7064075: Security libraries don't build with javac -Xlint:all,-deprecation -Werror
jjg
parents: 9508
diff changeset
   576
            public String nextElement()
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   577
            {
10336
0bb1999251f8 7064075: Security libraries don't build with javac -Xlint:all,-deprecation -Werror
jjg
parents: 9508
diff changeset
   578
                KeyEntry entry = iter.next();
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   579
                return entry.getAlias();
90ce3da70b43 Initial load
duke
parents:
diff changeset
   580
            }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   581
        };
90ce3da70b43 Initial load
duke
parents:
diff changeset
   582
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   583
90ce3da70b43 Initial load
duke
parents:
diff changeset
   584
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
   585
     * Checks if the given alias exists in this keystore.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   586
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   587
     * @param alias the alias name
90ce3da70b43 Initial load
duke
parents:
diff changeset
   588
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   589
     * @return true if the alias exists, false otherwise
90ce3da70b43 Initial load
duke
parents:
diff changeset
   590
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   591
    public boolean engineContainsAlias(String alias) {
10336
0bb1999251f8 7064075: Security libraries don't build with javac -Xlint:all,-deprecation -Werror
jjg
parents: 9508
diff changeset
   592
        for (Enumeration<String> enumerator = engineAliases();
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   593
            enumerator.hasMoreElements();)
90ce3da70b43 Initial load
duke
parents:
diff changeset
   594
        {
10336
0bb1999251f8 7064075: Security libraries don't build with javac -Xlint:all,-deprecation -Werror
jjg
parents: 9508
diff changeset
   595
            String a = enumerator.nextElement();
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   596
90ce3da70b43 Initial load
duke
parents:
diff changeset
   597
            if (a.equals(alias))
90ce3da70b43 Initial load
duke
parents:
diff changeset
   598
                return true;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   599
        }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   600
        return false;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   601
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   602
90ce3da70b43 Initial load
duke
parents:
diff changeset
   603
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
   604
     * Retrieves the number of entries in this keystore.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   605
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   606
     * @return the number of entries in this keystore
90ce3da70b43 Initial load
duke
parents:
diff changeset
   607
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   608
    public int engineSize() {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   609
        return entries.size();
90ce3da70b43 Initial load
duke
parents:
diff changeset
   610
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   611
90ce3da70b43 Initial load
duke
parents:
diff changeset
   612
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
   613
     * Returns true if the entry identified by the given alias is a
90ce3da70b43 Initial load
duke
parents:
diff changeset
   614
     * <i>key entry</i>, and false otherwise.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   615
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   616
     * @return true if the entry identified by the given alias is a
90ce3da70b43 Initial load
duke
parents:
diff changeset
   617
     * <i>key entry</i>, false otherwise.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   618
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   619
    public boolean engineIsKeyEntry(String alias) {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   620
90ce3da70b43 Initial load
duke
parents:
diff changeset
   621
        if (alias == null) {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   622
            return false;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   623
        }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   624
90ce3da70b43 Initial load
duke
parents:
diff changeset
   625
        for (KeyEntry entry : entries) {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   626
            if (alias.equals(entry.getAlias())) {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   627
                return entry.getPrivateKey() != null;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   628
            }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   629
        }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   630
90ce3da70b43 Initial load
duke
parents:
diff changeset
   631
        return false;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   632
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   633
90ce3da70b43 Initial load
duke
parents:
diff changeset
   634
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
   635
     * Returns true if the entry identified by the given alias is a
90ce3da70b43 Initial load
duke
parents:
diff changeset
   636
     * <i>trusted certificate entry</i>, and false otherwise.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   637
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   638
     * @return true if the entry identified by the given alias is a
90ce3da70b43 Initial load
duke
parents:
diff changeset
   639
     * <i>trusted certificate entry</i>, false otherwise.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   640
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   641
    public boolean engineIsCertificateEntry(String alias)
90ce3da70b43 Initial load
duke
parents:
diff changeset
   642
    {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   643
        for (KeyEntry entry : entries) {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   644
            if (alias.equals(entry.getAlias())) {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   645
                return entry.getPrivateKey() == null;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   646
            }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   647
        }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   648
90ce3da70b43 Initial load
duke
parents:
diff changeset
   649
        return false;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   650
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   651
90ce3da70b43 Initial load
duke
parents:
diff changeset
   652
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
   653
     * Returns the (alias) name of the first keystore entry whose certificate
90ce3da70b43 Initial load
duke
parents:
diff changeset
   654
     * matches the given certificate.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   655
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   656
     * <p>This method attempts to match the given certificate with each
90ce3da70b43 Initial load
duke
parents:
diff changeset
   657
     * keystore entry. If the entry being considered
90ce3da70b43 Initial load
duke
parents:
diff changeset
   658
     * is a <i>trusted certificate entry</i>, the given certificate is
90ce3da70b43 Initial load
duke
parents:
diff changeset
   659
     * compared to that entry's certificate. If the entry being considered is
90ce3da70b43 Initial load
duke
parents:
diff changeset
   660
     * a <i>key entry</i>, the given certificate is compared to the first
90ce3da70b43 Initial load
duke
parents:
diff changeset
   661
     * element of that entry's certificate chain (if a chain exists).
90ce3da70b43 Initial load
duke
parents:
diff changeset
   662
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   663
     * @param cert the certificate to match with.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   664
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   665
     * @return the (alias) name of the first entry with matching certificate,
90ce3da70b43 Initial load
duke
parents:
diff changeset
   666
     * or null if no such entry exists in this keystore.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   667
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   668
    public String engineGetCertificateAlias(Certificate cert)
90ce3da70b43 Initial load
duke
parents:
diff changeset
   669
    {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   670
        for (KeyEntry entry : entries) {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   671
            if (entry.certChain != null && entry.certChain[0].equals(cert)) {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   672
                return entry.getAlias();
90ce3da70b43 Initial load
duke
parents:
diff changeset
   673
            }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   674
        }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   675
90ce3da70b43 Initial load
duke
parents:
diff changeset
   676
        return null;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   677
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   678
90ce3da70b43 Initial load
duke
parents:
diff changeset
   679
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
   680
     * engineStore is currently a no-op.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   681
     * Entries are stored during engineSetEntry.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   682
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   683
     * A compatibility mode is supported for applications that assume
90ce3da70b43 Initial load
duke
parents:
diff changeset
   684
     * keystores are stream-based. It permits (but ignores) a non-null
90ce3da70b43 Initial load
duke
parents:
diff changeset
   685
     * <code>stream</code> or <code>password</code>.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   686
     * The mode is enabled by default.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   687
     * Set the
90ce3da70b43 Initial load
duke
parents:
diff changeset
   688
     * <code>sun.security.mscapi.keyStoreCompatibilityMode</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
   689
     * system property to <code>false</code> to disable compatibility mode
90ce3da70b43 Initial load
duke
parents:
diff changeset
   690
     * and reject a non-null <code>stream</code> or <code>password</code>.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   691
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   692
     * @param stream the output stream, which should be <code>null</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
   693
     * @param password the password, which should be <code>null</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
   694
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   695
     * @exception IOException if compatibility mode is disabled and either
90ce3da70b43 Initial load
duke
parents:
diff changeset
   696
     * parameter is non-null.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   697
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   698
    public void engineStore(OutputStream stream, char[] password)
90ce3da70b43 Initial load
duke
parents:
diff changeset
   699
        throws IOException, NoSuchAlgorithmException, CertificateException
90ce3da70b43 Initial load
duke
parents:
diff changeset
   700
    {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   701
        if (stream != null && !keyStoreCompatibilityMode) {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   702
            throw new IOException("Keystore output stream must be null");
90ce3da70b43 Initial load
duke
parents:
diff changeset
   703
        }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   704
90ce3da70b43 Initial load
duke
parents:
diff changeset
   705
        if (password != null && !keyStoreCompatibilityMode) {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   706
            throw new IOException("Keystore password must be null");
90ce3da70b43 Initial load
duke
parents:
diff changeset
   707
        }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   708
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   709
90ce3da70b43 Initial load
duke
parents:
diff changeset
   710
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
   711
     * Loads the keystore.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   712
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   713
     * A compatibility mode is supported for applications that assume
90ce3da70b43 Initial load
duke
parents:
diff changeset
   714
     * keystores are stream-based. It permits (but ignores) a non-null
90ce3da70b43 Initial load
duke
parents:
diff changeset
   715
     * <code>stream</code> or <code>password</code>.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   716
     * The mode is enabled by default.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   717
     * Set the
90ce3da70b43 Initial load
duke
parents:
diff changeset
   718
     * <code>sun.security.mscapi.keyStoreCompatibilityMode</code>
90ce3da70b43 Initial load
duke
parents:
diff changeset
   719
     * system property to <code>false</code> to disable compatibility mode
90ce3da70b43 Initial load
duke
parents:
diff changeset
   720
     * and reject a non-null <code>stream</code> or <code>password</code>.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   721
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   722
     * @param stream the input stream, which should be <code>null</code>.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   723
     * @param password the password, which should be <code>null</code>.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   724
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   725
     * @exception IOException if there is an I/O or format problem with the
90ce3da70b43 Initial load
duke
parents:
diff changeset
   726
     * keystore data. Or if compatibility mode is disabled and either
90ce3da70b43 Initial load
duke
parents:
diff changeset
   727
     * parameter is non-null.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   728
     * @exception NoSuchAlgorithmException if the algorithm used to check
90ce3da70b43 Initial load
duke
parents:
diff changeset
   729
     * the integrity of the keystore cannot be found
90ce3da70b43 Initial load
duke
parents:
diff changeset
   730
     * @exception CertificateException if any of the certificates in the
90ce3da70b43 Initial load
duke
parents:
diff changeset
   731
     * keystore could not be loaded
90ce3da70b43 Initial load
duke
parents:
diff changeset
   732
     * @exception SecurityException if the security check for
90ce3da70b43 Initial load
duke
parents:
diff changeset
   733
     *  <code>SecurityPermission("authProvider.<i>name</i>")</code> does not
90ce3da70b43 Initial load
duke
parents:
diff changeset
   734
     *  pass, where <i>name</i> is the value returned by
90ce3da70b43 Initial load
duke
parents:
diff changeset
   735
     *  this provider's <code>getName</code> method.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   736
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   737
    public void engineLoad(InputStream stream, char[] password)
90ce3da70b43 Initial load
duke
parents:
diff changeset
   738
        throws IOException, NoSuchAlgorithmException, CertificateException
90ce3da70b43 Initial load
duke
parents:
diff changeset
   739
    {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   740
        if (stream != null && !keyStoreCompatibilityMode) {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   741
            throw new IOException("Keystore input stream must be null");
90ce3da70b43 Initial load
duke
parents:
diff changeset
   742
        }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   743
90ce3da70b43 Initial load
duke
parents:
diff changeset
   744
        if (password != null && !keyStoreCompatibilityMode) {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   745
            throw new IOException("Keystore password must be null");
90ce3da70b43 Initial load
duke
parents:
diff changeset
   746
        }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   747
90ce3da70b43 Initial load
duke
parents:
diff changeset
   748
        /*
90ce3da70b43 Initial load
duke
parents:
diff changeset
   749
         * Use the same security check as AuthProvider.login
90ce3da70b43 Initial load
duke
parents:
diff changeset
   750
         */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   751
        SecurityManager sm = System.getSecurityManager();
90ce3da70b43 Initial load
duke
parents:
diff changeset
   752
        if (sm != null) {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   753
            sm.checkPermission(new SecurityPermission(
90ce3da70b43 Initial load
duke
parents:
diff changeset
   754
                "authProvider.SunMSCAPI"));
90ce3da70b43 Initial load
duke
parents:
diff changeset
   755
        }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   756
90ce3da70b43 Initial load
duke
parents:
diff changeset
   757
        // Clear all key entries
90ce3da70b43 Initial load
duke
parents:
diff changeset
   758
        entries.clear();
90ce3da70b43 Initial load
duke
parents:
diff changeset
   759
9508
310b4f6c8e61 6732372: Some MSCAPI native methods not returning correct exceptions.
vinnie
parents: 5506
diff changeset
   760
        try {
310b4f6c8e61 6732372: Some MSCAPI native methods not returning correct exceptions.
vinnie
parents: 5506
diff changeset
   761
310b4f6c8e61 6732372: Some MSCAPI native methods not returning correct exceptions.
vinnie
parents: 5506
diff changeset
   762
            // Load keys and/or certificate chains
310b4f6c8e61 6732372: Some MSCAPI native methods not returning correct exceptions.
vinnie
parents: 5506
diff changeset
   763
            loadKeysOrCertificateChains(getName(), entries);
310b4f6c8e61 6732372: Some MSCAPI native methods not returning correct exceptions.
vinnie
parents: 5506
diff changeset
   764
310b4f6c8e61 6732372: Some MSCAPI native methods not returning correct exceptions.
vinnie
parents: 5506
diff changeset
   765
        } catch (KeyStoreException e) {
310b4f6c8e61 6732372: Some MSCAPI native methods not returning correct exceptions.
vinnie
parents: 5506
diff changeset
   766
            throw new IOException(e);
310b4f6c8e61 6732372: Some MSCAPI native methods not returning correct exceptions.
vinnie
parents: 5506
diff changeset
   767
        }
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   768
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   769
90ce3da70b43 Initial load
duke
parents:
diff changeset
   770
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
   771
     * Generates a certificate chain from the collection of
90ce3da70b43 Initial load
duke
parents:
diff changeset
   772
     * certificates and stores the result into a key entry.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   773
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   774
    private void generateCertificateChain(String alias,
10336
0bb1999251f8 7064075: Security libraries don't build with javac -Xlint:all,-deprecation -Werror
jjg
parents: 9508
diff changeset
   775
        Collection<? extends Certificate> certCollection,
0bb1999251f8 7064075: Security libraries don't build with javac -Xlint:all,-deprecation -Werror
jjg
parents: 9508
diff changeset
   776
        Collection<KeyEntry> entries)
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   777
    {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   778
        try
90ce3da70b43 Initial load
duke
parents:
diff changeset
   779
        {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   780
            X509Certificate[] certChain =
90ce3da70b43 Initial load
duke
parents:
diff changeset
   781
                new X509Certificate[certCollection.size()];
90ce3da70b43 Initial load
duke
parents:
diff changeset
   782
90ce3da70b43 Initial load
duke
parents:
diff changeset
   783
            int i = 0;
10336
0bb1999251f8 7064075: Security libraries don't build with javac -Xlint:all,-deprecation -Werror
jjg
parents: 9508
diff changeset
   784
            for (Iterator<? extends Certificate> iter =
0bb1999251f8 7064075: Security libraries don't build with javac -Xlint:all,-deprecation -Werror
jjg
parents: 9508
diff changeset
   785
                    certCollection.iterator(); iter.hasNext(); i++)
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   786
            {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   787
                certChain[i] = (X509Certificate) iter.next();
90ce3da70b43 Initial load
duke
parents:
diff changeset
   788
            }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   789
90ce3da70b43 Initial load
duke
parents:
diff changeset
   790
            KeyEntry entry = new KeyEntry(alias, null, certChain);
90ce3da70b43 Initial load
duke
parents:
diff changeset
   791
90ce3da70b43 Initial load
duke
parents:
diff changeset
   792
            // Add cert chain
90ce3da70b43 Initial load
duke
parents:
diff changeset
   793
            entries.add(entry);
90ce3da70b43 Initial load
duke
parents:
diff changeset
   794
        }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   795
        catch (Throwable e)
90ce3da70b43 Initial load
duke
parents:
diff changeset
   796
        {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   797
            // Ignore the exception and skip this entry
90ce3da70b43 Initial load
duke
parents:
diff changeset
   798
            // TODO - throw CertificateException?
90ce3da70b43 Initial load
duke
parents:
diff changeset
   799
        }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   800
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   801
90ce3da70b43 Initial load
duke
parents:
diff changeset
   802
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
   803
     * Generates RSA key and certificate chain from the private key handle,
90ce3da70b43 Initial load
duke
parents:
diff changeset
   804
     * collection of certificates and stores the result into key entries.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   805
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   806
    private void generateRSAKeyAndCertificateChain(String alias,
90ce3da70b43 Initial load
duke
parents:
diff changeset
   807
        long hCryptProv, long hCryptKey, int keyLength,
10336
0bb1999251f8 7064075: Security libraries don't build with javac -Xlint:all,-deprecation -Werror
jjg
parents: 9508
diff changeset
   808
        Collection<? extends Certificate> certCollection,
0bb1999251f8 7064075: Security libraries don't build with javac -Xlint:all,-deprecation -Werror
jjg
parents: 9508
diff changeset
   809
        Collection<KeyEntry> entries)
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   810
    {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   811
        try
90ce3da70b43 Initial load
duke
parents:
diff changeset
   812
        {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   813
            X509Certificate[] certChain =
90ce3da70b43 Initial load
duke
parents:
diff changeset
   814
                new X509Certificate[certCollection.size()];
90ce3da70b43 Initial load
duke
parents:
diff changeset
   815
90ce3da70b43 Initial load
duke
parents:
diff changeset
   816
            int i = 0;
10336
0bb1999251f8 7064075: Security libraries don't build with javac -Xlint:all,-deprecation -Werror
jjg
parents: 9508
diff changeset
   817
            for (Iterator<? extends Certificate> iter =
0bb1999251f8 7064075: Security libraries don't build with javac -Xlint:all,-deprecation -Werror
jjg
parents: 9508
diff changeset
   818
                    certCollection.iterator(); iter.hasNext(); i++)
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   819
            {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   820
                certChain[i] = (X509Certificate) iter.next();
90ce3da70b43 Initial load
duke
parents:
diff changeset
   821
            }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   822
90ce3da70b43 Initial load
duke
parents:
diff changeset
   823
            KeyEntry entry = new KeyEntry(alias, new RSAPrivateKey(hCryptProv,
90ce3da70b43 Initial load
duke
parents:
diff changeset
   824
                hCryptKey, keyLength), certChain);
90ce3da70b43 Initial load
duke
parents:
diff changeset
   825
90ce3da70b43 Initial load
duke
parents:
diff changeset
   826
            // Add cert chain
90ce3da70b43 Initial load
duke
parents:
diff changeset
   827
            entries.add(entry);
90ce3da70b43 Initial load
duke
parents:
diff changeset
   828
        }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   829
        catch (Throwable e)
90ce3da70b43 Initial load
duke
parents:
diff changeset
   830
        {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   831
            // Ignore the exception and skip this entry
90ce3da70b43 Initial load
duke
parents:
diff changeset
   832
            // TODO - throw CertificateException?
90ce3da70b43 Initial load
duke
parents:
diff changeset
   833
        }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   834
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   835
90ce3da70b43 Initial load
duke
parents:
diff changeset
   836
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
   837
     * Generates certificates from byte data and stores into cert collection.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   838
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   839
     * @param data Byte data.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   840
     * @param certCollection Collection of certificates.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   841
     */
10336
0bb1999251f8 7064075: Security libraries don't build with javac -Xlint:all,-deprecation -Werror
jjg
parents: 9508
diff changeset
   842
    private void generateCertificate(byte[] data,
0bb1999251f8 7064075: Security libraries don't build with javac -Xlint:all,-deprecation -Werror
jjg
parents: 9508
diff changeset
   843
        Collection<Certificate> certCollection) {
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   844
        try
90ce3da70b43 Initial load
duke
parents:
diff changeset
   845
        {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   846
            ByteArrayInputStream bis = new ByteArrayInputStream(data);
90ce3da70b43 Initial load
duke
parents:
diff changeset
   847
90ce3da70b43 Initial load
duke
parents:
diff changeset
   848
            // Obtain certificate factory
90ce3da70b43 Initial load
duke
parents:
diff changeset
   849
            if (certificateFactory == null) {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   850
                certificateFactory = CertificateFactory.getInstance("X.509");
90ce3da70b43 Initial load
duke
parents:
diff changeset
   851
            }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   852
90ce3da70b43 Initial load
duke
parents:
diff changeset
   853
            // Generate certificate
10336
0bb1999251f8 7064075: Security libraries don't build with javac -Xlint:all,-deprecation -Werror
jjg
parents: 9508
diff changeset
   854
            Collection<? extends Certificate> c =
0bb1999251f8 7064075: Security libraries don't build with javac -Xlint:all,-deprecation -Werror
jjg
parents: 9508
diff changeset
   855
                    certificateFactory.generateCertificates(bis);
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   856
            certCollection.addAll(c);
90ce3da70b43 Initial load
duke
parents:
diff changeset
   857
        }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   858
        catch (CertificateException e)
90ce3da70b43 Initial load
duke
parents:
diff changeset
   859
        {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   860
            // Ignore the exception and skip this certificate
90ce3da70b43 Initial load
duke
parents:
diff changeset
   861
            // TODO - throw CertificateException?
90ce3da70b43 Initial load
duke
parents:
diff changeset
   862
        }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   863
        catch (Throwable te)
90ce3da70b43 Initial load
duke
parents:
diff changeset
   864
        {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   865
            // Ignore the exception and skip this certificate
90ce3da70b43 Initial load
duke
parents:
diff changeset
   866
            // TODO - throw CertificateException?
90ce3da70b43 Initial load
duke
parents:
diff changeset
   867
        }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   868
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   869
90ce3da70b43 Initial load
duke
parents:
diff changeset
   870
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
   871
     * Returns the name of the keystore.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   872
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   873
    private String getName()
90ce3da70b43 Initial load
duke
parents:
diff changeset
   874
    {
90ce3da70b43 Initial load
duke
parents:
diff changeset
   875
        return storeName;
90ce3da70b43 Initial load
duke
parents:
diff changeset
   876
    }
90ce3da70b43 Initial load
duke
parents:
diff changeset
   877
90ce3da70b43 Initial load
duke
parents:
diff changeset
   878
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
   879
     * Load keys and/or certificates from keystore into Collection.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   880
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   881
     * @param name Name of keystore.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   882
     * @param entries Collection of key/certificate.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   883
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   884
    private native void loadKeysOrCertificateChains(String name,
9508
310b4f6c8e61 6732372: Some MSCAPI native methods not returning correct exceptions.
vinnie
parents: 5506
diff changeset
   885
        Collection<KeyEntry> entries) throws KeyStoreException;
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   886
90ce3da70b43 Initial load
duke
parents:
diff changeset
   887
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
   888
     * Stores a DER-encoded certificate into the certificate store
90ce3da70b43 Initial load
duke
parents:
diff changeset
   889
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   890
     * @param name Name of the keystore.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   891
     * @param alias Name of the certificate.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   892
     * @param encoding DER-encoded certificate.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   893
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   894
    private native void storeCertificate(String name, String alias,
90ce3da70b43 Initial load
duke
parents:
diff changeset
   895
        byte[] encoding, int encodingLength, long hCryptProvider,
9508
310b4f6c8e61 6732372: Some MSCAPI native methods not returning correct exceptions.
vinnie
parents: 5506
diff changeset
   896
        long hCryptKey) throws CertificateException, KeyStoreException;
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   897
90ce3da70b43 Initial load
duke
parents:
diff changeset
   898
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
   899
     * Removes the certificate from the certificate store
90ce3da70b43 Initial load
duke
parents:
diff changeset
   900
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   901
     * @param name Name of the keystore.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   902
     * @param alias Name of the certificate.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   903
     * @param encoding DER-encoded certificate.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   904
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   905
    private native void removeCertificate(String name, String alias,
9508
310b4f6c8e61 6732372: Some MSCAPI native methods not returning correct exceptions.
vinnie
parents: 5506
diff changeset
   906
        byte[] encoding, int encodingLength)
310b4f6c8e61 6732372: Some MSCAPI native methods not returning correct exceptions.
vinnie
parents: 5506
diff changeset
   907
            throws CertificateException, KeyStoreException;
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   908
90ce3da70b43 Initial load
duke
parents:
diff changeset
   909
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
   910
     * Destroys the key container.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   911
     *
90ce3da70b43 Initial load
duke
parents:
diff changeset
   912
     * @param keyContainerName The name of the key container.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   913
     */
9508
310b4f6c8e61 6732372: Some MSCAPI native methods not returning correct exceptions.
vinnie
parents: 5506
diff changeset
   914
    private native void destroyKeyContainer(String keyContainerName)
310b4f6c8e61 6732372: Some MSCAPI native methods not returning correct exceptions.
vinnie
parents: 5506
diff changeset
   915
        throws KeyStoreException;
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   916
90ce3da70b43 Initial load
duke
parents:
diff changeset
   917
    /**
90ce3da70b43 Initial load
duke
parents:
diff changeset
   918
     * Generates a private-key BLOB from a key's components.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   919
     */
90ce3da70b43 Initial load
duke
parents:
diff changeset
   920
    private native byte[] generatePrivateKeyBlob(
90ce3da70b43 Initial load
duke
parents:
diff changeset
   921
        int keyBitLength,
90ce3da70b43 Initial load
duke
parents:
diff changeset
   922
        byte[] modulus,
90ce3da70b43 Initial load
duke
parents:
diff changeset
   923
        byte[] publicExponent,
90ce3da70b43 Initial load
duke
parents:
diff changeset
   924
        byte[] privateExponent,
90ce3da70b43 Initial load
duke
parents:
diff changeset
   925
        byte[] primeP,
90ce3da70b43 Initial load
duke
parents:
diff changeset
   926
        byte[] primeQ,
90ce3da70b43 Initial load
duke
parents:
diff changeset
   927
        byte[] exponentP,
90ce3da70b43 Initial load
duke
parents:
diff changeset
   928
        byte[] exponentQ,
9508
310b4f6c8e61 6732372: Some MSCAPI native methods not returning correct exceptions.
vinnie
parents: 5506
diff changeset
   929
        byte[] crtCoefficient) throws InvalidKeyException;
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   930
90ce3da70b43 Initial load
duke
parents:
diff changeset
   931
    private native RSAPrivateKey storePrivateKey(byte[] keyBlob,
9508
310b4f6c8e61 6732372: Some MSCAPI native methods not returning correct exceptions.
vinnie
parents: 5506
diff changeset
   932
        String keyContainerName, int keySize) throws KeyStoreException;
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   933
}