doc(engine): improve authorization javadocs

related to CAM-979