https://github.com/eifinger/ip-range-filter
Filter AWS IP ranges to provide input for AWS Security Group Rules
https://github.com/eifinger/ip-range-filter
Last synced: 23 days ago
JSON representation
Filter AWS IP ranges to provide input for AWS Security Group Rules
- Host: GitHub
- URL: https://github.com/eifinger/ip-range-filter
- Owner: eifinger
- License: mit
- Created: 2022-10-26T17:31:16.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2022-11-02T08:47:51.000Z (over 2 years ago)
- Last Synced: 2025-04-12T08:58:50.980Z (23 days ago)
- Language: Java
- Size: 159 KB
- Stars: 3
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# IP-Range-Filter
Application which allows you to filter IP ranges as defined in https://ip-ranges.amazonaws.com/ip-ranges.json.
## Usage
The application is packaged and published as a docker container. If you have Docker installed you can run it locally
and use curl or postman to use it.
````shell
docker run -p 8080:8080 -d ghcr.io/eifinger/ip-range-filter:latest
curl --location --request GET 'http://localhost:8080/ip-ranges?region=AP'
````
Allowed regions are `EU`,`US`,`AP`,`CN`,`SA`,`AF`,`CA`,`ALL`
You can also use the Swagger-UI under http://localhost:8080http://swagger-ui.html
## Testing the application
Due to the fact that this application is very small and has trivial logic no separate unit tests have been written.
All tests are e2e/integration tests which test against a [MockWebServer](https://github.com/square/okhttp/tree/master/mockwebserver).
This provides the benefit that the whole application with serializing, dependencies,... is tested.
When the application grows in complexity this approach should be revisited.
````shell
./gradlew test
````