[ Web Proxy ]
URL:
Viewing: https://developer.android.com/reference/java/security/spec/PKCS8EncodedKeySpec [Back]  [Original]

PKCS8EncodedKeySpec  |  API reference  |  Android Developers Skip to main content
Essentials Design & Plan Develop Google Play Blog
Search:
Android Studio
Android Developers [Android Developers]
Stay organized with collections Save and categorize content based on your preferences.
Added in API level 1

PKCS8EncodedKeySpec

public class PKCS8EncodedKeySpec
extends EncodedKeySpec

java.lang.Object
   ↳ java.security.spec.EncodedKeySpec
     ↳ java.security.spec.PKCS8EncodedKeySpec


This class represents the ASN.1 encoding of a private key, encoded according to the ASN.1 type PrivateKeyInfo. The PrivateKeyInfo syntax is defined in the PKCS#8 standard as follows:

PrivateKeyInfo ::= SEQUENCE {
  version Version,
  privateKeyAlgorithm PrivateKeyAlgorithmIdentifier,
  privateKey PrivateKey,
  attributes [0] IMPLICIT Attributes OPTIONAL }

Version ::= INTEGER

PrivateKeyAlgorithmIdentifier ::= AlgorithmIdentifier

PrivateKey ::= OCTET STRING

Attributes ::= SET OF Attribute

See also:

Summary

Public constructors

PKCS8EncodedKeySpec(byte[] encodedKey)

Creates a new PKCS8EncodedKeySpec with the given encoded key.

PKCS8EncodedKeySpec(byte[] encodedKey, String algorithm)

Creates a new PKCS8EncodedKeySpec with the given encoded key and algorithm.

Public methods

byte[] getEncoded()

Returns the key bytes, encoded according to the PKCS #8 standard.

final String getFormat()

Returns the name of the encoding format associated with this key specification.

Inherited methods

Public constructors

PKCS8EncodedKeySpec

Added in API level 1
public PKCS8EncodedKeySpec (byte[] encodedKey)

Creates a new PKCS8EncodedKeySpec with the given encoded key.

Parameters
encodedKey byte: the key, which is assumed to be encoded according to the PKCS #8 standard. The contents of the array are copied to protect against subsequent modification.

Throws
NullPointerException if encodedKey is null.

PKCS8EncodedKeySpec

Added in API level 35
public PKCS8EncodedKeySpec (byte[] encodedKey, 
                String algorithm)

Creates a new PKCS8EncodedKeySpec with the given encoded key and algorithm. This constructor is useful when subsequent callers of the PKCS8EncodedKeySpec object might not know the algorithm of the private key.

Parameters
encodedKey byte: the key, which is assumed to be encoded according to the PKCS #8 standard. The contents of the array are copied to protect against subsequent modification.

algorithm String: the algorithm name of the encoded private key See the KeyFactory section in the Java Security Standard Algorithm Names Specification for information about standard algorithm names.

Throws
IllegalArgumentException if algorithm is the empty string ""
NullPointerException if encodedKey or algorithm is null.

Public methods

getEncoded

Added in API level 1
public byte[] getEncoded ()

Returns the key bytes, encoded according to the PKCS #8 standard.

Returns
byte[] the PKCS #8 encoding of the key. Returns a new array each time this method is called.

getFormat

Added in API level 1
public final String getFormat ()

Returns the name of the encoding format associated with this key specification.

Returns
String the string "PKCS#8".

Content and code samples on this page are subject to the licenses described in the Content License. Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.

Last updated 2026-08-03 UTC.

[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2026-08-03 UTC."],[],[]]

Web Proxy Viewer  |  New URL  |  Original Page