https://github.com/wirepact/demo-applications
WirePact demo applications in a Docker container. App and API in various variants.
https://github.com/wirepact/demo-applications
basic-authentication demo-app oidc wirepact
Last synced: 7 days ago
JSON representation
WirePact demo applications in a Docker container. App and API in various variants.
- Host: GitHub
- URL: https://github.com/wirepact/demo-applications
- Owner: WirePact
- License: apache-2.0
- Created: 2022-03-21T15:25:10.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2024-09-18T04:16:23.000Z (over 1 year ago)
- Last Synced: 2024-09-19T01:14:41.261Z (over 1 year ago)
- Topics: basic-authentication, demo-app, oidc, wirepact
- Language: JavaScript
- Homepage:
- Size: 1.86 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# WirePact Applications
This repository contains various demo/showcase applications for WirePact.
The applications are used during development of translators and for
the end-to-end demo. They vary in terms of programming language
and flavor to show that neither the framework nor the programming language
limits the use case of WirePact.
**Note** that these applications are not meant for production!
## Flavors/Applications
### [OIDC Provider](./oidc_provider/)
This application serves as "login" point for demo applications that use OIDC.
It is a custom web app with the [node-oidc-provider](https://github.com/panva/node-oidc-provider)
package to deliver OIDC login capabilities. This serves as an
alternative to ["Keycloak"](https://www.keycloak.org/)
or other OIDC provider pre-built software, which tend to
have longer startup times for development.
### [App with OIDC](./oidc_app/)
The "OIDC client application" provides a Next.js application that uses NextAuth
to authenticate the user against the [OIDC Provider](./oidc_provider).
As mentioned, to log in, you may use any username/password combination
since the provider accepts arbitrary input.
Once you are logged in, you can enter an API url that the app shall
send an HTTP GET request to. The result is then displayed in the
web application.
### [API with OIDC](./oidc_api/)
The "OIDC API" is a dotnet (.net6.0) application that uses
OIDC (more specifically
[OAuth2.0Introspection](https://github.com/IdentityModel/IdentityModel.AspNetCore.OAuth2Introspection)) authentication
to check if a user may or may not access the API. The API has
one endpoint (`/swapi/people`) that returns the first ten people from the
[Star Wars API](https://swapi.dev/).
### [App with Basic Auth](./basic_auth_app/)
Trivial HTML/JavaScript application that uses HTTP Basic Authentication
([RFC7617](https://tools.ietf.org/html/rfc7617))
to authenticate against a given API. Served via NGINX.
### [Backend App with Basic Auth](./basic_auth_backend_app/)
.NET Razor Pages application that uses HTTP Basic Authentication
([RFC7617](https://tools.ietf.org/html/rfc7617))
to authenticate against a given API. The application utilizes
post-back forms to execute the basic auth request to the API.
This enables the app to use the HTTP_PROXY environment variable.
### [API with Basic Auth](./basic_auth_api/)
This API uses simple Basic Auth ([RFC7617](https://tools.ietf.org/html/rfc7617))
credentials to authenticate a user. Like the OIDC API, it exposes one
possible API endpoint (`/swapi/people`) that returns the first ten people
of the [Star Wars API](https://swapi.dev/).
## Run All Applications
If you want to try the applications, you may use the provided
[docker-compose.yml](./docker-compose.yml) file to build and start
the applications. Be aware that on
[Docker for Mac](https://docs.docker.com/desktop/mac/)
and [Docker for Windows](https://docs.docker.com/desktop/windows/)
you eventually are required to change the `localhost` references
to `host.docker.internal` because of the way the port forwarding
works. Or vice versa.