# OIDC Tester App

OIDC Tester App is a self-hosted development app. A test client for OpenID Connect (OIDC), the open standard for authentication and single sign-on. It is open source and self-hosted, installable on Docker Hub.

Canonical page: https://ourlocalhost.com/app/5426/oidc-tester-app

## Description

A test client for OpenID Connect (OIDC), the open standard for authentication and single sign-on. Part of the Authelia project, it simulates a real user signing in so developers can verify their identity provider is configured correctly before exposing it to real users.

## Platform availability

Available on 0 of 10 platforms.

## Health score

65/100 (Good), based on 4 of 5 factors.
- Maintained: 100 (last commit 3 days ago)
- Popular: 23 (13 GitHub stars)
- Easy to install: 25 (0 install platforms, install notes, Docker image)
- Security check: 89 (no serious findings, 1 minor, CI, tests, OpenSSF Scorecard 8.1/10)

## Links

- GitHub: https://github.com/authelia/oidc-tester-app
- Docker Hub: https://hub.docker.com/r/authelia/oidc-tester-app

## Common questions

### Can oidc-tester-app be used to test Authelia’s OIDC API?

Yes, it is an OIDC client used for testing the OIDC API provided by Authelia.

### What must be configured in .env before login requests work?

Fill in the .env login settings or identity provider settings, or enable mock mode. Without them, the app does not know where to send login requests, so sign-in and testing will not work correctly.

### What should BASE_URL be set to in a manual setup?

Set BASE_URL to the path where your app is hosted, such as / for the site root. If this path is wrong, the app can fail to load properly or send you to broken login pages.

### How can I run a quick local OIDC test environment?

Run a Dockerized Keycloak instance, configure a realm and OIDC client, then connect the application to the authorization, token, and userinfo endpoints.

---
Source: Our Local Host (https://ourlocalhost.com/app/5426/oidc-tester-app), the self-hosted and open-source app directory.
