Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/nbarbettini/oidc-debugger

OAuth 2.0 and OpenID Connect debugging tool
https://github.com/nbarbettini/oidc-debugger

Last synced: 3 months ago
JSON representation

OAuth 2.0 and OpenID Connect debugging tool

Awesome Lists containing this project

README

        

# OAuth 2.0 and OpenID Connect Debugger

:earth_americas: Live here: https://oauthdebugger.com or https://oidcdebugger.com

## What is this?

Read the blog post: [Introducing the OpenID Connect Debugger](https://www.recaffeinate.co/post/introducing-openid-connect-debugger/)

Getting an OAuth or OpenID Connect flow working properly can be tricky. There's a bunch of parameters you need to get right, and it's not always easy to capture or parse errors. I wrote this little web tool to make the process easier.

## How to use the debugger

All you need to do is temporarily set your OAuth client redirect URI to `https://oidcdebugger.com/debug` (or `https://oauthdebugger.com/debug`):

Temporarily change client redirect URI to debugger

Then, build a request to your authorization server using the debugger, and fire it off:

Choose response mode and click Send Request

The debugger will capture the callback and help you understand what happened (whether success or failure):

Decode the error message, or view the successful callback information

## Contributing

Issues and PRs are welcome! The project is built with ASP.NET Core and Vue.js.

To build and run locally,

```
git clone https://github.com/nbarbettini/oidc-debugger
cd oidc-debugger
dotnet build
dotnet run
```