Top Description Fields Constructors Methods
org.bouncycastle.asn1.isismtt.x509

public Class AdmissionSyntax

extends ASN1Object
Class Inheritance
Imports
java.util.Enumeration, org.bouncycastle.asn1.ASN1EncodableVector, .ASN1Object, .ASN1Primitive, .ASN1Sequence, .DERSequence, org.bouncycastle.asn1.x509.GeneralName

Attribute to indicate admissions to certain professions.
    AdmissionSyntax ::= SEQUENCE
    {
      admissionAuthority GeneralName OPTIONAL,
      contentsOfAdmissions SEQUENCE OF Admissions
    }

    Admissions ::= SEQUENCE
    {
      admissionAuthority [0] EXPLICIT GeneralName OPTIONAL
      namingAuthority [1] EXPLICIT NamingAuthority OPTIONAL
      professionInfos SEQUENCE OF ProfessionInfo
    }

    NamingAuthority ::= SEQUENCE
    {
      namingAuthorityId OBJECT IDENTIFIER OPTIONAL,
      namingAuthorityUrl IA5String OPTIONAL,
      namingAuthorityText DirectoryString(SIZE(1..128)) OPTIONAL
    }

    ProfessionInfo ::= SEQUENCE
    {
      namingAuthority [0] EXPLICIT NamingAuthority OPTIONAL,
      professionItems SEQUENCE OF DirectoryString (SIZE(1..128)),
      professionOIDs SEQUENCE OF OBJECT IDENTIFIER OPTIONAL,
      registrationNumber PrintableString(SIZE(1..128)) OPTIONAL,
      addProfessionInfo OCTET STRING OPTIONAL
    }

ISIS-MTT PROFILE: The relatively complex structure of AdmissionSyntax supports the following concepts and requirements:

By means of different namingAuthority-OIDs or profession OIDs hierarchies of professions, specializations, disciplines, fields of activity, etc. can be expressed. The issuing admission authority should always be indicated (field admissionAuthority), whenever a registration number is presented. Still, information on admissions can be given without indicating an admission or a naming authority by the exclusive use of the component professionItems. In this case the certification authority is responsible for the verification of the admission information.

This attribute is single-valued. Still, several admissions can be captured in the sequence structure of the component contentsOfAdmissions of AdmissionSyntax or in the component professionInfos of Admissions. The component admissionAuthority of AdmissionSyntax serves as default value for the component admissionAuthority of Admissions. Within the latter component the default value can be overwritten, in case that another authority is responsible. The component namingAuthority of Admissions serves as a default value for the component namingAuthority of ProfessionInfo. Within the latter component the default value can be overwritten, in case that another naming authority needs to be recorded.

The length of the string objects is limited to 128 characters. It is recommended to indicate a namingAuthorityURL in all issued attribute certificates. If a namingAuthorityURL is indicated, the field professionItems of ProfessionInfo should contain only registered titles. If the field professionOIDs exists, it has to contain the OIDs of the professions listed in professionItems in the same order. In general, the field professionInfos should contain only one entry, unless the admissions that are to be listed are logically connected (e.g. they have been issued under the same admission number).

See Also
org.bouncycastle.asn1.isismtt.x509.Admissions, org.bouncycastle.asn1.isismtt.x509.ProfessionInfo, org.bouncycastle.asn1.isismtt.x509.NamingAuthority

Field Summary

Modifier and TypeField and Description
private GeneralName
private ASN1Sequence

Constructor Summary

AccessConstructor and Description
private
AdmissionSyntax(ASN1Sequence
The ASN.1 sequence.
seq
)

Constructor from ASN1Sequence.

public
AdmissionSyntax(GeneralName
The admission authority.
admissionAuthority
,
ASN1Sequence
The admissions.
contentsOfAdmissions
)

Constructor from given details.

Method Summary

Modifier and TypeMethod and Description
public GeneralName

Returns:

Returns the admissionAuthority if present, null otherwise.
getAdmissionAuthority
()

public Admissions[]

Returns:

Returns the contentsOfAdmissions.
getContentsOfAdmissions
()

public static AdmissionSyntax
public ASN1Primitive

Returns:

a DERObject
toASN1Primitive
()

Implements abstract org.bouncycastle.asn1.ASN1Object.toASN1Primitive.

