OPALE - parametrage

Gestion des droits d'accès sur les objets MAPPING

De MappingDoc

Introduction

Cette documentation explique la gestion des droits d'accès sur les objets MAPPING IBM-i.
Cette documentation explique notamment les droits minimum nécessaire au bon fonctionnement du robot MAPPING

Quelques commandes AS400 à connaitre sur la gestions des droits

DSPOBJAUT : Permet d'afficher les autorisations sur les objets

DSPOBJAUT OBJ(OPALE1017/MAPCPYSPLF) OBJTYPE(*PGM)

--> Affiche les autorisation du programme MAPCPYSPLF de la bib OPALE1017

GRTOBJAUT : Permet de modifier les autorisations sur les objets

GRTOBJAUT OBJ(MAPCPYSPLF) OBJTYPE(*PGM) USER(QPGMR) AUT(*EXCLUDE)

--> Passe l'utililisateur QPGMR en *EXCLUDE sur l'objet programme MAPCPYSPLF de la bib OPALE1017

WRKUSRPRF : Permet de modifier les profils utilisateurs

WRKUSRPRF USRPRF(JDIEU)

--> Permet de voir et modifier les attributs du profil utilisateur JDIEU

Traitements MAPPING

Pour garantir le bon fonctionnement de l'application MAPPING, il faut s'assurer que les utilisateurs exécutant les différents jobs de traitements aient bien accès aux ressources nécessaires (commandes, programmes, etc)

Il y a plusieurs façon d'invoquer des traitements dans MAPPING :

  • De manière interactive en ligne de commande
  • Avec l'utilisation de CL programmes
  • A l'aide du Robot MAPPING

De manière interactive en ligne de commande

Cette façon est souvent utilisée lors des tests manuels. L'utilisateur invoquant la commande est l'utilisateur avec lequel vous êtes connecté (à l'exception des envois d'emails).

Cet utilisateur devra alors avoir accès aux ressources.

Avec l'utilisation de CL programmes

Cette façon est parfois utilisée par nos clients. Les commandes MAPPING sont alors inclues directement dans les programmes CL des clients générant notamment les spooled files. L'utilisateur exécutant les commandes MAPPING sera alors l'utilisateur soumettant le travail. (celui-ci dépend de la configuration des traitements du client)

Traitements via le Robot MAPPING

