chore(curriculum): add instructions for certificate 09 (#44241)
This commit is contained in:
Alessia Vanni
GitHub
@ -9,22 +9,74 @@ dashedName: port-scanner
|
||||
|
||||
# --description--
|
||||
|
||||
You will be [working on this project with our Replit starter code](https://replit.com/github/freeCodeCamp/boilerplate-port-scanner).
|
||||
|
||||
We are still developing the interactive instructional part of the Python curriculum. For now, here are some videos on the freeCodeCamp.org YouTube channel that will teach you everything you need to know to complete this project:
|
||||
|
||||
- [Python for Everybody Video Course](https://www.freecodecamp.org/news/python-for-everybody/) (14 hours)
|
||||
|
||||
- [Learn Python Video Course](https://www.freecodecamp.org/news/learn-python-video-course/) (10 hours)
|
||||
|
||||
# --instructions--
|
||||
|
||||
Create a port scanner using Python.
|
||||
|
||||
You can access [the full project description and starter code on Replit](https://replit.com/github/freeCodeCamp/boilerplate-port-scanner).
|
||||
In the `port_scanner.py` file, create a function called `get_open_ports` that takes a `target` argument and a `port_range` argument. `target` can be a URL or IP address. `port_range` is a list of two numbers indicating the first and last numbers of the range of ports to check.
|
||||
|
||||
After going to that link, fork the project. Once you complete the project based on the instructions in 'README.md', submit your project link below.
|
||||
Here are examples of how the function may be called:
|
||||
|
||||
We are still developing the interactive instructional part of the Python curriculum. For now, here are some videos on the freeCodeCamp.org YouTube channel that will teach you some of the Python skills required for this project:
|
||||
```py
|
||||
get_open_ports("209.216.230.240", [440, 445])
|
||||
get_open_ports("www.stackoverflow.com", [79, 82])
|
||||
```
|
||||
|
||||
<ul>
|
||||
<li>
|
||||
<a href='https://www.freecodecamp.org/news/python-for-everybody/'>Python for Everybody Video Course</a> (14 hours)
|
||||
</li>
|
||||
<li>
|
||||
<a href='https://www.freecodecamp.org/news/learn-python-basics-in-depth-video-course/'>Learn Python Video Course</a> (2 hours)
|
||||
</li>
|
||||
</ul>
|
||||
The function should return a list of open ports in the given range.
|
||||
|
||||
The `get_open_ports` function should also take an optional third argument of `True` to indicate "Verbose" mode. If this is set to true, the function shourd return a descriptive string instead of a list of ports.
|
||||
|
||||
Here is the format of the string that should be returned in verbose mode (text inside `{}` indicates the information that should appear):
|
||||
|
||||
```bash
|
||||
Open ports for {URL} ({IP address})
|
||||
PORT SERVICE
|
||||
{port} {service name}
|
||||
{port} {service name}
|
||||
```
|
||||
|
||||
You can use the dictionary in `common_ports.py` to get the correct service name for each port.
|
||||
|
||||
For example, if the function is called like this:
|
||||
|
||||
```py
|
||||
port_scanner.get_open_ports("scanme.nmap.org", [20, 80], True)
|
||||
```
|
||||
|
||||
It should return the following:
|
||||
|
||||
```bash
|
||||
Open ports for scanme.nmap.org (45.33.32.156)
|
||||
PORT SERVICE
|
||||
22 ssh
|
||||
80 http
|
||||
```
|
||||
|
||||
Make sure to include proper spacing and new line characters.
|
||||
|
||||
If the URL passed into the `get_open_ports` function is invalid, the function should return the string: "Error: Invalid hostname".
|
||||
|
||||
If the IP address passed into the `get_open_ports` function is invalid, the function should return the string: "Error: Invalid IP address".
|
||||
|
||||
## Development
|
||||
|
||||
Write your code in `port_scanner.py`. For development, you can use `main.py` to test your code. Click the "run" button and `main.py` will run.
|
||||
|
||||
## Testing
|
||||
|
||||
The unit tests for this project are in `test_module.py`. We imported the tests from `test_module.py` to `main.py` for your convenience. The tests will run automatically whenever you hit the "run" button.
|
||||
|
||||
## Submitting
|
||||
|
||||
Copy your project's URL and submit it to freeCodeCamp.
|
||||
|
||||
# --hints--
|
||||
|
||||
|
||||
@ -9,22 +9,51 @@ dashedName: sha-1-password-cracker
|
||||
|
||||
# --description--
|
||||
|
||||
You will be [working on this project with our Replit starter code](https://replit.com/github/freeCodeCamp/boilerplate-SHA-1-password-cracker).
|
||||
|
||||
We are still developing the interactive instructional part of the Python curriculum. For now, here are some videos on the freeCodeCamp.org YouTube channel that will teach you everything you need to know to complete this project:
|
||||
|
||||
- [Python for Everybody Video Course](https://www.freecodecamp.org/news/python-for-everybody/) (14 hours)
|
||||
|
||||
- [Learn Python Video Course](https://www.freecodecamp.org/news/learn-python-video-course/) (10 hours)
|
||||
|
||||
# --instructions--
|
||||
|
||||
Passwords should never be stored in plain text. They should be stored as hashes, just in case the password list is discovered. However, not all hashes are created equal.
|
||||
|
||||
For this project you will learn about the importance of good security by creating a password cracker to figure out passwords that were hashed using SHA-1.
|
||||
|
||||
You can access [the full project description and starter code on Replit](https://replit.com/github/freeCodeCamp/boilerplate-SHA-1-password-cracker).
|
||||
Create a function that takes in a SHA-1 hash of a password and returns the password if it is one of the top 10,000 passwords used. If the SHA-1 hash is NOT of a password in the database, return "PASSWORD NOT IN DATABASE".
|
||||
|
||||
After going to that link, fork the project. Once you complete the project based on the instructions in 'README.md', submit your project link below.
|
||||
The function should hash each password from `top-10000-passwords.txt` and compare it to the hash passed into the function.
|
||||
|
||||
We are still developing the interactive instructional part of the Python curriculum. For now, here are some videos on the freeCodeCamp.org YouTube channel that will teach you some of the Python skills required for this project:
|
||||
The function should take an optional second argument named `use_salts`. If set to true, each salt string from the file `known-salts.txt` should be appended AND prepended to each password from `top-10000-passwords.txt` before hashing and before comparing it to the hash passed into the function.
|
||||
|
||||
<ul>
|
||||
<li>
|
||||
<a href='https://www.freecodecamp.org/news/python-for-everybody/'>Python for Everybody Video Course</a> (14 hours)
|
||||
</li>
|
||||
<li>
|
||||
<a href='https://www.freecodecamp.org/news/learn-python-basics-in-depth-video-course/'>Learn Python Video Course</a> (2 hours)
|
||||
</li>
|
||||
</ul>
|
||||
Here are some hashed passwords to test the function with:
|
||||
|
||||
- `b305921a3723cd5d70a375cd21a61e60aabb84ec` should return "sammy123"
|
||||
- `c7ab388a5ebefbf4d550652f1eb4d833e5316e3e` should return "abacab"
|
||||
- `5baa61e4c9b93f3f0682250b6cf8331b7ee68fd8` should return "password"
|
||||
|
||||
Here are some hashed passwords to test the function with when `use_salts` is set to `True`:
|
||||
|
||||
- `53d8b3dc9d39f0184144674e310185e41a87ffd5` should return "superman"
|
||||
- `da5a4e8cf89539e66097acd2f8af128acae2f8ae` should return "q1w2e3r4t5"
|
||||
- `ea3f62d498e3b98557f9f9cd0d905028b3b019e1` should return "bubbles1"
|
||||
|
||||
The `hashlib` library has been imported for you. You should condider using it in your code. [Learn more about "hashlib" here.](https://docs.python.org/3/library/hashlib.html)
|
||||
|
||||
## Development
|
||||
|
||||
Write your code in `password_cracker.py`. For development, you can use `main.py` to test your code. Click the "run" button and `main.py` will run.
|
||||
|
||||
## Testing
|
||||
|
||||
The unit tests for this project are in `test_module.py`. We imported the tests from `test_module.py` to `main.py` for your convenience. The tests will run automatically whenever you hit the "run" button.
|
||||
|
||||
## Submitting
|
||||
|
||||
Copy your project's URL and submit it to freeCodeCamp.
|
||||
|
||||
# --hints--
|
||||
|
||||
|
||||
Reference in New Issue
Block a user