Download the PHP package cidekar/laravel-tenantmagic without Composer
On this page you can find all versions of the php package cidekar/laravel-tenantmagic. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download cidekar/laravel-tenantmagic
More information about cidekar/laravel-tenantmagic
Files in cidekar/laravel-tenantmagic
Package laravel-tenantmagic
Short Description A multitenancy package for Laravel Passport.
License MIT
Informations about the package laravel-tenantmagic
Introduction
Laravel Passport makes password grant client authentication dead-simple for your API. Laravel Multitenancy makes a Laravel application tenant aware in minutes - feels like cheating. Tenantmagic, provides one approach to a making your Passport password grant client tenant aware. Before going through the rest of this documentation, take time to read Laravel Multitenancy and Laravel Passport, if your unfamiliar. Tenantmagic is built on top of Laravel Passport and Laravel Multitenancy.
Motivation
Multitenancy typically requires a user provide their authentication credentials and subdomain to get a token. Tenantmagic removes the need for a subdomain when logging into your multi-tenant application; provide a user name and password and the package will do the rest!
Installation
This package can be installed with Composer:
Publish the configuration:
The configuration will be published to config/tenantmagic.php
The User model must use :
Please keep in mind this package assumes the grant client is stored in the landlord database. Users are stored in the tenant database.
Add the TenantmagicDomainTenantFinder to the multitenancy config:
Add the to the array:
Configure your tenant and landlord database connections:
X-Magictenant Header
Out of the box, Tenantmagic will return the header when responding to a successful authorization request. To reveal the domain and tenant name, the x-magictenant header value (i.e., non-extended notation, using "quoted-string") needs to be decoded:
Requirements
- Your application is configured for multitenancy using a separate database for each tenant
- Passport is installed and configured
Testing
To get started, create the following MySql databases:
laravel_tenantmagic_landlord
laravel_tenantmagic_tenant_1
laravel_tenantmagic_tenant_2
Now, you may run the package's tests:
Security
Please do not publicly disclose security-related issues, email [email protected]. Security vulnerabilities will be promptly addressed.
License
Copyright 2020 Cidekar, LLC. All rights reserved.
Apache License 2.0
All versions of laravel-tenantmagic with dependencies
laravel/passport Version ^9.3|^10.0
spatie/laravel-multitenancy Version ^2.3.3