Demo resource server

Edit online

The demonstration resource server is a simple application that you can use instead of a real application when you experiment with IBM® Application Gateway capabilities.

When you configure the application with IAG, it:

Responds to requests for any URL
Displays all received HTTP headers, including identity headers that are added by IAG
Displays the decoded content of any Basic authentication header
Displays the claims in a JWT that is passed in the jwt HTTP header

For complete examples, see the Hello world section.

Hosted version

A hosted version of the demo resource server is available at the following location:


Protocol	Host	Port
HTTPS	resource-server-demo.verify.ibm.com	443

resource_servers:
  - path:            /demo-https
    connection_type: ssl
    sni: resource-server-demo.verify.ibm.com
    servers:
      - host: resource-server-demo.verify.ibm.com
        port: 443
    ...

Docker container

The latest published IBM Application Gateway (IAG) demo resource server image is available from IBM Cloud Container Registry:

icr.io/ibmappgateway/ibm-application-gateway-demo-resource-server:23.04

For more information, see Containers.

Accessing the Image

To load the image from IBM Cloud Container Registry, use the docker pull command. Specify the image name and a tag that corresponds to the image version. For example:

docker pull icr.io/ibmappgateway/ibm-application-gateway-demo-resource-server:23.04

Ports

The demo resource server container exposes a single port for incoming requests: HTTP 8000. By default, Docker publishes this port to a random port on the Docker host. To specify a port or host IP address, use the --publish option with the docker run command.

Quick Start

To start the container in the foreground, execute the command:

docker run --rm --name iag-demo-resource-server icr.io/ibmappgateway/ibm-application-gateway-demo-resource-server:23.04

To run the container in detached mode and specify a port:

docker run --name iag-demo-resource-server \
    --detach \
    --publish 8080:8000 \
    icr.io/ibmappgateway/ibm-application-gateway-demo-resource-server:23.04

To view the container request log file:

docker logs -f iag-demo-resource-server

Supported Tags


Tag	Purpose
YY.MM	A particular release, of the format: `{year}.{month}`. For example 23.04.
YY.MM.R	A particular release, of the format: `{year}.{month}.{revision}`. For example 23.04.0.