feat: example use Ory Hydra. Spring Boot 2 (Java 11), Angular, Docker (Docker Compose)

README.md

@@ -15,6 +15,7 @@ If you have any questions or suggestions
 - [Example with Supabase using Ory Kratos and Ory Oathkeeper](https://github.com/ory/examples/tree/master/kratos-keto-oathkeeper-supabase)
 - [Example with Supabase using Ory Cloud](https://github.com/ory/examples/tree/master/supabase-ory-cloud)
 - [Example API Gateway with Kong using Ory Kratos & Ory Oathkeeper](https://github.com/ory/examples/tree/master/kratos-oathkeeper-kong)
+- [Example implementation of OAuth 2.0 Authorization Code Flow with PKCE using Ory Hydra(Spring, Angular and Docker Compose)](https://github.com/ory/examples/tree/master/ory-hydra-oauth2.0-spring-angular-docker-compose)
 
 ### Configuration Examples
 

ory-hydra-oauth2.0-spring-angular-docker-compose/.env

@@ -0,0 +1,28 @@
+# ------------------!!!EDIT!!!----------------
+
+IP_AUTHORIZATION_SERVER=192.168.0.101
+IP_RESOURCE_SERVER=192.168.0.104
+IP_CLIENT_READONLY=192.168.0.102
+IP_CLIENT_WRITE_AND_READ=192.168.0.103
+
+DNS_AUTHORIZATION_SERVER=authorization-server.com
+DNS_RESOURCE_SERVER=resource-server.com
+DNS_CLIENT_READONLY=client-readonly.com
+DNS_CLIENT_WRITE_AND_READ=client-write-and-read.com
+
+USER_AUTHORIZATION_SERVER=someuser
+USER_RESOURCE_SERVER=someuser
+USER_CLIENT_READONLY=someuser
+USER_CLIENT_WRITE_AND_READ=someuser
+
+USER_DATA_POSTGRESQL_PASSWORD=cklGS7BNMT6Io9Yd8FKzg4ZmWLXjQnA24JbXNHbG
+
+HYDRA_POSTGRESQL_PASSWORD=7pj3gK8arVwk6A1BbUD2XysfIYmKdEk0DL8BMRNx
+
+HYDRA_SECRETS_COOKIE=OT9Z8I2NcBp01rP4FwQG7JEt6nuXeJ0BDpf4Bjwc
+HYDRA_SECRETS_SYSTEM=cIsKS4VzJCDpXlwm2PNTb7v60GHh1iEYZPiiPpRS
+
+HYDRA_INTROSPECT_USER=user_introspect
+HYDRA_INTROSPECT_PASSWORD=hUq7Mw3fr4lFjnHQtoJucgDdAV58NbAOvuGN2OfB
+
+# ------------------------------------------

ory-hydra-oauth2.0-spring-angular-docker-compose/.gitignore

@@ -0,0 +1,4 @@
+.$ory-hydra-oauth2-example.drawio.bkp
+.$ory-hydra-oauth2-example.drawio.dtmp
+
+ca_*

ory-hydra-oauth2.0-spring-angular-docker-compose/README.md

@@ -0,0 +1,221 @@
+# **ORY Hydra OAuth2 Example**
+
+[Русский язык](README_RUS.md)
+
+## Description
+
+Example implementation of [OAuth 2.0 Authorization Code with PKCE](https://www.ory.sh/docs/oauth2-oidc/authorization-code-flow) using [ORY Hydra](https://www.ory.sh/hydra/).
+
+Login Flow and Consent Flow are implemented using Spring boot 2(Java 11, WebFlux), Angular 17, PostgreSQL 15.
+
+Everything has been tested: Karma, JUnit 5, Testcontainers.
+
+## How to build example Login Flow Wrapper, Consent Flow Wrapper,  OAuth 2.0 Client(s), OAuth 2.0 Resource Server
+
+Let's take Login Flow and Consent Flow Wrapper as an example.
+
+### Build Frontend
+
+path:
+
+```bash
+cd ory_hydra_oauth2_example_authorization_server/authorization/authorization-frontend/
+```
+
+If you need to perform testing (Karma), then:
+
+```bash
+cd ory_hydra_oauth2_example_authorization_server/authorization/authorization-frontend/ && \
+npm i && \
+bash test_and_report.bash
+```
+
+If you need to find out the code coverage of tests, then you need to open the following through the browser:
+
+```text
+ory_hydra_oauth2_example_authorization_server/authorization/authorization-frontend/coverage/authorization-frontend/index.html
+```
+
+To build a docker image, do the following (ATTENTION! You must install pack. The instructions are inside build_image.bash):
+
+```bash
+
+# install pack
+# https://buildpacks.io/docs/tools/pack/#linux-script-install
+# (curl -sSL "https://github.com/buildpacks/pack/releases/download/v0.29.0/pack-v0.29.0-linux.tgz" | sudo tar -C /usr/local/bin/ --no-same-owner -xzv pack)
+
+cd ory_hydra_oauth2_example_authorization_server/authorization/authorization-frontend/ && \
+bash build_image.bash
+```
+
+### Build Backend
+
+path:
+
+```bash
+cd ory_hydra_oauth2_example_authorization_server/authorization/authorization-backend/
+```
+
+If you need to perform testing (JUnit 5), then (**ATTENTION!** Since Testcontainers is used for testing, you must have rights to run docker (sudo usermod -aG docker \[user\])):
+
+```bash
+cd ory_hydra_oauth2_example_authorization_server/authorization/authorization-backend/ && \
+./gradlew -v && \
+bash test_and_report.bash
+```
+
+If you need to find out the code coverage of tests (JaCoCo), then you need to open the following in the browser:
+
+```text
+ory_hydra_oauth2_example_authorization_server/authorization/authorization-backend/build/reports/jacoco/test/html/index.html
+```
+
+To build a docker image, do the following:
+
+```bash
+cd ory_hydra_oauth2_example_authorization_server/authorization/authorization-backend/ && \
+bash build_image.bash
+```
+
+### Proxy
+
+#### Docker (Debian)
+
+```bash
+mkdir -p /etc/systemd/system/docker.service.d
+
+# set proxy
+cat > /etc/systemd/system/docker.service.d/http-proxy.conf <<-EOF
+[Service]
+Environment="HTTP_PROXY=http://proxyuser:proxypass@192.168.20.4:8822/"
+Environment="HTTPS_PROXY=http://proxyuser:proxypass@192.168.20.4:8822/"
+Environment="NO_PROXY=localhost,127.0.0.1"
+EOF
+
+# restart docker
+sudo systemctl daemon-reload
+sudo systemctl restart docker
+
+# check
+systemctl show --property=Environment docker
+
+```
+
+#### APT (Docker image)
+
+If you need to specify a proxy server (see ory_hydra_oauth2_example_authorization_server/authorization/authorization-frontend/build_image.bash or ory_hydra_oauth2_example_authorization_server/authorization/authorization-backend/build_image.bash), then uncomment HTTP_PROXY (HTTPS_PROXY or/and NO_PROXY) and edit HTTP_PROXY ( HTTPS_PROXY or/and NO_PROXY)
+
+```bash
+ #!/bin/bash
+
+export HTTP_PROXY="http://proxyuser:proxypass@192.168.20.4:8822/"
+export HTTPS_PROXY="http://proxyuser:proxypass@192.168.20.4:8822/"
+export NO_PROXY="localhost,127.0.0.1"
+
+REPO_IMAGE="chistousov"
+...
+
+```
+
+## Example
+
+![ory-hydra-oauth2-example](ory-hydra-oauth2-example.png)
+
+4 Debian:
+| Type                                           | DNS, Hostname             | IP            |
+| -------------                                  | -------------             | ------------- |
+| OAuth 2.0 Authorization Server                 | authorization-server.com  | 192.168.0.101 |
+| OAuth 2.0 Client (Readonly)                    | client-readonly.com       | 192.168.0.102 |
+| OAuth 2.0 Client (Write and read)              | client-write-and-read.com | 192.168.0.103 |
+| OAuth 2.0 Resource Server                      | resource-server.com       | 192.168.0.104 |
+
+Requires openssl, jq (apt install jq), htpasswd (apt install apache2-utils), envsubst to run start.bash.
+
+Required on remote servers: Docker, Docker Compose (V3)
+
+We organize ssh and coordinate the settings with the .env file
+```bash
+# ------------------!!!EDIT!!!----------------
+
+IP_AUTHORIZATION_SERVER=192.168.0.101
+IP_RESOURCE_SERVER=192.168.0.104
+IP_CLIENT_READONLY=192.168.0.102
+IP_CLIENT_WRITE_AND_READ=192.168.0.103
+
+DNS_AUTHORIZATION_SERVER=authorization-server.com
+DNS_RESOURCE_SERVER=resource-server.com
+DNS_CLIENT_READONLY=client-readonly.com
+DNS_CLIENT_WRITE_AND_READ=client-write-and-read.com
+
+USER_AUTHORIZATION_SERVER=someuser
+USER_RESOURCE_SERVER=someuser
+USER_CLIENT_READONLY=someuser
+USER_CLIENT_WRITE_AND_READ=someuser
+
+USER_DATA_POSTGRESQL_PASSWORD=cklGS7BNMT6Io9Yd8FKzg4ZmWLXjQnA24JbXNHbG
+
+HYDRA_POSTGRESQL_PASSWORD=7pj3gK8arVwk6A1BbUD2XysfIYmKdEk0DL8BMRNx
+
+HYDRA_SECRETS_COOKIE=OT9Z8I2NcBp01rP4FwQG7JEt6nuXeJ0BDpf4Bjwc
+HYDRA_SECRETS_SYSTEM=cIsKS4VzJCDpXlwm2PNTb7v60GHh1iEYZPiiPpRS
+
+HYDRA_INTROSPECT_USER=user_introspect
+HYDRA_INTROSPECT_PASSWORD=hUq7Mw3fr4lFjnHQtoJucgDdAV58NbAOvuGN2OfB
+
+# ------------------------------------------
+
+```
+
+To find out the IP address you can run ***ip a***.
+
+**WARNING!** Users USER_AUTHORIZATION_SERVER, USER_RESOURCE_SERVER, USER_CLIENT_READONLY and USER_CLIENT_WRITE_AND_READ must be allowed to run docker compose (V3) (sudo usermod -aG docker \[user\]).
+
+We run the script to configure four servers:
+```bash
+bash start.bash
+```
+
+### Checking
+
+On the Resource Owner computer, DESCRIBE IP ADDRESSES IN THE FILE /etc/hosts (Linux).
+
+```bash
+# Let's say
+#DNS_AUTHORIZATION_SERVER=authorization-server.com
+#DNS_RESOURCE_SERVER=resource-server.com
+#DNS_CLIENT_READONLY=client-readonly.com
+#DNS_CLIENT_WRITE_AND_READ=client-write-and-read.com
+
+echo '192.168.0.101 authorization-server.com' >> /etc/hosts
+echo '192.168.0.102 client-readonly.com' >> /etc/hosts
+echo '192.168.0.103 client-write-and-read.com' >> /etc/hosts
+echo '192.168.0.104 resource-server.com' >> /etc/hosts
+# check
+ping authorization-server.com
+ping client-readonly.com
+ping client-write-and-read.com
+ping resource-server.com
+```
+
+0. Register Resource Owner <https://authorization-server.com/registration>.
+1. Go to <https://client-readonly.com>.
+2. Since the user is not logged in, the user is redirected to <https://authorization-server.com/login> (Login Flow, authentication), then to <https://authorization-server.com/consent> (Consent Flow, authorization).
+3. Next, the user is taken back to <https://client-readonly.com>.
+4. To receive data, OAuth 2.0 Client (Readonly) contacts <https://resource-server.com> with an access token.
+
+
+### Stop
+
+Stopping containers that save data (volume).
+
+```bash
+bash stop.bash
+```
+
+### Stop and clean
+
+We stop the containers and delete all data (volume).
+
+```bash
+bash stop_and_clean.bash
+```