Skip to content

Commit c7850ed

Browse files
authored
all pages now have some content
2 parents a2e4de9 + 89b486d commit c7850ed

30 files changed

+497
-453
lines changed

.wordlist.txt

Lines changed: 41 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -429,3 +429,44 @@ enum
429429
intel
430430
subcommand
431431
subcommands
432+
kubernetes
433+
modularized
434+
ChartMuseum
435+
CMS
436+
CMSeeK
437+
Joomla
438+
WPScan
439+
Wordpress
440+
Kube
441+
Kubeaudit
442+
doggo
443+
Ncrack
444+
bruteforcing
445+
Nmap
446+
Whatweb
447+
Gitleaks
448+
Semgrep
449+
SSLyze
450+
ffuf
451+
Nikto
452+
Screenshooter
453+
OpenAPI
454+
Trivy
455+
scalable
456+
JSR
457+
Keyczar
458+
Tink
459+
Shiro
460+
OSS
461+
Sonatype
462+
DotNet
463+
HAPI
464+
NodeJS
465+
hsecscan
466+
SecurityHeaders
467+
Recx
468+
testssl
469+
DrHEADer
470+
csp
471+
DocX
472+
MOBI

_data/draft.yaml

Lines changed: 5 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -190,33 +190,24 @@ docs:
190190
- title: '6.2.1 Zed Attack Proxy'
191191
url: verification/tools/zed_attack_proxy
192192

193-
- title: '6.2.2 Code Pulse'
194-
url: verification/tools/code_pulse
195-
196-
- title: '6.2.3 Amass'
193+
- title: '6.2.2 Amass'
197194
url: verification/tools/amass
198195

199-
- title: '6.2.4 Offensive Web Testing Framework'
196+
- title: '6.2.3 Offensive Web Testing Framework'
200197
url: verification/tools/offensive_web_testing_framework
201198

202-
- title: '6.2.5 Nettacker'
199+
- title: '6.2.4 Nettacker'
203200
url: verification/tools/nettacker
204201

205-
- title: '6.2.6 OWASP Secure Headers Project'
202+
- title: '6.2.5 OWASP Secure Headers Project'
206203
url: verification/tools/secure_headers
207204

208205
- title: '6.3 Frameworks'
209206
url: verification/frameworks
210207

211-
- title: '6.3.1 Glue'
212-
url: verification/frameworks/glue
213-
214-
- title: '6.3.2 secureCodeBox'
208+
- title: '6.3.1 secureCodeBox'
215209
url: verification/frameworks/secure_codebox
216210

217-
- title: '6.3.3 Dracon'
218-
url: verification/frameworks/dracon
219-
220211
- title: '6.4 Vulnerability management'
221212
url: verification/vulnerability_management
222213

contributing.md

Lines changed: 24 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -2,10 +2,11 @@
22

33
### Contributing
44

5-
The Developer Guide needs to be updated for the modern security landscape,
6-
and OWASP is reviving this project to do just that.
7-
The project has a team of leaders that will oversee the project
8-
and now we need as many members of the security community as possible to contribute.
5+
The Developer Guide has been updated for the modern security landscape,
6+
concentrating less on covering everything in one document and more on introducing a subject/project
7+
and then suggesting where more in-depth information can be found.
8+
The project has a team of leaders that oversee the project
9+
and contributions from members of the security community are positively encouraged.
910

1011
All contributions and suggestions are certainly welcome, and we ask that
1112
you follow the [contributing code of conduct][conduct].
@@ -38,13 +39,13 @@ and keeps track of progress towards each milestone.
3839
### Style Guide
3940

4041
The Developer Guide will have many contributors, and it is an aim to keep the style of writing similar throughout.
41-
It would be good to keep to a style used in OWASP flagship projects [ASVS][asvs] and [WSTG][wstg],
42+
Follow the style used in OWASP flagship projects [ASVS][asvs] and [WSTG][wstg],
4243
which is speaking from first person plural and semi-formal in tone.
4344

4445
### Technical level
4546

4647
Generally the guide is aimed at the introductory to medium technical levels,
47-
and should rarely deal with a subject at an advanced level.
48+
and should rarely deal with any subject at an advanced level.
4849
This is a deliberate policy that makes the guide accessible and keeps the length reasonable.
4950

