You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@isis.apache.org by da...@apache.org on 2016/07/12 05:45:34 UTC

[04/26] isis-site git commit: ISIS-1335: removing -SNAPSHOT for 1.13.0, also migration and release notes

http://git-wip-us.apache.org/repos/asf/isis-site/blob/2c032b24/content/guides/ugvw.html
----------------------------------------------------------------------
diff --git a/content/guides/ugvw.html b/content/guides/ugvw.html
index 587f2b0..12ef172 100644
--- a/content/guides/ugvw.html
+++ b/content/guides/ugvw.html
@@ -1369,7 +1369,7 @@ converted dynamically into the corresponding <code>moment.js</code> format.</p><
 </div></div></td>
 <td class="tableblock halign-left valign-top"><p class="tableblock">ISO format date<br>
 (<code>2100-01-01T00:00:00.000Z</code>)</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">(<code>1.13.0-SNAPSHOT</code>), specifies a maximum date after which dates may not be specified.
+<td class="tableblock halign-left valign-top"><p class="tableblock">Specifies a maximum date after which dates may not be specified.
 </p><p class="tableblock">See <a href="http://eonasdan.github.io/bootstrap-datetimepicker/Options/#maxdate">datetimepicker reference docs</a> for
 further details.  The string must be in ISO date format (see <a href="https://github.com/moment/moment/issues/1407">here</a>
 for further details).</p></td>
@@ -1381,7 +1381,7 @@ for further details).</p></td>
 </div></div></td>
 <td class="tableblock halign-left valign-top"><p class="tableblock">ISO format date<br>
 (<code>1900-01-01T00:00:00.000Z</code>)</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">(<code>1.13.0-SNAPSHOT</code>), specifies a minimum date before which dates may not be specified.
+<td class="tableblock halign-left valign-top"><p class="tableblock">Specifies a minimum date before which dates may not be specified.
 </p><p class="tableblock">See <a href="http://eonasdan.github.io/bootstrap-datetimepicker/Options/#mindate">datetimepicker reference docs</a> for
 further details.  The string must be in ISO date format (see <a href="https://github.com/moment/moment/issues/1407">here</a>
 for further details).</p></td>
@@ -1408,7 +1408,7 @@ for further details).</p></td>
 <code>liveReloadUrl</code></p>
 </div></div></td>
 <td class="tableblock halign-left valign-top"><p class="tableblock">URL</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">(<code>1.13.0-SNAPSHOT</code>), specifies the URL if <a href="dg.html#_dg_ide_intellij_advanced_gradle-liveReload">live reload</a> is set up, eg:<br>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Specifies the URL if <a href="dg.html#_dg_ide_intellij_advanced_gradle-liveReload">live reload</a> is set up, eg:<br>
 </p><p class="tableblock"><code><a href="http://localhost:35729/livereload.js?snipver=1" class="bare">http://localhost:35729/livereload.js?snipver=1</a></code></p></td>
 </tr>
 <tr>
@@ -1449,7 +1449,7 @@ for further details).</p></td>
 <code>rememberMe.cookieKey</code></p>
 </div></div></td>
 <td class="tableblock halign-left valign-top"><p class="tableblock">ascii chars (<code><em>isisWicketRememberMe</em></code>)</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">(<code>1.13.0-SNAPSHOT</code>) Cookie key holding the (encrypted) 'rememberMe' user/password.  There is generally no need to
+<td class="tableblock halign-left valign-top"><p class="tableblock">Cookie key holding the (encrypted) 'rememberMe' user/password.  There is generally no need to
 change this. <br>
 </p><p class="tableblock">Valid values as per <a href="http://stackoverflow.com/a/1969339/56880">this StackOverflow answer</a>.</p></td>
 </tr>