Implements org.bouncycastle.asn1.ASN1Encodable.toASN1Primitive.

Produce an object suitable for an ASN1OutputStream.

Inherited from org.bouncycastle.asn1.ASN1Object:
encodeToencodeToequalsgetEncodedgetEncodedhasEncodedTagValuehashCode

Field Detail

admissionAuthorityback to summary
private GeneralName admissionAuthority
contentsOfAdmissionsback to summary
private ASN1Sequence contentsOfAdmissions

Constructor Detail

AdmissionSyntaxback to summary
private AdmissionSyntax(ASN1Sequence seq)

Constructor from ASN1Sequence.

The sequence is of type ProcurationSyntax:

    AdmissionSyntax ::= SEQUENCE
    {
      admissionAuthority GeneralName OPTIONAL,
      contentsOfAdmissions SEQUENCE OF Admissions
    }

    Admissions ::= SEQUENCE
    {
      admissionAuthority [0] EXPLICIT GeneralName OPTIONAL
      namingAuthority [1] EXPLICIT NamingAuthority OPTIONAL
      professionInfos SEQUENCE OF ProfessionInfo
    }

    NamingAuthority ::= SEQUENCE
    {
      namingAuthorityId OBJECT IDENTIFIER OPTIONAL,
      namingAuthorityUrl IA5String OPTIONAL,
      namingAuthorityText DirectoryString(SIZE(1..128)) OPTIONAL
    }

    ProfessionInfo ::= SEQUENCE
    {
      namingAuthority [0] EXPLICIT NamingAuthority OPTIONAL,
      professionItems SEQUENCE OF DirectoryString (SIZE(1..128)),
      professionOIDs SEQUENCE OF OBJECT IDENTIFIER OPTIONAL,
      registrationNumber PrintableString(SIZE(1..128)) OPTIONAL,
      addProfessionInfo OCTET STRING OPTIONAL
    }

Parameters
seq:ASN1Sequence

The ASN.1 sequence.

AdmissionSyntaxback to summary
public AdmissionSyntax(GeneralName admissionAuthority, ASN1Sequence contentsOfAdmissions)

Constructor from given details.

Parameters
admissionAuthority:GeneralName

The admission authority.

contentsOfAdmissions:ASN1Sequence

The admissions.

Method Detail

getAdmissionAuthorityback to summary
public GeneralName getAdmissionAuthority()
Returns:GeneralName

Returns the admissionAuthority if present, null otherwise.

getContentsOfAdmissionsback to summary
public Admissions[] getContentsOfAdmissions()
Returns:Admissions[]

Returns the contentsOfAdmissions.

getInstanceback to summary
public static AdmissionSyntax getInstance(Object obj)
toASN1Primitiveback to summary
public ASN1Primitive toASN1Primitive()

Implements abstract org.bouncycastle.asn1.ASN1Object.toASN1Primitive.

Implements org.bouncycastle.asn1.ASN1Encodable.toASN1Primitive.

Produce an object suitable for an ASN1OutputStream.

Returns:

    AdmissionSyntax ::= SEQUENCE
    {
      admissionAuthority GeneralName OPTIONAL,
      contentsOfAdmissions SEQUENCE OF Admissions
    }

    Admissions ::= SEQUENCE
    {
      admissionAuthority [0] EXPLICIT GeneralName OPTIONAL
      namingAuthority [1] EXPLICIT NamingAuthority OPTIONAL
      professionInfos SEQUENCE OF ProfessionInfo
    }

    NamingAuthority ::= SEQUENCE
    {
      namingAuthorityId OBJECT IDENTIFIER OPTIONAL,
      namingAuthorityUrl IA5String OPTIONAL,
      namingAuthorityText DirectoryString(SIZE(1..128)) OPTIONAL
    }

    ProfessionInfo ::= SEQUENCE
    {
      namingAuthority [0] EXPLICIT NamingAuthority OPTIONAL,
      professionItems SEQUENCE OF DirectoryString (SIZE(1..128)),
      professionOIDs SEQUENCE OF OBJECT IDENTIFIER OPTIONAL,
      registrationNumber PrintableString(SIZE(1..128)) OPTIONAL,
      addProfessionInfo OCTET STRING OPTIONAL
    }
Returns:ASN1Primitive

a DERObject