5051
The overview/introduction of the main sections should be aimed at the introductory level,
@@ -54,13 +55,24 @@ instead provide links to these specialist security knowledge bases.
5455

5556
### Page structure
5657

57-
Each sub-section should deal with one specific subject, for example 'Threat modeling' or 'Digests'.
58-
The sub-sections ideally follow the same structure:
58+
Each sub-section should deal with one specific subject, for example 'Threat modeling',
59+
or a single project such as the OWASP 'Threat Dragon' Builder/Tool project.
5960

60-
1. Overview, summarising the subject at an introductory level
61-
2. Main body, explaining the subject to a medium/general level
62-
3. Further reading, providing links to the subject at an advanced/detailed level
63-
4. Resources, providing links to tools and applications that may be used when working within this domain
61+
Sub-sections that describe an individual project should follow the same structure:
62+
63+
1. Introduction, summarising the project at a very high level:
64+
_supply a couple of sentences on the project including its status as an OWASP project and where to find it_
65+
2. The 'What', explaining what the project is to a general level:
66+
_go into more detail about the project so that a developer can gain an overview of what this project can provide for them_
67+
3. The 'Why', explaining why developers will want to use the project:
68+
_provide more context for project that allows developers to determine whether to use it in their team_
69+
4. The 'How', describe how to get started with the project
70+
_give a brief outline of how the project provides value for a web application development team_
71+
_Do not repeat the project documentation itself; ideally provide a primer and a pointer to the project documentation_
72+
5. Further reading or resources, if any, providing links on the project at an advanced/detailed level
73+
74+
Note that the page describing a project should not be the same as the project documentation on the OWASP site,
75+
the Developer Guide should strive to be a ' TL;DR ' for the project running to one or maybe two pages.
6476

6577
### Pull requests
6678

draft/02-toc.md

