Contribute in GitHub:
Open doc issue|Edit online
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 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 IBM® Application Gateway (IAG) image is available from IBM Cloud Container Registry: icr.io/ibmappgateway/ibm-application-gateway-demo-resource-server:24.3
See Software Downloads > Containers for more information.
Accessing the Image
To load the image from IBM Cloud Container Registry 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 icr.io/ibmappgateway/ibm-application-gateway-demo-resource-server:24.3
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 icr.io/ibmappgateway/ibm-application-gateway-demo-resource-server:24.3
However, a more complete command, which would specify a port, could be:
docker run --name iag-demo-resource-server \
--detach \
--publish 8080:8000 \
icr.io/ibmappgateway/ibm-application-gateway-demo-resource-server:24.3
### Examine the request log file of the container.
docker logs -f iag-demo-resource-server