manuales_desarrollo

Manuales de desarrollo de YeboYebo

Project maintained by yeboyebo Hosted on GitHub Pages — Theme by mattgraham

Manual desarrollo con ACL

Parte 3. Aplicando reglas en Quimera

Debemos tener la extensión de login en nuestro proyecto, por lo que decidimos si la incluirá nuestro proyecto o la extensión en concreto.
Importamos la librería login en el index.ts de nuestro proyecto/extensión
```
import login from '@quimera-core/extensions/login'
```

Añadimos la extensión al array de dependencias

export default {
  path: ...,
  dependencies: [
    core,
    login
  ],
}

Restringiendo el acceso a Views

Para restringir el acceso a Views, debemos añadir, si no existe, una clave rules en el index.ts de nuestra extensión
```
export default {
  path: ...,
  dependencies: [...],
  rules: {

  }
}
```
Dentro de este objeto, crearemos una propiedad '_ViewName_:visit'. El valor de esta propiedad determinará si es posible acceder a esta View.
```
export default {
  path: ...,
  dependencies: [...],
  rules: {
    'ListaRecibosCliente:visit': false,
  }
}
```
Esto haría que nadie (salvo el superusuario) pueda entrar a la View ListaRecibosCliente. En proximas secciones veremos que valores puede recibir esta propiedad.
En caso de no tener permisos de acceso a una View, se devolverá una página 403

Restringiendo el acceso a los menús

Para restringir el acceso a menús, debemos añadir, si no existe, una clave rules en el index.ts de nuestra extensión
```
export default {
  path: ...,
  dependencies: [...],
  rules: {

  }
}
```

Dentro de este objeto, crearemos una regla. Lo normal será igualar la regla a una función check (ver más adelante):

export default {
  path: ...,
  dependencies: [...],
  rules: {
    'mi_regla': (check: (rule: string) => boolean) => check('inventarios'),
  }
}

En la extensión que crea o modifica la opción de menú, incluimos una propiedad rule en el fichero appmenu.js.

  export default parent => ({
  ...parent,
  inventarios: {
    title: 'Almacén',
    items: {
      ...parent?.inventarios?.items,
      inventarios: {
        ...
        rule: 'mi_regla',
        ...
      },
    },
  }
})

Lo lógico aquí es que si hay una view master con una regla '_ViewName_:visit', que usemos esa misma regla como regla de acceso en la propiedad rule de appmanu.js.

Restringiendo la visualización de elementos

Lo primero que debemos hacer es tener una regla que mapee el acceso al componente o grupo de componentes. Lo haremos de la misma manera que visit, pero esta vez con una regla personalizada. Ej:

export default {
  path: ...,
  dependencies: [...],
  rules: {
    'ListaRecibosCliente:visit': false,
    'ListaRecibosCliente:botonera-superior': false,
  }
}

Ahora podemos utilizar la regla 'ListaRecibosCliente:botonera-superior' de dos maneras diferentes. La primera sería como un componente y la segunda como una función:

ACL por componente

<Can rule='ListaRecibosCliente:botonera-superior'>
  <Button id='boton1' ... />
  <Button id='boton2' ... />
  <Button id='boton3' ... />
</Can>

ACL por función

if (ACL.can('ListaRecibosCliente:botonera-superior')) {
  // do stuff...
}

Posibles valores de restricción

Estático (true/false). Simple. Si es true, todo usuario tendrá acceso, mientras que si es false, solo un superusuario lo tendrá.

export default {
  path: ...,
  dependencies: [...],
  rules: {
    'ListaRecibosCliente:visit': false,
    'ListaRecibosCliente:botonera-superior': true,
  }
}

Check. Una función que busca si el usuario tiene acceso (en la tabla flpermissions) a una determinada regla. En el siguiente ejemplo, solo los usuarios que tengan acceso a reciboscli/get podrán entrar a la view ListaRecibosCliente
```
export default {
  path: ...,
  dependencies: [...],
  rules: {
    'ListaRecibosCliente:visit': (check) => check("reciboscli.get"),
    'ListaRecibosCliente:botonera-superior': true,
  }
}
```

Check Múltiple. Una función que busca si el usuario tiene acceso (en la tabla flpermissions) a una lista de reglas. Todas deben ser verdaderas.

export default {
  path: ...,
  dependencies: [...],
  rules: {
    'ListaRecibosCliente:visit': (check) => check(["reciboscli.get", "reciboscli/delete"]),
    'ListaRecibosCliente:botonera-superior': true,
  }
}

Check Condicional. Concatenación OR de funciones Check.

export default {
  path: ...,
  dependencies: [...],
  rules: {
    'ListaRecibosCliente:visit': (check) => check("reciboscli.get") || check("reciboscli/delete"),
    'ListaRecibosCliente:botonera-superior': true,
  }
}