We Have Moved

The IBM Application Gateway has a new home - docs.verify.ibm.com/gateway

The documentation on this site will no longer be maintained after v21.02, please update your bookmarks.

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:

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:

• ibmcom/ibm-application-gateway-demo-resource-server

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:21.02

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:21.02

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:21.02
    
# Examine the request log file of the container.
docker logs -f iag-demo-resource-server

Supported Tags