|
Server : Apache/2.2.2 (Fedora) System : Linux App1.pathumtani.go.th 2.6.20-1.2320.fc5smp #1 SMP Tue Jun 12 19:40:16 EDT 2007 i686 User : apache ( 48) PHP Version : 5.2.9 Disable Function : NONE Directory : /usr/share/javadoc/cryptix-3.2.0/xjava/security/interfaces/ |
Upload File : |
<?xml version="1.0" encoding="US-ASCII"?>
<!DOCTYPE html PUBLIC "-//gnu.org///DTD XHTML 1.1 plus Target 1.0//EN" "../../../resources/xhtml11-target10.dtd"><html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head><title>RSAFactors (cryptix JavaDoc)</title><script src="../../../resources/gjdoc.js" type="text/javascript"><!-- this comment required for konqueror 3.2.2 --></script><meta http-equiv="Content-Type" content="text/html; charset=US-ASCII"/><meta name="generator" content="GNU Gjdoc Standard Doclet"/><meta name="keywords" content="xjava.security.interfaces.RSAFactors class"/><meta name="keywords" content="getP()"/><meta name="keywords" content="getQ()"/><meta name="keywords" content="getInverseOfQModP()"/><link rel="stylesheet" type="text/css" href="../../../resources/gjdochtml-clean-layout.css" title="GNU Clean"/><link rel="stylesheet" type="text/css" href="../../../resources/gjdochtml-clean-color1.css" title="GNU Clean"/></head><body class="content class" onload="if(parent.contentPageLoaded)parent.contentPageLoaded(document.title)"><table class="navbar div top"><tr><td class="navbar div top"><div class="navbar div top"><span class="navbar item enabled"><a href="../../../overview-summary.html">Overview</a></span> <span class="navbar item enabled"><a href="package-summary.html">Package</a></span> <span class="navbar item enabled"><a href="tree.html">Tree</a></span> <span class="navbar item enabled"><a href="../../../alphaindex.html">Index</a></span> <span class="navbar item enabled"><a href="../../../deprecated.html">Deprecated</a></span> <span class="navbar item enabled"><a href="../../../about.html">About</a></span></div></td></tr><tr><td class="navi"><a href="../../../xjava/security/interfaces/ElGamalPublicKey.html">Prev Class</a> | <a href="../../../xjava/security/interfaces/RSAKey.html">Next Class</a></td><td class="navi"><a href="../../../index.html" title="Show in a frameset" target="_top">Frames</a> | <a href="RSAFactors.html" title="Show without frames" target="_top">No Frames</a> </td></tr><tr><td class="navi">Summary: Nested | Field | <a href="#summary-methods">Method</a> | Constr</td><td class="navi">Detail: Nested | Field | <a href="#detail-methods">Method</a> | Constr</td></tr></table><div class="class title outer"><h3 class="class title-package">xjava.security.interfaces</h3><h1 class="class title-class">Interface RSAFactors</h1></div><dl class="class knownimplementing"><dt class="header"><b>Known Implementing Classes:</b></dt><dd class="item"><a href="../../../cryptix/provider/rsa/BaseRSAPrivateKey.html" title="Class in cryptix.provider.rsa">BaseRSAPrivateKey</a>, <a href="../../../cryptix/provider/rsa/RawRSAPrivateKey.html" title="Class in cryptix.provider.rsa">RawRSAPrivateKey</a></dd></dl><hr/><div class="class synopsis outer"><div class="class synopsis declaration"><code>public interface <b class="class synopsis name">RSAFactors</b></code></div></div><hr/><div class="class description"> An interface with methods to return the factors and coefficient of an
RSA modulus. These are useful for speeding up RSA operations using the
Chinese Remainder Theorem.
<p/>
It is not specified which factor is the larger, but the coefficient
must be equal to the inverse of <i>q</i> modulo <i>p</i>.
<p/>
Note that if the encryption exponent <i>e</i>, and the two factors are
available to an attacker, the decryption exponent <i>d</i> can be found.
This means that the factors must always be kept secret.
<p/>
The intention is for implementations of RSAPrivateKey (and possibly
RSAPublicKey) to optionally implement this interface. Users of RSA keys can
check whether the key object is an <code>instanceof RSAFactors</code>,
and if so make a further check that the factors are known for this key
(i.e. that <code>getP</code>, <code>getQ</code> and
<code>getInverseOfQModP</code> return non-null values).
<p/>
For example:
<pre>
import java.security.interfaces.*;
<br/>
void foo(RSAPrivateKey key) {
BigInteger p = null, q = null, u = null;
<br/>
if (key instanceof RSAFactors) {
RSAFactors factors = (RSAFactors) key;
p = factors.getP();
q = factors.getQ();
u = factors.getInverseOfQModP();
}
if (p != null) {
// efficient code (q and u can be assumed to be non-null)
} else {
// less efficient code
}
}
</pre>
<p/>
Key implementations should ensure that either all of the methods defined
in this interface return null, or that none of them do.
<p/>
<strong><a href="../guide/ijce/JCEDifferences.html">This interface
is not supported in JavaSoft's version of JCE.</a></strong>.
To maintain compatibility, the RSAFactors classfile should be included
with any application that uses it and may be linked against JavaSoft's
JCE, so that the application will not fail with a NoClassDefFoundError.
<p/>
<b>Copyright</b> © 1997
<a href="http://www.systemics.com/">Systemics Ltd</a> on behalf of the
<a href="http://www.systemics.com/docs/cryptix/">Cryptix Development Team</a>.
<br/>All rights reserved.
<p/><b>$Revision: 1.2 $</b>
</div><div class="taglet"><dl class="tag list"><dt class="tag section header"><b>Author:</b></dt><dd class="tag item">David Hopwood</dd></dl></div><div class="taglet"><dl class="tag list"><dt class="tag section header"><b>Since:</b></dt><dd>IJCE 1.0.1</dd></dl></div><div class="taglet"></div><div class="taglet"></div><div class="taglet"><dl class="tag list"><dt class="tag section header"><b>See Also:</b></dt><dd><code>java.security.interfaces.RSAKey</code></dd></dl></div><div class="taglet"></div><div class="taglet"></div><a name="summary-methods" id="summary-methods"/><dl class="table container"><dd><table class="class summary" border="1" width="100%"><tr class="table header"><td colspan="2"><h2 class="table header">Method Summary</h2></td></tr><tr><td class="left" valign="top"><code class="synopsis"> BigInteger</code></td><td class="right"><dl class="list"><dt class="synopsis"><code><a href="#getInverseOfQModP()">getInverseOfQModP</a>()</code></dt><dd class="description"> Returns the coefficient, equal to the multiplicative inverse of
<i>q</i> modulo <i>p</i>, or null if the factors of the modulus are
unknown.</dd></dl></td></tr><tr><td class="left" valign="top"><code class="synopsis"> BigInteger</code></td><td class="right"><dl class="list"><dt class="synopsis"><code><a href="#getP()">getP</a>()</code></dt><dd class="description"> Returns the first prime factor, <i>p</i>, or null if the factors of
the modulus are unknown.</dd></dl></td></tr><tr><td class="left" valign="top"><code class="synopsis"> BigInteger</code></td><td class="right"><dl class="list"><dt class="synopsis"><code><a href="#getQ()">getQ</a>()</code></dt><dd class="description"> Returns the second prime factor, <i>q</i>, or null if the factors of
the modulus are unknown.</dd></dl></td></tr></table></dd></dl><a name="detail-methods" id="detail-methods"/><h2 class="section header">Method Details</h2><div class="section"><a name="getInverseOfQModP()" id="getInverseOfQModP()"/><div class="member detail outer"><h3 class="member detail name">getInverseOfQModP</h3><pre class="member detail synopsis">public BigInteger getInverseOfQModP()</pre><blockquote class="member detail name"><div class="member detail description"> Returns the coefficient, equal to the multiplicative inverse of
<i>q</i> modulo <i>p</i>, or null if the factors of the modulus are
unknown.
</div><div class="taglet"></div><div class="taglet"></div><div class="taglet"></div><div class="taglet"></div><div class="taglet"></div></blockquote></div><hr/><a name="getP()" id="getP()"/><div class="member detail outer"><h3 class="member detail name">getP</h3><pre class="member detail synopsis">public BigInteger getP()</pre><blockquote class="member detail name"><div class="member detail description"> Returns the first prime factor, <i>p</i>, or null if the factors of
the modulus are unknown.
</div><div class="taglet"></div><div class="taglet"></div><div class="taglet"></div><div class="taglet"></div><div class="taglet"></div></blockquote></div><hr/><a name="getQ()" id="getQ()"/><div class="member detail outer"><h3 class="member detail name">getQ</h3><pre class="member detail synopsis">public BigInteger getQ()</pre><blockquote class="member detail name"><div class="member detail description"> Returns the second prime factor, <i>q</i>, or null if the factors of
the modulus are unknown.
</div><div class="taglet"></div><div class="taglet"></div><div class="taglet"></div><div class="taglet"></div><div class="taglet"></div></blockquote></div></div><p class="navbar bottom spacer"> </p><table class="navbar div bottom"><tr><td><div class="navbar div top"><span class="navbar item enabled"><a href="../../../overview-summary.html">Overview</a></span> <span class="navbar item enabled"><a href="package-summary.html">Package</a></span> <span class="navbar item enabled"><a href="tree.html">Tree</a></span> <span class="navbar item enabled"><a href="../../../alphaindex.html">Index</a></span> <span class="navbar item enabled"><a href="../../../deprecated.html">Deprecated</a></span> <span class="navbar item enabled"><a href="../../../about.html">About</a></span></div></td></tr></table></body></html>