blob: 1ce2a534c8553f8f0a93732a04b73c9b26aaafaa [file] [log] [blame]
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html lang="en">
<HEAD>
<meta name="copyright" content="Copyright (c) IBM Corporation and others 2008, 2011. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page." >
<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<META http-equiv="Content-Style-Type" content="text/css"><LINK rel="STYLESHEET" href="../book.css" charset="ISO-8859-1" type="text/css">
<script language="JavaScript" src="PLUGINS_ROOT/org.eclipse.help/livehelp.js" type="text/javascript"></script>
<TITLE>Secure storage runtime options</TITLE>
</HEAD>
<BODY bgcolor="#ffffff">
<H1 class="Head">Secure storage runtime options</H1>
<h4>Changing location of secure storage</h4>
<p>By default, secure storage is located in your home directory. On Windows that typically resolves to
<i>&quot;C:\Documents and Settings\&lt;user_name&gt;\.eclipse\org.eclipse.equinox.security&quot;</i>. This location is selected
to allow multiple Eclipse-based applications to share the same secure storage.</p>
<p>If you would like to modify the location of the default secure storage, you can use the
&quot;-eclipse.keyring &lt;file_path&gt;&quot; runtime option. The &lt;file_path&gt; is a path to the file which is used
to persist the secure storage data.</p>
<p>The current location of the default secure storage can be found on the
<a class="command-link" href='javascript:executeCommand("org.eclipse.ui.window.preferences(preferencePageId=org.eclipse.equinox.security.ui.storage)")'>
<img src="PLUGINS_ROOT/org.eclipse.help/command_link.png" alt="command link">
<strong>General &gt; Security &gt; Secure Storage</strong></a>
preferences page.</p>
<h4>Password file</h4>
<p>The password provider mechanism can be bypassed if you specify the
&quot;-eclipse.password &lt;file path&gt;&quot; runtime option. In this case the contents of the file you specified
as the argument will be used as a master password. While this option is valuable in some circumstances
(such as headless applications), the protection of the password file becomes a consideration. The password file
can be protected by the operating system access rights and/or by placing it on a removable storage,
such as a USB key.</p>
<p><img alt="Related concepts" src="../images/ngrelc.png" border="0">
<br><A href="ref-securestorage-start.htm">Secure storage</A>
<br><A href="ref-securestorage-works.htm">How secure storage works</A>
<br><A href="ref-securestorage-recovery.htm">Password recovery</A>
<br><A href="ref-securestorage-passwd.htm">Life of a master password</A>
</p>
<p><img alt="Related reference" src="../images/ngrelr.png" border="0">
<br><a href="ref-securestorage-prefs.htm">Secure storage preference page</a>
</p>
</BODY>
</HTML>