...
Le Framework SFK fournit un mécanisme qui permet de filtrer l’accès aux données.
Ce mécanisme est comparable à la mécanique de filtre de synchro du Mobile.
On va ainsi fournir un moyen de construire la liste des éléments accessibles pour un utilisateur connecté.
Avertissement |
---|
BEL question : on parle que SFK. C’est valide dans one? Si oui il faudra revoir les terminologies |
Comment fonctionne le rowaccess ?
...
Deux tables systèmes contiennent les informations nécessaires pour la gestion des droits d’accès.
Remarque |
---|
Il fortement déconseillé d’utiliser manuellement les tables systèmes dans les requêtes métier. |
sw_sys_rowaccessstatus
Liste les demandes de calculs de droits d’accès
...
...
BEL : on n’indique jamais le type des colonnes; normal?
PHM : j’ai ajouté les types
BEL : aurait pu être en présentation tableau; Je mets la version tableau pour visualiser, attente retour pour voir (car permet à l’utilisateur de trier par exemple)
PHM : tu as tout à fait raison la présentation en tableau est plus lisible, j’ai fait le tableau pour l’autre table aussi
Nom de colonne | Type | Description |
---|---|---|
device_ID | INT(11) | L’ID ID du compte de l’utilisateur dont on a demandé les droits d’accès |
metatable_ID | INT(11) | L’ID ID de la table pour laquelle on gère les droits |
computeDate | DATETIME | La date Date de calcul de droits d’accès |
computeDuration | INT(11) | La durée Durée de calcul en millisecondes |
Liste les tables ayant un calcul de rowaccess (en comptant le nombre de comptecomptes)
Bloc de code | ||
---|---|---|
| ||
SELECT ras.metatable_ID, mt.schemaTable, COUNT(ras.device_ID) AS nbDevice FROM sw_sys_rowaccessstatus AS ras INNER JOIN sw_sys_metatable AS mt ON mt.metatable_ID = ras.metatable_ID GROUP BY ras.metatable_ID; |
...
Le rowaccess est lié à une table.
Le calcul est lancé pour un compte connecté.
Pour construire la liste des rowID, il faut utiliser un datasource de type “rowaccess”.
Avec les 3 propriétés suivantes
Nom de propriété | Description | Remarque |
---|---|---|
TableName |
...
Nom de la table pour laquelle on calcule les droits d’accès |
...
Le format avec SFK n’a pas besoin du préfix sw_data_ (exemple : “customer”) |
RowIdField |
...
Nom du champ qui contient l’ID que l’on va copier dans sw_sys_rowaccess.rowID | |
SelectQueryName |
...
Nom du fichier contenant la requête SQL qui retourne la liste des ID accessibles de la table pour un compte |
...
Il est possible de filtrer par rapport à différentes informations liées au compte connecté en utilisant les variables système deviceID, baseUser, baseUserTree, … et les variables de session |
...
Pour demander le calcul d’un rowaccess, il faut utiliser une des méthodes de script client suivantes
...
SFK a un mécanisme pour éviter la surcharge du serveur avec des demandes de calcul trop fréquentes.
S’il y a moins de 5 minutes entre une demande de calcul et la précédente, alors SFK refuse le calcul de droit d’accès. La propriété optionnelle foreceUpdate permet d’obliger le recalcul.
En standard, à la connexion (aussi valable avec F5), on utilise la demande de calcul sans forcer. Par contre lors d’une création ou avec à l’utilisation du bouton de la barre de notification qui permet de mettre à jour les droits d’accès, on force le calcul.
Bouton pour forcer le recalcul de rowaccess
Pour un projet, il est possible d’activer un bouton dans la barre de notification avec la variable RowAccess.ManualRefresh.Enabled
.
...
Ce bouton permet de lancer un recalcul manuel sans tenir compte du délai du cache de tous les rowaccess.
Ce bouton est disponible depuis la version 5.5.
Application du rowaccess
A partir du moment où l’on a une demande de calcul dans la table sw_sys_rowaccessstatus pour une table, cette table sera alors soumise à un droit d’accès. Et tous les comptes qui n’ont pas de ligne pour la table dans sw_sys_rowaccess n’ont aucun accès pour cette table.
Note : c’est valable aussi pour les comptes externes (Extranet). Donc lorsqu’on ajoute un rowaccess, il faut s’assurer que les comptes externes ne sont pas altérés.
...
un formulaire (crud)
Si le crud utilise un datasource de type “table” dont la table est soumise à un rowaccess, les droits d’accès sont automatiquement gérés. Il faut alors avoir accès à l’ID pour accéder au que les données soient chargées dans le formulaire.dans n’importe quel datasource avec une requête SQL (utilisé par une grid, un graph, une combobox, …)
Si l’on utilise la syntaxe {{TABLE(<nom_de_table>, <alias_de_table>)}} avec une table soumise à un rowaccess alors la requête va intègrer un filtre avec sw_sys_rowaccess.
Note : la syntaxe peut être utilisé pour les clauses FROM et INNER JOIN.un élément dans une liste d’entité (entityviews)
Si l’entité est une table soumise à un rowaccess, alors la requête pour construire la liste va intégrer un filtre avec sw_sys_rowaccess.
Si la propriété Data.ApplyRestrictions est utilisée sur une colonne de type foreign dont le schema est définit sur une table soumise à un rowaccess alors la requête pour construire la liste va intégrer un filtre avec sw_sys_rowaccess.
...
Il faut retirer toutes les occurrences des fonctions $rowAccess.setByDatasourceAsync et $rowAccess.setByDatasourcesAsync utilisant le(s) datasource de type “rowaccess” avec le TableName correspondant à la table pour laquelle on veut désactiver.
Info |
---|
...
Ne pas oublier de vider le rowacess pour la table après avoir désactivé. |
Remarque |
---|
La désactivation d'un rowaccess, c’est retirer une restriction d’accès pour tous les utilisateurs d’un projet. Sans restriction, tous les utilisateurs vont accéder à toutes les données.
|
Historique d’utilisation
Ce mécanisme est mis à disposition par le Framework SFK depuis février 2021.
Il a d’abord été intégré pour filtrer l’accès au tiers (table sw_data_customer) dans les versions suivantes de weavy 5.3, 5.4, 5.5, 5.6 et 5.7.
...
Parallélisation de l’exécution des requêtes listant les ID accessibles par l'utilisateur connecté.
Attention : l’ajout L’ajout et la suppression étant dans l’unique table sw_sys_rowaccess, ces traitements ne sont pas parallélisables car il y a un lock de la table.Réécriture des requêtes et ajouts d’index pour optimiser l’exécution.
Algorithme d’optimisation de traitements
Supprimer tous les ID d’une table; puis insérer tous les ID d’une table
Faire le diff de modifications apportées; s’il est inférieur à 500 changements alors la modification est faite de manière plus fine