Skip to content

Latest commit

 

History

History
78 lines (47 loc) · 2.4 KB

README.md

File metadata and controls

78 lines (47 loc) · 2.4 KB
Raw

helidon-mp-native

Prerequisites:

  • This example requires Java 11
  • If you want to run GraalVM native image, you need to install version 19.3.1

## Build and run Java application To build: mvn clean package

To run: java -jar target/helidon-examples-native-image-mp.jar

Build and run native image

This example was tested with GraalVM Version 19.3.1 CE.

To build native image:

  1. Export the location of graal-vm installation with native image to an env variable GRAALVM_HOME export GRAALVM_HOME=/your/installation/of/graalvm
  2. mvn clean package -Pnative-image

Note: There is a few warnings in the output, we are working on fixing them

To run: ./target/helidon-examples-native-image-mp

Endpoints

Application endpoints

See the standard output of the application - you see the token content to be used for jwt, referenced as ${TOKEN} in examples

MicroProfile JWT-Auth protected endpoint:

curl -i -H "Authorization: bearer ${TOKEN}" http://localhost:7001/jwt/scope

curl -i -H "Authorization: bearer ${TOKEN}" http://localhost:7001/jwt/role

curl -i http://localhost:7001/jwt/public

OIDC (Open ID Connect) protected endpoint (Uses JWT to handle authentication, redirect is disabled):

curl -i -H "Authorization: bearer ${TOKEN}" http://localhost:7001/oidc/scope

curl -i -H "Authorization: bearer ${TOKEN}" http://localhost:7001/oidc/role

curl -i http://localhost:7001/oidc/public

Basic Authentication:

curl -i -u jack:password http://localhost:7001/basic/role

curl -i http://localhost:7001/basic/public

  • Not authorized (not in correct role) - should return "403 Forbidden"

curl -i -u john:password http://localhost:7001/basic/role

Any protected endpoint (*/role and */scope) invoked without authentication information should not be authenticated and return "401 Unauthorized"

A small issue with HTTP response codes:

  • "401 Unauthorized" means "Not Authenticated"
  • "403 Forbidden" means "Not Authorized"

MP endpoints

Health:

  • Liveness health checks: curl http://localhost:7001/health/live
  • Readiness health checks: curl http://localhost:7001/health/ready

Metrics:

  • Base metrics: curl -H "Accept: application/json" http://localhost:7001/metrics/base
  • Vendor metrics: curl -H "Accept: application/json" http://localhost:7001/metrics/vendor
  • Application metrics: curl -H "Accept: application/json" http://localhost:7001/metrics/application