Skip to main content

Demo Resource Server

The demonstration resource server is a simple application which can be used in place of a real application while experimenting with IBM Application Gateway's capabilities.

When configured with IAG, this application:

  • Can respond to requests for any URL
  • Displays all received HTTP headers, including identity headers added by IAG
  • Displays the decoded version of any basic authentication header provided
  • Displays the claims within a JWT passed in the 'jwt' HTTP header

Refer to the Hello World topic for complete examples.

Hosted Version

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

Protocol Host Port
HTTPS resource-server.au-syd.mybluemix.net 443
HTTP resource-server.au-syd.mybluemix.net 80
resource_servers:
  - path:            /demo-https
    connection_type: ssl
    servers:
      - host: resource-server.au-syd.mybluemix.net
        port: 443
    ...
  - path:            /demo-http
    connection_type: tcp
    servers:
      - host: resource-server.au-syd.mybluemix.net
        port: 80
    ...

Docker Container

The demonstration application is also available from Docker Hub:

Accessing the Image

To load the image from Docker Hub the 'docker pull' command should be used. The image name should be supplied with the pull command, along with a tag which corresponds to the image version number. For example:

docker pull ibmcom/ibm-application-gateway-demo-resource-server:20.09

Ports

The demo resource server container will expose a single port which the server will listen for requests: HTTP 8000. By default the Docker environment will publish this port to random ports on the Docker host. If a specific port or Docker host IP address is required the '--publish' option should be used 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 ibmcom/ibm-application-gateway-demo-resource-server:20.09

However, a more complete command, which would specify a port, could be:

docker run --name iag-demo-resource-server \
    --detach \
    --publish 8080:8000 \
    ibmcom/ibm-application-gateway-demo-resource-server:20.09
    
# Examine the request log file of the container.
docker logs -f iag-demo-resource-server

Supported Tags

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