Lines changed: 5 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -82,15 +82,12 @@ permalink:
8282
6.1.3 [Application Security Verification Standard](#application-security-verification-standard)
8383
6.2 [Tools](#verification-tools)
8484
6.2.1 [Zed Attack Proxy](#zed-attack-proxy)
85-
6.2.2 [Code Pulse](#code-pulse)
86-
6.2.3 [Amass](#amass)
87-
6.2.4 [Offensive Web Testing Framework](#offensive-web-testing-framework)
88-
6.2.5 [Nettacker](#nettacker)
89-
6.2.6 [OWASP Secure Headers Project](#secure-headers-project)
85+
6.2.2 [Amass](#amass)
86+
6.2.3 [Offensive Web Testing Framework](#offensive-web-testing-framework)
87+
6.2.4 [Nettacker](#nettacker)
88+
6.2.5 [OWASP Secure Headers Project](#secure-headers-project)
9089
6.3 [Frameworks](#verification-frameworks)
91-
6.3.1 [Glue](#glue)
92-
6.3.2 [secureCodeBox](#securecodebox)
93-
6.3.3 [Dracon](#dracon)
90+
6.3.1 [secureCodeBox](#securecodebox)
9491
6.4 [Vulnerability management](#verification-vulnerability-management)
9592
6.4.1 [DefectDojo](#defectdojo)
9693
6.5 [Verification Do's and Don'ts](#verification-dos-and-donts)

draft/03-introduction.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -49,8 +49,8 @@ Application developers should try to be familiar with the entire guide;
4949
it is far harder to write solid applications than to destroy them.
5050

5151
You can regard the purpose of this guide as answering the question:
52-
“I am a developer and I need a reference source to navigate the numerous projects
53-
and describe the security activities I really should be doing
52+
“I am a developer and I need a reference guide to describe the security activities I really should be doing
53+
and to navigate the numerous security tools and projects
5454

5555
Or you can regard this guide as a companion document to the OWASP [Application Wayfinder][wayfinder] project:
5656
the Wayfinder maps out the many OWASP tools, projects and documents with the Developer Guide providing some context.

draft/04-foundations/02-secure-development.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -76,7 +76,7 @@ There are many OWASP tools and resources to help build security into the SDLC.
7676
100% include in every project" and this is certainly good advice. Implementing these controls can provide
7777
a high degree of confidence that the application or system will be reasonably secure.
7878
OWASP provides two libraries that can be incorporated in web applications,
79-
the [Enterprise Security API (ESAPI)][esapi] security control library
79+
the [Enterprise Security API (ESAPI)][esapi-project] security control library
8080
and [CSRFGuard][csrfguard] to mitigate the risk of Cross-Site Request Forgery (CSRF) attacks,
8181
that help implement these proactive controls. In addition the OWASP [Cheat Sheet Series][cheatproject]
8282
is a valuable source of information and advice on all aspects of applications security.
@@ -160,7 +160,7 @@ There are many OWASP tools and resources to help build security into the SDLC.
160160
* [CSRFGuard library][csrfguard]
161161
* [Dependency-Check Software Composition Analysis (SCA)][depcheck]
162162
* [Dependency-Track Continuous SBOM Analysis Platform][deptrack]
163-
* [Enterprise Security API][esapi] (ESAPI)
163+
* [Enterprise Security API][esapi-project] (ESAPI)
164164
* [Integration Standards project Application Wayfinder][wayfinder]
165165
* [Mobile Application Security][mas] (MAS)
166166
* [Pythonic Threat Modeling][pytm]
@@ -186,7 +186,7 @@ then [submit an issue][issue0402] or [edit on GitHub][edit0402].
186186
[devsecops]: https://owasp.org/www-project-devsecops-guideline/
187187
[dojo]: https://www.defectdojo.org/
188188
[edit0402]: https://github.com/OWASP/www-project-developer-guide/blob/main/draft/04-foundations/02-secure-development.md
189-
[esapi]: https://owasp.org/www-project-enterprise-security-api/
189+
[esapi-project]: https://owasp.org/www-project-enterprise-security-api/
190190
[github]: https://github.com/
191191
[gitlab]: https://about.gitlab.com/
192192
[issue0402]: https://github.com/OWASP/www-project-developer-guide/issues/new?labels=enhancement&template=request.md&title=Update:%2004-foundations/02-secure-development

draft/06-design/01-threat-modeling/04-cornucopia.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -38,7 +38,7 @@ Cornucopia provides a [score sheet][cornucopia-score] to help keep track of the
3838
To provide context each card in the Cornucopia deck references other OWASP projects:
3939

4040
* Application Security Verification Standard ([ASVS][asvs])
41-
* Secure Coding Practices ([SCP][scp])
41+
* Secure Coding Practices ([SCP][scp-v21]]) Quick Reference Guide
4242
* [AppSensor][appsensor]
4343

4444
The SCP has now been incorporated into the now part of the [Developer Guide](../02-web-app-checklist/toc.md)
@@ -89,7 +89,7 @@ then [submit an issue][issue060104] or [edit on GitHub][edit060104].
8989
[cornucopia-play]: https://owasp.org/www-project-cornucopia#div-play
9090
[edit060104]: https://github.com/OWASP/www-project-developer-guide/blob/main/draft/06-design/01-threat-modeling/04-cornucopia.md
9191
[issue060104]: https://github.com/OWASP/www-project-developer-guide/issues/new?labels=content&template=request.md&title=Update:%2006-design/01-threat-modeling/04-cornucopia
92-
[scp]: https://owasp.org/www-project-secure-coding-practices-quick-reference-guide/assets/docs/OWASP_SCP_Quick_Reference_Guide_v21.pdf
92+
[scp-v21]: https://owasp.org/www-project-secure-coding-practices-quick-reference-guide/assets/docs/OWASP_SCP_Quick_Reference_Guide_v21.pdf
9393
[spotlight16]: https://youtu.be/NesxjEGX58s
9494

9595
\newpage

draft/07-implementation/01-documentation/02-go-scp.md

Lines changed: 48 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
title: Go Secure Coding Practices
44
layout: col-document
55
tags: OWASP Developer Guide
6-
contributors:
6+
contributors: Jon Gadsden
77
document: OWASP Developer Guide
88
order: 712
99
permalink: /draft/implementation/documentation/go_scp/
@@ -14,32 +14,63 @@ permalink: /draft/implementation/documentation/go_scp/
1414

1515
### 5.1.2 Go Secure Coding Practices
1616

17-
To Do: supply a couple of sentences on the OWASP Go Secure Coding Practices (SCP) documentation project,
18-
including its status as an OWASP project and where to find it.
17+
The OWASP Go Secure Coding Practices (Go-SCP) is a set of software secure coding practices for Go.
1918

20-
#### What is Go SCP?
19+
The Go-SCP [documentation project][go-scp-project] is an OWASP Incubator Project
20+
that has enough long term support to achieve Lab status soon.
21+
The document can be [downloaded in various formats][go-scp-download] from the github repo.
2122

22-
To Do: go into more detail about the Go SCP project so that a developer
23-
can gain an overview of what this documentation project can provide for them.
23+
#### What is Go-SCP?
2424

25-
#### Why use Go SCP?
25+
Go-SCP provides examples and recommendations to help developers avoid common mistakes and pitfalls,
26+
including code examples in Go that provide practical guidance on implementing the recommendations.
27+
Go-SCP covers the OWASP [Secure Coding Practices Quick Reference Guide][scp-qrf] topic-by-topic:
2628

27-
To Do: provide more context for Go SCP that allows developers to determine whether to use it in their project.
29+
* Input Validation
30+
* Sanitization Output Encoding
31+
* Authentication and Password Management
32+
* Session Management
33+
* Access Control
34+
* Cryptographic Practices
35+
* Error Handling and Logging
36+
* Data Protection
37+
* Communication Security
38+
* System Configuration
39+
* Database Security
40+
* File Management
41+
* Memory Management
42+
* General Coding Practices
2843

29-
#### How to apply Go SCP
44+
The [Go Secure Coding Practices][go-scp-project] book is available in various formats:
3045

31-
To Do: give a brief outline of how applying the Go SCP project provides value for a development team.
32-
Do not repeat the project documentation itself; ideally provide a primer and a pointer to the documentation.
46+
* PDF
47+
* ePub
48+
* DocX
49+
* MOBI
3350

34-
----
51+
#### Why use Go-SCP?
3552

36-
![Developer Guide](../../../assets/images/dg_wip.png "OWASP Developer Guide")
53+
Development teams often need help and support in getting the security right for web applications,
54+
and part of this help comes from secure coding guidelines and best practices.
55+
Go-SCP provides this guidance for a wide range of secure coding topics as well as providing practical code examples.
3756

38-
The OWASP Developer Guide is a community effort and this page needs some content to be added.
39-
If you have suggestions then [submit an issue][issue070102] and the project team can assign it to you,
40-
or provide new content [direct on GitHub][edit070102].
57+
#### How to use Go-SCP?
58+
59+
The primary audience of the Go Secure Coding Practices Guide is developers,
60+
particularly the ones with previous experience with other programming languages.
61+
62+
Download the [Go-SCP document][go-scp-download] in one of the formats: PDF, ePub, DocX and MOBI.
63+
Refer to the specific topic chapter and then use the example Go code snippets for practical guidance on secure coding in Go.
64+
65+
----
66+
67+
The OWASP Developer Guide is a community effort; if there is something that needs changing
68+
then [submit an issue][issue070102] or [edit on GitHub][edit070102].
4169

42-
[issue070102]: https://github.com/OWASP/www-project-developer-guide/issues/new?labels=content&template=request.md&title=Update:%2007-implementation/01-documentation/02-go-scp
4370
[edit070102]: https://github.com/OWASP/www-project-developer-guide/blob/main/draft/07-implementation/01-documentation/02-go-scp.md
71+
[go-scp-download]: https://github.com/OWASP/Go-SCP/tree/master/dist
72+
[go-scp-project]: https://owasp.org/www-project-go-secure-coding-practices-guide/
73+
[issue070102]: https://github.com/OWASP/www-project-developer-guide/issues/new?labels=content&template=request.md&title=Update:%2007-implementation/01-documentation/02-go-scp
74+
[scp-qrf]: https://owasp.org/www-project-secure-coding-practices-quick-reference-guide/
4475

4576
\newpage

0 commit comments

Comments
 (0)