org.opensc.pkcs15.application.impl.PKCS15Application.java Source code

Introduction

Here is the source code for org.opensc.pkcs15.application.impl.PKCS15Application.java

Source

/***********************************************************
 * $Id$
 * 
 * PKCS#15 cryptographic provider of the opensc project.
 * http://www.opensc-project.org
 *
 * Licensed 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.
 *
 * Created: 26.12.2007
 * 
 ***********************************************************/

package org.opensc.pkcs15.application.impl;

import java.io.ByteArrayInputStream;
import java.io.IOException;
import java.util.Arrays;

import org.bouncycastle.asn1.ASN1InputStream;
import org.opensc.pkcs15.AIDs;
import org.opensc.pkcs15.application.Application;
import org.opensc.pkcs15.asn1.ISO7816ApplicationTemplate;
import org.opensc.pkcs15.asn1.ref.DDO;
import org.opensc.pkcs15.token.Token;

/**
 * A PKCS#15 application with PKI functionality.
 * 
 * This class is the foundation for implementing a KeyStore and various key
 * classes of the JCE provider. 
 * 
 * @author wglas
 */
public class PKCS15Application implements Application {

    private ISO7816ApplicationTemplate template;
    private Token token;
    private DDO ddo;

    private static final byte[] DEFAULT_PATH = new byte[] { 0x3F, 0x00, 0x50, 0x15 };

    /**
     * default constructor called during instantiation of a new application on the card.
     * 
     * This constructor creates the basic DFs and EFs for the application for lateron
     * adding PKCS#15 objects to the directory. 
     */
    PKCS15Application(Token token) throws IOException {
        this.token = token;
        this.template = new ISO7816ApplicationTemplate();
        this.template.setAid(AIDs.PKCS15_AID);
        this.template.setDescription("OpenSC JAVA");
        this.template.setPath(DEFAULT_PATH);
    }

    /**
     * default constructor called during instantiation of an application already
     * existing on the card.
     * @throws IOException Upon errors reading additional token information.
     */
    PKCS15Application(Token token, ISO7816ApplicationTemplate template) throws IOException {
        if (template == null)
            throw new IllegalArgumentException("PKCS15Application instantiated with template == null.");

        if (template.getAid() == null)
            throw new IllegalArgumentException("PKCS15Application instantiated with template.aid == null.");

        if (!Arrays.equals(AIDs.PKCS15_AID, template.getAid()))
            throw new IllegalArgumentException("PKCS15Application instantiated with invalid AID in template.");

        this.template = template;
        this.token = token;

        if (this.template.getDiscretionaryData() != null) {
            ByteArrayInputStream is = new ByteArrayInputStream(this.template.getDiscretionaryData());
            ASN1InputStream ais = new ASN1InputStream(is);

            this.ddo = DDO.getInstance(ais.readObject());
            ais.close();
        }
    }

    /* (non-Javadoc)
     * @see org.opensc.pkcs15.application.Application#getAID()
     */
    @Override
    public byte[] getAID() {

        return AIDs.PKCS15_AID;
    }

    /* (non-Javadoc)
     * @see org.opensc.pkcs15.application.Application#getApplicationTEmplate()
     */
    @Override
    public ISO7816ApplicationTemplate getApplicationTemplate() {

        return this.template;
    }

    /* (non-Javadoc)
     * @see org.opensc.pkcs15.application.Application#getToken()
     */
    @Override
    public Token getToken() {

        return this.token;
    }

    /**
     * @return The PKCS#15 specific DDO information contained in
     *         {@link ISO7816ApplicationTemplate#getDiscretionaryData()}.
     */
    public DDO getDdo() {
        return this.ddo;
    }

}