search

nbarbettini / oidc-debugger

OAuth 2.0 and OpenID Connect debugging tool
https://oidcdebugger.com
MIT License
224 stars 29 forks source link

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

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