Refactor security documentation for 2.5.2

Some refactoring for the Security documentation. Gives better distinction between the configuration and the usage.

Known issues:
1. The three tables under ``LDAP Authentication`` are formatted differently. I can't figure out how to get them to align with each other.
2. Some of the links are broken.
3. As discussed on Hipchat, we may want to consider pulling ``Security`` out one more level.
Yeah, I've left a couple of TODOs in the doc changes that I wasn't sure how to address. Sent out a PR to be able to start iterating on it but was hoping JJ would help me fix those.