Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/brabster/website-checker
Checks whether websites meet expectations based on user defined information
https://github.com/brabster/website-checker
Last synced: 1 day ago
JSON representation
Checks whether websites meet expectations based on user defined information
- Host: GitHub
- URL: https://github.com/brabster/website-checker
- Owner: brabster
- License: other
- Created: 2013-07-16T19:20:12.000Z (over 11 years ago)
- Default Branch: master
- Last Pushed: 2013-07-22T07:51:50.000Z (over 11 years ago)
- Last Synced: 2023-08-02T04:59:00.367Z (over 1 year ago)
- Language: Java
- Size: 172 KB
- Stars: 0
- Watchers: 3
- Forks: 0
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
website-checker
===============
Checks whether websites of interest meet expectations around availability, performance and security.
A means of building an executable JAR file is provided, and an API provides access for programmatic
or scripted execution.
Implemented in pure Java, the application should run anywhere there is a Java Virtual Machine > 1.5.
Any thoughts, suggestions or contributions gratefully received.
issues
======
Raise issues at https://github.com/brabster/website-checker/issues?milestone=1&state=open
features
========
For all URLs:
- checks status code is as expected
- checks response is received in less than a given number of milliseconds
Where an https protocol is specified and a certificate is presented:
- checks certificate is valid
- checks certificate is trusted by the computer running the check
- checks certificate is valid for at least a specified number of days
From a security perspective, the response content is not evaluated and the app has no access to your web browser.
quick-start
===========
Define your website URLs and expectations using JSON and then run the checker programmatically
or as an executable JAR using the Maven assembly:single goal.
An example of URL and expectation definitions follows.
We expect all URLs in the "Google" group to return an HTTP 200 response in less than 2000ms,
and where a secure URL is specified, it must present a valid certificate.
We further specify that the "Secure Google Homepage"
URL must present a certificate valid for at least the next 7 days.
```
[
{
"label": "Google",
"expect": {
"faster_than_millis": 2000,
"status_code": 200,
"accept_untrusted_certificates": false
},
"urls": [
{
"url": "http://google.com",
"label": "Google Homepage"
},
{
"url": "https://www.google.co.uk/webhp",
"label": "Secure Google Homepage",
"expect": {
"certificate_valid_for_days": 7
}
}
]
}
]
```
Running a jar-with-dependencies produces output such as:
```
[paul@paul-laptop java-website-check]$ java -jar target/java-website-check-1.0-SNAPSHOT-jar-with-dependencies.jar urls.json
Starting Check
OK My Blog (http://blog.crossedstreams.com) status 200 in 280ms
OK My Domain (http://crossedstreams.com) status 200 in 272ms
OK My Twitter Profile (http://twitter.com/brabster) status 301 in 206ms
OK Google Homepage (http://google.com) status 200 in 31ms
ERR Secure Google Homepage (https://google.com) SSLException java.lang.RuntimeException: Certificate not valid for 365 days
ERR NoSuchDomain.none (http://nosuchdomain.none) UnknownHostException nosuchdomain.none
ERR No Page Here (http://blog.crossedstreams.com/nopagehere) expected HTTP 200 but received 404
Check Complete
```
license
=======
Copyright 2013 Paul J Brabban
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.