droits.md

Soit l'association entre utilisateur et rôle est renseignée directement dans la base de données (table user/role/linker
Soit en fonction du filtre LDAP du rôle : si un rôle a un filtre LDAP renseigné et que le compte LDAP correspond à ce filtre alors il peut être associé au rôle.
<?php

namespace Application\Provider\Privilege;

/**
 * Description of Privileges
 *
 * Liste des privilèges utilisables dans votre application
 *
 * @author UnicaenCode
 */
class Privileges extends \UnicaenAuth\Provider\Privilege\Privileges {

    const ALBUM_VISUALISATION           = 'album-visualisation';
    const ALBUM_EDITION                 = 'album-edition';

}
'bjyauthorize'    => [
        'guards'             => [
            /* Utilisation du système de privilèges d'UnicaenAuth pour les guards */
            \UnicaenAuth\Guard\PrivilegeController::class => [
                /* Global */
                [
                    'controller' => 'Application\Controller\OffreFormation',
                    'action'     => ['search-structures', 'search-niveaux'],
                    'privileges' => Privileges::ODF_VISUALISATION,
                ],
                /* Éléments pédagogiques */
                [
                    'controller' => 'Application\Controller\OffreFormation\ElementPedagogique',
                    'action'     => ['voir', 'search', 'getPeriode'], // getPeriode est utilisé pour la saisie de service!!!
                    'privileges' => Privileges::ODF_ELEMENT_VISUALISATION,
                ],
                [
                    'controller' => 'Application\Controller\OffreFormation\ElementPedagogique',
                    'action'     => ['saisir', 'supprimer'],
                    'privileges' => Privileges::ODF_ELEMENT_EDITION,
                    // usage avancé d'une assertion pour préciser les droits
                    'assertion'  => 'OffreDeFormationAssertion',
                ],
                /* Rétro-compatibilité avec le système de BjyAuthorize : on peut aussi fournir des rôles... */
                [
                    'controller' => 'Application\Controller\OffreFormation\OffreFormation',
                    'action'     => ['index'],
                    'roles'      => ['user'], // tous les utilisateurs connectés ont accès à cette page
                ],
            ],
        ],
    ],
$resourceAlbumIndex = \UnicaenAuth\Guard\PrivilegeController::getResourceId('Application\Controller\Album', 'index');
use Application\Provider\Privilege\Privileges;

$resourceAlbumEdition = Privileges::getResourceId(Privileges::ALBUM_EDITION);
'bjyauthorize' => [
    'resource_providers' => [
        'BjyAuthorize\Provider\Resource\Config' => [
            'ElementPedagogique' => [],
            'Etape'              => [],
        ],
    ],
],
namespace Application\Entity\Db;

use Zend\Permissions\Acl\Resource\ResourceInterface;

class ElementPedagogique implements ResourceInterface
{

    /**
     * Returns the string identifier of the Resource
     *
     * @return string
     */
    public function getResourceId()
    {
        return 'ElementPedagogique'; // à déclarer aussi dans votre config comme ci-dessus
    }

}
'bjyauthorize' => [
    'rule_providers'     => [
        \UnicaenAuth\Provider\Rule\PrivilegeRuleProvider::class => [
            'allow' => [
                [
                    'privileges' => Privileges::ODF_ELEMENT_EDITION,
                    'resources'  => ['ElementPedagogique', 'Structure'],
                    'assertion'  => 'AssertionOffreDeFormation',
                ],
                [
                    'privileges' => Privileges::ODF_ETAPE_EDITION,
                    'resources'  => ['Etape', 'Structure'],
                    'assertion'  => 'AssertionOffreDeFormation',
                ],
                [
                    'privileges' => Privileges::ODF_CENTRES_COUT_EDITION,
                    'resources'  => ['Etape', 'Structure', 'ElementPedagogique', 'CentreCoutEp'],
                    'assertion'  => 'AssertionOffreDeFormation',
                ],
                [
                    'privileges' => Privileges::ODF_MODULATEURS_EDITION,
                    'resources'  => ['Etape', 'Structure', 'ElementPedagogique', 'ElementModulateur'],
                    'assertion'  => 'AssertionOffreDeFormation',
                ],
            ],
        ],
    ],
],
/**
 * @param string        $privilege
 * @param string        $subPrivilege
 *
 * @return boolean
 */
