Bug 1252773

Summary:	[QE] Insufficient description of digestCallback for UsernamePasswordLoginModule
Product:	[JBoss] JBoss Enterprise Application Platform 6	Reporter:	mchoma
Component:	Documentation	Assignee:	Priyanka Nag <pnag>
Status:	CLOSED CURRENTRELEASE	QA Contact:	mchoma
Severity:	medium	Docs Contact:
Priority:	unspecified
Version:	6.4.0	CC:	dmichael, eap-docs
Target Milestone:	post-GA	Keywords:	Documentation, EasyFix, Triaged
Target Release:	EAP 6.4.3
Hardware:	Unspecified
OS:	Unspecified
URL:	https://access.stage.redhat.com/documentation/en/red-hat-jboss-enterprise-application-platform/version-6.4/login-module-reference
Whiteboard:
Fixed In Version:		Doc Type:	Bug Fix
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2015-10-20 13:00:20 UTC	Type:	Bug
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	---	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:
Embargoed:
Bug Depends On:
Bug Blocks:	1233012

Description mchoma 2015-08-12 08:56:31 UTC

Book: Login Module Reference
Revision: n_1575841_login-module-reference_version_6.4_edition_1.0_release_0-revision_6701191
Section: 2.2. UsernamePasswordLoginModule

Issue description:
1) For exactness there should be rather mentioned fully-qualified name (FQN) which is org.jboss.crypto.digest.DigestCallback in sentence "The class name of the DigestCallback implementation that includes pre/post digest content like salts for hashing the input password. "

2) Description of digestCallback option for UsernamePasswordLoginModule contains sentence "Only used if hashAlgorithm has been specified.". However it also depends on hashUserPassword option which has to be set to true.


Suggestions for improvement:
Replace description with "The class name of the org.jboss.crypto.digest.DigestCallback implementation that includes pre/post digest content like salts for hashing the input password. Only used if hashAlgorithm has been specified and hashUserPassword is set to true."