Review Comments from Security Arch review

1)Reorganize document to clearly differentiate what is newly exposed in SailFin, usecases, examples and implementation detail.
2)Update document on how to configure /write Realms.<br>
3)Realms that will be supported in sailfin and GF<br>
4)Check to see if we have utility methods to check for trusted ip address<br>
5)Support properties for TrustHandler<br>
6)Writing a new realm for developers should be made easy i,e for those who<br>
want to reuse supplied Digest validation functionality.<br>
7)Host Name support apart from ipaddress, support for cardinality operators eg: 129.158.229.* i,e all ip
addresses under subnet 129.158.229