Manage Your API Gateway with NGINX Plus and 3scale


NGINX, Inc. and 3scale are teaming up to offer the highest performing API gateway on the market. For a limited time, special combination packages are being offered at a significant discount.

3scale provides a full‑featured API management solution with exceptional scalability, security, and flexibility to meet the most demanding requirements. 3scale makes it easy to manage all phases of API deployment, set access controls and rate limits, monitor traffic, generate reports, set up a developer portal, collect access fees, and more.

NGINX Plus provides the reverse proxy engine that executes the 3scale‑defined API policies for all of your API traffic. Renowned for its scalability, reliability, and performance, NGINX Plus minimizes the performance impact of applying sophisticated policies. It also includes extensions to the open source NGINX software (see Enhanced Features in NGINX Plus), all backed by support from the NGINX, Inc. engineering team.

Deploying 3scale and NGINX Plus together makes your API services even more reliable and easy to manage. Joint support from 3scale and NGINX, Inc. means your API delivery process is covered end to end.

Getting Started with NGINX Plus and 3scale

To take advantage of the discount on combined NGINX Plus and 3scale packages, perform the following steps:

Editor – The discount package described in this post is no longer available, and the following instructions are not current. For information about NGINX and NGINX Plus as an API gateway, see our Products page or contact us.

  1. Sign up for the discount package on the 3scale website. 3scale will contact you to discuss which package is right for you, and then send your login credentials for access to the 3scale software. Your credentials from NGINX, Inc. will be sent separately after 3scale informs us of your purchase.
  2. Follow the 3scale Quickstart instructions to configure your API gateway.
  3. Log in to the NGINX Customer Portal using the credentials supplied by NGINX, Inc. Perform the following steps to install the NGINX Plus Extras package:
    1. On the Subscriptions page that opens after you log in, click NGINX Plus installation instructions.
    2. On the Instructions page that opens, select your operating system from the drop‑down menu and perform the instructions that appear. In the NGINX installation command (usually the next‑to‑last bullet), substitute nginx‑plus‑extras for nginx‑plus as indicated.

      Note: The nginx‑plus‑extras package is not available for RHEL/CentOS/Oracle Linux 5.10+.

      • Debian – Run sudo apt-get install nginx-plus-extras
      • FreeBSD – Run sudo pkg install nginx-plus-extras
      • RHEL/CentOS/Oracle Linux (all versions) – Run sudo yum install nginx‑plus‑extras
      • SLES 12 – Run zypper install nginx-plus-extras
      • Ubuntu – Run sudo apt-get install nginx-plus-extras
  4. On the 3scale website, follow the instructions on the NGINX Self‑Managed Setup page.
    1. Skip Steps 1 and 2 (Install the dependencies and Compile and install NGINX), which explain how to download and install NGINX from OpenResty ( In Step 3b of these instructions you installed the NGINX Plus Extras package instead.
    2. Complete the instructions in Step 3 (Download your API gateway configuration from 3scale). The default directory specified in the final step, /usr/local/openresty/nginx/conf/, is appropriate for an OpenResty installation; substitute the location for NGINX Plus configuration files, which is /etc/nginx/conf.d by default.
    3. In Step 4 (Basic operations), modify the start command to use the paths appropriate for NGINX Plus instead of OpenResty. The following command uses the NGINX Plus defaults:
      sudo /usr/sbin/nginx -c /etc/nginx/conf.d/
    4. In the Tips for managing multiple versions of configuration files subsection of Step 5 (Optimizing the workflow), make the same substitution for the configuration files directory as in the previous step (substitute /etc/nginx/conf.d/ for /usr/local/openresty/nginx/conf/).

You’ve finished basic configuration of NGINX Plus and 3scale. To start NGINX Plus, run the sudo /usr/sbin/nginx command shown in Step 4c of these instructions. To verify that NGINX Plus is running, run the following command:

# /etc/init.d/nginx status
* nginx is running

To verify that the API gateway is functioning correctly, issue requests against some API endpoints and verify that hits are recorded (on your 3scale administrative dashboard, navigate to the Monitoring page and click Usage).

Enhanced Features in NGINX Plus

NGINX Plus provides all the outstanding performance and functionality of the open source NGINX software, along with several enhancements.

Load Balancing

For more information, see Application Load Balancing with NGINX Plus and Session Persistence with NGINX Plus.

Health Checks and Live Activity Monitoring

On-the-Fly Reconfiguration of Upstream Server Groups

Retrieved by Nick Shadrin from website.