Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/bradpotts/multi-tenancy-devise
mtdevise adds basecamp style user logins to your ruby on rails application.
https://github.com/bradpotts/multi-tenancy-devise
authentication bradpotts engine gem multi-tenancy multi-tenant phcnetworks rails rails-engine ruby-gem subdomain tenants
Last synced: 30 days ago
JSON representation
mtdevise adds basecamp style user logins to your ruby on rails application.
- Host: GitHub
- URL: https://github.com/bradpotts/multi-tenancy-devise
- Owner: bradpotts
- License: mit
- Created: 2015-06-03T02:35:10.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2022-04-11T22:37:45.000Z (over 2 years ago)
- Last Synced: 2024-10-10T06:11:07.120Z (about 1 month ago)
- Topics: authentication, bradpotts, engine, gem, multi-tenancy, multi-tenant, phcnetworks, rails, rails-engine, ruby-gem, subdomain, tenants
- Language: Ruby
- Homepage: https://phcnetworks.net
- Size: 18.2 MB
- Stars: 29
- Watchers: 4
- Forks: 6
- Open Issues: 13
-
Metadata Files:
- Readme: README.md
- License: MIT-LICENSE
Awesome Lists containing this project
README
[](https://hakiri.io/github/PHCNetworks/multi-tenancy-devise/master)
[](https://codeclimate.com/github/PHCNetworks/multi-tenancy-devise)
[](https://badge.fury.io/rb/mtdevise)
[](https://github.com/PHCNetworks/multi-tenancy-devise/blob/master/MIT-LICENSE)
### MTDevise Rails 5.1 Multi-Tenancy Engine Documentation
PHC MTDevise Rails 5.1 engine adds multi-tenant and account management features to rails Devise gem. Plataformatec Devise and required custom Bootstrap Devise views included.
* Multi-tenancy using subdomain scoping and account_id column.
* Adds basecamp style logins to devise authentication gem.
* Welcome, Dashboard with custom Devise views included.
* Highly customizable views and layouts using standard bootstrap 3 code.
* Central login screen for all tenants (users) or logins through a subdomain.
* Mis-Spelling and redirect to welcome screen if subdomain none-existent.
* Compatible with postgre, mysql and sqlite (for dev environments).
#### Step 1 - Add user model to your app (Must be Done First!!)
Generate a user.rb file in your mainapp and add the code below
rails g model User
include Mtdevise::UserStorage
#### Step 2 - Add Mtdevise to your gemfile and run command
gem 'mtdevise', '~> 16.0'
bundle exec install
#### Step 3 - Add and migrate mtdevise database tables
rake railties:install:migrations
rake db:migrate
#### Step 4 - Configure ActionMailer
* Mailer functions are required in order for mtdevise to operate.
* Mailer is used for confirmation and password reset functions.
#### Step 5 - Mount the Engine in your Routes File
Add this line at the end of the routes file.
mount Mtdevise::Engine, :at => '/'
#### Step 6 - Constrain the routs you want secured
All the routes you want to have multi-tenacy login functions goes in between the constraints block.
constraints(Mtdevise::Constraints::SubdomainRequired) do
# Routes Requiring Security & Multi-Tenancy Routes
end
#### Step 7 - Modifications to MainApp Controllers & Database
Your app needs modification to [controllers (example)](https://github.com/PHCNetworks/multi-tenancy-devise/wiki/Scoped-Controller-Example)
Any corresponding db database tables must have an accounts_id column
accounts_id
#### Step 8 - Add mtdevise extension to models
Add the mtdevise extension to the top of all models for the routes configured in the previous step.
def self.scoped_to(account)
where(:account_id => account.id)
end
#### Step 9 - Configure scopes in your controller
Scope your controllers. Examples on github wiki or multi-tenant starter app.
.scoped_to(current_account)
#### Step 10 - Environment (ENV) Variables
Set a sent from email address for confirmation and password reset emails [more info here.](https://github.com/PHCNetworks/multi-tenancy-devise/wiki/ENV---Environment-Variables) .
PHC_MTDEVISE_SENDER = [email protected]
### Additional Information
#### Views - Mtdevise Views Can be Customized
Once installed views can be generated and customized to your apps needs.
rails generate mtdevise:views
rake assets:clobber
rake assets:precompile
#### Additional Documentation
[Multi-Tenant Starter App](https://github.com/PHCNetworks/multi-tenancy-starter-devise)
[Documentation (Github Wiki)](https://github.com/PHCNetworks/multi-tenancy-devise/wiki)
[Environment Variables](https://github.com/PHCNetworks/multi-tenancy-devise/wiki/ENV---Environment-Variables)
[Issues & Bug Reports](https://github.com/PHCNetworks/multi-tenancy-devise/issues)
[Past Security Patch Notes](https://github.com/PHCNetworks/multi-tenancy-devise/wiki/Critical-Security-Updates)
[Managed by PHCNetworks](http://phcnetworks.net)
[](https://circleci.com/gh/PHCNetworks/multi-tenancy-devise/tree/master)