@@ -1459,12 +1459,15 @@ change this. <br>
 <code>rememberMe.encryptionKey</code></p>
 </div></div></td>
 <td class="tableblock halign-left valign-top"><p class="tableblock">any string (a random UUID each time)</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">(<code>1.13.0-SNAPSHOT</code>) Encryption key is used to encrypt the rememberMe user/password. <br>
-</p><p class="tableblock">It should be set to a unique and private value.  If a hard-coded and publicly known value is used, then it would be
-possible for rememberMe user/password to be intercepted and decrypted, compromising access.
-</p><p class="tableblock">If no value is set then (for safety) a random UUID will be used as the encryption key.  The net effect of this
-default is that 'rememberMe' will work, but only until the webapp is restarted (after which the end-user will have
-to log in again).</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Encryption key is used to encrypt the rememberMe user/password. <br>
+</p><p class="tableblock">Apache Isis leverages <a href="http://wicket.apache.org">Apache Wicket</a>'s rememberMe support which holds remembered
+user/passwords in an encrypted cookie.
+</p><p class="tableblock">If a hard-coded and publicly known value were to be used (as was the case prior to <code>1.13.0</code>), then it would be
+possible for rememberMe user/password to be intercepted and decrypted, possibly compromising access.  This
+configuration property therefore allows a private key to be specified, baked into the application.
+</p><p class="tableblock">If no value is set then (for safety) a random UUID will be used as the encryption key.  (The net effect of this
+fallback behaviour is that 'rememberMe' will work, but only until the webapp is restarted (after which the end-user
+will have to log in again).</p></td>
 </tr>
 <tr>
 <td class="tableblock halign-left valign-top"><div><div class="paragraph">
@@ -1472,7 +1475,7 @@ to log in again).</p></td>
 <code>rememberMe.suppress</code></p>
 </div></div></td>
 <td class="tableblock halign-left valign-top"><p class="tableblock"><code>true</code>,<code>false</code> (<code><em>false</em></code>)</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">(<code>1.13.0-SNAPSHOT</code>) Whether to suppress "remember me" checkbox on the login page.</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Whether to suppress "remember me" checkbox on the login page.</p></td>
 </tr>
 <tr>
 <td class="tableblock halign-left valign-top"><div><div class="paragraph">
@@ -1496,7 +1499,7 @@ to log in again).</p></td>
 <code>suppressRememberMe</code></p>
 </div></div></td>
 <td class="tableblock halign-left valign-top"><p class="tableblock"><code>true</code>,<code>false</code> (<code><em>false</em></code>)</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">(Deprecated in <code>1.13.0-SNAPSHOT</code>, replaced by <code>rememberMe.suppress</code>).  Whether to suppress "remember me" checkbox on the login page.</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">(Deprecated in <code>1.13.0</code>, replaced by <code>rememberMe.suppress</code>).  Whether to suppress "remember me" checkbox on the login page.</p></td>
 </tr>
 <tr>
 <td class="tableblock halign-left valign-top"><div><div class="paragraph">
@@ -1599,21 +1602,13 @@ isis.viewer.wicket.maxTitleLengthInParentedTables=8</code></pre>
 <div class="sect3">
 <h4 id="_configuration_4">3.2.2. Configuration</h4>
 <div class="paragraph">
-<p>To suppress the 'remember me' checkbox, add the following configuration flag (<code>1.13.0-SNAPSHOT</code>):</p>
+<p>To suppress the 'remember me' checkbox, add the following configuration flag:</p>
 </div>
 <div class="listingblock">
 <div class="content">
 <pre class="CodeRay highlight"><code data-lang="ini">isis.viewer.wicket.rememberMe.suppress=true</code></pre>
 </div>
 </div>
-<div class="paragraph">
-<p>Prior to <code>1.13.0-SNAPSHOT</code>, the configuration property is:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="CodeRay highlight"><code data-lang="ini">isis.viewer.wicket.suppressRememberMe=true</code></pre>
-</div>
-</div>
 </div>
 </div>
 <div class="sect2">