Il est tout à fait possible également d'utiliser le Robot MAPPING pour automatiser les traitements. L'utilisateur invoquant les commandes (à l'exception de la commande MAPSNDMAIL) sera alors l'utilisateur système MAPPING. (profil créé et paramétré lors de l'installation de MAPPING IBM-i)

Cet utilisateur devra alors avoir accès aux ressources.

Fonctionnement des droits sur les objets IBM-i

Valeurs par défaut à l'installation de MAPPING IBM-i

Lors de l'installation de MAPPING IBM-i, des valeurs de droits par défaut sont présentes sur les différents objets MAPPING. (programmes, commandes, etc...)

Pour les besoin de rédaction de cette présente documentation, nous allons prendre pour exemple le programme de génération de PDF via la commande MAPCPYSPLF. La commande MAPCPYSPLF exécute en fait 3 programmes : MAPCPYSPLF, MAP_815UCS et MAP_XPS

Nous allons vérifier les autorisations données par défaut à ces objets lors de l'installation de MAPPING.

DSPOBJAUT OBJ(OPALE1017/MAPCPYSPLF) OBJTYPE(*PGM)
                         Droits  
  Utilisat    Groupe      sur objet 
  *PUBLIC                 *CHANGE   
  QPGMR                   *ALL      
DSPOBJAUT OBJ(OPALE1017/MAP_815UCS) OBJTYPE(*PGM)
                         Droits  
  Utilisat    Groupe      sur objet 
  *PUBLIC                 *CHANGE   
  QPGMR                   *ALL  

DSPOBJAUT OBJ(OPALE1017/MAP_XPS) OBJTYPE(*PGM)

                         Droits  
  Utilisat    Groupe      sur objet 
  *PUBLIC                 *CHANGE   
  QPGMR                   *ALL  

DSPOBJAUT OBJ(OPALE1017/MAPCPYSPLF) OBJTYPE(*CMD)

                         Droits  
  Utilisat    Groupe      sur objet 
  *PUBLIC                 *CHANGE   
  QPGMR                   *ALL  

Nous voyons que pour ces objets par défaut, l'utilisateur QPGMR a tous les droits *ALL et que tous les autres *PUBLIC ( soit les autres que celui listé en dessous ( soit dans notre cas QPGMR)) ont les droits de modifications *CHANGE

Quels impacts il y a sur les traitements du robot MAPPING

MAPPING a un robot (Sous système scannant des fichiers spool dans des OUTQs monitorées) qui permet l'automatisation des traitements. Chaque évènement arrivant dans une des OUTQs monitorés fait l'objet d'un traitement par l'intermédiaire de différents jobs. A l'exception de la commande MAPSNDMAIL, tous ces jobs sont exécutés par l'utilisateur système MAPPING (utilisateur créé à l'installation de MAPPING IBM-i)

Par conséquent, il faut s'assurer que l'utilisateur MAPPING ait bien les droits d'exécution sur les objets MAPPING (Exemple du MAPCPYSPLF ci-dessus)

Pour étayer cela, prenons les exemples ci-dessous.


Exemple 1

MAPPING en classe utilisateur *USER sans droits spéciaux avec *PUBLIC en *CHANGE et QPGMR en *ALL.

Prenons pour exemple l'exécution du programme MAPCPYSPLF avec le paramétrage droits/Autorisations suivant :

Utilisateur MAPPING :

  • Classe utilisateur : *USER
  • Droit spéciaux : *NONE

Programme MAPCPYSPLF :

  • PUBLIC *CHANGE

QPGMR *ALL

Le fonctionnement des droits fonctionne comme ci-après :

  1. Est ce que l'utilisateur MAPPING a les droits sur le programme MAPCPYSPLF?

Pour répondre à cette question, exécutons la commande ci-dessous :

DSPOBJAUT OBJ(OPALE1017/MAPCPYSPLF) OBJTYPE(*PGM)
                         Droits  
  Utilisat    Groupe      sur objet 
  *PUBLIC                 *CHANGE   
  QPGMR                   *ALL

L'utilisateur MAPPING fait dans ce cas parti du '*PUBLIC', de ce fait, il a le droit à '*CHANGE'

*CHANGE 
        Permet toutes les opérations sur l'objet, à l'exception de 
        celles réservées au propriétaire ou contrôlées par les droits 
        sur l'existence et sur la gestion de l'objet.

Cette autorisation lui permet donc d'exécuter la commande MAPCPYSPLF (et les 2 autres programmes associés qui ont les mêmes autorisations).

De ce fait la création du PDF ne posera pas de problème via le Robot.

Exemple 2

MAPPING en classe utilisateur *USER sans droits spéciaux avec *PUBLIC en *EXCLUDE et QPGMR en *ALL

Prenons pour exemple l'exécution du programme MAPCPYSPLF avec le paramétrage droits/Autorisations suivant :

Utilisateur MAPPING :

  • Classe utilisateur : *USER
  • Droit spéciaux : *NONE

Programme MAPCPYSPLF :

  • PUBLIC *EXCLUDE

QPGMR *ALL

Le fonctionnement des droits est comme cela :

  1. Est ce que l'utilisateur MAPPING a les droits sur programme MAPCPYSPLF?

Pour répondre à cette question, exécutons la commande ci-dessous :

DSPOBJAUT OBJ(OPALE1017/MAPCPYSPLF) OBJTYPE(*PGM)
                         Droits  
  Utilisat    Groupe      sur objet 
  *PUBLIC                 *EXCLUDE   
  QPGMR                   *ALL

L'utilisateur MAPPING fait dans ce cas partie du '*PUBLIC', de ce fait, il a le droit à '*EXCLUDE'

     *EXCLUDE 
        Interdit toute opération sur l'objet.  
        sur l'existence et sur la gestion de l'objet.

On pourrait donc croire que le Robot ne puisse pas exécuter le programme MAPCPYSPLF, mais en fait il le pourra car dans le cas où l'utilisateur l'exécutant (dans le cas du Robot, l'utilisateur MAPPING) n'a pas les droits pour l'exécuter, le système IBM-i l'exécutera également avec les droits de son propriétaire. Le propriétaire des programmes MAPPING étant l'utilisateur QPGMR, alors son exécution se fera avec ses droits. Dans notre exemple avec les droits *ALL

Cette autorisation lui permet donc d'exécuter la commande MAPCPYSPLF (et les 2 autres programmes associés qui ont les mêmes autorisations).

De ce fait la création du PDF ne posera pas de problème via le Robot.


Exemple 3

MAPPING en classe utilisateur *USER sans droits spéciaux avec *PUBLIC en *EXCLUDE et QPGMR en *EXCLUDE

Prenons pour exemple l'exécution du programme MAPCPYSPLF avec le paramétrage droits/Autorisations suivant :

Utilisateur MAPPING :

  • Classe utilisateur : *USER
  • Droit spéciaux : *NONE

Programme MAPCPYSPLF :

  • PUBLIC *EXCLUDE

QPGMR *EXCLUDE

Le fonctionnement des droits est comme cela :

  1. Est ce que l'utilisateur MAPPING a les droits sur programme MAPCPYSPLF?

Pour répondre à cette question, exécutons la commande ci-dessous :

DSPOBJAUT OBJ(OPALE1017/MAPCPYSPLF) OBJTYPE(*PGM)
                         Droits  
  Utilisat    Groupe      sur objet 
  *PUBLIC                 *EXCLUDE   
  QPGMR                   *EXCLUDE

L'utilisateur MAPPING fait dans ce cas parti du '*PUBLIC', de ce fait, il a le droit à '*EXCLUDE'

     *EXCLUDE 
        Interdit toute opération sur l'objet.  
        sur l'existence et sur la gestion de l'objet.

Tout comme dans l'exemple 2 ci-dessus, le système va essayer d'exécuter le programme MAPCPYSPLF avec l'utilisateur MAPPING. Celui-ci fait parti de *PUBLIC qui est en *EXCLUDE, de ce fait, il ne pourra pas l'exécuter. Ensuite le système va essayer de l'exécuter avec l'utilisateur propriétaire du programme à exécuter (MAPCPYSPLF) qui est QPGMR, mais celui-ci est également en *EXCLUDE

De ce fait la création du PDF sera impossible via le Robot. Un message d'erreur apparaitra dans les logs du robot MAPPING : Erreurs trouvées dans la commande


Exemple 4

Il est tout à fait possible de surcharger les autorisations vues précédemment (vu dans le DSPOBJAUT) en attribuant des droits spéciaux sur le profil MAPPING. La valeur permettant d'exécuter n'importe quel programme même si l'utilisateur n'a pas les droits dessus est la valeur *ALLOBJ

Si l'utilisateur MAPPING a ce droit spéciaux, alors peu importe ses droits sur les objets, il pourra les exécuter et il n'y aura plus de problème de droits avec le Robot. (De ce fait, avec les droits spéciaux *ALLOBJ, l'exécution de la commande MAPCPYSPLF de l'exemple 3 serait alors possible )

Remarque sur le passage d'un utilisateur en *ALLOBJ:
Avantage : Plus facile car on ne se pose plus de question sur la gestion des droits
Inconvénient : Donne accès à tous les objets sur système, ce qui peut être dangereux.


Cas particulier de l'envoi d'emails via la commande MAPSNDMAIL

Nous avons vu plus haut que toute commande invoquée par le Robot MAPPING été exécutée avec l'utilisateur MAPPING. Nous avons également vu qu'il y avait une exception qui est la commande MAPSNDMAIL (à l'étape de l'envoi d'emails)

En effet la commande MAPSNDMAIL est quant à elle invoquée par l'utilisateur ayant lancé le travail MAPSMTP :

Soit via le menu MAPPING e-Mail / Démarrage de la gestion des mails, soit via la commande STRMAPMAIL.

L'utilisateur lançant ce job devra respecter les mêmes contraintes que l'utilisateur MAPPING afin que les mails puissent être envoyé via le Robot MAPPING. (avoir accès au programme d'envoi d'emails MAP_031P1)

Les envois de PDFs par emails via la commande MAPSNDMAIL se passent comme ceci :

  • La commande MAPCPYSPLF (avec les 3 programmes MAPCPYSPLF, MAP_815UCS et MAP_XPS) sont exécutées pour la création du fichier PDF. (Et non directement par MAPPING comme dans le cas de génération de PDF sans envoi d'email)

--> Ces programmes sont exécutés avec en premier l'utilisateur propriétaire du spool à envoyer, et si celui-ci n'a pas les droits, avec l'utilisateur MAPPING et si celui-ci n'a pas non plus les droits avec le propriétaire des programmes (QPGMR)

  • Une fois le PDF généré, l'envoi d'email se fera via le programme MAP_031P1 et sera exécuté avec l'utilisateur qui a démarré le job MAPSMTP

-->Celui-ci doit bien avoir accès au programme MAP_031P1 (comme vu dans les exemples d'avant)

Démarrage/Arrêt du Robot MAPPING

  1. L'utilisateur voulant démarrer le robot MAPPING (STRRBT) devra obligatoirement avoir le droit spécial *JOBCTL.
  2. Il devra également avoir les droits en *USE sur la description de sous-système (DSPOBJAUT OBJ(BIB/MAPSxxxx) OBJTYPE(*SBSD)
  3. Il devra aussi avoir les droits en *EXECUTE sur la bibliothèque contenant cette description (DSPOBJAUT OBJ(LIB) OBJTYPE(*LIB))

Conclusion

Nous pouvons tirer plusieurs conclusions :

  1. Dans le cas d'utilisation du Robot, le profil utilisateur exécutant les traitement sera toujours (à l'exception de la commande MAPSNDMAIL) MAPPING
  2. Peu importe la classe utilisateur du profil exécutant le traitement
  3. Sans droit spéciaux, les droits d'un objet (programme, commande, etc) IBM-i sont affichés grâce la commande DSPOBJAUT ou modifiés à la commande GRTOBJAUT
  4. Le droit spécial *ALLOBJ donné à un utilisateur bypasse ces restrictions de droits et donne accès à l'exécution sur tous les objets
  5. Dans les envois en PDF, il y a 2 niveaux de droits :
  • 1er niveau sur la création du PDF : Avec dans l'ordre le profil ayant créé le spool à envoyer ou l'utilisateur MAPPING ou l'utilisateur propriétaire des programme QPGMR
  • 2ième niveau pour l'envoi : L'utilisateur exécutant le programme d'envoi d'emails (MAP_C31P1) est celui ayant lancé le MAPSMTP
  1. Démarrage du Robot MAPPING : Droit spécial *JOBCTL