package org.bouncycastle.asn1.x509;

import org.bouncycastle.asn1.ASN1Encodable;
import org.bouncycastle.asn1.ASN1EncodableVector;
import org.bouncycastle.asn1.ASN1Sequence;
import org.bouncycastle.asn1.ASN1TaggedObject;
import org.bouncycastle.asn1.DERObject;
import org.bouncycastle.asn1.DERSequence;
import org.bouncycastle.asn1.DERTaggedObject;

The Holder object.

For an v2 attribute certificate this is:

           Holder ::= SEQUENCE {
                 baseCertificateID   [0] IssuerSerial OPTIONAL,
                          -- the issuer and serial number of
                          -- the holder's Public Key Certificate
                 entityName          [1] GeneralNames OPTIONAL,
                          -- the name of the claimant or role
                 objectDigestInfo    [2] ObjectDigestInfo OPTIONAL
                          -- used to directly authenticate the holder,
                          -- for example, an executable
           }

For an v1 attribute certificate this is:

        subject CHOICE {
         baseCertificateID [0] IssuerSerial,
         -- associated with a Public Key Certificate
         subjectName [1] GeneralNames },
         -- associated with a name
/** * The Holder object. * <p> * For an v2 attribute certificate this is: * * <pre> * Holder ::= SEQUENCE { * baseCertificateID [0] IssuerSerial OPTIONAL, * -- the issuer and serial number of * -- the holder's Public Key Certificate * entityName [1] GeneralNames OPTIONAL, * -- the name of the claimant or role * objectDigestInfo [2] ObjectDigestInfo OPTIONAL * -- used to directly authenticate the holder, * -- for example, an executable * } * </pre> * * <p> * For an v1 attribute certificate this is: * * <pre> * subject CHOICE { * baseCertificateID [0] IssuerSerial, * -- associated with a Public Key Certificate * subjectName [1] GeneralNames }, * -- associated with a name * </pre> */
public class Holder extends ASN1Encodable { IssuerSerial baseCertificateID; GeneralNames entityName; ObjectDigestInfo objectDigestInfo; private int version = 1; public static Holder getInstance(Object obj) { if (obj instanceof Holder) { return (Holder)obj; } else if (obj instanceof ASN1Sequence) { return new Holder((ASN1Sequence)obj); } else if (obj instanceof ASN1TaggedObject) { return new Holder((ASN1TaggedObject)obj); } throw new IllegalArgumentException("unknown object in factory: " + obj.getClass().getName()); }
Constructor for a holder for an v1 attribute certificate.
Params:
  • tagObj – The ASN.1 tagged holder object.
/** * Constructor for a holder for an v1 attribute certificate. * * @param tagObj The ASN.1 tagged holder object. */
public Holder(ASN1TaggedObject tagObj) { switch (tagObj.getTagNo()) { case 0: baseCertificateID = IssuerSerial.getInstance(tagObj, false); break; case 1: entityName = GeneralNames.getInstance(tagObj, false); break; default: throw new IllegalArgumentException("unknown tag in Holder"); } version = 0; }
Constructor for a holder for an v2 attribute certificate. *
Params:
  • seq – The ASN.1 sequence.
/** * Constructor for a holder for an v2 attribute certificate. * * * @param seq The ASN.1 sequence. */
public Holder(ASN1Sequence seq) { if (seq.size() > 3) { throw new IllegalArgumentException("Bad sequence size: " + seq.size()); } for (int i = 0; i != seq.size(); i++) { ASN1TaggedObject tObj = ASN1TaggedObject.getInstance(seq .getObjectAt(i)); switch (tObj.getTagNo()) { case 0: baseCertificateID = IssuerSerial.getInstance(tObj, false); break; case 1: entityName = GeneralNames.getInstance(tObj, false); break; case 2: objectDigestInfo = ObjectDigestInfo.getInstance(tObj, false); break; default: throw new IllegalArgumentException("unknown tag in Holder"); } } version = 1; } public Holder(IssuerSerial baseCertificateID) { this.baseCertificateID = baseCertificateID; }
Constructs a holder from a IssuerSerial.
Params:
  • baseCertificateID – The IssuerSerial.
  • version – The version of the attribute certificate.
/** * Constructs a holder from a IssuerSerial. * @param baseCertificateID The IssuerSerial. * @param version The version of the attribute certificate. */
public Holder(IssuerSerial baseCertificateID, int version) { this.baseCertificateID = baseCertificateID; this.version = version; }
Returns 1 for v2 attribute certificates or 0 for v1 attribute certificates.
Returns:The version of the attribute certificate.
/** * Returns 1 for v2 attribute certificates or 0 for v1 attribute * certificates. * @return The version of the attribute certificate. */
public int getVersion() { return version; }
Constructs a holder with an entityName for v2 attribute certificates or with a subjectName for v1 attribute certificates.
Params:
  • entityName – The entity or subject name.
/** * Constructs a holder with an entityName for v2 attribute certificates or * with a subjectName for v1 attribute certificates. * * @param entityName The entity or subject name. */
public Holder(GeneralNames entityName) { this.entityName = entityName; }
Constructs a holder with an entityName for v2 attribute certificates or with a subjectName for v1 attribute certificates.
Params:
  • entityName – The entity or subject name.
  • version – The version of the attribute certificate.
/** * Constructs a holder with an entityName for v2 attribute certificates or * with a subjectName for v1 attribute certificates. * * @param entityName The entity or subject name. * @param version The version of the attribute certificate. */
public Holder(GeneralNames entityName, int version) { this.entityName = entityName; this.version = version; }
Constructs a holder from an object digest info.
Params:
  • objectDigestInfo – The object digest info object.
/** * Constructs a holder from an object digest info. * * @param objectDigestInfo The object digest info object. */
public Holder(ObjectDigestInfo objectDigestInfo) { this.objectDigestInfo = objectDigestInfo; } public IssuerSerial getBaseCertificateID() { return baseCertificateID; }
Returns the entityName for an v2 attribute certificate or the subjectName for an v1 attribute certificate.
Returns:The entityname or subjectname.
/** * Returns the entityName for an v2 attribute certificate or the subjectName * for an v1 attribute certificate. * * @return The entityname or subjectname. */
public GeneralNames getEntityName() { return entityName; } public ObjectDigestInfo getObjectDigestInfo() { return objectDigestInfo; } public DERObject toASN1Object() { if (version == 1) { ASN1EncodableVector v = new ASN1EncodableVector(); if (baseCertificateID != null) { v.add(new DERTaggedObject(false, 0, baseCertificateID)); } if (entityName != null) { v.add(new DERTaggedObject(false, 1, entityName)); } if (objectDigestInfo != null) { v.add(new DERTaggedObject(false, 2, objectDigestInfo)); } return new DERSequence(v); } else { if (entityName != null) { return new DERTaggedObject(false, 1, entityName); } else { return new DERTaggedObject(false, 0, baseCertificateID); } } } }