/* * Copyright (c) 2024, 2025, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it * under the terms of the GNU General Public License version 2 only, as * published by the Free Software Foundation. Oracle designates this * particular file as subject to the "Classpath" exception as provided * by Oracle in the LICENSE file that accompanied this code. * * This code is distributed in the hope that it will be useful, but WITHOUT * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License * version 2 for more details (a copy is included in the LICENSE file that * accompanied this code). * * You should have received a copy of the GNU General Public License version * 2 along with this work; if not, write to the Free Software Foundation, * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. * * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA * or visit www.oracle.com if you need additional information or have any * questions. */ package sun.security.pkcs; import sun.security.util.DerInputStream; import sun.security.util.DerValue; import sun.security.x509.AlgorithmId; import javax.security.auth.DestroyFailedException; import java.io.IOException; import java.io.InvalidObjectException; import java.io.ObjectInputStream; import java.io.Serial; import java.security.InvalidKeyException; import java.security.NoSuchAlgorithmException; import java.security.ProviderException; import java.security.spec.NamedParameterSpec; import java.util.Arrays; /// Represents a private key from an algorithm family that is specialized /// with a named parameter set. /// /// This key is generated by either a [sun.security.provider.NamedKeyPairGenerator] /// or [sun.security.provider.NamedKeyFactory]. Its [#getAlgorithm] method /// returns the algorithm family name, while its [#getParams()] method returns /// the parameter set name as a [NamedParameterSpec] object. The algorithm /// identifier in the PKCS #8 encoding of the key is always a single OID derived /// from the parameter set name. /// /// @see sun.security.provider.NamedKeyPairGenerator public final class NamedPKCS8Key extends PKCS8Key { @Serial private static final long serialVersionUID = 1L; private final String fname; private final transient NamedParameterSpec paramSpec; private final byte[] rawBytes; private transient boolean destroyed = false; /// Ctor from family name, parameter set name, raw key bytes. /// Key bytes won't be cloned, caller must relinquish ownership public NamedPKCS8Key(String fname, String pname, byte[] rawBytes) { this.fname = fname; this.paramSpec = new NamedParameterSpec(pname); try { this.algid = AlgorithmId.get(pname); } catch (NoSuchAlgorithmException e) { throw new ProviderException(e); } this.rawBytes = rawBytes; DerValue val = new DerValue(DerValue.tag_OctetString, rawBytes); try { this.privKeyMaterial = val.toByteArray(); } finally { val.clear(); } } /// Ctor from family name, and PKCS #8 bytes public NamedPKCS8Key(String fname, byte[] encoded) throws InvalidKeyException { super(encoded); this.fname = fname; try { paramSpec = new NamedParameterSpec(algid.getName()); if (algid.getEncodedParams() != null) { throw new InvalidKeyException("algorithm identifier has params"); } rawBytes = new DerInputStream(privKeyMaterial).getOctetString(); } catch (IOException e) { throw new InvalidKeyException("Cannot parse input", e); } } @Override public String toString() { // Do not modify: this can be used by earlier JDKs that // do not have the getParams() method return paramSpec.getName() + " private key"; } /// Returns the reference to the internal key. Caller must not modify /// the content or keep a reference. public byte[] getRawBytes() { return rawBytes; } @Override public NamedParameterSpec getParams() { return paramSpec; } @Override public String getAlgorithm() { return fname; } @java.io.Serial private void readObject(ObjectInputStream stream) throws IOException, ClassNotFoundException { throw new InvalidObjectException( "NamedPKCS8Key keys are not directly deserializable"); } @Override public void destroy() throws DestroyFailedException { Arrays.fill(rawBytes, (byte)0); Arrays.fill(privKeyMaterial, (byte)0); if (encodedKey != null) { Arrays.fill(encodedKey, (byte)0); } destroyed = true; } @Override public boolean isDestroyed() { return destroyed; } }