From a14be592de431a1565d76d5a47e750c76ef66908 Mon Sep 17 00:00:00 2001
From: Bill Burke <bburke@redhat.com>
Date: Wed, 13 Aug 2014 15:11:05 -0400
Subject: [PATCH] more tooltips

---
 .../base/resources/partials/brute-force.html  | 36 +++++++++++--------
 .../resources/partials/defense-headers.html   |  4 ++-
 .../partials/session-revocation.html          |  3 +-
 3 files changed, 26 insertions(+), 17 deletions(-)

diff --git a/forms/common-themes/src/main/resources/theme/admin/base/resources/partials/brute-force.html b/forms/common-themes/src/main/resources/theme/admin/base/resources/partials/brute-force.html
index 08cddc0ad1c..6567e5992ee 100755
--- a/forms/common-themes/src/main/resources/theme/admin/base/resources/partials/brute-force.html
+++ b/forms/common-themes/src/main/resources/theme/admin/base/resources/partials/brute-force.html
@@ -6,7 +6,7 @@
     </ul>
     <h2></h2>
     <div id="content">
-        <h2><span>{{realm.realm}}</span> Brute Force Protection Settings</h2>
+        <h2><span>{{realm.realm}}</span> Brute Force Protection <span tooltip-placement="right" tooltip="Seeks to prevent hackers trying to guess passwords.  It remembers failures and will lock out users that have too many failutres for a certain amount of time.  WARNING: Vulnerable to denail of service attacks see docs for more details." class="pficon pficon-help"></span></h2>
         <form class="form-horizontal" name="realmForm" novalidate kc-read-only="!access.manageRealm">
             <fieldset class="border-top">
                 <div class="form-group">
@@ -18,21 +18,22 @@
                 <div class="form-group" data-ng-show="realm.bruteForceProtected">
                     <label class="col-sm-2 control-label" for="failureFactor">Failure Factor</label>
 
-                    <div class="col-sm-4">
+                    <div class="col-sm-5">
                         <input class="form-control" type="number" min="1" max="31536000" id="failureFactor" name="failureFactor" data-ng-model="realm.failureFactor" autofocus
                                required>
                     </div>
+                    <span tooltip-placement="right" tooltip="How many failures before wait is triggered." class="pficon pficon-help"></span>
                 </div>
                 <div class="form-group input-select" data-ng-show="realm.bruteForceProtected">
                     <label class="col-sm-2 control-label" for="waitIncrement">Wait Increment</label>
-                    <div class="col-sm-10">
+                    <div class="col-sm-5">
                         <div class="row">
-                            <div class="col-sm-2">
+                            <div class="col-sm-4">
                                 <input class="form-control" type="number" required min="1"
                                        max="31536000" data-ng-model="realm.waitIncrement"
                                        id="waitIncrement" name="waitIncrement"/>
                             </div>
-                            <div class="col-sm-2 select-kc">
+                            <div class="col-sm-4 select-kc">
                                 <select name="waitIncrementUnit" data-ng-model="realm.waitIncrementUnit" >
                                     <option data-ng-selected="!realm.waitIncrementUnit">Seconds</option>
                                     <option>Minutes</option>
@@ -42,25 +43,27 @@
                             </div>
                         </div>
                     </div>
+                    <span tooltip-placement="right" tooltip="When failure threshold has been met, how much time should the user be locked out?" class="pficon pficon-help"></span>
                 </div>
                 <div class="form-group" data-ng-show="realm.bruteForceProtected">
                     <label class="col-sm-2 control-label" for="quickLoginCheckMilliSeconds">Quick Login Check Milli Seconds</label>
 
-                    <div class="col-sm-4">
+                    <div class="col-sm-5">
                         <input class="form-control" type="number" min="1" max="31536000" id="quickLoginCheckMilliSeconds" name="quickLoginCheckMilliSeconds" data-ng-model="realm.quickLoginCheckMilliSeconds" autofocus
                                required>
                     </div>
+                    <span tooltip-placement="right" tooltip="If a failure happens concurrently too quickly, lock out the user." class="pficon pficon-help"></span>
                 </div>
                 <div class="form-group input-select" data-ng-show="realm.bruteForceProtected">
                     <label class="col-sm-2 control-label" for="minimumQuickLoginWait">Minimum Quick Login Wait</label>
-                    <div class="col-sm-10">
+                    <div class="col-sm-5">
                         <div class="row">
-                            <div class="col-sm-2">
+                            <div class="col-sm-4">
                                 <input class="form-control" type="number" required min="1"
                                        max="31536000" data-ng-model="realm.minimumQuickLoginWait"
                                        id="minimumQuickLoginWait" name="minimumQuickLoginWait"/>
                             </div>
-                            <div class="col-sm-2 select-kc">
+                            <div class="col-sm-4 select-kc">
                                 <select name="minimumQuickLoginWaitUnit" data-ng-model="realm.minimumQuickLoginWaitUnit" >
                                     <option data-ng-selected="!realm.minimumQuickLoginWaitUnit">Seconds</option>
                                     <option>Minutes</option>
@@ -70,17 +73,18 @@
                             </div>
                         </div>
                     </div>
+                    <span tooltip-placement="right" tooltip="How long to wait after a quick login failure." class="pficon pficon-help"></span>
                 </div>
                 <div class="form-group input-select" data-ng-show="realm.bruteForceProtected">
                     <label class="col-sm-2 control-label" for="maxFailureWait">Max Wait</label>
-                    <div class="col-sm-10">
+                    <div class="col-sm-5">
                         <div class="row">
