/* * Licensed to the Apache Software Foundation (ASF) under one or more * contributor license agreements. See the NOTICE file distributed with * this work for additional information regarding copyright ownership. * The ASF licenses this file to You under the Apache License, Version 2.0 * (the "License"); you may not use this file except in compliance with * the License. You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ /** * @author Alexander Y. Kleymenov * @version $Revision$ */ package org.apache.harmony.security.x509; import java.io.IOException; import java.util.ArrayList; import java.util.Arrays; import java.util.Collection; import java.util.Collections; import java.util.HashMap; import java.util.HashSet; import java.util.List; import java.util.Set; import javax.security.auth.x500.X500Principal; import org.apache.harmony.security.asn1.ASN1SequenceOf; import org.apache.harmony.security.asn1.ASN1Type; import org.apache.harmony.security.asn1.BerInputStream; /** * The class encapsulates the ASN.1 DER encoding/decoding work * with the Extensions part of X.509 certificate * (as specified in RFC 3280 - * Internet X.509 Public Key Infrastructure. * Certificate and Certificate Revocation List (CRL) Profile. * http://www.ietf.org/rfc/rfc3280.txt): * *
* Extensions ::= SEQUENCE SIZE (1..MAX) OF Extension **/ public final class Extensions { // Supported critical extensions oids: private static List SUPPORTED_CRITICAL = Arrays.asList( "2.5.29.15", "2.5.29.19", "2.5.29.32", "2.5.29.17", "2.5.29.30", "2.5.29.36", "2.5.29.37", "2.5.29.54"); // the values of extensions of the structure private final List
* id-ce-keyUsage OBJECT IDENTIFIER ::= { id-ce 15 } * * KeyUsage ::= BIT STRING { * digitalSignature (0), * nonRepudiation (1), * keyEncipherment (2), * dataEncipherment (3), * keyAgreement (4), * keyCertSign (5), * cRLSign (6), * encipherOnly (7), * decipherOnly (8) * } ** (as specified in RFC 3280) * * @return the value of Key Usage Extension if it is in the list, * and null if there is no such extension or its value can not be decoded * otherwise. Note, that the length of returned array can be greater * than 9. */ public boolean[] valueOfKeyUsage() { Extension extension = getExtensionByOID("2.5.29.15"); KeyUsage kUsage; if ((extension == null) || ((kUsage = extension.getKeyUsageValue()) == null)) { return null; } return kUsage.getKeyUsage(); } /** * Returns the value of Extended Key Usage extension (OID == 2.5.29.37). * The ASN.1 definition of Extended Key Usage Extension is: * *
* id-ce-extKeyUsage OBJECT IDENTIFIER ::= { id-ce 37 } * * ExtKeyUsageSyntax ::= SEQUENCE SIZE (1..MAX) OF KeyPurposeId * * KeyPurposeId ::= OBJECT IDENTIFIER ** (as specified in RFC 3280) * * @return the list with string representations of KeyPurposeId's OIDs * and null * @throws IOException if extension was incorrectly encoded. */ public List
* id-ce-basicConstraints OBJECT IDENTIFIER ::= { id-ce 19 } * * BasicConstraints ::= SEQUENCE { * cA BOOLEAN DEFAULT FALSE, * pathLenConstraint INTEGER (0..MAX) OPTIONAL * } ** (as specified in RFC 3280) * * @return-1 if the Basic Constraints Extension is not present or * it is present but it indicates the certificate is not a * certificate authority. If the certificate is a certificate * authority, returns the path length constraint if present, or * Integer.MAX_VALUE if it is not. */ public int valueOfBasicConstraints() { Extension extension = getExtensionByOID("2.5.29.19"); if (extension == null) { return -1; } BasicConstraints bc = extension.getBasicConstraintsValue(); if (bc == null || !bc.getCa()) { return -1; } return bc.getPathLenConstraint(); } /** * Returns the value of Subject Alternative Name (OID = 2.5.29.17). * The ASN.1 definition for Subject Alternative Name is: * *
* id-ce-subjectAltName OBJECT IDENTIFIER ::= { id-ce 17 } * * SubjectAltName ::= GeneralNames ** (as specified in RFC 3280) * * @return Returns the collection of pairs: * (Integer (tag), Object (name value)) if extension presents, and * null if does not. */ public Collection
* id-ce-issuerAltName OBJECT IDENTIFIER ::= { id-ce 18 } * * IssuerAltName ::= GeneralNames ** (as specified in RFC 3280) * * @return Returns the collection of pairs: * (Integer (tag), Object (name value)) if extension presents, and * null if does not. */ public Collection
* id-ce-certificateIssuer OBJECT IDENTIFIER ::= { id-ce 29 } * * certificateIssuer ::= GeneralNames ** (as specified in RFC 3280) * * @return the value of Certificate Issuer Extension */ public X500Principal valueOfCertificateIssuerExtension() throws IOException { Extension extension = getExtensionByOID("2.5.29.29"); if (extension == null) { return null; } return ((CertificateIssuer) extension.getDecodedExtensionValue()).getIssuer(); } /** * Returns ASN.1 encoded form of this X.509 Extensions value. */ public byte[] getEncoded() { if (encoding == null) { encoding = ASN1.encode(this); } return encoding; } @Override public boolean equals(Object other) { if (!(other instanceof Extensions)) { return false; } Extensions that = (Extensions) other; return (this.extensions == null || this.extensions.isEmpty()) ? (that.extensions == null || that.extensions.isEmpty()) : (this.extensions.equals(that.extensions)); } @Override public int hashCode() { int hashCode = 0; if (extensions != null) { hashCode = extensions.hashCode(); } return hashCode; } public void dumpValue(StringBuilder sb, String prefix) { if (extensions == null) { return; } int num = 1; for (Extension extension: extensions) { sb.append('\n').append(prefix).append('[').append(num++).append("]: "); extension.dumpValue(sb, prefix); } } /** * Custom X.509 Extensions decoder. */ public static final ASN1Type ASN1 = new ASN1SequenceOf(Extension.ASN1) { @Override public Object getDecodedObject(BerInputStream in) { return new Extensions((List