When configuring your Common Alert Protocol (CAP) endpoint to send CAP-formatted messages as POSTs to your own server/listener, Omnilert will need to check that the listening server is available.
Omnilert will post to that server to determine if it's available. This status check happens:
- Whenever you click Update configuration for CAP
- Whenever the Send Message (composer window) or Endpoints screen loads.
There are two options for this special service status check:
1) Perform a simple GET on the URL to see if the URL returns a 200 "Success". (Default)
2) Send a CAP-formatted message with its <status> set as a "Test", which your CAP-compatible listener should respond to with "HTTP 200 SUCCESS".
Using CAP-formatted Service Status checks
Most listeners will not need CAP-formatted tests to verify their status.
However, if your CAP-listening server requires a CAP-formatted POST to respond and be seen, then check the box "Send CAP 'Test' messages as Service Status checks."
(This setting is found at the bottom of the CAP feed's configuration screen in Omnilert.)
Only enable this setting if your listener is expecting and can handle CAP messages with their "status" set to "Test" properly.
Why? Because this setting will send messages. Each time Omnilert loads its message composer and/or endpoint lists, the system will send a CAP message with content similar to that shown below.
Note that the message is a "test" and expires in one minute.
<?xml version=\"1.0\" encoding=\"UTF-8\"?>
(Note: The <sent> and <expires> timestamps vary based on the date/time the page loads, of course.)
The CAP <status> field is set as "Test".
This should indicate to your CAP-enabled endpoint that this message is just a technical test to see if its listening and thus should not cause an alarm. (For details on standard CAP fields' recommended uses, please see http://docs.oasis-open.org/emergency/cap/v1.2/CAP-v1.2-os.html)
Note: This setting is only relevant to you if you're using Omnilert's CAP service to post alerts to a listening server. If you're using CAP via "pull", by pulling messages from Omnilert's server as a feed, then this setting doesn't matter for your use-case.