diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 63124c53..1003d225 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -15,12 +15,64 @@ You may run the tests as follows from your local copy of the repository: ### Building the project -You may build the project and generate the JAR as follows from your local copy of the repository: -
- $ mvn package
-
+#### Prerequisites
+
+Building AuthzForce Core requires:
+
+* JDK 17 or later;
+* [Apache Maven](https://maven.apache.org/);
+* an [NVD API key](https://nvd.nist.gov/developers/request-an-api-key) for the OWASP Dependency-Check vulnerability scan;
+* a [Sonatype Guide personal access token](https://help.sonatype.com/en/manage-guide-user-tokens.html) for the OSS Index vulnerability scan.
+
+The API key and personal access token are required only for the complete verification lifecycle. They are not required for a regular `mvn package` build.
+
+#### Environment setup
+
+Configure the NVD API key and Sonatype Guide token in your Maven `~/.m2/settings.xml`:
+
+```xml
+