ibm-information-center/dist/eclipse/plugins/i5OS.ic.rzaha_5.4.0.1/rzahajssesysprops.htm

129 lines
6.6 KiB
HTML

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html lang="en-us" xml:lang="en-us">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name="security" content="public" />
<meta name="Robots" content="index,follow" />
<meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
<meta name="DC.Type" content="concept" />
<meta name="DC.Title" content="JSSE Java system properties" />
<meta name="abstract" content="To use JSSE in your applications, you need to specify several system properties that the default SSLContext objects needs in order to provide confirmation of the configuration. Some of the properties apply to both providers, while others apply to only the native iSeries provider." />
<meta name="description" content="To use JSSE in your applications, you need to specify several system properties that the default SSLContext objects needs in order to provide confirmation of the configuration. Some of the properties apply to both providers, while others apply to only the native iSeries provider." />
<meta name="DC.Relation" scheme="URI" content="rzahajsseconfig.htm" />
<meta name="copyright" content="(C) Copyright IBM Corporation 2006" />
<meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 2006" />
<meta name="DC.Format" content="XHTML" />
<meta name="DC.Identifier" content="rzahajssesysprops" />
<meta name="DC.Language" content="en-us" />
<!-- All rights reserved. Licensed Materials Property of IBM -->
<!-- US Government Users Restricted Rights -->
<!-- Use, duplication or disclosure restricted by -->
<!-- GSA ADP Schedule Contract with IBM Corp. -->
<link rel="stylesheet" type="text/css" href="./ibmdita.css" />
<link rel="stylesheet" type="text/css" href="./ic.css" />
<title>JSSE Java system properties</title>
</head>
<body id="rzahajssesysprops"><a name="rzahajssesysprops"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">JSSE Java system properties</h1>
<div><p>To use JSSE in your applications, you need to specify several system
properties that the default SSLContext objects needs in order to provide confirmation
of the configuration. Some of the properties apply to both providers, while
others apply to only the native iSeries™ provider.</p>
<p>When using the native iSeries JSSE provider, when you specify none of the
properties, the os400.certificateContainer defaults to *SYSTEM, which means
that JSSE uses the default entry in the system certificate store.</p>
<div class="section"><h4 class="sectiontitle">Properties that work for both providers</h4><p>The following
properties apply to both JSSE providers. Each description includes the default
property, if applicable.</p>
<p><strong>javax.net.ssl.trustStore</strong></p>
<blockquote> <p>The
name of the file that contains the KeyStore object that you want the default
TrustManager to use. The default value is jssecacerts, or cacerts (if jssecacerets
does not exist).</p>
</blockquote>
<p> <strong>javax.net.ssl.trustStoreType</strong></p>
<blockquote>
<p>The type of KeyStore object that you want the default TrustManager to
use. The default value is the value returned by the KeyStore.getDefaultType
method.</p>
</blockquote>
<p><strong>javax.net.ssl.trustStorePassword</strong></p>
<blockquote> <p>The
password for the KeyStore object that you want the default TrustManager to
use. </p>
</blockquote>
<p><strong>javax.net.ssl.keyStore</strong></p>
<blockquote> <p>The name of
the file that contains the KeyStore object that you want the default KeyManager
to use.</p>
</blockquote>
<p><strong>javax.net.ssl.keyStoreType</strong></p>
<blockquote> <p>The type
of KeyStore object that you want the default KeyManager to use. The default
value is the value returned by the KeyStore.getDefaultType method.</p>
</blockquote>
<p><strong>javax.net.ssl.keyStorePassword</strong></p>
<blockquote>
<p>The password for the KeyStore object that you want the default KeyManager
to use.</p>
</blockquote>
</div>
<div class="section"><h4 class="sectiontitle">Properties that work for the iSeries native JSSE provider only</h4><p>The
following properties apply to the native iSeries JSSE provider only.</p>
<p><strong>os400.secureApplication</strong></p>
<blockquote>
<p>The application identifier. JSSE uses this property only when you do not
specify any of the following properties:</p>
<ul><li>javax.net.ssl.keyStore</li>
<li>javax.net.ssl.keyStorePassword</li>
<li>javax.net.ssl.keyStoreType</li>
<li>javax.net.ssl.trustStore</li>
<li>javax.net.ssl.trustStorePassword</li>
<li>javax.ssl.net.trustStoreType</li>
</ul>
</blockquote>
<p><strong>os400.certificateContainer</strong></p>
<blockquote> <p>The name of the
keyring that you want to use. JSSE uses this property only when you do not
specify any of the following properties:</p>
<ul><li>javax.net.ssl.keyStore</li>
<li>javax.net.ssl.keyStorePassword</li>
<li>javax.net.ssl.keyStoreType</li>
<li>javax.net.ssl.trustStore</li>
<li>javax.net.ssl.trustStorePassword</li>
<li>javax.ssl.net.trustStoreType</li>
<li>os400.secureApplication</li>
</ul>
</blockquote>
<p><strong>os400.certificateLabel</strong></p>
<blockquote> <p>The keyring label
that you want to use. JSSE uses this property only when you do not specify
any of the following properties:</p>
<ul><li>javax.net.ssl.keyStore</li>
<li>javax.net.ssl.keyStorePassword</li>
<li>javax.net.ssl.trustStore</li>
<li>javax.net.ssl.trustStorePassword</li>
<li>javax.ssl.net.trustStoreType</li>
<li>os400.secureApplication</li>
</ul>
</blockquote>
<p></p>
</div>
<div class="section"><h4 class="sectiontitle"> Additional information</h4><p>For more information about
system properties, see the following topics:</p>
<ul><li><a href="sysprop2.htm#sysprop2">List of Java system properties</a></li>
<li><a href="http://java.sun.com/docs/books/tutorial/essential/system/properties.html" target="_blank">System Properties</a> on the Sun Java™ Web
site.</li>
</ul>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzahajsseconfig.htm" title="Configure your iSeries server to use IBM JSSE. This topic includes software requirements, how to change JSSE providers, and the necessary security properties and system properties.">Configuring your iSeries server to support JSSE</a></div>
</div>
</div>
</body>
</html>