Download the PHP package marshmallow/ip-access without Composer

Marshmallow - Laravel IP Access

This a IP Access redirect package for IPv4 & IPv6. The purpose is to allow or deny access to the Laravel routes by IP address. It is able to allow certain IPs (IPv4 or IPv6) to access default files or envirioments, and redirect non-authorized IPs or Users to an external URL, while letting whitelisted IPs to have access to the entire site or to a special Envirionment.

Installation

You can install the package via composer:

And publish the service provider (and config):

This is the contents of the published config file:

Optional

These are the optional .env variables to set up:

Disable lock for routes and webhooks

If you are testing webhooks on an ip locked envoirment you need to open up your application so the webhooks won't be blocked. You can do this by adding values in the config array except. Below you will find a few examples.

Just open up a route

Add a url to the array to just open it up. If this route is matched, the package will just let the request through.

Open up with a secret

If you want to open up the route but want to require the request to have a secret, you can do so by adding some settings to the except array.

Via headers

Via body/query string

Usage with Laravel Nova

If you want to keep track of the ip addresses that have access using Laravel Nova you need to follow the following steps.

To add an check for IP access in Nova, add the following to NovaServiceProvider:

Update your config file

Set use_nova to true in config/ip-access.php.

Run migrations

You need to run the migrations after you've update the config file so we have the tables we need to store the ip addresse.

Publish the Nova resource

The last step is publishing the Nova resource so you can manage all ip address in your Laravel Nova installation.

Uninstall

Once your application is done and you are going to publish your application to production for the whole world to see, you can delete this package. You don't need it anymore and its always good practice to keep your code clean. Run the command below to uninstall this package. This command will delete the config file. Delete the nova resource, delete the migration record, delete the ip_accesss database table and remove the package from your composer file. You will have to review and commit the changes in you GIT repository yourself.

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

Credits

• LTKort
• Stef van Esch
• All Contributors

License

The MIT License (MIT). Please see License File for more information.