Class BcX509FrameworkAttributeMapper

java.lang.Object
zeroecho.pki.impl.framework.x509.bc.BcX509FrameworkAttributeMapper
All Implemented Interfaces:
FrameworkAttributeMapper
public final class BcX509FrameworkAttributeMapper extends Object implements FrameworkAttributeMapper
Minimal framework attribute mapper for the internal Bouncy Castle backed X.509 adapter.

This mapper forms the attribute-normalization boundary between higher PKI layers and the X.509 framework implementation. It accepts framework-facing AttributeSet values and returns the normalized attribute set that should be consumed by downstream X.509 adapter components.

The current implementation is intentionally minimal and acts as an identity mapper. It validates only that the supplied attribute set reference is not null and then returns it unchanged.

In a more feature-complete X.509 implementation, this component would be the natural place to apply framework-specific normalization rules such as:

  • OID validation and canonicalization,
  • distinguished-name normalization,
  • attribute catalogue enforcement,
  • validation of expected attribute value types for X.509-specific override identifiers.

Architectural role

This class does not perform certificate issuance, CSR parsing, or status- object generation. Its responsibility is limited to normalizing framework- specific attribute input before that input is consumed by other X.509 adapter components.

Security considerations

  • Framework attributes may contain operationally sensitive metadata or adapter-specific wiring values.
  • This implementation does not redact, filter, or validate attribute content.
  • Callers must not assume that the returned attribute set is safe for unrestricted logging or external exposure.

Thread-safety

This class is stateless and thread-safe.

  • Constructor Details

    • BcX509FrameworkAttributeMapper

      public BcX509FrameworkAttributeMapper()
      Creates the stateless X.509 framework attribute mapper.

  • Method Details

    • normalize

      public AttributeSet normalize(AttributeSet input)
      Normalizes the supplied framework attribute set.

      The current implementation performs only null checking and returns the input instance unchanged. No copying, canonicalization, validation, or enrichment is performed.

      Specified by:
      normalize in interface FrameworkAttributeMapper
      Parameters:
      input - framework-facing attribute set to normalize; must not be null
      Returns:
      the supplied attribute set unchanged
      Throws:
      IllegalArgumentException - if input is null