Deprecated API

Contents

• Deprecated Classes
• Deprecated Fields
• Deprecated Methods
• Deprecated Constructors
• Deprecated Enum Constants

Deprecated Classes

Class and Description
org.bouncycastle.bcpg.OutputStreamPacket Will be removed
org.bouncycastle.bcpg.sig.RevocationKey since RFC9580
org.bouncycastle.openpgp.operator.RFC6637KDFCalculator this class is no longer required and will be removed.

Deprecated Fields

Field and Description
org.bouncycastle.bcpg.PublicKeyAlgorithmTags.EC use PublicKeyAlgorithmTags.ECDH instead.
org.bouncycastle.bcpg.PublicKeyAlgorithmTags.EDDSA use PublicKeyAlgorithmTags.EDDSA_LEGACY instead.
org.bouncycastle.bcpg.PublicKeyAlgorithmTags.ELGAMAL_GENERAL use PublicKeyAlgorithmTags.ELGAMAL_ENCRYPT instead.
org.bouncycastle.bcpg.HashAlgorithmTags.MD4 non-standard
org.bouncycastle.bcpg.PublicKeyAlgorithmTags.RSA_ENCRYPT use PublicKeyAlgorithmTags.RSA_GENERAL instead.
org.bouncycastle.bcpg.PublicKeyAlgorithmTags.RSA_SIGN use PublicKeyAlgorithmTags.RSA_GENERAL instead.
org.bouncycastle.bcpg.S2K.SALTED use S2K.SALTED_AND_ITERATED or S2K.ARGON_2 instead.
org.bouncycastle.bcpg.HashAlgorithmTags.SHA3_224 non-standard
org.bouncycastle.bcpg.HashAlgorithmTags.SHA3_256_OLD non-standard
org.bouncycastle.bcpg.HashAlgorithmTags.SHA3_384 non-standard
org.bouncycastle.bcpg.HashAlgorithmTags.SHA3_512_OLD non-standard
org.bouncycastle.bcpg.S2K.SIMPLE use S2K.SALTED_AND_ITERATED or S2K.ARGON_2 instead.
org.bouncycastle.bcpg.HashAlgorithmTags.SM3 non-standard
org.bouncycastle.bcpg.SecretKeyPacket.USAGE_CHECKSUM Use of MalleableCFB is deprecated. For v4 keys, use SecretKeyPacket.USAGE_SHA1 instead. For v6 keys use SecretKeyPacket.USAGE_AEAD instead.

Deprecated Methods