protected function assertPrivilege($privilege, $subPrivilege = null)

/**
 * @param string        $controller
 * @param string        $action
 * @param string        $privilege
 *
 * @return boolean
 */
protected function assertController($controller, $action = null, $privilege = null)

/**
 * @param ResourceInterface $entity
 * @param string            $privilege
 *
 * @return boolean
 */
protected function assertEntity(ResourceInterface $entity, $privilege = null)

/**
 * @param ResourceInterface $resource
 * @param string            $privilege
 *
 * @return boolean
 */
protected function assertOther(ResourceInterface $resource = null, $privilege = null)
<?php

namespace Application\Assertion;

use Application\Provider\Privilege\Privileges;
use Application\Entity\Db\CentreCoutEp;
use Application\Entity\Db\ElementModulateur;
use Application\Entity\Db\ElementPedagogique;
use Application\Entity\Db\Etape;
use Application\Entity\Db\Source;
use Application\Entity\Db\Structure;
use UnicaenAuth\Assertion\AbstractAssertion;
use Application\Acl\Role;
use Zend\Permissions\Acl\Resource\ResourceInterface;


/**
 * Description of OffreDeFormationAssertion
 *
 * @author Laurent LÉCLUSE <laurent.lecluse at unicaen.fr>
 */
class OffreDeFormationAssertion extends AbstractAssertion
{
    protected function assertEntity(ResourceInterface $entity = null, $privilege = null)
    {
        $role = $this->getRole();
        // Si le rôle n'est pas renseigné alors on s'en va...
        if (!$role instanceof Role) return false;
        // pareil si le rôle ne possède pas le privilège adéquat
        if (!$this->getAcl()->isAllowed($role, Privileges::getResourceId($privilege))) return false;

        // Si c'est bon alors on affine...
        switch(true){
            case $entity instanceof ElementPedagogique:
                switch ($privilege) {
                    case Privileges::ODF_ELEMENT_EDITION:
                        return $this->assertElementPedagogiqueSaisie($role,$entity);
                    case Privileges::ODF_CENTRES_COUT_EDITION:
                        return $this->assertElementPedagogiqueSaisieCentresCouts($role, $entity);
                    case Privileges::ODF_MODULATEURS_EDITION:
                        return $this->assertElementPedagogiqueSaisieModulateurs($role, $entity);
                }
                break;
            case $entity instanceof Etape:
                switch ($privilege) {
                    case Privileges::ODF_ETAPE_EDITION:
                        return $this->assertEtapeSaisie($role, $entity);
                    case Privileges::ODF_CENTRES_COUT_EDITION:
                        return $this->assertEtapeSaisieCentresCouts($role, $entity);
                    case Privileges::ODF_MODULATEURS_EDITION:
                        return $this->assertEtapeSaisieModulateurs($role, $entity);
                }
                break;
            case $entity instanceof Structure:
                switch ($privilege) {
                    case Privileges::ODF_ETAPE_EDITION:
                    case Privileges::ODF_ELEMENT_EDITION:
                    case Privileges::ODF_CENTRES_COUT_EDITION:
                    case Privileges::ODF_MODULATEURS_EDITION:
                        return $this->assertStructureSaisie($role, $entity);
                }
                break;
            case $entity instanceof CentreCoutEp:
                switch ($privilege) {
                    case Privileges::ODF_CENTRES_COUT_EDITION:
                        return $this->assertCentreCoutEpSaisieCentresCouts($role, $entity);
                }
                break;
            case $entity instanceof ElementModulateur:
                switch ($privilege) {
                    case Privileges::ODF_MODULATEURS_EDITION:
                        return $this->assertElementModulateurSaisieModulateurs($role, $entity);
                }
                break;
        }

        return true;
    }


