https://github.com/nginx-openid-connect/nginx-oidc-amazon-cognito

NGINX Plus OIDC w/ Amazon Cognito Integration
https://github.com/nginx-openid-connect/nginx-oidc-amazon-cognito

amazon-cognito identity-provider idp nginx nginx-oidc nginx-openid-connect nginx-plus nginxplus oauth2 oidc openid-connect

Last synced: 4 days ago
JSON representation

NGINX Plus OIDC w/ Amazon Cognito Integration

• Host: GitHub
• URL: https://github.com/nginx-openid-connect/nginx-oidc-amazon-cognito
• Owner: nginx-openid-connect
• License: other
• Created: 2022-06-24T20:46:48.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2022-11-18T17:30:16.000Z (almost 2 years ago)
• Last Synced: 2023-03-08T21:43:04.463Z (over 1 year ago)
• Topics: amazon-cognito, identity-provider, idp, nginx, nginx-oidc, nginx-openid-connect, nginx-plus, nginxplus, oauth2, oidc, openid-connect
• Language: JavaScript
• Homepage:
• Size: 7.42 MB
• Stars: 0
• Watchers: 0
• Forks: 2
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# nginx-oidc-amazon-cognito

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

This repo provides the information of how to set up Amazon Cognito, 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 Amazon Cognito](./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 Amazon Cognito](https://github.com/nginx-openid-connect/nginx-oidc-troubleshooting#-troubleshooting-for-nginx-plus-oidc-and-amazon-cognito)




## 📚 References

- [OpenID Connect Standard Spec](https://openid.net/specs/openid-connect-core-1_0.html)

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

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

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