| /* |
| * Copyright (c) 2000, Oracle and/or its affiliates. All rights reserved. |
| * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. |
| * |
| * This code is free software; you can redistribute it and/or modify it |
| * under the terms of the GNU General Public License version 2 only, as |
| * published by the Free Software Foundation. Oracle designates this |
| * particular file as subject to the "Classpath" exception as provided |
| * by Oracle in the LICENSE file that accompanied this code. |
| * |
| * This code is distributed in the hope that it will be useful, but WITHOUT |
| * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or |
| * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License |
| * version 2 for more details (a copy is included in the LICENSE file that |
| * accompanied this code). |
| * |
| * You should have received a copy of the GNU General Public License version |
| * 2 along with this work; if not, write to the Free Software Foundation, |
| * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. |
| * |
| * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA |
| * or visit www.oracle.com if you need additional information or have any |
| * questions. |
| */ |
| |
| package sun.security.x509; |
| |
| import java.io.IOException; |
| import sun.security.util.DerValue; |
| import sun.security.util.DerOutputStream; |
| |
| /** |
| * This class defines the X400Address of the GeneralName choice. |
| * <p> |
| * The ASN.1 syntax for this is: |
| * <pre> |
| * ORAddress ::= SEQUENCE { |
| * built-in-standard-attributes BuiltInStandardAttributes, |
| * built-in-domain-defined-attributes |
| * BuiltInDomainDefinedAttributes OPTIONAL, |
| * -- see also teletex-domain-defined-attributes |
| * extension-attributes ExtensionAttributes OPTIONAL } |
| * -- The OR-address is semantically absent from the OR-name if the |
| * -- built-in-standard-attribute sequence is empty and the |
| * -- built-in-domain-defined-attributes and extension-attributes are |
| * -- both omitted. |
| * |
| * -- Built-in Standard Attributes |
| * |
| * BuiltInStandardAttributes ::= SEQUENCE { |
| * country-name CountryName OPTIONAL, |
| * administration-domain-name AdministrationDomainName OPTIONAL, |
| * network-address [0] NetworkAddress OPTIONAL, |
| * -- see also extended-network-address |
| * terminal-identifier [1] TerminalIdentifier OPTIONAL, |
| * private-domain-name [2] PrivateDomainName OPTIONAL, |
| * organization-name [3] OrganizationName OPTIONAL, |
| * -- see also teletex-organization-name |
| * numeric-user-identifier [4] NumericUserIdentifier OPTIONAL, |
| * personal-name [5] PersonalName OPTIONAL, |
| * -- see also teletex-personal-name |
| * organizational-unit-names [6] OrganizationalUnitNames OPTIONAL |
| * -- see also teletex-organizational-unit-names -- } |
| * |
| * CountryName ::= [APPLICATION 1] CHOICE { |
| * x121-dcc-code NumericString |
| * (SIZE (ub-country-name-numeric-length)), |
| * iso-3166-alpha2-code PrintableString |
| * (SIZE (ub-country-name-alpha-length)) } |
| * |
| * AdministrationDomainName ::= [APPLICATION 2] CHOICE { |
| * numeric NumericString (SIZE (0..ub-domain-name-length)), |
| * printable PrintableString (SIZE (0..ub-domain-name-length)) } |
| * |
| * NetworkAddress ::= X121Address -- see also extended-network-address |
| * |
| * X121Address ::= NumericString (SIZE (1..ub-x121-address-length)) |
| * |
| * TerminalIdentifier ::= PrintableString (SIZE (1..ub-terminal-id-length)) |
| * |
| * PrivateDomainName ::= CHOICE { |
| * numeric NumericString (SIZE (1..ub-domain-name-length)), |
| * printable PrintableString (SIZE (1..ub-domain-name-length)) } |
| * |
| * OrganizationName ::= PrintableString |
| * (SIZE (1..ub-organization-name-length)) |
| * -- see also teletex-organization-name |
| * |
| * NumericUserIdentifier ::= NumericString |
| * (SIZE (1..ub-numeric-user-id-length)) |
| * |
| * PersonalName ::= SET { |
| * surname [0] PrintableString (SIZE (1..ub-surname-length)), |
| * given-name [1] PrintableString |
| * (SIZE (1..ub-given-name-length)) OPTIONAL, |
| * initials [2] PrintableString (SIZE (1..ub-initials-length)) OPTIONAL, |
| * generation-qualifier [3] PrintableString |
| * (SIZE (1..ub-generation-qualifier-length)) OPTIONAL } |
| * -- see also teletex-personal-name |
| * |
| * OrganizationalUnitNames ::= SEQUENCE SIZE (1..ub-organizational-units) |
| * OF OrganizationalUnitName |
| * -- see also teletex-organizational-unit-names |
| * |
| * OrganizationalUnitName ::= PrintableString (SIZE |
| * (1..ub-organizational-unit-name-length)) |
| * |
| * -- Built-in Domain-defined Attributes |
| * |
| * BuiltInDomainDefinedAttributes ::= SEQUENCE SIZE |
| * (1..ub-domain-defined-attributes) OF |
| * BuiltInDomainDefinedAttribute |
| * |
| * BuiltInDomainDefinedAttribute ::= SEQUENCE { |
| * type PrintableString (SIZE |
| * (1..ub-domain-defined-attribute-type-length)), |
| * value PrintableString (SIZE |
| * (1..ub-domain-defined-attribute-value-length))} |
| * |
| * -- Extension Attributes |
| * |
| * ExtensionAttributes ::= SET SIZE (1..ub-extension-attributes) OF |
| * ExtensionAttribute |
| * |
| * ExtensionAttribute ::= SEQUENCE { |
| * extension-attribute-type [0] INTEGER (0..ub-extension-attributes), |
| * extension-attribute-value [1] |
| * ANY DEFINED BY extension-attribute-type } |
| * |
| * -- Extension types and attribute values |
| * -- |
| * |
| * common-name INTEGER ::= 1 |
| * |
| * CommonName ::= PrintableString (SIZE (1..ub-common-name-length)) |
| * |
| * teletex-common-name INTEGER ::= 2 |
| * |
| * TeletexCommonName ::= TeletexString (SIZE (1..ub-common-name-length)) |
| * |
| * teletex-organization-name INTEGER ::= 3 |
| * |
| * TeletexOrganizationName ::= |
| * TeletexString (SIZE (1..ub-organization-name-length)) |
| * |
| * teletex-personal-name INTEGER ::= 4 |
| * |
| * TeletexPersonalName ::= SET { |
| * surname [0] TeletexString (SIZE (1..ub-surname-length)), |
| * given-name [1] TeletexString |
| * (SIZE (1..ub-given-name-length)) OPTIONAL, |
| * initials [2] TeletexString (SIZE (1..ub-initials-length)) OPTIONAL, |
| * generation-qualifier [3] TeletexString (SIZE |
| * (1..ub-generation-qualifier-length)) OPTIONAL } |
| * |
| * teletex-organizational-unit-names INTEGER ::= 5 |
| * |
| * TeletexOrganizationalUnitNames ::= SEQUENCE SIZE |
| * (1..ub-organizational-units) OF TeletexOrganizationalUnitName |
| * |
| * TeletexOrganizationalUnitName ::= TeletexString |
| * (SIZE (1..ub-organizational-unit-name-length)) |
| * |
| * pds-name INTEGER ::= 7 |
| * |
| * PDSName ::= PrintableString (SIZE (1..ub-pds-name-length)) |
| * |
| * physical-delivery-country-name INTEGER ::= 8 |
| * |
| * PhysicalDeliveryCountryName ::= CHOICE { |
| * x121-dcc-code NumericString (SIZE (ub-country-name-numeric-length)), |
| * iso-3166-alpha2-code PrintableString |
| * (SIZE (ub-country-name-alpha-length)) } |
| * |
| * postal-code INTEGER ::= 9 |
| * |
| * PostalCode ::= CHOICE { |
| * numeric-code NumericString (SIZE (1..ub-postal-code-length)), |
| * printable-code PrintableString (SIZE (1..ub-postal-code-length)) } |
| * |
| * physical-delivery-office-name INTEGER ::= 10 |
| * |
| * PhysicalDeliveryOfficeName ::= PDSParameter |
| * |
| * physical-delivery-office-number INTEGER ::= 11 |
| * |
| * PhysicalDeliveryOfficeNumber ::= PDSParameter |
| * |
| * extension-OR-address-components INTEGER ::= 12 |
| * |
| * ExtensionORAddressComponents ::= PDSParameter |
| * |
| * physical-delivery-personal-name INTEGER ::= 13 |
| * |
| * PhysicalDeliveryPersonalName ::= PDSParameter |
| * |
| * physical-delivery-organization-name INTEGER ::= 14 |
| * |
| * PhysicalDeliveryOrganizationName ::= PDSParameter |
| * |
| * extension-physical-delivery-address-components INTEGER ::= 15 |
| * |
| * ExtensionPhysicalDeliveryAddressComponents ::= PDSParameter |
| * |
| * unformatted-postal-address INTEGER ::= 16 |
| * |
| * UnformattedPostalAddress ::= SET { |
| * printable-address SEQUENCE SIZE (1..ub-pds-physical-address-lines) OF |
| * PrintableString (SIZE (1..ub-pds-parameter-length)) OPTIONAL, |
| * teletex-string TeletexString |
| * (SIZE (1..ub-unformatted-address-length)) OPTIONAL } |
| * |
| * street-address INTEGER ::= 17 |
| * |
| * StreetAddress ::= PDSParameter |
| * |
| * post-office-box-address INTEGER ::= 18 |
| * |
| * PostOfficeBoxAddress ::= PDSParameter |
| * |
| * poste-restante-address INTEGER ::= 19 |
| * |
| * PosteRestanteAddress ::= PDSParameter |
| * |
| * unique-postal-name INTEGER ::= 20 |
| * |
| * UniquePostalName ::= PDSParameter |
| * |
| * local-postal-attributes INTEGER ::= 21 |
| * |
| * LocalPostalAttributes ::= PDSParameter |
| * |
| * PDSParameter ::= SET { |
| * printable-string PrintableString |
| * (SIZE(1..ub-pds-parameter-length)) OPTIONAL, |
| * teletex-string TeletexString |
| * (SIZE(1..ub-pds-parameter-length)) OPTIONAL } |
| * |
| * extended-network-address INTEGER ::= 22 |
| * |
| * ExtendedNetworkAddress ::= CHOICE { |
| * e163-4-address SEQUENCE { |
| * number [0] NumericString (SIZE (1..ub-e163-4-number-length)), |
| * sub-address [1] NumericString |
| * (SIZE (1..ub-e163-4-sub-address-length)) OPTIONAL }, |
| * psap-address [0] PresentationAddress } |
| * |
| * PresentationAddress ::= SEQUENCE { |
| * pSelector [0] EXPLICIT OCTET STRING OPTIONAL, |
| * sSelector [1] EXPLICIT OCTET STRING OPTIONAL, |
| * tSelector [2] EXPLICIT OCTET STRING OPTIONAL, |
| * nAddresses [3] EXPLICIT SET SIZE (1..MAX) OF OCTET STRING } |
| * |
| * terminal-type INTEGER ::= 23 |
| * |
| * TerminalType ::= INTEGER { |
| * telex (3), |
| * teletex (4), |
| * g3-facsimile (5), |
| * g4-facsimile (6), |
| * ia5-terminal (7), |
| * videotex (8) } (0..ub-integer-options) |
| * |
| * -- Extension Domain-defined Attributes |
| * |
| * teletex-domain-defined-attributes INTEGER ::= 6 |
| * |
| * TeletexDomainDefinedAttributes ::= SEQUENCE SIZE |
| * (1..ub-domain-defined-attributes) OF TeletexDomainDefinedAttribute |
| * |
| * TeletexDomainDefinedAttribute ::= SEQUENCE { |
| * type TeletexString |
| * (SIZE (1..ub-domain-defined-attribute-type-length)), |
| * value TeletexString |
| * (SIZE (1..ub-domain-defined-attribute-value-length)) } |
| * |
| * -- specifications of Upper Bounds shall be regarded as mandatory |
| * -- from Annex B of ITU-T X.411 Reference Definition of MTS Parameter |
| * -- Upper Bounds |
| * |
| * -- Upper Bounds |
| * ub-name INTEGER ::= 32768 |
| * ub-common-name INTEGER ::= 64 |
| * ub-locality-name INTEGER ::= 128 |
| * ub-state-name INTEGER ::= 128 |
| * ub-organization-name INTEGER ::= 64 |
| * ub-organizational-unit-name INTEGER ::= 64 |
| * ub-title INTEGER ::= 64 |
| * ub-match INTEGER ::= 128 |
| * |
| * ub-emailaddress-length INTEGER ::= 128 |
| * |
| * ub-common-name-length INTEGER ::= 64 |
| * ub-country-name-alpha-length INTEGER ::= 2 |
| * ub-country-name-numeric-length INTEGER ::= 3 |
| * ub-domain-defined-attributes INTEGER ::= 4 |
| * ub-domain-defined-attribute-type-length INTEGER ::= 8 |
| * ub-domain-defined-attribute-value-length INTEGER ::= 128 |
| * ub-domain-name-length INTEGER ::= 16 |
| * ub-extension-attributes INTEGER ::= 256 |
| * ub-e163-4-number-length INTEGER ::= 15 |
| * ub-e163-4-sub-address-length INTEGER ::= 40 |
| * ub-generation-qualifier-length INTEGER ::= 3 |
| * ub-given-name-length INTEGER ::= 16 |
| * ub-initials-length INTEGER ::= 5 |
| * ub-integer-options INTEGER ::= 256 |
| * ub-numeric-user-id-length INTEGER ::= 32 |
| * ub-organization-name-length INTEGER ::= 64 |
| * ub-organizational-unit-name-length INTEGER ::= 32 |
| * ub-organizational-units INTEGER ::= 4 |
| * ub-pds-name-length INTEGER ::= 16 |
| * ub-pds-parameter-length INTEGER ::= 30 |
| * ub-pds-physical-address-lines INTEGER ::= 6 |
| * ub-postal-code-length INTEGER ::= 16 |
| * ub-surname-length INTEGER ::= 40 |
| * ub-terminal-id-length INTEGER ::= 24 |
| * ub-unformatted-address-length INTEGER ::= 180 |
| * ub-x121-address-length INTEGER ::= 16 |
| * |
| * -- Note - upper bounds on string types, such as TeletexString, are |
| * -- measured in characters. Excepting PrintableString or IA5String, a |
| * -- significantly greater number of octets will be required to hold |
| * -- such a value. As a minimum, 16 octets, or twice the specified upper |
| * -- bound, whichever is the larger, should be allowed for TeletexString. |
| * -- For UTF8String or UniversalString at least four times the upper |
| * -- bound should be allowed. |
| * </pre> |
| * |
| * @author Anne Anderson |
| * @since 1.4 |
| * @see GeneralName |
| * @see GeneralNames |
| * @see GeneralNameInterface |
| */ |
| public class X400Address implements GeneralNameInterface { |
| |
| // Private data members |
| byte[] nameValue = null; |
| |
| /** |
| * Create the X400Address object from the specified byte array |
| * |
| * @param nameValue value of the name as a byte array |
| */ |
| public X400Address(byte[] value) { |
| nameValue = value; |
| } |
| |
| /** |
| * Create the X400Address object from the passed encoded Der value. |
| * |
| * @param derValue the encoded DER X400Address. |
| * @exception IOException on error. |
| */ |
| public X400Address(DerValue derValue) throws IOException { |
| nameValue = derValue.toByteArray(); |
| } |
| |
| /** |
| * Return the type of the GeneralName. |
| */ |
| public int getType() { |
| return (GeneralNameInterface.NAME_X400); |
| } |
| |
| /** |
| * Encode the X400 name into the DerOutputStream. |
| * |
| * @param out the DER stream to encode the X400Address to. |
| * @exception IOException on encoding errors. |
| */ |
| public void encode(DerOutputStream out) throws IOException { |
| DerValue derValue = new DerValue(nameValue); |
| out.putDerValue(derValue); |
| } |
| |
| /** |
| * Return the printable string. |
| */ |
| public String toString() { |
| return ("X400Address: <DER-encoded value>"); |
| } |
| |
| /** |
| * Return type of constraint inputName places on this name:<ul> |
| * <li>NAME_DIFF_TYPE = -1: input name is different type from name (i.e. does not constrain). |
| * <li>NAME_MATCH = 0: input name matches name. |
| * <li>NAME_NARROWS = 1: input name narrows name (is lower in the naming subtree) |
| * <li>NAME_WIDENS = 2: input name widens name (is higher in the naming subtree) |
| * <li>NAME_SAME_TYPE = 3: input name does not match or narrow name, but is same type. |
| * </ul>. These results are used in checking NameConstraints during |
| * certification path verification. |
| * |
| * @param inputName to be checked for being constrained |
| * @returns constraint type above |
| * @throws UnsupportedOperationException if name is same type, but comparison operations are |
| * not supported for this name type. |
| */ |
| public int constrains(GeneralNameInterface inputName) throws UnsupportedOperationException { |
| int constraintType; |
| if (inputName == null) |
| constraintType = NAME_DIFF_TYPE; |
| else if (inputName.getType() != NAME_X400) |
| constraintType = NAME_DIFF_TYPE; |
| else |
| //Narrowing, widening, and match constraints not defined in rfc2459 for X400Address |
| throw new UnsupportedOperationException("Narrowing, widening, and match are not supported for X400Address."); |
| return constraintType; |
| } |
| |
| /** |
| * Return subtree depth of this name for purposes of determining |
| * NameConstraints minimum and maximum bounds and for calculating |
| * path lengths in name subtrees. |
| * |
| * @returns distance of name from root |
| * @throws UnsupportedOperationException if not supported for this name type |
| */ |
| public int subtreeDepth() throws UnsupportedOperationException { |
| throw new UnsupportedOperationException("subtreeDepth not supported for X400Address"); |
| } |
| |
| } |
