abilityUtils.ts 12 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316
  1. import RoleUtils from '~/services/rights/roleUtils'
  2. import {AbilitiesType} from '~/types/interfaces'
  3. import YamlDenormalizer from "~/services/data/serializer/denormalizer/yamlDenormalizer";
  4. import {MongoAbility} from "@casl/ability/dist/types/Ability";
  5. import {useEach} from "#imports";
  6. import {ABILITIES} from "~/types/enum/enums";
  7. interface Condition {
  8. function: string
  9. parameters?: Array<any>
  10. expectedResult?: any
  11. }
  12. /**
  13. * Classe permettant de mener des opérations sur les habilités
  14. */
  15. class AbilityUtils {
  16. private readonly ability: MongoAbility = {} as MongoAbility
  17. private readonly accessProfile: any
  18. private readonly organizationProfile: any
  19. private readonly configDir = './config/abilities/config.yaml'
  20. private abilitiesByRoles: Array<AbilitiesType> = []
  21. private abilitiesByConfig: Array<AbilitiesType> = []
  22. /**
  23. * @constructor
  24. */
  25. constructor(
  26. ability: MongoAbility,
  27. accessProfile: any,
  28. organizationProfile: any,
  29. ) {
  30. this.ability = ability
  31. this.accessProfile = accessProfile
  32. this.organizationProfile = organizationProfile
  33. }
  34. /**
  35. * Construit les habilités de l'utilisateur selon son profil et met à jour MongoAbility en fonction
  36. */
  37. setupAbilities() {
  38. // Nécessaire pour que l'update des habilités soit correcte après la phase SSR
  39. this.ability.update(this.accessProfile.abilities)
  40. // Au moment où l'on effectue une action organizationProfileStore.setProfile, il faut aller récupérer
  41. // les différentes habilités que l'utilisateur peut effectuer. (Tout cela se passe en SSR)
  42. const unsubscribe = this.organizationProfile.$onAction(({
  43. name, // name of the action
  44. store, // store instance, same as `someStore`
  45. args, // array of parameters passed to the action
  46. after, // hook after the action returns or resolves
  47. onError, // hook if the action throws or rejects
  48. }: any) => {
  49. after((result: any)=>{
  50. if (name === 'setProfile'){
  51. //On récupère les habilités
  52. const abilities = this.buildAbilities();
  53. //On les store puis on update le service ability pour le mettre à jour.
  54. this.accessProfile.abilities = abilities
  55. console.log(abilities)
  56. this.ability.update(abilities)
  57. // Unsubscribe pour éviter les memory leaks
  58. unsubscribe()
  59. }
  60. })
  61. })
  62. }
  63. /**
  64. * Construit et renvoie l'ensemble des habilités de l'utilisateur, qu'elles soient issues de ses roles
  65. * ou de la configuration
  66. *
  67. * @return {Array<AbilitiesType>}
  68. */
  69. buildAbilities(): Array<AbilitiesType> {
  70. this.buildAbilitiesFromRoles()
  71. this.buildAbilitiesFromConfig()
  72. return this.abilities()
  73. }
  74. abilities(): Array<AbilitiesType> {
  75. return ([] as Array<AbilitiesType>).concat(this.abilitiesByRoles).concat(this.abilitiesByConfig)
  76. }
  77. /**
  78. * Adaptation et transformations des roles symfony en abilities Casl
  79. */
  80. buildAbilitiesFromRoles() {
  81. this.abilitiesByRoles = RoleUtils.rolesToAbilities(this.accessProfile.roles)
  82. }
  83. /**
  84. * Charge les habilités depuis les fichiers de configuration
  85. */
  86. buildAbilitiesFromConfig() {
  87. const doc = YamlDenormalizer.denormalize({path: this.configDir})
  88. const fromConfig = doc.abilities
  89. useEach(fromConfig, (ability: { action: ABILITIES, conditions: Array<Condition> }, subject: string) => {
  90. let { action, conditions } = ability
  91. if (!Array.isArray(conditions)) {
  92. // Special: la denormalization ne produit pas une array s'il n'y a qu'un seul élément
  93. conditions = [conditions]
  94. }
  95. if (this.hasConfigAbility(conditions as Array<Condition>, subject)) {
  96. this.abilitiesByConfig.push({ action, subject })
  97. }
  98. })
  99. }
  100. /**
  101. * Parcourt les services définis dans la configuration, et établit si oui ou non l'habilité est autorisée
  102. *
  103. * @return {boolean}
  104. * @param conditions Les conditions à l'obtention de l'habileté, telles que définies dans les fichiers de config
  105. * @param subject For debugging purpose only
  106. */
  107. hasConfigAbility(conditions: Array<Condition>, subject: string = '') {
  108. return conditions.every((condition) => this.execAndValidateCondition(condition, subject))
  109. }
  110. /**
  111. * Correspondances entre les noms des fonctions définies dans les conditions des fichiers de configuration et
  112. * les méthodes correspondantes
  113. *
  114. * TODO: voir pourquoi on a besoin d'accepter un param null pour le hasProfile?
  115. */
  116. handlerMap: any = {
  117. accessHasAllRoleAbilities: (parameters: any) => this.hasAllRoleAbilities(parameters),
  118. accessHasAnyRoleAbility: (parameters: any) => this.hasAnyRoleAbility(parameters),
  119. accessHasAnyProfile: (parameters: any) => parameters === null || this.hasAnyProfile(parameters),
  120. accessHasAllModules: (parameters: any) => this.hasAllModules(parameters),
  121. organizationHasAnyModule: (parameters: any) => this.hasAnyModule(parameters),
  122. accessIsAdminAccount: (parameters: any) => this.accessProfile.isAdminAccount,
  123. organizationIsSchool: (parameters: any) => this.organizationProfile.isSchool,
  124. organizationIsArtist: (parameters: any) => this.organizationProfile.isArtist,
  125. organizationIsManagerProduct: (parameters: any) => this.organizationProfile.isManagerProduct,
  126. organizationHasChildren: (parameters: any) => this.organizationProfile.hasChildren,
  127. organizationIsAssociation: (parameters: any) => this.organizationProfile.isAssociation,
  128. organizationIsShowAdherentList: (parameters: any) => this.organizationProfile.isShowAdherentList,
  129. organizationIsCmf: (parameters: any) => this.organizationProfile.isCmf,
  130. organizationHasWebsite: (parameters: any) => this.organizationProfile.getWebsite,
  131. }
  132. /**
  133. * Exécute la fonction associée à la condition, et compare le résultat obtenu au résultat attendu (true par défaut)
  134. *
  135. * @param condition Un condition à la possession d'une habilité, telle que définie dans les fichiers de config
  136. * @param subject For debugging purpose only
  137. * @private
  138. */
  139. private execAndValidateCondition(
  140. condition: Condition,
  141. subject: string = ''
  142. ) {
  143. const expectedResult: boolean = condition.expectedResult ?? true;
  144. const parameters = condition.parameters ?? []
  145. if (!(condition.function in this.handlerMap)) {
  146. throw new Error('unknown condition function : ' + condition.function)
  147. }
  148. const actualResult = this.handlerMap[condition.function](parameters ?? null)
  149. return actualResult === expectedResult
  150. }
  151. /**
  152. * Est-ce que l'utilisateur possède l'habilité en paramètre
  153. *
  154. * @return {boolean}
  155. * @param ability
  156. */
  157. hasRoleAbility(ability: AbilitiesType): boolean {
  158. // console.log(ability, this.abilitiesByRoles.some((candidate: AbilitiesType) => {
  159. // return candidate.subject === ability.subject && (candidate.action === ability.action || candidate.action === 'manage')
  160. // }))
  161. return this.abilitiesByRoles.some((candidate: AbilitiesType) => {
  162. return candidate.subject === ability.subject &&
  163. (candidate.action === ability.action || candidate.action === 'manage') // 'manage' permet aussi l'action 'read'
  164. })
  165. }
  166. /**
  167. * Est-ce que l'utilisateur possède toutes les habilités passées en paramètre
  168. *
  169. * @param {Array<AbilitiesType>} abilities Habilités à tester
  170. * @return {boolean}
  171. */
  172. hasAllRoleAbilities(abilities: Array<AbilitiesType>): boolean {
  173. return abilities.every(ability => this.hasRoleAbility(ability))
  174. }
  175. /**
  176. * Est-ce que l'utilisateur possède au moins l'une des habilités passées en paramètre
  177. *
  178. * @param {Array<AbilitiesType>} abilities Habilités à tester
  179. * @return {boolean}
  180. */
  181. hasAnyRoleAbility(abilities: Array<AbilitiesType>): boolean {
  182. return abilities.some(ability => this.hasRoleAbility(ability))
  183. }
  184. /**
  185. * Teste si l'utilisateur possède le profil donné
  186. *
  187. * @param {string} profile Profil à tester
  188. * @return {boolean}
  189. */
  190. hasProfile(profile: string): boolean {
  191. return {
  192. 'admin': this.accessProfile.isAdmin,
  193. 'administratifManager': this.accessProfile.isAdministratifManager,
  194. 'pedagogicManager': this.accessProfile.isPedagogicManager,
  195. 'financialManager': this.accessProfile.isFinancialManager,
  196. 'caMember': this.accessProfile.isCaMember,
  197. 'student': this.accessProfile.isStudent,
  198. 'teacher': this.accessProfile.isTeacher,
  199. 'member': this.accessProfile.isMember,
  200. 'other': this.accessProfile.isOther,
  201. 'guardian': this.accessProfile.isGuardian,
  202. 'payor': this.accessProfile.isPayer,
  203. }[profile] ?? false
  204. }
  205. /**
  206. * Retourne vrai si l'utilisateur connecté possède l'un des profils passés en paramètre
  207. *
  208. * @param {Array<string>} profiles Profils à tester
  209. * @return {boolean}
  210. */
  211. hasAnyProfile (profiles: Array<string>): boolean {
  212. return profiles.some(p => this.hasProfile(p))
  213. }
  214. /**
  215. * Retourne vrai si l'utilisateur connecté possède tous les profils passés en paramètre
  216. *
  217. * @param {Array<string>} profiles Profils à tester
  218. * @return {boolean}
  219. */
  220. hasAllProfiles (profiles: Array<string>): boolean {
  221. return profiles.every(p => this.hasProfile(p))
  222. }
  223. /**
  224. * Est-ce que l'utilisateur possède le rôle donné ?
  225. *
  226. * @return {boolean}
  227. * @param role
  228. */
  229. hasRole(role: string): boolean {
  230. return this.accessProfile.hasRole(role)
  231. }
  232. /**
  233. * L'utilisateur possède-t-il au moins l'un des rôles donnés
  234. *
  235. * @return {boolean}
  236. * @param roles
  237. */
  238. hasAnyRole(roles: Array<string>): boolean {
  239. return roles.some(r => this.hasRole(r))
  240. }
  241. /**
  242. * L'utilisateur possède-t-il tous les rôles donnés
  243. *
  244. * @return {boolean}
  245. * @param roles
  246. */
  247. hasAllRoles(roles: Array<string>): boolean {
  248. return roles.every(r => this.hasRole(r))
  249. }
  250. /**
  251. * Est-ce que l'organisation possède le module donné
  252. *
  253. * @return {boolean}
  254. * @param module
  255. */
  256. hasModule(module: string): boolean {
  257. return this.organizationProfile.hasModule(module)
  258. }
  259. /**
  260. * Est-ce que l'organisation possède au moins un des modules donnés
  261. *
  262. * @param modules
  263. * @return {boolean}
  264. */
  265. hasAnyModule(modules: Array<string>): boolean {
  266. return modules.some(r => this.hasModule(r))
  267. }
  268. /**
  269. * Est-ce que l'organisation possède-t-il tous les modules donnés
  270. *
  271. * @param modules
  272. * @return {boolean}
  273. */
  274. hasAllModules(modules: Array<string>): boolean {
  275. return modules.every(r => this.hasModule(r))
  276. }
  277. }
  278. export default AbilityUtils