shiro-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
Subject shiro-site git commit: minor update to web tutorial
Date Wed, 21 Sep 2016 13:32:03 GMT
Repository: shiro-site
Updated Branches:
  refs/heads/master 17a52e37c -> 03c3bb47f

minor update to web tutorial


Branch: refs/heads/master
Commit: 03c3bb47f9b15e51ce34619207d1852c5dda507d
Parents: 17a52e3
Author: Brian Demers <>
Authored: Wed Sep 21 09:31:53 2016 -0400
Committer: Brian Demers <>
Committed: Wed Sep 21 09:31:53 2016 -0400

---------------------------------------------------------------------- | 28 ++++++++++++++--------------
 1 file changed, 14 insertions(+), 14 deletions(-)
diff --git a/ b/
index 5e58da9..22698cf 100644
--- a/
+++ b/
@@ -257,6 +257,9 @@ A Stormpath API Key is required for the Stormpath Realm to communicate
with Stor
 5. Also change the file permissions to ensure only you can read this file. For example, on
*nix operating systems:
         $ chmod go-rwx $HOME/.stormpath/
+        $ chmod u-w $HOME/.stormpath/
+On Windows, you can [set file permissions similarly](
 #### Retrieve the default Stormpath Application
@@ -317,7 +320,7 @@ Make note of your top-level `href` from above - we will use this href
in the `sh
 Now that we have an application, we'll want to create a sample/test user for that application:
+    curl --request POST --user $YOUR_API_KEY_ID:$YOUR_API_KEY_SECRET \
         -H "Accept: application/json" \
         -H "Content-Type: application/json" \
         -d '{
@@ -341,33 +344,30 @@ Again, don't forget to change `$YOUR_APPLICATION_ID` in the URL above
to match y
 Once you choose at least one user store to connect to for Shiro's needs, we'll need to configure
a `Realm` that represents that data store and then tell the Shiro `SecurityManager` about
-If you've checked out the `step2` branch, you'll notice the `shiro.ini` file's `[main]` section
now has the following additions:
+If you've checked out the `step2` branch, you'll notice the `src/main/webapp/WEB-INF/shiro.ini`
file's `[main]` section now has the following additions:
     # Configure a Realm to connect to a user datastore.  In this simple tutorial, we'll just
point to Stormpath since it
     # takes 5 minutes to set up:
     stormpathClient = com.stormpath.shiro.client.ClientFactory
     stormpathClient.cacheManager = $cacheManager
-    stormpathClient.apiKeyFileLocation = $HOME/.stormpath/
+    # (Optional) If you put your in the non-default location, you set the
location here
+    #stormpathClient.apiKeyFileLocation = $HOME/.stormpath/
     stormpathRealm = com.stormpath.shiro.realm.ApplicationRealm
     stormpathRealm.client = $stormpathClient
     # Find this URL in your Stormpath console for an application you create:
     # Applications -> (choose application name) --> Details --> REST URL
-    stormpathRealm.applicationRestUrl =$STORMPATH_APPLICATION_ID
+    # (Optional) If you only have one Application
+    #stormpathRealm.applicationRestUrl =$STORMPATH_APPLICATION_ID
     stormpathRealm.groupRoleResolver.modeNames = name
     securityManager.realm = $stormpathRealm
-Make the following changes:
-1. Change the `$HOME` placeholder to be your actual home directory path, e.g. `/home/jsmith`
so the final `stormpathClient.apiKeyFileLocation` value is something like `/home/jsmith/.stormpath/`.
 This path must match the location of the `` file you downloaded from Stormpath
in Step 2a.
-2. Change the `$STORMPATH_APPLICATION_ID` placeholder to be the actual ID value in the `href`
returned from Stormpath at the end of Step 2a.  The final `stormpathRealm.applicationRestUrl`
value should look something like ``
(with a different application ID of course).
-### 2c: Commit your changes
-Your replaced `$HOME` and `STORMPATH_APPLICATION_ID` values are specific to your application.
Go ahead and commit those changes to your branch:
+Note the optional lines:  
-    $ git add . && git commit -m "updated app-specific placeholders" .
+- If you have been using Stormpath for a while and you have more then one Stormpath application,
the `stormpathRealm.applicationRestUrl` property must be set. 
 ### 2d: Run the webapp

View raw message