https://github.com/vcian/laravel-ip-gateway

Laravel IP Gateway
https://github.com/vcian/laravel-ip-gateway

ip ipaddress ipblock ipblocklist ipwhitelist laravel laravel-framework php

Last synced: 3 days ago
JSON representation

Laravel IP Gateway

• Host: GitHub
• URL: https://github.com/vcian/laravel-ip-gateway
• Owner: vcian
• License: mit
• Created: 2019-01-10T12:42:15.000Z (over 5 years ago)
• Default Branch: main
• Last Pushed: 2024-08-23T07:32:17.000Z (about 1 month ago)
• Last Synced: 2024-08-23T08:39:53.621Z (about 1 month ago)
• Topics: ip, ipaddress, ipblock, ipblocklist, ipwhitelist, laravel, laravel-framework, php
• Language: PHP
• Homepage: https://packagist.org/packages/vcian/laravel-ip-gateway
• Size: 26.4 KB
• Stars: 41
• Watchers: 4
• Forks: 9
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# IP gateway for laravel

[![Software License](https://img.shields.io/badge/license-MIT-brightgreen.svg?style=for-the-badge)](LICENSE.md)

[![Total Downloads](https://img.shields.io/packagist/dt/vcian/laravel-ip-gateway?style=for-the-badge)](https://packagist.org/packages/vcian/laravel-ip-gateway)

## Features

*  The Laravel Ip gateway package helps you to blacklist or whitelist IP to prevent unauthorized access to your application.

*  Since blacklists deny access to specific entities, they are best used when a limited number of items need to be denied access.

When most entities need to be denied access, a whitelist approach is more efficient.

## Requirements

PHP ^8.0

## Installation

You can install the package via composer:

```bash

composer require vcian/laravel-ip-gateway

```

After installation, You need to publish the config file for this package. This will add the file `config/ip-gateway.php`, where you can configure this package.

```bash

php artisan vendor:publish

```

### Config Usage (`ip-gateway.php`)

* `enable_package` is used for enable/disable access protection.

* `enable_blacklist` when its true that means, It will denied access for registered ips in `ip-list`, false means, It will allow accessing for registered ips in `ip-list`.

*  You can authenticated IPs through register route groups in `middleware`.  

* `redirect_route_to` will access URL, To redirect if denied.

*  You can define all your whitelist or blacklist IP addresses inside `ip-list`.

*  If you want to add IP gateway middleware in you custom middleware group then just define your custom middleware group inside `middleware`

### Changelog

Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.

## Contributing

Please see [CONTRIBUTING](CONTRIBUTING.md) for details.

## Security

If you discover any security-related issues, please email [email protected] instead of using the issue tracker.

## License

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

## Notes

**You can create as many whitelists or blacklist groups as you wish to protect access**