README.md

nginx-oidc-v1-auth0

Reference implementation v1 enhancement of NGINX Plus as relying party for OpenID Connect authentication w/ Auth0.

This repo provides the information of how to set up Auth0, integrate with NGINX Plus, and test using a containerized NGINX Plus app, a frontend OIDC simulation tool, and a NGINX Dev Portal.

1. Enhanced Features

The following features are enhanced from the nginx-oidc-core-v1:

• Access token
• Login endpoint
• Userinfo endpoint
• Logout endpoint: standard, custom params
• Frontend simulation tool: login, logout, proxied API w/ access-token

2. Getting Started

Steps	Docs
1) IdP Setup	How To Configure Auth0
2) NGINX Plus OIDC Setup	How To Configure NGINX Plus OIDC
3) OIDC Test	How To Test OIDC in Containerized App
	How To Test OIDC in Dev Portal

References

• NGINX OIDC Core v1.0: Forked from NGINX GitHub
• NGINX Plus: Single Sign-On With Auth0