https://github.com/nginx-openid-connect/nginx-oidc-keycloak

NGINX Plus OIDC w/ Keycloak Integration
https://github.com/nginx-openid-connect/nginx-oidc-keycloak

identity-provider idp keycloak nginx nginx-oidc nginx-openid-connect nginx-plus oauth2 oidc openid-connect

Last synced: 26 days ago
JSON representation

NGINX Plus OIDC w/ Keycloak Integration

• Host: GitHub
• URL: https://github.com/nginx-openid-connect/nginx-oidc-keycloak
• Owner: nginx-openid-connect
• License: other
• Created: 2022-06-24T20:48:20.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2024-01-20T07:37:55.000Z (about 1 year ago)
• Last Synced: 2024-11-13T09:16:52.321Z (3 months ago)
• Topics: identity-provider, idp, keycloak, nginx, nginx-oidc, nginx-openid-connect, nginx-plus, oauth2, oidc, openid-connect
• Language: JavaScript
• Homepage:
• Size: 8.48 MB
• Stars: 1
• Watchers: 0
• Forks: 2
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# nginx-oidc-keycloak

Reference implementation of NGINX Plus as relying party for OpenID Connect authentication w/ Keycloak.

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

![](./docs/img/nginx-oidc-workflow.png)

- [Getting Started](#🏠-getting-started)

- [Troubleshooting](#🔧-troubleshooting)

- [References](#📚-references)




## 🏠 Getting Started

### Set up an identity provider (IdP)

- [Create and configure an app in Keycloak](./docs/01-IdP-Setup.md)

### Option 1. Set up and Test a SSO application via NGINX Plus

- [Configure NGINX Plus OIDC](./docs/02-NGINX-Plus-Setup.md)

- [Locally Test an SSO app in a container ](./docs/03-Container-Test.md)

### Option 2. Set up and Test a SSO application via NGINX ACM/DevPortal

- [Install, configure, and test OIDC via NGINX ACM/DevPortal](./docs/04-NGINX-DevPortal-Test.md)




## 🔧 Troubleshooting

- [Common Troubleshooting for NGINX Plus OIDC](https://github.com/nginx-openid-connect/nginx-oidc-troubleshooting#-common-troubleshooting-for-nginx-oidc-and-all-idps)

- [Troubleshooting for NGINX Plus OIDC and Keycloak](https://github.com/nginx-openid-connect/nginx-oidc-troubleshooting#troubleshooting-for-nginx-plus-oidc-and-keycloak)




## 📚 References

- [NGINX OIDC Core v1.0: Forked from NGINX GitHub](https://github.com/nginx-openid-connect/nginx-oidc-core-v1)

- [NGINX OIDC Core v2.0: Forked from NGINX GitHub](https://github.com/nginx-openid-connect/nginx-oidc-core)

- [NGINX Plus: Single Sign-On With Keycloak](https://docs.nginx.com/nginx/deployment-guides/single-sign-on/keycloak/)

- [NGINX Management Suite](https://docs.nginx.com/nginx-management-suite/)

- [NGINX API Connectivity Manager](https://docs.nginx.com/nginx-management-suite/acm/)