|
Bouncy Castle Cryptography Library 1.87 | |||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
java.lang.Objectorg.bouncycastle.pkcs.util.PKCS12Util
Utility class for re-encoding PKCS#12 files to definite length.
Replaces PKCS12Util; this class additionally
understands RFC 9579 PBMAC1 protected PFX files.
| Constructor Summary | |
PKCS12Util()
|
|
| Method Summary | |
static byte[] |
convertToDefiniteLength(byte[] berPKCS12File)
Just re-encode the outer layer of the PKCS#12 file to definite length encoding. |
static byte[] |
convertToDefiniteLength(byte[] berPKCS12File,
char[] passwd)
Re-encode the PKCS#12 structure to definite length encoding at the inner layer as well, recomputing the MAC accordingly. |
static byte[] |
convertToDefiniteLength(byte[] berPKCS12File,
char[] passwd,
java.security.Provider provider)
Re-encode the PKCS#12 structure to definite length encoding at the inner layer as well, recomputing the MAC accordingly. |
static byte[] |
convertToDefiniteLength(byte[] berPKCS12File,
char[] passwd,
java.lang.String provider)
Re-encode the PKCS#12 structure to definite length encoding at the inner layer as well, recomputing the MAC accordingly. |
static org.bouncycastle.asn1.ASN1Encodable |
getContent(org.bouncycastle.asn1.pkcs.ContentInfo contentInfo)
Return the content of a ContentInfo, raising ASN1ParsingException if absent. |
static byte[] |
getContentOctets(org.bouncycastle.asn1.pkcs.ContentInfo contentInfo)
Return the octets carried by a ContentInfo, raising ASN1ParsingException if the
content is absent or not an . |
static org.bouncycastle.asn1.ASN1OctetString |
getEncryptedContent(org.bouncycastle.asn1.pkcs.EncryptedData encryptedData)
Return the ciphertext octets of an EncryptedData, raising
ASN1ParsingException if absent. |
static int |
validateIterationCount(java.math.BigInteger ic)
Validate an iteration count from a PFX, enforcing the cap configured via the Properties.PKCS12_MAX_IT_COUNT security property (default
5,000,000). |
static int |
validateKeyLength(java.math.BigInteger keyLength)
Validate a PBKDF2 keyLength from a PFX. |
static int |
validateMacKeyLength(java.math.BigInteger keyLength)
Validate a PBKDF2 keyLength that will size a PBMAC1 MAC key. |
| Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
| Constructor Detail |
public PKCS12Util()
| Method Detail |
public static byte[] convertToDefiniteLength(byte[] berPKCS12File)
throws java.io.IOException
berPKCS12File - - original PKCS#12 file
java.io.IOException
public static byte[] convertToDefiniteLength(byte[] berPKCS12File,
char[] passwd)
throws java.io.IOException
berPKCS12File - - original PKCS12 file.
java.io.IOException - on parsing, encoding errors.
public static byte[] convertToDefiniteLength(byte[] berPKCS12File,
char[] passwd,
java.lang.String provider)
throws java.io.IOException
berPKCS12File - - original PKCS12 file.provider - - provider name to use for MAC calculation.
java.io.IOException - on parsing, encoding errors.
public static byte[] convertToDefiniteLength(byte[] berPKCS12File,
char[] passwd,
java.security.Provider provider)
throws java.io.IOException
berPKCS12File - - original PKCS12 file.provider - - provider to use for MAC calculation.
java.io.IOException - on parsing, encoding errors.
public static org.bouncycastle.asn1.ASN1Encodable getContent(org.bouncycastle.asn1.pkcs.ContentInfo contentInfo)
throws java.io.IOException
ASN1ParsingException if absent.
contentInfo - the ContentInfo to inspect.
java.io.IOException - on ASN.1 parsing errors.
public static byte[] getContentOctets(org.bouncycastle.asn1.pkcs.ContentInfo contentInfo)
throws java.io.IOException
ASN1ParsingException if the
content is absent or not an .
contentInfo - the ContentInfo to inspect.
java.io.IOException - on ASN.1 parsing errors.
public static org.bouncycastle.asn1.ASN1OctetString getEncryptedContent(org.bouncycastle.asn1.pkcs.EncryptedData encryptedData)
throws java.io.IOException
EncryptedData, raising
ASN1ParsingException if absent.
encryptedData - the EncryptedData to inspect.
java.io.IOException - on ASN.1 parsing errors.public static int validateKeyLength(java.math.BigInteger keyLength)
keyLength - the keyLength from the wire.
java.lang.IllegalStateException - if the keyLength is absent, not positive, or larger than the
maximum supported.public static int validateMacKeyLength(java.math.BigInteger keyLength)
validateKeyLength(BigInteger), plus the floor RFC 9579 sec. 9 asks for: "It's
RECOMMENDED to reject any KDF parameters that specify key lengths less than 20 octets." A MAC
key of one or two octets is brute-forceable, so a PFX declaring one would have its integrity
MAC checked against a key an attacker can guess without knowing the password. Sec. 5 has the
length SHOULD match the HMAC output size, so no conforming file comes near the floor.
This is deliberately separate from validateKeyLength(BigInteger), which also bounds
the PBES2 content-encryption keyLength - where 16 octets (AES-128) is legal and BC
writes it itself. The upper bound stays at 1024 rather than the HMAC output size for the
mirror-image reason: BC's PKCS12-PBMAC1 keystore asked for a 256-octet MAC key up to release
1.86, so a cap at the output size would refuse files BC itself produced.
keyLength - the keyLength from the wire.
java.lang.IllegalStateException - if the keyLength is absent, not positive, below 20 octets, or
larger than the maximum supported.public static int validateIterationCount(java.math.BigInteger ic)
Properties.PKCS12_MAX_IT_COUNT security property (default
5,000,000). Negative values and values that do not fit in a signed 32-bit integer are
also rejected.
ic - the iteration count from the wire.
java.lang.IllegalStateException - if the iteration count is negative, larger than the
configured maximum, or does not fit in a signed 32-bit integer.
|
Bouncy Castle Cryptography Library 1.87 | |||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||