|
DESede3KeySecretKeyFactoryEngine |
|
1 /* $RCSfile: DESede3KeySecretKeyFactoryEngine.java,v $
2 * $Revision: 1.10 $
3 * $Date: 2003/10/04 19:18:38 $
4 * $Author: uwe_guenther $
5 * $State: Exp $
6 *
7 * Created on August 13, 2001 9:45 PM
8 *
9 * Copyright (C) 2001 Uwe Guenther <uwe@cscc.de>
10 *
11 * This file is part of the jhbci JCE-ServiceProvider. The jhbci JCE-
12 * ServiceProvider is a library, written in JavaTM, that should be
13 * used in HBCI banking applications (clients and may be servers),
14 * to do cryptographic operations.
15 *
16 * The jhbci library is free software; you can redistribute it and/or
17 * modify it under the terms of the GNU Lesser General Public
18 * License as published by the Free Software Foundation; either
19 * version 2.1 of the License, or (at your option) any later version.
20 *
21 * The jhbci library is distributed in the hope that it will be useful,
22 * but WITHOUT ANY WARRANTY; without even the implied warranty of
23 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
24 * Lesser General Public License for more details.
25 *
26 * You should have received a copy of the GNU Lesser General Public
27 * License along with this library; if not, write to the Free Software
28 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
29 *
30 */
31
32 package de.cscc.crypto.provider;
33
34 import java.security.InvalidKeyException;
35 import java.security.spec.InvalidKeySpecException;
36 import java.security.spec.KeySpec;
37
38 import javax.crypto.SecretKey;
39 import javax.crypto.SecretKeyFactorySpi;
40
41 /**
42 * DESede3KeySecretKeyFactoryEngine Class.
43 *
44 * @author <a href=mailto:uwe@cscc.de>Uwe Günther</a>
45 * @version $Revision: 1.10 $
46 */
47 public final class DESede3KeySecretKeyFactoryEngine extends SecretKeyFactorySpi {
48
49 /** The delegate for this wrapper object */
50 private DESede3KeySecretKeyFactoryImpl factory =
51 new DESede3KeySecretKeyFactoryImpl();
52
53 /**
54 * Creates new DESede3KeySecretKeyFactoryEngine.
55 *
56 * @throws SecurityException if the provider self integrity check fails.
57 */
58 public DESede3KeySecretKeyFactoryEngine() {
59 if (JHBCI.selfIntegrityChecking() == false) {
60 throw new SecurityException("JHBCI-Provider is tampered.");
61 }
62 }
63
64 /**
65 * Returns a string representation of the object.
66 *
67 * @return a string representation of the object.
68 */
69 public String toString() {
70 return this.factory.toString();
71 }
72
73 /**
74 * Generates a <code>SecretKey</code> object from the
75 * provided key specification (key material).
76 *
77 * @param keySpec the specification (key material) of the secret key.
78 * @return the secret key.
79 * @exception InvalidKeySpecException if the given key specification
80 * is inappropriate for this secret-key factory to produce a secret key.
81 */
82 protected SecretKey engineGenerateSecret(KeySpec keySpec)
83 throws InvalidKeySpecException {
84 return this.factory.generateSecret(keySpec);
85 }
86
87 /**
88 * Returns a specification (key material) of the given key object in the
89 * requested format.
90 *
91 * @param key the key.
92 * @param keySpec the requested format in which the key material shall be
93 * returned.
94 * @return the underlying key specification (key material) in the requested
95 * format.
96 * @throws NullPointerException if key or keySpec is null.
97 * @throws InvalidKeySpecException if the requested key specification is
98 * inappropriate for the given key (e.g., the algorithms associated with
99 * <code>key</code> and <code>keySpec</code> do not match, or
100 * <code>key</code> references a key on a cryptographic hardware device
101 * whereas <code>keySpec</code> is the specification of a software-based
102 * key), or the given key cannot be dealt with (e.g., the given key has
103 * an algorithm or format not supported by this secret-key factory).
104 */
105 protected KeySpec engineGetKeySpec(SecretKey key, Class keySpec)
106 throws InvalidKeySpecException {
107 return this.factory.getKeySpec(key, keySpec);
108 }
109
110 /**
111 * Translates a key object, whose provider may be unknown or potentially
112 * untrusted, into a corresponding key object of this secret-key factory.
113 *
114 * @return they key whose provider is unknown or untrusted.
115 * @param key the key whose provider is unknown or untrusted.
116 * @throws NullPointerException if key is null.
117 * @throws InvalidKeyException if the given key cannot be processed by this
118 * secret-key factory.
119 */
120 protected SecretKey engineTranslateKey(SecretKey key)
121 throws InvalidKeyException {
122 return this.factory.translateKey(key);
123 }
124 }
125
|
DESede3KeySecretKeyFactoryEngine |
|