Class MacData

Represents a MacData structure in a PKCS#12 file.

Asn

MacData ::= SEQUENCE {
   mac        DigestInfo,
   macSalt    OCTET STRING,
   iterations INTEGER DEFAULT 1
}

Hierarchy (View Summary)

PkiBase<MacData>
- MacData

Index

Constructors

constructor

new MacData(
    options: {
        iterations?: number;
        mac: DigestInfo;
        macSalt: Uint8Array<ArrayBuffer> | OctetString;
    },
): MacData
Parameters
- options: {
      iterations?: number;
      mac: DigestInfo;
      macSalt: Uint8Array<ArrayBuffer> | OctetString;
  }
Returns MacData
Overrides PkiBase.constructor
- Defined in packages/pki-lite/src/pkcs12/MacData.ts:26

Properties

iterations

iterations: number

mac

mac: DigestInfo

macSalt

macSalt: OctetString

Accessors

pemHeader

get pemHeader(): string
Gets the PEM header name for this object type. Converts the class name to uppercase for use in PEM encoding.

Returns string
Inherited from PkiBase.pemHeader
- Defined in packages/pki-lite/src/core/PkiBase.ts:60

pkiType

get pkiType(): string
Gets the PKI type name for this object (typically the class name). Used for PEM headers and debugging output.

Returns string
Inherited from PkiBase.pkiType
- Defined in packages/pki-lite/src/core/PkiBase.ts:52

Methods

equals

equals(other: PkiBase<any>): boolean
Compares this PKI object with another for equality. Two objects are considered equal if their DER encodings are identical.
Parameters
- other: PkiBase<any>
  The other PKI object to compare with
Returns boolean
true if the objects are equal, false otherwise
Inherited from PkiBase.equals
- Defined in packages/pki-lite/src/core/PkiBase.ts:122

parseAs

parseAs<T>(type: ParseableAsn1<T>): T
Parses this object as a different PKI type. Useful for converting between related PKI structures.
Type Parameters
- T
  The target type to parse as
Parameters
- type: ParseableAsn1<T>
  The target type constructor with parsing capabilities
Returns T
A new instance of the target type
Inherited from PkiBase.parseAs
- Defined in packages/pki-lite/src/core/PkiBase.ts:134

toAsn1

toAsn1(): Asn1BaseBlock
Converts this PKI object to its ASN.1 representation.

Returns Asn1BaseBlock
The ASN.1 representation of this object
Overrides PkiBase.toAsn1
- Defined in packages/pki-lite/src/pkcs12/MacData.ts:40

toDer

toDer(): Uint8Array<ArrayBuffer>
Converts this PKI object to DER (Distinguished Encoding Rules) format.

Returns Uint8Array<ArrayBuffer>
The DER-encoded bytes of this object
Inherited from PkiBase.toDer
- Defined in packages/pki-lite/src/core/PkiBase.ts:100

toHumanString

toHumanString(): string
Returns a human-readable string representation of this object. By default, returns the same as toString(), but subclasses can override for more user-friendly output.

Returns string
A human-readable string representation
Inherited from PkiBase.toHumanString
- Defined in packages/pki-lite/src/core/PkiBase.ts:90

toJSON

toJSON(): ToJson<T>
Converts this object to a JSON representation.

Returns ToJson<T>
A JSON-serializable representation of this object
Inherited from PkiBase.toJSON
- Defined in packages/pki-lite/src/core/PkiBase.ts:69

toPem

toPem(): string
Converts this PKI object to PEM (Privacy-Enhanced Mail) format.

Returns string
A PEM-encoded string with appropriate headers
Inherited from PkiBase.toPem
- Defined in packages/pki-lite/src/core/PkiBase.ts:109

toString

toString(): string
Returns a string representation of this PKI object. Includes the type name and ASN.1 structure.

Returns string
A string representation for debugging
Inherited from PkiBase.toString
- Defined in packages/pki-lite/src/core/PkiBase.ts:79

`Static`create

create(
    data: Uint8Array<ArrayBuffer>,
    password: string | Uint8Array<ArrayBuffer>,
    iterations: number,
    hash?: HashAlgorithm,
): Promise<MacData>
Creates a PKCS#12 MacData: HMAC over data keyed by a key derived using the PKCS#12 password-based KDF (RFC 7292 Appendix B).

Note: Uses the legacy PKCS#12 KDF for MAC key derivation to maintain compatibility with OpenSSL and other PKCS#12 implementations.
Parameters
- data: Uint8Array<ArrayBuffer>
  The data to compute MAC over
- password: string | Uint8Array<ArrayBuffer>
  The password (string or bytes)
- iterations: number
  Iteration count for KDF
- hash: HashAlgorithm = 'SHA-256'
  Hash algorithm to use (default: SHA-256)
Returns Promise<MacData>
Promise resolving to MacData instance
- Defined in packages/pki-lite/src/pkcs12/MacData.ts:89

`Static`fromAsn1

fromAsn1(asn1: Asn1BaseBlock): MacData
Parameters
- asn1: Asn1BaseBlock
Returns MacData
- Defined in packages/pki-lite/src/pkcs12/MacData.ts:51

`Static`fromDer

fromDer(der: Uint8Array<ArrayBuffer>): MacData
Parameters
- der: Uint8Array<ArrayBuffer>
Returns MacData
- Defined in packages/pki-lite/src/pkcs12/MacData.ts:72

Class MacData

Asn

Hierarchy (View Summary)

Index

Constructors

Properties

Accessors

Methods

Constructors

constructor

Parameters

Returns MacData

Properties

iterations

mac

macSalt

Accessors

pemHeader

Returns string

pkiType

Returns string

Methods

equals

Parameters

Returns boolean

parseAs

Type Parameters

Parameters

Returns T

toAsn1

Returns Asn1BaseBlock

toDer

Returns Uint8Array<ArrayBuffer>

toHumanString

Returns string

toJSON

Returns ToJson<T>

toPem

Returns string

toString

Returns string

Staticcreate

Parameters

Returns Promise<MacData>

StaticfromAsn1

Parameters

Returns MacData

StaticfromDer

Parameters

Returns MacData

Settings

On This Page

`Static`create

`Static`fromAsn1

`Static`fromDer