Method and Description
org.bouncycastle.bcpg.ArmoredOutputStream.addHeader(String, String) use appropriate methods in ArmoredOutputStream.Builder instead
org.bouncycastle.openpgp.PGPSignatureSubpacketGenerator.addRevocationKey(boolean, int, byte[]) the revocation key mechanism is deprecated. Applications MUST NOT generate such a packet.
org.bouncycastle.bcpg.ArmoredOutputStream.clearHeaders() use appropriate methods in ArmoredOutputStream.Builder instead.
org.bouncycastle.openpgp.PGPPublicKeyEncryptedData.getDataStream(SessionKeyDataDecryptorFactory) will be removed in 1.74, use PGPEncryptedDataList.extractSessionKeyEncryptedData() and then apply the dataDecryptorFactory.
org.bouncycastle.openpgp.PGPPBEEncryptedData.getDataStream(SessionKeyDataDecryptorFactory) will be removed in 1.74, use PGPEncryptedDataList.extractSessionKeyEncryptedData() and then apply the dataDecryptorFactory.
org.bouncycastle.openpgp.PGPUtil.getDefaultProvider() unused
org.bouncycastle.bcpg.AEADEncDataPacket.getIVLength(byte) use AEADUtils.getIVLength()
org.bouncycastle.openpgp.PGPPublicKeyEncryptedData.getKeyID() use PGPPublicKeyEncryptedData.getKeyIdentifier() instead
org.bouncycastle.openpgp.PGPSignatureSubpacketVector.getNotationDataOccurences() use getNotationDataOccurrences()
org.bouncycastle.openpgp.operator.bc.BcPGPKeyConverter.getPGPPublicKey(int, PGPAlgorithmParameters, AsymmetricKeyParameter, Date) use versioned BcPGPKeyConverter.getPGPPublicKey(int, int, PGPAlgorithmParameters, AsymmetricKeyParameter, Date) instead
org.bouncycastle.openpgp.operator.jcajce.JcaPGPKeyConverter.getPGPPublicKey(int, PGPAlgorithmParameters, PublicKey, Date) use versioned JcaPGPKeyConverter.getPGPPublicKey(int, int, PGPAlgorithmParameters, PublicKey, Date) instead.
org.bouncycastle.openpgp.operator.jcajce.JcaPGPKeyConverter.getPGPPublicKey(int, PublicKey, Date) use versioned JcaPGPKeyConverter.getPGPPublicKey(int, int, PublicKey, Date) instead.
org.bouncycastle.openpgp.PGPSignatureSubpacketVector.getPreferredAEADAlgorithms() use PGPSignatureSubpacketVector.getPreferredAEADCiphersuites() or PGPSignatureSubpacketVector.getPreferredLibrePgpEncryptionModes() instead.
org.bouncycastle.bcpg.ExperimentalPacket.getTag() use getPacketTag();
org.bouncycastle.bcpg.PublicKeyPacket.getValidDays() v4 and v6 keys instead signal their expiration time via the KeyExpirationTime signature subpacket.
org.bouncycastle.openpgp.PGPPublicKey.getValidDays() use getValidSeconds(): greater than version 3 keys may be valid for less than a day.
org.bouncycastle.openpgp.PGPPublicKey.isRevoked() this method is poorly named, use hasRevocation().
org.bouncycastle.openpgp.api.MessageEncryptionMechanism.legacyEncryptedNonIntegrityProtected(int)
org.bouncycastle.openpgp.api.OpenPGPKeyReader.parseCertificateOrKey(byte[]) use OpenPGPKeyReader.parseKeyOrCertificate(byte[]) instead.
org.bouncycastle.openpgp.api.OpenPGPKeyReader.parseCertificateOrKey(InputStream) use OpenPGPKeyReader.parseKeyOrCertificate(InputStream) instead.
org.bouncycastle.openpgp.api.OpenPGPKeyReader.parseCertificateOrKey(String) use OpenPGPKeyReader.parseKeyOrCertificate(String) instead.
org.bouncycastle.openpgp.PGPSecretKey.parseSecretKeyFromSExpr(InputStream, PBEProtectionRemoverFactory, KeyFingerPrintCalculator) use org.bouncycastle.gpg.SExprParser - it will also allow you to verify the protection checksum if it is available.
org.bouncycastle.openpgp.PGPSecretKey.parseSecretKeyFromSExpr(InputStream, PBEProtectionRemoverFactory, PGPPublicKey) use org.bouncycastle.gpg.SExprParser - it will also allow you to verify the protection checksum if it is available.
org.bouncycastle.openpgp.operator.PublicKeyDataDecryptorFactory.recoverSessionData(int, byte[][]) use PublicKeyDataDecryptorFactory.recoverSessionData(PublicKeyEncSessionPacket, InputStreamPacket) instead.
org.bouncycastle.openpgp.operator.PublicKeyDataDecryptorFactory.recoverSessionData(int, byte[][], int) use PublicKeyDataDecryptorFactory.recoverSessionData(PublicKeyEncSessionPacket, InputStreamPacket) instead.
org.bouncycastle.bcpg.ArmoredOutputStream.resetHeaders() use ArmoredOutputStream.Builder.clearHeaders() instead.
org.bouncycastle.openpgp.PGPUtil.setDefaultProvider(String) unused
org.bouncycastle.bcpg.ArmoredInputStream.setDetectMissingCRC(boolean) use Builder class for configuring this.
org.bouncycastle.openpgp.PGPSignatureSubpacketGenerator.setEmbeddedSignature(boolean, PGPSignature) use PGPSignatureSubpacketGenerator.addEmbeddedSignature(boolean, PGPSignature) instead.
org.bouncycastle.bcpg.ArmoredOutputStream.setHeader(String, String) use appropriate methods in ArmoredOutputStream.Builder instead.
org.bouncycastle.openpgp.PGPSignatureSubpacketGenerator.setIntendedRecipientFingerprint(boolean, PGPPublicKey) use PGPSignatureSubpacketGenerator.addIntendedRecipientFingerprint(boolean, PGPPublicKey) instead.
org.bouncycastle.openpgp.PGPSignatureSubpacketGenerator.setNotationData(boolean, boolean, String, String) use PGPSignatureSubpacketGenerator.addNotationData(boolean, boolean, String, String) instead.
org.bouncycastle.openpgp.PGPSignatureSubpacketGenerator.setPreferredAEADAlgorithms(boolean, int[]) use PGPSignatureSubpacketGenerator.setPreferredAEADCiphersuites(boolean, PreferredAEADCiphersuites.Combination[]) or PGPSignatureSubpacketGenerator.setPreferredLibrePgpEncryptionModes(boolean, int[]) instead.
org.bouncycastle.openpgp.PGPSignatureSubpacketGenerator.setPreferredKeyServer(boolean, String) use PGPSignatureSubpacketGenerator.addPreferredKeyServer(boolean, String) instead.
org.bouncycastle.openpgp.PGPSignatureSubpacketGenerator.setPreferredLibrePgpEncryptionModes(boolean, int[]) the use of this subpacket is deprecated in LibrePGP
org.bouncycastle.openpgp.PGPSignatureSubpacketGenerator.setRevocationKey(boolean, int, byte[]) the revocation key mechanism is deprecated. Applications MUST NOT generate such a packet.
org.bouncycastle.openpgp.PGPSignatureSubpacketGenerator.setSignerUserID(boolean, byte[]) use PGPSignatureSubpacketGenerator.addSignerUserID(boolean, byte[]) instead.
org.bouncycastle.openpgp.PGPSignatureSubpacketGenerator.setSignerUserID(boolean, String) use PGPSignatureSubpacketGenerator.addSignerUserID(boolean, String) instead.
org.bouncycastle.openpgp.operator.PublicKeyKeyEncryptionMethodGenerator.setUseWildcardKeyID(boolean) use PublicKeyKeyEncryptionMethodGenerator.setUseWildcardRecipient(boolean) instead TODO: Remove in a future release
org.bouncycastle.bcpg.BCPGInputStream.skipMarkerPackets() use skipMarkerAndPaddingPackets
org.bouncycastle.bcpg.sig.SignatureCreationTime.timeToBytes(Date) Will be removed
org.bouncycastle.bcpg.sig.SignatureExpirationTime.timeToBytes(long) Will be removed
org.bouncycastle.bcpg.sig.KeyExpirationTime.timeToBytes(long) Will be removed

