blob: 246bc7d3f038e3c5789487b322b77be3c1e33de7 [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=utf-8">
<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>"C:\Documents and Settings\&lt;user_name&gt;\.eclipse\org.eclipse.equinox.security"</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 "-eclipse.keyring
&lt;file_path&gt;" 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.svg" 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 "-eclipse.password &lt;file path&gt;" 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>
<h3 class="related">Related concepts</h3><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>
<h3 class="related">Related reference</h3><a href="ref-securestorage-prefs.htm">Secure storage preference page</a>
</body>
</html>