-                            <div class="col-sm-2">
+                            <div class="col-sm-4">
                                 <input class="form-control" type="number" required min="1"
                                        max="31536000" data-ng-model="realm.maxFailureWait"
                                        id="maxFailureWait" name="maxFailureWait"/>
                             </div>
-                            <div class="col-sm-2 select-kc">
+                            <div class="col-sm-4 select-kc">
                                 <select name="maxFailureWaitUnit" data-ng-model="realm.maxFailureWaitUnit" >
                                     <option data-ng-selected="!realm.maxFailureWaitUnit">Seconds</option>
                                     <option>Minutes</option>
@@ -90,17 +94,18 @@
                             </div>
                         </div>
                     </div>
+                    <span tooltip-placement="right" tooltip="Max time a user will be locked out." class="pficon pficon-help"></span>
                 </div>
                 <div class="form-group input-select" data-ng-show="realm.bruteForceProtected">
                     <label class="col-sm-2 control-label" for="maxDeltaTime">Failure Reset Time</label>
-                    <div class="col-sm-10">
+                    <div class="col-sm-5">
                         <div class="row">
-                            <div class="col-sm-2">
+                            <div class="col-sm-4">
                                 <input class="form-control" type="number" required min="1"
                                        max="31536000" data-ng-model="realm.maxDeltaTime"
                                        id="maxDeltaTime" name="maxDeltaTime"/>
                             </div>
-                            <div class="col-sm-2 select-kc">
+                            <div class="col-sm-4 select-kc">
                                 <select name="maxDeltaTimeUnit" data-ng-model="realm.maxDeltaTimeUnit" >
                                     <option data-ng-selected="!realm.maxDeltaTimeUnit">Seconds</option>
                                     <option>Minutes</option>
@@ -110,6 +115,7 @@
                             </div>
                         </div>
                     </div>
+                    <span tooltip-placement="right" tooltip="When will failure count be reset?" class="pficon pficon-help"></span>
                 </div>
             </fieldset>
             <div class="pull-right form-actions" data-ng-show="access.manageRealm">
diff --git a/forms/common-themes/src/main/resources/theme/admin/base/resources/partials/defense-headers.html b/forms/common-themes/src/main/resources/theme/admin/base/resources/partials/defense-headers.html
index 4958950db3f..3f334d184bf 100755
--- a/forms/common-themes/src/main/resources/theme/admin/base/resources/partials/defense-headers.html
+++ b/forms/common-themes/src/main/resources/theme/admin/base/resources/partials/defense-headers.html
@@ -7,7 +7,7 @@
     <h2></h2>
     <div id="content">
         <div data-ng-show="access.viewRealm">
-            <h2><span>{{realm.realm}}</span> Browser Security Headers</h2>
+            <h2><span>{{realm.realm}}</span> Browser Security Headers <span tooltip-placement="right" tooltip="HTTP Response header values that you can set to help prevent clickjacking and XSS attacks." class="pficon pficon-help"></span></h2>
             <form class="form-horizontal" name="realmForm" novalidate kc-read-only="!access.manageRealm">
                 <fieldset class="border-top">
                     <div class="form-group">
@@ -15,12 +15,14 @@
                         <div class="col-sm-6">
                             <input class="form-control" id="xFrameOptions" type="text" ng-model="realm.browserSecurityHeaders.xFrameOptions">
                         </div>
+                        <span tooltip-placement="right" tooltip="Click on label link for more information.  The default value prevents pages from being included via non-origin iframes." class="pficon pficon-help"></span>
                     </div>
                     <div class="form-group">
                         <label class="col-sm-2 control-label" for="contentSecurityPolicy"><a href="http://www.w3.org/TR/CSP/">Content-Security-Policy</a></label>
                         <div class="col-sm-6">
                             <input class="form-control" id="contentSecurityPolicy" type="text" ng-model="realm.browserSecurityHeaders.contentSecurityPolicy">
                         </div>
+                        <span tooltip-placement="right" tooltip="Click on label link for more information.  The default value prevents pages from being included via non-origin iframes." class="pficon pficon-help"></span>
                     </div>
                 </fieldset>
                 <div class="pull-right form-actions" data-ng-show="access.manageRealm">
diff --git a/forms/common-themes/src/main/resources/theme/admin/base/resources/partials/session-revocation.html b/forms/common-themes/src/main/resources/theme/admin/base/resources/partials/session-revocation.html
index 8474c1e9178..285f7208f6c 100755
--- a/forms/common-themes/src/main/resources/theme/admin/base/resources/partials/session-revocation.html
+++ b/forms/common-themes/src/main/resources/theme/admin/base/resources/partials/session-revocation.html
@@ -15,6 +15,7 @@
                     <div class="col-sm-4">
                         <input ng-disabled="true" class="form-control" type="text" id="notBefore" name="notBefore" data-ng-model="notBefore" autofocus>
                     </div>
+                    <span tooltip-placement="right" tooltip="Revoke any tokens issued before this date." class="pficon pficon-help"></span>
                 </div>
             </fieldset>
             <div class="pull-right form-actions" data-ng-show="access.manageApplications">
@@ -22,7 +23,7 @@
                 </button>
                 <button type="submit" data-ng-click="setNotBeforeNow()" class="btn btn-primary btn-lg">Set To Now
                 </button>
-                <button type="submit" data-ng-click="pushRevocation()" class="btn btn-primary btn-lg">Push
+                <button type="submit" data-ng-click="pushRevocation()" class="btn btn-primary btn-lg" tooltip="For every application that has an admin URL, notify them of the new revocation policy." tooltip-placement="bottom">Push
                 </button>
             </div>
         </form>