Repository files navigation

Authorization gem for Ruby on RailswithManagement Panel

Semantic. Flexible. Lightweight

TheRole:API:GUI:CI: ruby-toolbox

Strongly recommendedto upgrade from TheRole2 to TheRole3. Please, do it ASAP.

TheRole is an authorization library for Ruby on Rails which restricts what resources a given user is allowed to access. All permissions are defined in with2-level-hash, andstored in the database as a JSON string.

Using hashes, makes role system extremely easy to configure and use

• Any Role is a two-level hash, consisting of thesections and nestedrules
• ASection may be associated with acontroller name
• ARule may be associated with anaction name
• A Section can have many rules
• A Rule can betrue orfalse
• Sections and nestedRules provide anACL (Access Control List)

http://localhost:3000/admin/roles

Import/Export operations provided via TheRole Management Panel. If you have 2 Rails apps, based on TheRole - you can move roles between them via export/import abilities of TheRole Management Panel.It can be usefull for Rails apps based on one engine.

TheRole uses few conventions over configuration.It gives simplicity of code, but also some limitations.You have to know about them before using of TheRole:Limitations list

If you have to say something about TheRole, or if you need help, there are few ways to contact us:

0. SKYPE:ilya.killich
1. Email:zykin-ilya@ya.ru
2. TWITTER:@iam_teacher
3. Hash tag:#the_role
4. Google group:about the_role

• RAILS: 3.2.21, 4.0, 4.1, 4.2
• RUBY: 1.9.3, 2.0, 2.1, 2.2
• DB: sqlite, mysql, postgresql

totally: 48 environments

Supported locales:the_role_api |the_role_management_panel(please, help us with them)

MIT LicenseCopyright (c) 2012-2015Ilya N.Zykin

@the-teacher,@sedx,@seuros

@igmarin@doabit@linjunpop@egb3@klacointe@niltonvasques

Thanks for contributors