You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@syncope.apache.org by il...@apache.org on 2018/04/12 10:42:07 UTC
[4/6] syncope git commit: Reworking 'Set admin credentials'
Reworking 'Set admin credentials'
Project: http://git-wip-us.apache.org/repos/asf/syncope/repo
Commit: http://git-wip-us.apache.org/repos/asf/syncope/commit/3c4a3515
Tree: http://git-wip-us.apache.org/repos/asf/syncope/tree/3c4a3515
Diff: http://git-wip-us.apache.org/repos/asf/syncope/diff/3c4a3515
Branch: refs/heads/master
Commit: 3c4a351534e3221a2ce0f0a9660b442f8dbfdc74
Parents: 3211023
Author: Francesco Chicchiriccò <il...@apache.org>
Authored: Thu Apr 12 11:49:28 2018 +0200
Committer: Francesco Chicchiriccò <il...@apache.org>
Committed: Thu Apr 12 11:50:35 2018 +0200
----------------------------------------------------------------------
.../setadmincredentials.adoc | 23 +++++++++++++-------
1 file changed, 15 insertions(+), 8 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/syncope/blob/3c4a3515/src/main/asciidoc/reference-guide/workingwithapachesyncope/systemadministration/setadmincredentials.adoc
----------------------------------------------------------------------
diff --git a/src/main/asciidoc/reference-guide/workingwithapachesyncope/systemadministration/setadmincredentials.adoc b/src/main/asciidoc/reference-guide/workingwithapachesyncope/systemadministration/setadmincredentials.adoc
index 4292a06..10e24f0 100644
--- a/src/main/asciidoc/reference-guide/workingwithapachesyncope/systemadministration/setadmincredentials.adoc
+++ b/src/main/asciidoc/reference-guide/workingwithapachesyncope/systemadministration/setadmincredentials.adoc
@@ -21,22 +21,28 @@
[WARNING]
The procedure below affects only the `Master` <<domains,domain>>; for other domains check <<domains-management,above>>.
-The default password for the `admin` user is `password`.
-
The credentials are defined in the `security.properties` file; text encoding must be set to UTF-8:
-* `adminUser` - administrator username
-* `adminPassword` - SHA1 hash evaluation of cleartext password (represented as a sequence of 40 hexadecimal digits)
-* `adminPasswordAlgorithm` - algorithm to be used for hash evaluation (default value: SHA1)
+* `adminUser` - administrator username (default `admin`)
+* `adminPassword` - administrator password (default `password`)'s hashed value
+* `adminPasswordAlgorithm` - algorithm to be used for hash evaluation (default `SHA1`, others as
+`SHA256`, `SHA512`, `SMD5`, `SSHA1`, `SSHA256`, `SSHA512` and `BCRYPT` are supported)
-For GNU / Linux and Mac OS X, the SHA1 password can be obtained via the `sha1sum` command-line tool of
-http://www.gnu.org/software/coreutils/[GNU Core Utilities^]:
+[TIP]
+====
+The hashed password value can be obtained, depending on the actual algorithm, via various tools.
+As an example, for `SHA1` and GNU / Linux and Mac OS X, the `sha1sum` command-line tool of
+http://www.gnu.org/software/coreutils/[GNU Core Utilities^] can be used as follows:
[source,bash]
....
echo -n "new_password" | sha1sum
....
-For MS Windows, some options are available:
+
+Please beware that any shell special character must be properly escaped for the command above to produce the expected
+hashed value.
+
+Again about `SHA1`, for MS Windows some options are available:
* http://support.microsoft.com/kb/841290[MS File Checksum Integrity Verifier^] +
install, save your password to a file (e.g. `password.txt` without EOL) and issue at command line: +
@@ -47,3 +53,4 @@ fciv.exe -sha1 password.txt
* http://gnuwin32.sourceforge.net/[GnuWin32^] port of GNU utilities for MS Windows
* http://www.cygwin.com/[Cygwin^] Unix-like environment and command-line interface for Microsoft Windows (featuring
http://www.gnu.org/software/coreutils/[GNU Core Utilities^])
+====