For 7.1, the security guides have started formatting their management CLI commands with back slashes to break them up onto separate lines. I believe the intent was for better readability by users. However there are two issues with this:
- This is not something that we do in our other guides (CLI guide, configuration guide), so it is inconsistent.
- If you copy and paste one of these commands into the CLI, you can't go back and change values other than the last line (before the last slash) before you submit. Brian Stansberry confirmed this and brought this up as a concern, since this is probably a regular practice by users.
The second issues is the most problematic, especially since we regularly use test or replaceable values in our commands that a user would HAVE to replace before it is a valid command. An example is here [1], and shown below. If the user wanted to copy and paste this command into the CLI, they wouldn't be able to change any of the test values, like the real path instead of "/path/to".
/subsystem=elytron/kerberos-security-factory=krbSF:add( \ principal="HTTP/host@REALM", \ path="/path/to/http.keytab", \ mechanism-oids=[ \ 1.2.840.113554.1.2.2, \ 1.3.6.1.5.5.2 \ ] \ )
The security guides (and any other places that use this formatting) should be updated to remove the backslash formatting from their CLI commands.