Deprecated Constructors

Constructor and Description
org.bouncycastle.openpgp.operator.bc.BcPGPKeyPair(int, AsymmetricCipherKeyPair, Date)
org.bouncycastle.openpgp.operator.bc.BcPGPKeyPair(int, PGPAlgorithmParameters, AsymmetricCipherKeyPair, Date)
org.bouncycastle.openpgp.operator.jcajce.JcaPGPKeyPair(int, KeyPair, Date) use versioned JcaPGPKeyPair(int, int, KeyPair, Date) instead
org.bouncycastle.openpgp.operator.jcajce.JcaPGPKeyPair(int, PGPAlgorithmParameters, KeyPair, Date) use versioned JcaPGPKeyPair(int, int, PGPAlgorithmParameters, KeyPair, Date) instead
org.bouncycastle.openpgp.PGPSignatureGenerator(PGPContentSignerBuilder) use PGPSignatureGenerator(PGPContentSignerBuilder, PGPPublicKey) instead.
org.bouncycastle.bcpg.PublicKeyPacket(int, Date, BCPGKey) use versioned PublicKeyPacket(int, int, Date, BCPGKey) instead
org.bouncycastle.bcpg.PublicSubkeyPacket(int, Date, BCPGKey) use versioned PublicSubkeyPacket(int, int, Date, BCPGKey) instead
org.bouncycastle.bcpg.SymmetricEncIntegrityPacket() use createVersion1Packet()
org.bouncycastle.bcpg.SymmetricKeyEncSessionPacket(int, S2K, byte[]) use SymmetricKeyEncSessionPacket.createV4Packet(int, S2K, byte[]) instead

Deprecated Enum Constants

Enum Constant and Description
org.bouncycastle.openpgp.api.EncryptedDataPacketType.SED