How to enable and use OTK health check

Products

• CA API Gateway

Issue/Introduction

As per the OTK product document,

OAuth Server API Endpoints

The endpoint "Is only usable if the Gateway cluster property otk.health.apikey is defined. The Gateway cluster property otk.port.health should also be set if it does not match the default 8443."

The statement is not very accurate. Only define the cluster wide properties is not enough.

Environment

Release : 10.0

Component : API GATEWAY

Resolution

To enable the endpoint, need to modify the policy of /auth/oauth/health,

Option 1, set the values directly in policy,

Input the true values for "Set context variable otk.health.apikey as string to: <apikey>", "Set context variable otk.port.health as string to: <port>", at the beginning of the policy, save and activate the policy.

Then call the endpoint as,

curl -kv https://<gatewayhost>:<port>/auth/oauth/health?apikey=<apikey>

 

Option 2, use cluster wide properties,

1. modify the policy and set the variables as below,

"Set context variable otk.health.apikey as string to: ${gateway.otk.health.apikey}"

"Set context variable otk.port.health as string to: ${gateway.otk.port.health}"

2. 

add cluster wide properties otk.health.apikey, otk.port.health on Manage Cluster-Wide Properties window