Skip to content

Commit eb60397

Browse files
committed
chore: reformat a little
1 parent c37dad5 commit eb60397

File tree

11 files changed

+471
-483
lines changed

11 files changed

+471
-483
lines changed

CODE_OF_CONDUCT.md

+10-10
Original file line numberDiff line numberDiff line change
@@ -8,19 +8,19 @@ In the interest of fostering an open and welcoming environment, we as contributo
88

99
Examples of behavior that contributes to creating a positive environment include:
1010

11-
* Using welcoming and inclusive language
12-
* Being respectful of differing viewpoints and experiences
13-
* Gracefully accepting constructive criticism
14-
* Focusing on what is best for the community
15-
* Showing empathy towards other community members
11+
- Using welcoming and inclusive language
12+
- Being respectful of differing viewpoints and experiences
13+
- Gracefully accepting constructive criticism
14+
- Focusing on what is best for the community
15+
- Showing empathy towards other community members
1616

1717
Examples of unacceptable behavior by participants include:
1818

19-
* The use of sexualized language or imagery and unwelcome sexual attention or advances
20-
* Trolling, insulting/derogatory comments, and personal or political attacks
21-
* Public or private harassment
22-
* Publishing others' private information, such as a physical or electronic address, without explicit permission
23-
* Other conduct which could reasonably be considered inappropriate in a professional setting
19+
- The use of sexualized language or imagery and unwelcome sexual attention or advances
20+
- Trolling, insulting/derogatory comments, and personal or political attacks
21+
- Public or private harassment
22+
- Publishing others' private information, such as a physical or electronic address, without explicit permission
23+
- Other conduct which could reasonably be considered inappropriate in a professional setting
2424

2525
## Our Responsibilities
2626

CONTRIBUTING.md

-1
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,3 @@
1-
21
# Contributing
32

43
Contributing is VERY welcomed. The only way for this resource to be useful is if it is maintained.

LICENSE.md

+136-145
Large diffs are not rendered by default.

SECURITY.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44

55
| Version | Supported |
66
| ------- | ------------------ |
7-
| all | :white_check_mark: |
7+
| all | :white_check_mark: |
88

99
## Reporting a Vulnerability
1010

guides/roblee.md

+129-129
Large diffs are not rendered by default.

guides/scadamagICSLab.md

+7-7
Original file line numberDiff line numberDiff line change
@@ -12,12 +12,12 @@ If you’re from the ICS security camp, pay attention here. To correctly diagnos
1212

1313
So, why have a lab at all? It’s not cheap to set one up or keep it running.
1414

15-
* Have a place to examine failed parts to determine causes
16-
* Mock up and test new systems BEFORE installing it in the field for the first time
17-
* Practice what was taught in training
18-
* Penetration testing of offline equipment
19-
* Patch testing for field equipment
20-
* Demonstrate functionality of new equipment under consideration
15+
- Have a place to examine failed parts to determine causes
16+
- Mock up and test new systems BEFORE installing it in the field for the first time
17+
- Practice what was taught in training
18+
- Penetration testing of offline equipment
19+
- Patch testing for field equipment
20+
- Demonstrate functionality of new equipment under consideration
2121

2222
These are reasons enough for most Operations staff and every ICS consultant firm to have a lab. Not many mangers understand the depth and complexity of the instruments, the managed switches, the servers, the HMI workstations, the power systems, the networks, the wiring, the surge protection systems, the software, the PLC gear, the I/O panels and so forth.
2323

@@ -74,6 +74,7 @@ You may also want to check calibrations of RTDs or Thermistors using boiling liq
7474
So a lab is an interesting place. It’s a significant investment. You may be wondering if it’s worth doing. Well, it is. It all has to do with the care, empowerment, and feeding the needs of Engineers.
7575

7676
Here are few side benefits:
77+
7778
1. Toy Factor for Retention
7879
2. Recruitment
7980
3. Publicity
@@ -95,4 +96,3 @@ And finally, given a context like this, managers can determine who is on the bal
9596
## Summary
9697

9798
Not all of these features are things you’ll need to do, and not all of them are worth the expense. But the need for a lab is there. A lab isn’t cheap. However, if there is no lab, things will rapidly get a lot more expensive.
98-

hardware/README.md

+26-26
Original file line numberDiff line numberDiff line change
@@ -4,42 +4,42 @@ Developed as a community asset
44

55
## Starting Hardware
66

