directory-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From smckin...@apache.org
Subject [directory-fortress-enmasse] branch master updated: add a few examples
Date Sun, 17 Mar 2019 23:12:33 GMT
This is an automated email from the ASF dual-hosted git repository.

smckinney pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/directory-fortress-enmasse.git


The following commit(s) were added to refs/heads/master by this push:
     new 6bd7120  add a few examples
6bd7120 is described below

commit 6bd7120ee61cd543868f074e2130421c629ddcfb
Author: Shawn McKinney <smckinney@apache.org>
AuthorDate: Sun Mar 17 18:12:28 2019 -0500

    add a few examples
---
 README-QUICKSTART.md | 86 ++++++++++++++++++++++++++++++++++++----------------
 1 file changed, 60 insertions(+), 26 deletions(-)

diff --git a/README-QUICKSTART.md b/README-QUICKSTART.md
index 9b8455a..ec272b8 100644
--- a/README-QUICKSTART.md
+++ b/README-QUICKSTART.md
@@ -27,6 +27,7 @@
  * SECTION 3. Load Sample Security Policy
  * SECTION 4. Test
  * SECTION 5. Table with External Config Switches
+ * SECTION 6. Sample Config
 
 ___________________________________________________________________________________
 ## Document Overview
@@ -116,38 +117,71 @@ ________________________________________________________________________________
 
  Below is the list of Fortress config properties that can be set via Java System Property.
 
 
-|  #  |  Name                            | Sample Values                      |
-| --- | -------------------------------- | ---------------------------------- |
-|   1 | fortress.host                    | localhost, myhostname, 10.14.74.28 |
-|   2 | fortress.port                    | 389 (default), 636, 1389, 1636     |
-|   3 | fortress.admin.user              | cn=manager,dc=example,dc=com       |
-|   4 | fortress.admin.pw                | secret                             |
-|   5 | fortress.min.admin.conn          | 1                                  |
-|   6 | fortress.max.admin.conn          | 10                                 |
-|   7 | fortress.log.user                | cn=log                             |
-|   8 | fortress.log.pw                  | secret                             |
-|   9 | fortress.min.log.conn            | 1                                  |
-|  10 | fortress.max.log.conn            | 5                                  |
-|  11 | fortress.enable.ldap.ssl         | false(default), true               |
-|  12 | fortress.enable.ldap.starttls    | false(default), true               |
-|  13 | fortress.enable.ldap.ssl.debug   | false(default), true               |
-|  14 | fortress.trust.store             | mytruststore                       |
-|  15 | fortress.trust.store.password    | changeit                           |
-|  16 | fortress.trust.store.onclasspath | false(default), true               |
-|  17 | fortress.config.realm            | default                            |
-|  18 | fortress.config.root             | ou=config,dc=example,dc=com        |
-|  19 | fortress.ldap.server.type        | apacheds, openldap, other          |
-|  20 | fortress.is.arbac02              | false(default), true               |
-
-### Sample Config
-
- The following will connect to OpenLDAP over encrypted connection.  The runtime has ARBAC02
checks enabled.
+|  #  |  Name                            | Sample Values                               |
+| --- | -------------------------------- | ------------------------------------------- |
+|   1 | fortress.host                    | localhost(default), myhostname, 10.14.74.28 |
+|   2 | fortress.port                    | 389 (default), 636, 1389, 1636              |
+|   3 | fortress.admin.user              | cn=manager,dc=example,dc=com                |
+|   4 | fortress.admin.pw                | secret                                      |
+|   5 | fortress.min.admin.conn          | 1                                           |
+|   6 | fortress.max.admin.conn          | 10                                          |
+|   7 | fortress.log.user                | cn=log                                      |
+|   8 | fortress.log.pw                  | secret                                      |
+|   9 | fortress.min.log.conn            | 1                                           |
+|  10 | fortress.max.log.conn            | 5                                           |
+|  11 | fortress.enable.ldap.ssl         | false(default), true                        |
+|  12 | fortress.enable.ldap.starttls    | false(default), true                        |
+|  13 | fortress.enable.ldap.ssl.debug   | false(default), true                        |
+|  14 | fortress.trust.store             | mytruststore                                |
+|  15 | fortress.trust.store.password    | changeit                                    |
+|  16 | fortress.trust.store.onclasspath | false(default), true                        |
+|  17 | fortress.config.realm            | default                                     |
+|  18 | fortress.config.root             | ou=config,dc=example,dc=com                 |
+|  19 | fortress.ldap.server.type        | apacheds, openldap, other                   |
+|  20 | fortress.is.arbac02              | false(default), true                        |
+
+___________________________________________________________________________________
+## SECTION 6. Sample Config
+
+ Setting Apache Fortress external configurations via Java System properties can be done using
the startup scripts for the instance. For example the following are valid configurations.
+
+ a. Connect to an OpenLDAP over localhost, port 389 (defaults) using unencrypted connections.
 The runtime has ARBAC02 checks enabled.
  ```concept
 JAVA_OPTS=" -Dversion=2.0.4-SNAPSHOT   \ 
             -Dfortress.admin.user=cn=Manager,dc=example,dc=com  \ 
             -Dfortress.admin.pw=secret  \ 
             -Dfortress.config.root=ou=Config,dc=example,dc=com  \
+            -Dfortress.ldap.server.type=openldap   \
             -Dfortress.is.arbac02=true"
 ```
+ b. The following will connect to ApacheDS over encrypted connection, truststore on the classpath.
+ ```concept
+JAVA_OPTS=" -Dversion=2.0.4-SNAPSHOT   \
+            -Dfortress.host=mydomainname.com
+            -Dfortress.port=1636
+            -Dfortress.ldap.server.type=apacheds   \             
+            -Dfortress.admin.user=uid=admin,ou=system  \ 
+            -Dfortress.admin.pw=secret  \ 
+            -Dfortress.config.root=ou=Config,dc=example,dc=com  \
+            -Dfortress.enable.ldap.ssl=true"     \
+            -Dfortress.trust.store=mystruststore  \
+            -Dfortress.trust.store.password=changeit  \
+            -Dfortress.trust.store.onclasspath=true
+```
+
+ c. This one OpenLDAP again, encrypted connections, truststore found on fully qualified path.
+ ```concept
+JAVA_OPTS=" -Dversion=2.0.4-SNAPSHOT   \
+            -Dfortress.host=mydomainname.com
+            -Dfortress.port=636
+            -Dfortress.ldap.server.type=openldap   \             
+            -Dfortress.admin.user=cn=Manager,dc=example,dc=com  \ 
+            -Dfortress.admin.pw=secret  \ 
+            -Dfortress.config.root=ou=Config,dc=example,dc=com  \
+            -Dfortress.enable.ldap.ssl=true"     \
+            -Dfortress.trust.store=/fully/qualified/file/name/mystruststore  \
+            -Dfortress.trust.store.password=changeit  \
+            -Dfortress.trust.store.onclasspath=false
+```
 
 #### END OF README-QUICKSTART
\ No newline at end of file


Mime
View raw message