Readme docs - followup PR

[paulOsinski]

Addresses @cneill 's comments on my previous PR here #11516 (review)

• Before we merge, waiting to see what to do with this comment: https://github.com/DefectDojo/django-DefectDojo/pull/11516/files/59ee1d28455a9da0ea2ad06886a3c64f9f1ac272#r1905969636

[dryrunsecurity]

DryRun Security Summary

The pull request updates DefectDojo's documentation, enables LDAP authentication, and improves API documentation while maintaining security best practices.

Expand for full summary

Summary:

The code changes in this pull request primarily focus on updating the documentation and enabling LDAP authentication in the DefectDojo application. The changes do not introduce any obvious security vulnerabilities and follow standard practices for integrating LDAP authentication in a Django-based web application.

The key updates include:

1. Modifying the README.md file to update a link for the "Upgrade to DefectDojo Pro" section.
2. Updating the API v2 documentation to use the OpenAPI 3 specification and provide guidance on authentication methods.
3. Enabling LDAP authentication by modifying Dockerfiles, requirements.txt, and the local_settings.py file, as well as providing support for configuring LDAP settings through environment variables.

From an application security perspective, these changes are generally positive, as they improve the documentation, align the API documentation with industry standards, and provide a secure way to integrate LDAP authentication. However, it is crucial to ensure that the LDAP-related configuration, such as the server URI, bind DN, and bind password, are properly secured and not exposed in the codebase or deployment environment.

Files Changed:

1. README.md: The link for the "Upgrade to DefectDojo Pro" section has been updated.
2. docs/content/en/open_source/api-v2-docs.md: The documentation for the DefectDojo API v2 has been updated to use the OpenAPI 3 specification and provide guidance on authentication methods.
3. docs/content/en/open_source/ldap-authentication.md: Changes have been made to enable LDAP authentication in the DefectDojo application, including modifications to Dockerfiles, requirements.txt, and the local_settings.py file, as well as support for configuring LDAP settings through environment variables.

Code Analysis

We ran 9 analyzers against 3 files and 0 analyzers had findings. 9 analyzers had no findings.

View PR in the DryRun Dashboard.

[github-actions]

This pull request has conflicts, please resolve those before we can evaluate the pull request.

[github-actions]

Conflicts have been resolved. A maintainer will review the pull request shortly.

[mtesauro]

Approved