7-
* [Siemens S7-1200](http://w3.siemens.com/mcms/programmable-logic-controller/en/basic-controller/s7-1200/pages/default.aspx) PLCs - Cheap and commonly used. You can buy a "starter kit" that includes TIA Portal (software to configure the PLC). Trial version of the software is also available. Check eBay or refurb vendors for deals.
8-
* [MicroLogix 1100](http://ab.rockwellautomation.com/Programmable-Controllers/MicroLogix-1100) - Another alternative to the S7-1200 and also available in a starter kit. Again, check eBay or refurb vendors for deals.
7+
- [Siemens S7-1200](http://w3.siemens.com/mcms/programmable-logic-controller/en/basic-controller/s7-1200/pages/default.aspx) PLCs - Cheap and commonly used. You can buy a "starter kit" that includes TIA Portal (software to configure the PLC). Trial version of the software is also available. Check eBay or refurb vendors for deals.
8+
- [MicroLogix 1100](http://ab.rockwellautomation.com/Programmable-Controllers/MicroLogix-1100) - Another alternative to the S7-1200 and also available in a starter kit. Again, check eBay or refurb vendors for deals.
99

1010
## Basic Lab Setup
1111

12-
* [Modicon Quantum](http://www.schneider-electric.com/en/product-range/538-modicon-quantum/)
13-
* [Koyo Direct](http://www.automationdirect.com/adc/Overview/Catalog/Programmable_Controllers/DirectLogic_Series_PLCs_(Micro_to_Small,_Brick_-a-_Modular))
14-
* Any no-name PLC with ModBus
12+
- [Modicon Quantum](http://www.schneider-electric.com/en/product-range/538-modicon-quantum/)
13+
- [Koyo Direct](<http://www.automationdirect.com/adc/Overview/Catalog/Programmable_Controllers/DirectLogic_Series_PLCs_(Micro_to_Small,_Brick_-a-_Modular)>)
14+
- Any no-name PLC with ModBus
1515

1616
## Supporting Equipment
1717

1818
### Basic
1919

20-
* Network Tap or Hub for capturing network traffic
21-
* [Throwing Star LAN Tap](https://greatscottgadgets.com/throwingstar/) - a small, simple passive Ethernet tap for monitoring Ethernet communications, requiring no power for operation.
22-
* [BusPirate](http://dangerousprototypes.com/docs/Bus_Pirate), or equivalent
23-
* A few USB-Ethernet dongles
24-
* VMWare Workstation, or other virtualization software
25-
* Several Serial Cables, and USB adapters as well if you don't have a 'real' serial port, along with wireable serial connectors from Radio Shack
26-
* About 50 feet of networking cable with all the tools (you won't be doing just Ethernet stuff, but its good wiring for all kinds of things)
27-
* [NooElec SDR](http://www.nooelec.com/store/sdr.html) Dongle
28-
* Basic Switch, 10/100 is fine for automation
29-
* A Basic Serial to Ethernet converter (Digi, MOXA, and several others have decent products)
30-
* Basic Multimeter (e.g., [INNOVA 3320](http://www.amazon.com/INNOVA-3320-Auto-Ranging-Digital-Multimeter/dp/B000EVYGZA))
31-
* A few 120VAC appliance replacement cords. (plug on one end and wire on the other. Lots of this equipment doesn't have standard computer plugs, so having this makes it easy)
32-
* [Raspberry Pi](https://www.raspberrypi.org/products/) or [BeagleBone Black](https://www.sparkfun.com/products/12857) and Breadboard
33-
* [A low-cost, DIY data diode for ICS](https://github.com/wavestone-cdt/dyode)
20+
- Network Tap or Hub for capturing network traffic
21+
- [Throwing Star LAN Tap](https://greatscottgadgets.com/throwingstar/) - a small, simple passive Ethernet tap for monitoring Ethernet communications, requiring no power for operation.
22+
- [BusPirate](http://dangerousprototypes.com/docs/Bus_Pirate), or equivalent
23+
- A few USB-Ethernet dongles
24+
- VMWare Workstation, or other virtualization software
25+
- Several Serial Cables, and USB adapters as well if you don't have a 'real' serial port, along with wireable serial connectors from Radio Shack
26+
- About 50 feet of networking cable with all the tools (you won't be doing just Ethernet stuff, but its good wiring for all kinds of things)
27+
- [NooElec SDR](http://www.nooelec.com/store/sdr.html) Dongle
28+
- Basic Switch, 10/100 is fine for automation
29+
- A Basic Serial to Ethernet converter (Digi, MOXA, and several others have decent products)
30+
- Basic Multimeter (e.g., [INNOVA 3320](http://www.amazon.com/INNOVA-3320-Auto-Ranging-Digital-Multimeter/dp/B000EVYGZA))
31+
- A few 120VAC appliance replacement cords. (plug on one end and wire on the other. Lots of this equipment doesn't have standard computer plugs, so having this makes it easy)
32+
- [Raspberry Pi](https://www.raspberrypi.org/products/) or [BeagleBone Black](https://www.sparkfun.com/products/12857) and Breadboard
33+
- [A low-cost, DIY data diode for ICS](https://github.com/wavestone-cdt/dyode)
3434

3535
### Advanced
3636

37-
* Oscilloscope ([RIGOL](http://www.rigolna.com) are decent and cheap.)
38-
* Universal JTAG Adapter (e.g., [Wiggler](http://www.diygadget.com/universal-jtag-adapter-v2-wiggler-and-xilinx-platform-cable-compatible-debrick-routers-modems-and-more.html), [Flyswatter 2](http://www.tincantools.com/JTAG/Flyswatter2.html), [JTAGulator](http://www.grandideastudio.com/portfolio/jtagulator/)) and supporting software (e.g., [OpenOCD](http://openocd.org)).
39-
* Logic Analyzer ([Saleae](https://www.saleae.com) are good for normal use, stick with an 8 channel to start)
40-
* Adjustable Power Supply
41-
* [YardStickOne](https://greatscottgadgets.com/yardstickone/)/[RFCat](http://int3.cc/products/rfcat)/[HackRF](https://greatscottgadgets.com/hackrf/)
42-
* Another laptop for bare Linux
43-
* [IDAPro](https://www.hex-rays.com/products/ida/)
37+
- Oscilloscope ([RIGOL](http://www.rigolna.com) are decent and cheap.)
38+
- Universal JTAG Adapter (e.g., [Wiggler](http://www.diygadget.com/universal-jtag-adapter-v2-wiggler-and-xilinx-platform-cable-compatible-debrick-routers-modems-and-more.html), [Flyswatter 2](http://www.tincantools.com/JTAG/Flyswatter2.html), [JTAGulator](http://www.grandideastudio.com/portfolio/jtagulator/)) and supporting software (e.g., [OpenOCD](http://openocd.org)).
39+
- Logic Analyzer ([Saleae](https://www.saleae.com) are good for normal use, stick with an 8 channel to start)
40+
- Adjustable Power Supply
41+
- [YardStickOne](https://greatscottgadgets.com/yardstickone/)/[RFCat](http://int3.cc/products/rfcat)/[HackRF](https://greatscottgadgets.com/hackrf/)
42+
- Another laptop for bare Linux
43+
- [IDAPro](https://www.hex-rays.com/products/ida/)
4444

4545
(creative commons license)

hwinfo/README.md

+21-23
Original file line numberDiff line numberDiff line change
@@ -6,31 +6,29 @@ Developed as a community asset
66

77
This is meant to capture which protocol stack implementation is used in a variety of different ICS equipment vendors.
88

9-
ICS Vendor | Model | Stack Implementation | Protocols |
10-
-----------| ----- | -------------------- | --------- |
11-
ABB | ... | ... | ... |
12-
GE | ... | ... | ... |
13-
Honeywell | ... | ... | ... |
14-
S&C | ... | ... | ... |
15-
Schneider Electric | ... | ... | ... |
16-
SEL | ... | ... | ... |
17-
Siemens | ... | ... | ... |
18-
19-
20-
21-
## Processor and OS Information
9+
| ICS Vendor | Model | Stack Implementation | Protocols |
10+
| ------------------ | ----- | -------------------- | --------- |
11+
| ABB | ... | ... | ... |
12+
| GE | ... | ... | ... |
13+
| Honeywell | ... | ... | ... |
14+
| S&C | ... | ... | ... |
15+
| Schneider Electric | ... | ... | ... |
16+
| SEL | ... | ... | ... |
17+
| Siemens | ... | ... | ... |
18+
19+
## Processor and OS Information
2220

2321
This is meant to capture which CPU architecture and operating system is used in a variety of different ICS equipment vendors.
2422

25-
ICS Vendor | Model | CPU Architecture | Operating System |
26-
-----------| ----- | ---------------- | ---------------- |
27-
ABB | COM600 | x86 | Windows |
28-
ABB | REF615 | MPC82xx | VxWorks 5.5.X |
29-
ABB | RTU560 | TI am337x | VxWorks 6.9.X |
30-
SEL | All Relays | ... | ThreadX |
31-
SEL | 751 | MCF5445x | ThreadX |
32-
SEL | RTAC 3505 | ... | Linux |
33-
SEL | RTAC 3530 | ... | Linux |
34-
SEL | RTAC 3555 | x86 | Linux |
23+
| ICS Vendor | Model | CPU Architecture | Operating System |
24+
| ---------- | ---------- | ---------------- | ---------------- |
25+
| ABB | COM600 | x86 | Windows |
26+
| ABB | REF615 | MPC82xx | VxWorks 5.5.X |
27+
| ABB | RTU560 | TI am337x | VxWorks 6.9.X |
28+
| SEL | All Relays | ... | ThreadX |
29+
| SEL | 751 | MCF5445x | ThreadX |
30+
| SEL | RTAC 3505 | ... | Linux |
31+
| SEL | RTAC 3530 | ... | Linux |
32+
| SEL | RTAC 3555 | x86 | Linux |
3533

3634
(creative commons license)

0 commit comments

Comments
 (0)