Skip to content

Commit 7743ce4

Browse files
committed
Updated readme with new usage info
1 parent 6f103aa commit 7743ce4

File tree

1 file changed

+17
-20
lines changed

1 file changed

+17
-20
lines changed

README.md

Lines changed: 17 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -1,47 +1,44 @@
1-
#SSL-Yeah!
1+
# SSL-Yeah!
22
SSL-Yeah is a simple HTTPS verification tool for websites and ruleset creator for HTTPS Everywhere.
33

4-
##Getting Started
4+
## Getting Started
55

66
1. Install NodeJS on your system (http://nodejs.org/)
77
2. Download SSL-Yeah
88
3. `npm install` from the SSL-Yeah Folder.
99
3. Run the script!
1010

11-
##Usage
11+
## Usage
1212

13-
###Settings
14-
For the time being, the settings cannot be changed at runtime. You can configure SSL-Yeah prior to running the script in settings.js
15-
16-
###Launching
17-
####Launching via CLI
18-
You can call the script without arguments and follow the on-screen instructions.
13+
#### Launching via command line
14+
The easiest way to try out ssl-yeah is to launch it from the command line.
1915
```js
20-
node ssl-yeah.js
16+
node ssl-yeah myhost.com
2117
```
2218

23-
####Launching with an argument
24-
You can also pass a domain as argument when launching the program.
19+
#### Import ssl-yeah in your application
20+
For more flexibility, you may also import ssl-yeah into your application.
2521
```js
26-
node ssl-yeah.js mydomain.com
22+
var SSLYeah = require('ssl-yeah');
23+
var crawler = new SSLYeah();
24+
crawler.on('crawlDone', function(){...});
25+
crawler.startCrawl('myhost.com');
2726
```
2827

29-
###Output
30-
By default, a detailed test report and an HTTPS Everywhere ruleset will be output to /output
28+
### Output
29+
By default, all files are written to `./output`. In CLI mode, detailed test report and an HTTPS Everywhere ruleset will be output by default. In library mode, no files are created by default.
3130

3231
Make sure to test the ruleset thoroughly before publishing it. It is also a good idea to cross-reference the ruleset with the detailed report in order to manually fine-tune the rules.
3332

3433

35-
##Limitations
34+
## Limitations
3635

3736
- The input is not thoroughly checked for malformed or invalid urls
3837
- No detection of servers that serve completely different pages for http and https
3938
- No verification of secure cookies yet
4039
- No verification of XMLHttpRequests yet
4140

42-
##Dependencies
41+
## Dependencies
4342

44-
The following dependencies are used in SSL-Yeah:
45-
- Cheerio (https://github.com/cheeriojs/cheerio)
46-
- Moment (https://github.com/moment/moment)
43+
The following dependencies are included in SSL-Yeah:
4744
- A modified version of Robots-Parser (https://github.com/samclarke/robots-parser)

0 commit comments

Comments
 (0)