Skip to content

Added builds for NGINX R33 and R34 #81

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 6 commits into from
May 22, 2025
Merged
Show file tree
Hide file tree
Changes from 4 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
41 changes: 22 additions & 19 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ The tl;dr is a very simple API gateway that is blazing fast, highly scalable, an
## Module Configuration Directives

Version 2.0 introduced a **BREAKING CHANGE** to use updated configuration directives.\
See [previous configuration instructions](https://github.com/curityio/nginx_phantom_token_module/tree/1.6.0) to configure older releases.
See [previous configuration instructions](https://github.com/curityio/nginx_phantom_token_module/tree/2.0.0) to configure older releases.

### Required Configuration Directives

Expand Down Expand Up @@ -295,32 +295,35 @@ http {

## Compatibility

This module is compatible with Curity Identity Server versions >= 2.2. It has been tested with NGINX 1.13.7 (NGINX Plus Release 14) and NGINX 1.13.10 (NGINX Plus Release 15). It is likely to work with other, newish versions of NGINX, but only these have been tested, pre-built and verified.
The binary releases align with the 24 month supported release cycle of [NGINX Plus](https://docs.nginx.com/nginx/releases/) to keep the NGINX secure environment up to date. The module's code has also run to a production level with many previous NGINX releases.

### Releases
### Pre-Built Releases

Pre-built binaries of this module are provided for the following versions of NGINX on the corresponding operating system distributions:

| | NGINX 1.25.5 / NGINX Plus R32 | NGINX 1.25.3 / NGINX Plus R31 | NGINX 1.25.1 / NGINX Plus R30 | NGINX 1.23.4 / NGINX Plus R29 | NGINX 1.23.2 / NGINX Plus R28 |
| | NGINX 1.27.4 / NGINX Plus R34 | NGINX 1.27.2 / NGINX Plus R33 | NGINX 1.25.5 / NGINX Plus R32 | NGINX 1.25.3 / NGINX Plus R31 | NGINX 1.25.1 / NGINX Plus R30 |
| -----------------------------------|:-----------------------------:|:-----------------------------:|:-----------------------------:|:------------------------------:|:-----------------------------:|
| Alpine | [⇓](https://github.com/curityio/nginx_phantom_token_module/releases/download/1.6.0/alpine.ngx_curity_http_phantom_token_module_1.25.5.so) | [⇓](https://github.com/curityio/nginx_phantom_token_module/releases/download/1.6.0/alpine.ngx_curity_http_phantom_token_module_1.25.3.so) | [⇓](https://github.com/curityio/nginx_phantom_token_module/releases/download/1.6.0/alpine.ngx_curity_http_phantom_token_module_1.25.1.so) | [⇓](https://github.com/curityio/nginx_phantom_token_module/releases/download/1.6.0/alpine.ngx_curity_http_phantom_token_module_1.23.4.so) | [⇓](https://github.com/curityio/nginx_phantom_token_module/releases/download/1.6.0/alpine.ngx_curity_http_phantom_token_module_1.23.2.so) |
| Debian 11.0 (Bullseye) | [⇓](https://github.com/curityio/nginx_phantom_token_module/releases/download/1.6.0/debian.bullseye.ngx_curity_http_phantom_token_module_1.25.5.so) | [⇓](https://github.com/curityio/nginx_phantom_token_module/releases/download/1.6.0/debian.bullseye.ngx_curity_http_phantom_token_module_1.25.3.so) | [⇓](https://github.com/curityio/nginx_phantom_token_module/releases/download/1.6.0/debian.bullseye.ngx_curity_http_phantom_token_module_1.25.1.so) | [⇓](https://github.com/curityio/nginx_phantom_token_module/releases/download/1.6.0/debian.bullseye.ngx_curity_http_phantom_token_module_1.23.4.so) | [⇓](https://github.com/curityio/nginx_phantom_token_module/releases/download/1.6.0/debian.bullseye.ngx_curity_http_phantom_token_module_1.23.2.so) |
| Debian 12.0 (Bookworm) | [⇓](https://github.com/curityio/nginx_phantom_token_module/releases/download/1.6.0/debian.bookworm.ngx_curity_http_phantom_token_module_1.25.5.so) | [⇓](https://github.com/curityio/nginx_phantom_token_module/releases/download/1.6.0/debian.bookworm.ngx_curity_http_phantom_token_module_1.25.3.so) | [⇓](https://github.com/curityio/nginx_phantom_token_module/releases/download/1.6.0/debian.bookworm.ngx_curity_http_phantom_token_module_1.25.1.so) | X | X |
| Ubuntu 20.04 LTS (Focal Fossa) | [⇓](https://github.com/curityio/nginx_phantom_token_module/releases/download/1.6.0/ubuntu.20.04.ngx_curity_http_phantom_token_module_1.25.5.so) | [⇓](https://github.com/curityio/nginx_phantom_token_module/releases/download/1.6.0/ubuntu.20.04.ngx_curity_http_phantom_token_module_1.25.3.so) | [⇓](https://github.com/curityio/nginx_phantom_token_module/releases/download/1.6.0/ubuntu.20.04.ngx_curity_http_phantom_token_module_1.25.1.so) | [⇓](https://github.com/curityio/nginx_phantom_token_module/releases/download/1.6.0/ubuntu.20.04.ngx_curity_http_phantom_token_module_1.23.4.so) | [⇓](https://github.com/curityio/nginx_phantom_token_module/releases/download/1.6.0/ubuntu.20.04.ngx_curity_http_phantom_token_module_1.23.2.so) |
| Ubuntu 22.04 LTS (Jammy Jellyfish) | [⇓](https://github.com/curityio/nginx_phantom_token_module/releases/download/1.6.0/ubuntu.22.04.ngx_curity_http_phantom_token_module_1.25.5.so) | [⇓](https://github.com/curityio/nginx_phantom_token_module/releases/download/1.6.0/ubuntu.22.04.ngx_curity_http_phantom_token_module_1.25.3.so) | [⇓](https://github.com/curityio/nginx_phantom_token_module/releases/download/1.6.0/ubuntu.22.04.ngx_curity_http_phantom_token_module_1.25.1.so) | [⇓](https://github.com/curityio/nginx_phantom_token_module/releases/download/1.6.0/ubuntu.22.04.ngx_curity_http_phantom_token_module_1.23.4.so) | [⇓](https://github.com/curityio/nginx_phantom_token_module/releases/download/1.6.0/ubuntu.22.04.ngx_curity_http_phantom_token_module_1.23.2.so) |
| Ubuntu 24.04 LTS (Noble Numbat) | [⇓](https://github.com/curityio/nginx_phantom_token_module/releases/download/1.6.0/ubuntu.24.04.ngx_curity_http_phantom_token_module_1.25.5.so) | X | X | X | X |
| Amazon Linux 2 | [⇓](https://github.com/curityio/nginx_phantom_token_module/releases/download/1.6.0/amzn2.ngx_curity_http_phantom_token_module_1.25.5.so) | [⇓](https://github.com/curityio/nginx_phantom_token_module/releases/download/1.6.0/amzn2.ngx_curity_http_phantom_token_module_1.25.3.so) | [⇓](https://github.com/curityio/nginx_phantom_token_module/releases/download/1.6.0/amzn2.ngx_curity_http_phantom_token_module_1.25.1.so) | [⇓](https://github.com/curityio/nginx_phantom_token_module/releases/download/1.6.0/amzn2.ngx_curity_http_phantom_token_module_1.23.4.so) | [⇓](https://github.com/curityio/nginx_phantom_token_module/releases/download/1.6.0/amzn2.ngx_curity_http_phantom_token_module_1.23.2.so) |
| Amazon Linux 2023 | [⇓](https://github.com/curityio/nginx_phantom_token_module/releases/download/1.6.0/amzn2023.ngx_curity_http_phantom_token_module_1.25.5.so) | [⇓](https://github.com/curityio/nginx_phantom_token_module/releases/download/1.6.0/amzn2023.ngx_curity_http_phantom_token_module_1.25.3.so) | [⇓](https://github.com/curityio/nginx_phantom_token_module/releases/download/1.6.0/amzn2023.ngx_curity_http_phantom_token_module_1.25.1.so) | [⇓](https://github.com/curityio/nginx_phantom_token_module/releases/download/1.6.0/amzn2023.ngx_curity_http_phantom_token_module_1.23.4.so) | [⇓](https://github.com/curityio/nginx_phantom_token_module/releases/download/1.6.0/amzn2023.ngx_curity_http_phantom_token_module_1.23.2.so) |
| CentOS Stream 9.0+ | [⇓](https://github.com/curityio/nginx_phantom_token_module/releases/download/1.6.0/centos.stream.9.ngx_curity_http_phantom_token_module_1.25.5.so) | [⇓](https://github.com/curityio/nginx_phantom_token_module/releases/download/1.6.0/centos.stream.9.ngx_curity_http_phantom_token_module_1.25.3.so) | [⇓](https://github.com/curityio/nginx_phantom_token_module/releases/download/1.6.0/centos.stream.9.ngx_curity_http_phantom_token_module_1.25.1.so) | [⇓](https://github.com/curityio/nginx_phantom_token_module/releases/download/1.6.0/centos.stream.9.ngx_curity_http_phantom_token_module_1.23.4.so) | [⇓](https://github.com/curityio/nginx_phantom_token_module/releases/download/1.6.0/centos.stream.9.ngx_curity_http_phantom_token_module_1.23.2.so) |

## Status
This module is fit for production usage.

## Development Setup
If you wish to build this module from source, in order to run against other NGINX versions, or to change the module's logic, see the [Development Wiki](https://github.com/curityio/nginx_phantom_token_module/wiki) for instructions.
| Alpine | [⇓](https://github.com/curityio/nginx_phantom_token_module/releases/download/2.0.0/alpine.ngx_curity_http_phantom_token_module_1.27.4.so) | [⇓](https://github.com/curityio/nginx_phantom_token_module/releases/download/2.0.0/alpine.ngx_curity_http_phantom_token_module_1.27.2.so) | [⇓](https://github.com/curityio/nginx_phantom_token_module/releases/download/2.0.0/alpine.ngx_curity_http_phantom_token_module_1.25.5.so) | [⇓](https://github.com/curityio/nginx_phantom_token_module/releases/download/2.0.0/alpine.ngx_curity_http_phantom_token_module_1.25.3.so) | [⇓](https://github.com/curityio/nginx_phantom_token_module/releases/download/2.0.0/alpine.ngx_curity_http_phantom_token_module_1.25.1.so) |
| Debian 11.0 (Bullseye) | [⇓](https://github.com/curityio/nginx_phantom_token_module/releases/download/2.0.0/debian.bullseye.ngx_curity_http_phantom_token_module_1.27.4.so) | [⇓](https://github.com/curityio/nginx_phantom_token_module/releases/download/2.0.0/debian.bullseye.ngx_curity_http_phantom_token_module_1.27.2.so) | [⇓](https://github.com/curityio/nginx_phantom_token_module/releases/download/2.0.0/debian.bullseye.ngx_curity_http_phantom_token_module_1.25.5.so) | [⇓](https://github.com/curityio/nginx_phantom_token_module/releases/download/2.0.0/debian.bullseye.ngx_curity_http_phantom_token_module_1.25.3.so) | [⇓](https://github.com/curityio/nginx_phantom_token_module/releases/download/2.0.0/debian.bullseye.ngx_curity_http_phantom_token_module_1.25.1.so) |
| Debian 12.0 (Bookworm) | [⇓](https://github.com/curityio/nginx_phantom_token_module/releases/download/2.0.0/debian.bookworm.ngx_curity_http_phantom_token_module_1.27.4.so) | [⇓](https://github.com/curityio/nginx_phantom_token_module/releases/download/2.0.0/debian.bookworm.ngx_curity_http_phantom_token_module_1.27.2.so) | [⇓](https://github.com/curityio/nginx_phantom_token_module/releases/download/2.0.0/debian.bookworm.ngx_curity_http_phantom_token_module_1.25.5.so) | [⇓](https://github.com/curityio/nginx_phantom_token_module/releases/download/2.0.0/debian.bookworm.ngx_curity_http_phantom_token_module_1.25.3.so) | [⇓](https://github.com/curityio/nginx_phantom_token_module/releases/download/2.0.0/debian.bookworm.ngx_curity_http_phantom_token_module_1.25.1.so) |
| Ubuntu 20.04 LTS (Focal Fossa) | [⇓](https://github.com/curityio/nginx_phantom_token_module/releases/download/2.0.0/ubuntu.20.04.ngx_curity_http_phantom_token_module_1.27.4.so) | [⇓](https://github.com/curityio/nginx_phantom_token_module/releases/download/2.0.0/ubuntu.20.04.ngx_curity_http_phantom_token_module_1.27.2.so) | [⇓](https://github.com/curityio/nginx_phantom_token_module/releases/download/2.0.0/ubuntu.20.04.ngx_curity_http_phantom_token_module_1.25.5.so) | [⇓](https://github.com/curityio/nginx_phantom_token_module/releases/download/2.0.0/ubuntu.20.04.ngx_curity_http_phantom_token_module_1.25.3.so) | [⇓](https://github.com/curityio/nginx_phantom_token_module/releases/download/2.0.0/ubuntu.20.04.ngx_curity_http_phantom_token_module_1.25.1.so) |
| Ubuntu 22.04 LTS (Jammy Jellyfish) | [⇓](https://github.com/curityio/nginx_phantom_token_module/releases/download/2.0.0/ubuntu.22.04.ngx_curity_http_phantom_token_module_1.27.4.so) | [⇓](https://github.com/curityio/nginx_phantom_token_module/releases/download/2.0.0/ubuntu.22.04.ngx_curity_http_phantom_token_module_1.27.2.so) | [⇓](https://github.com/curityio/nginx_phantom_token_module/releases/download/2.0.0/ubuntu.22.04.ngx_curity_http_phantom_token_module_1.25.5.so) | [⇓](https://github.com/curityio/nginx_phantom_token_module/releases/download/2.0.0/ubuntu.22.04.ngx_curity_http_phantom_token_module_1.25.3.so) | [⇓](https://github.com/curityio/nginx_phantom_token_module/releases/download/2.0.0/ubuntu.22.04.ngx_curity_http_phantom_token_module_1.25.1.so) |
| Ubuntu 24.04 LTS (Noble Numbat) | [⇓](https://github.com/curityio/nginx_phantom_token_module/releases/download/2.0.0/ubuntu.24.04.ngx_curity_http_phantom_token_module_1.27.4.so) | [⇓](https://github.com/curityio/nginx_phantom_token_module/releases/download/2.0.0/ubuntu.24.04.ngx_curity_http_phantom_token_module_1.27.2.so) | [⇓](https://github.com/curityio/nginx_phantom_token_module/releases/download/2.0.0/ubuntu.24.04.ngx_curity_http_phantom_token_module_1.25.5.so) | X | X |
| Amazon Linux 2 | [⇓](https://github.com/curityio/nginx_phantom_token_module/releases/download/2.0.0/amzn2.ngx_curity_http_phantom_token_module_1.27.4.so) | [⇓](https://github.com/curityio/nginx_phantom_token_module/releases/download/2.0.0/amzn2.ngx_curity_http_phantom_token_module_1.27.2.so) | [⇓](https://github.com/curityio/nginx_phantom_token_module/releases/download/2.0.0/amzn2.ngx_curity_http_phantom_token_module_1.25.5.so) | [⇓](https://github.com/curityio/nginx_phantom_token_module/releases/download/2.0.0/amzn2.ngx_curity_http_phantom_token_module_1.25.3.so) | [⇓](https://github.com/curityio/nginx_phantom_token_module/releases/download/2.0.0/amzn2.ngx_curity_http_phantom_token_module_1.25.1.so) |
| Amazon Linux 2023 | [⇓](https://github.com/curityio/nginx_phantom_token_module/releases/download/2.0.0/amzn2023.ngx_curity_http_phantom_token_module_1.27.4.so) | [⇓](https://github.com/curityio/nginx_phantom_token_module/releases/download/2.0.0/amzn2023.ngx_curity_http_phantom_token_module_1.27.2.so) | [⇓](https://github.com/curityio/nginx_phantom_token_module/releases/download/2.0.0/amzn2023.ngx_curity_http_phantom_token_module_1.25.5.so) | [⇓](https://github.com/curityio/nginx_phantom_token_module/releases/download/2.0.0/amzn2023.ngx_curity_http_phantom_token_module_1.25.3.so) | [⇓](https://github.com/curityio/nginx_phantom_token_module/releases/download/2.0.0/amzn2023.ngx_curity_http_phantom_token_module_1.25.1.so) |
| CentOS Stream 9.0+ | x | x | [⇓](https://github.com/curityio/nginx_phantom_token_module/releases/download/2.0.0/centos.stream.9.ngx_curity_http_phantom_token_module_1.25.5.so) | [⇓](https://github.com/curityio/nginx_phantom_token_module/releases/download/2.0.0/centos.stream.9.ngx_curity_http_phantom_token_module_1.25.3.so) | [⇓](https://github.com/curityio/nginx_phantom_token_module/releases/download/2.0.0/centos.stream.9.ngx_curity_http_phantom_token_module_1.25.1.so) |

## Building From Source

To build the latest code against older NGINX versions or Linux distributions, follow the instructions in the [Development Wiki](https://github.com/curityio/nginx_phantom_token_module/wiki).

- [Build the Module](https://github.com/curityio/nginx_phantom_token_module/wiki/3.-Builds)
- [Deploy the Module](https://github.com/curityio/nginx_phantom_token_module/wiki/4.-Testing-Deployment)

## More Information

For more information about the Curity Identity Server, its capabilities, and how to use it to issue phantom tokens for microservices, visit [curity.io](https://curity.io/product/token-service/?=use-cases?tab=microservices). For background information on using the Curity Identity Server to secure API access, see our [API security resources](https://curity.io/resources/api-security).

## Licensing

This software is copyright (C) 2022 Curity AB. It is open source software that is licensed under the [Apache v. 2](LICENSE). For commercial support of this module, please contact [Curity sales](mailto:[email protected]).
2 changes: 1 addition & 1 deletion build.sh
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
# Builds a particular NGINX version for a particular Linux OS and version
#########################################################################

NGINX_VERSION=${NGINX_VERSION:-1.25.5}
NGINX_VERSION=${NGINX_VERSION:-1.27.4}
NGINX_TARBALL=nginx-${NGINX_VERSION}.tar.gz
LINUX_DISTRO=${LINUX_DISTRO:-alpine}

Expand Down
4 changes: 2 additions & 2 deletions buildall.sh
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
# Builds an entire release with all supported NGINX versions and Linux OS versions
##################################################################################

NGINX_VERSIONS=('1.25.5' '1.25.3' '1.25.1' '1.23.4' '1.23.2')
NGINX_VERSIONS=('1.27.4' '1.27.2' '1.25.5' '1.25.3' '1.25.1')
LINUX_DISTROS=('alpine' 'debian11' 'debian12' 'ubuntu20' 'ubuntu22' 'ubuntu24' 'amazon2' 'amazon2023' 'centosstream9')
rm log.txt 2>/dev/null

Expand All @@ -17,7 +17,7 @@ function isValidBuild() {

if [ "$LINUX_DISTRO_PARAM" == 'ubuntu24' ] && [[ '1.25.5' > "$NGINX_VERSION_PARAM" ]]; then
echo 'false'
elif [ "$LINUX_DISTRO_PARAM" == 'debian12' ] && [[ '1.25.1' > "$NGINX_VERSION_PARAM" ]]; then
elif [ "$LINUX_DISTRO_PARAM" == 'centosstream9' ] && [[ '1.27.2' > "$NGINX_VERSION_PARAM" ]]; then
echo 'false'
else
echo 'true'
Expand Down
2 changes: 1 addition & 1 deletion configure
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ set -e

SRC_DIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)

NGINX_VERSION=${NGINX_VERSION:-1.25.5}
NGINX_VERSION=${NGINX_VERSION:-1.27.4}
BUILD_INFO_FILE="$SRC_DIR/.build.info"
test -f "$BUILD_INFO_FILE" && . "$BUILD_INFO_FILE"

Expand Down
2 changes: 1 addition & 1 deletion testing/integration/deploy.sh
Original file line number Diff line number Diff line change
Expand Up @@ -33,7 +33,7 @@ if [ "$LINUX_DISTRO" == '' ]; then
LINUX_DISTRO='alpine'
fi
if [ "$NGINX_VERSION" == '' ]; then
NGINX_VERSION='1.25.5'
NGINX_VERSION='1.27.4'
fi
echo "Deploying for $LINUX_DISTRO with NGINX version $NGINX_VERSION ..."

Expand Down