sync with main

CONTRIBUTING.md

@@ -7,7 +7,7 @@ Suggest a new site to be covered by the tool.
 How to do that:
 
 - Find the new site which has public profiles of people (with no authentication required)
-- Use [this form](https://spotinfo.co/535y) to tell us about it.... OR....
+- Use [this form](https://forms.office.com/r/TscnNQqrD1) to tell us about it.... OR....
 - Create a Github Issue and submit the link to an example profile. You can
   do that by navigating to [Issues](https://github.com/WebBreacher/WhatsMyName/issues)
   and clicking "New issue"
@@ -36,8 +36,7 @@ How to do that:
   curl https://infosec.exchange/ThisDoesNotExistForSure504
   ```
 - Observe the outcome for non-existing profile. Some sites use 404 (error), some use 302
-(redirection), some confusingly use 200 (OK) for profiles which don't exist,
-e.g.
+(redirection), some confusingly use 200 (OK) for profiles which don't exist.
   ```
   $ curl https://github.com/ThisDoesNotExistForSure504
   [...]
@@ -55,16 +54,20 @@ This is too specific:
 ```
 <h2>You are browsing the profile of WebBreacher</h2>
 ```
+This is too general:
+```
+the profile
+```
 - Add a section to `wmn-data.json`
-- Test your configuration by running the tool for a given site
+- Test your configuration by running a tool for a given site
 - Submit a pull request with that change
 - There is also the `sample.json` file that you can use for testing. Simply replace the existing content with new data and test.
 
 ## Format of the JSON File
 
-### Format of the New/Current JSON file
+### Format of the JSON file
 
-The format of the `wmn-data.json` JSON was altered due to Issue #414. There are still 3 main elements:
+The format of the `wmn-data.json` JSON has 3 main elements:
 
 1. License - The license for this project and its data
 2. Authors - The people that have recently contributed to this project
@@ -77,16 +80,16 @@ Within the `sites` elements, the format is as follows (with several parameters b
       {
          "name" : "name of the site",
          "uri_check" : "URI to check the site with the {account} string replaced by a username",
-         "uri_pretty" : "if the check_uri is for an API, this OPTIONAL element can show a human-readable page",
+         "uri_pretty" : "[OPTIONAL] if the check_uri is for an API, this element can show a human-readable page",
          "post_body" : "[OPTIONAL] if non-empty, then this entry is an HTTP POST and the content of this field are the data",
          "strip_bad_char" : "[OPTIONAL] checking apps should ignore or strip these characters from usernames",
          "e_code" : "the HTTP response code for a good 'account is there' response as an integer",
          "e_string" : "the string in the response that we look for for a good response",
-         "m_string" : "this OPTIONAL string will only be in the response if there is no account found ",
+         "m_string" : "this string will only be in the response if there is no account found",
          "m_code" : "the HTTP response code for a bad 'account is not there' response as an integer",
          "known" : ["a list of user accounts that can be used to test", "for user enumeration"],
          "cat" : "a category for what the site is mainly used for. The current categories are found at the top of the JSON",
-         "valid" : "[OPTIONAL] single value of True. If it is present and True, then checkers should skip this site",
+         "valid" : "[OPTIONAL] single value of False. If it is present and False, then checkers should skip this site",
          "headers": {"[OPTIONAL] a dictionary of headers that should be passed to a site"}
       },
       ...

README.md

@@ -38,26 +38,21 @@ For a site to be included in WMN it has to:
 * [Spiderfoot](https://github.com/smicallef/spiderfoot) uses this in the **sfp_account** module. There is also [this video](https://asciinema.org/a/295923) showing how to use this project using the Spiderfoot Command Line Interface (CLI).
 * [WhatsMyName-Python](https://github.com/C3n7ral051nt4g3ncy/WhatsMyName-Python) **Whats My Name** simple Python script made by [@C3n7ral051nt4g3ncy](https://github.com/C3n7ral051nt4g3ncy)
 * [WMN_screenshooter](https://github.com/swedishmike/WMN_screenshooter) a helper script that uses Selenium to try and grab screenshots of identified profile pages.
-
+* [WhatsMyName-Client](https://github.com/grabowskiadrian/WhatsMyName-Client) a simple Python script with 'request headers' and 'POST requests' support made by [@grabowskiadrian](https://github.com/grabowskiadrian). The script also allows you to test the configuration of the wmn-data.json file.
+* [WhatsMyName-Web](https://github.com/AXRoux/WhatsMyName-Web) **Whats My Name-Web** is a simple Flask web app iteration of WhatsMyName made by [@AXRoux](https://github.com/AXRoux/)
 
 ## Content
 
 * The https://github.com/WebBreacher/WhatsMyName/wiki/Problem-Removed-Sites page has websites that we have had in the project and are currently not working for some reason. We will retest those sites (in the future) and try to find detections.
 * If you would like to help with detections, we are happy to accept them via GitHub pull request or you can [create an issue](https://github.com/WebBreacher/WhatsMyName/issues) with the details of the site.
-* Want to suggest a site to be added? Use [this form](https://spotinfo.co/535y).
+* Want to suggest a site to be added? Use [this form](https://forms.office.com/r/TscnNQqrD1).
 
 
 ## Format
 
 See [CONTRIBUTING](CONTRIBUTING.md)
 
 
-# Social Media
-
-Come follow us for updates. We are on:
-* Mastodon at https://infosec.exchange/@whatsmyname <a rel="me" href="https://infosec.exchange/@whatsmyname"></a>
-
-
 # License
 
 <a rel="license" href="http://creativecommons.org/licenses/by-sa/4.0/"><img alt="Creative Commons License" style="border-width:0" src="https://i.creativecommons.org/l/by-sa/4.0/88x31.png" /></a><br />This work is licensed under a <a rel="license" href="http://creativecommons.org/licenses/by-sa/4.0/">Creative Commons Attribution-ShareAlike 4.0 International License</a>.

sample.json

@@ -27,7 +27,10 @@
       "m_code" : 404,
       "m_string" : "Account not found",
       "known" : ["whoami", "johndoe"],
-      "cat" : "images"
+      "cat" : "images",
+      "headers": {
+               "accept": "text/html"
+       }
     }
   ]
 }