    /* ---- Edition étapes & éléments ---- */
    protected function assertElementPedagogiqueSaisie(Role $role, ElementPedagogique $elementPedagogique)
    {
        return $this->assertStructureSaisie($role, $elementPedagogique->getStructure())
        && $this->assertSourceSaisie($elementPedagogique->getSource());
    }


    protected function assertEtapeSaisie(Role $role, Etape $etape)
    {
        return $this->assertStructureSaisie($role, $etape->getStructure())
        && $this->assertSourceSaisie($etape->getSource());
    }


    /* ---- Centres de coûts ---- */
    protected function assertEtapeSaisieCentresCouts(Role $role, Etape $etape)
    {
        return $this->assertStructureSaisie($role, $etape->getStructure())
        && $etape->getElementPedagogique()->count() > 0;
    }


    protected function assertCentreCoutEpSaisieCentresCouts(Role $role, CentreCoutEp $centreCoutEp)
    {
        return $this->assertElementPedagogiqueSaisieCentresCouts($role, $centreCoutEp->getElementPedagogique());
    }


    protected function assertElementPedagogiqueSaisieCentresCouts(Role $role, ElementPedagogique $elementPedagogique)
    {
        return $this->assertStructureSaisie($role, $elementPedagogique->getStructure());
    }


    /* ---- Modulateurs ---- */
    protected function assertEtapeSaisieModulateurs(Role $role, Etape $etape)
    {
        return $this->assertStructureSaisie($role, $etape->getStructure())
        && $etape->getElementPedagogique()->count() > 0;
    }


    protected function assertElementPedagogiqueSaisieModulateurs(Role $role, ElementPedagogique $elementPedagogique)
    {
        return $this->assertStructureSaisie($role, $elementPedagogique->getStructure());
    }


    protected function assertElementModulateurSaisieModulateurs(Role $role, CentreCoutEp $centreCoutEp)
    {
        return $this->assertElementPedagogiqueSaisieCentresCouts($role, $centreCoutEp->getElementPedagogique());
    }


    /* ---- Globaux ---- */
    protected function assertStructureSaisie(Role $role, Structure $structure)
    {
        // Dans Ose (d'où vient cette assertion), les rôles sont parfois liés à une structure. Pas dans UnicaenAuth
        if ($rs = $role->getStructure()) {
            return $rs === $structure;
        }

        return true;
    }


    protected function assertSourceSaisie(Source $source)
    {
        return $source->isOse();
    }
}
$elementPedagogique = /* Récupération d'un élément pédagogique */
$canEditElement = $this->isAllowed($elementPedagogique,Privileges::ODF_ELEMENT_EDITION);
if ($canEditElement) echo 'On a le droit d\'éditer cet élément pédagogique particulier';


/* Depuis une aide de vue */
$canCreateEtape = $this->getView()->isAllowed(Privileges::getResourceId(Privileges::ODF_ETAPE_EDITION));
//utile pour afficher de manière conditionnelle un bouton d'ajout d'étape à partir du privilège correspondant


/* Savoir si on a le droit d'effectuer l'action de saisir un album */
$canGo = $this->isAllowed(\UnicaenAuth\Guard\PrivilegeController::getResourceId('Application\Controller\Album', 'saisie');
if ($canGo) echo '<a href="'.$this->url('album/saisie').'">Saisie d\'album</a>';
$serviceAuthorize = $this->getServiceLocator()->get('BjyAuthorize\Service\Authorize');
/* @var $serviceAuthorize \BjyAuthorize\Service\Authorize */

$canDoThat = $serviceAuthorize->isAllowed(/* vos paramètres */);
'navigation'      => [
        'default' => [
            'home' => [
                'pages' => [
                    'of' => [
                        'label'    => 'Offre de formation',
                        'title'    => "Gestion de l'offre de formation",
                        'route'    => 'of',
                        // exemple en récupérant le ressource d'une action de contrôleur
                        'resource' => \UnicaenAuth\Guard\PrivilegeController::getResourceId('Application\Controller\OffreFormation', 'index'),
                    ],
                ],
            ],
        ],
    ],