Skip to content

Commit 2acfc35

Browse files
authored
Merge pull request #201 from secvisogram/fix/#199-read.me
Fix #199 README.md
2 parents 530c592 + 6e4e1f8 commit 2acfc35

File tree

5 files changed

+437
-9
lines changed

5 files changed

+437
-9
lines changed
Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,19 @@
1+
# Licensed to the Apache Software Foundation (ASF) under one
2+
# or more contributor license agreements. See the NOTICE file
3+
# distributed with this work for additional information
4+
# regarding copyright ownership. The ASF licenses this file
5+
# to you under the Apache License, Version 2.0 (the
6+
# "License"); you may not use this file except in compliance
7+
# with the License. You may obtain a copy of the License at
8+
#
9+
# http://www.apache.org/licenses/LICENSE-2.0
10+
#
11+
# Unless required by applicable law or agreed to in writing,
12+
# software distributed under the License is distributed on an
13+
# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
14+
# KIND, either express or implied. See the License for the
15+
# specific language governing permissions and limitations
16+
# under the License.
17+
wrapperVersion=3.3.2
18+
distributionType=only-script
19+
distributionUrl=https://repo.maven.apache.org/maven2/org/apache/maven/apache-maven/3.9.9/apache-maven-3.9.9-bin.zip

README.md

Lines changed: 9 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -42,7 +42,7 @@ only required to manage documents on the server or validate against the
4242
To build the application run:
4343

4444
```shell
45-
./mvn package
45+
./mvnw package
4646
```
4747

4848
The resulting jar file in the `target` folder can then be run with
@@ -129,7 +129,7 @@ only and should not be used in production.
129129

130130
- run `docker compose up`
131131
- After Keycloak is up, open a second terminal window and run
132-
`docker compose up csaf-keycloak-cli` to import a realm with all the users
132+
`docker compose up keycloak-cli` to import a realm with all the users
133133
and roles already set up.
134134
- To set up our CouchDB server open `http://127.0.0.1:5984/_utils/#/setup`
135135
and run the [Single Node Setup](https://docs.couchdb.org/en/stable/setup/single-node.html). This creates databases like **_users** and stops CouchDB from spamming our logs (Admin credentials from .env)
@@ -140,7 +140,7 @@ only and should not be used in production.
140140
- On the left side, navigate to "Clients" and select the Secvisogram client.
141141
- Select the **Credentials** tab and copy the Secret. This is our
142142
`CSAF_CLIENT_SECRET` environment variable.
143-
- [Generate a cookie secret](https://oauth2-proxy.github.io/oauth2-proxy/docs/configuration/overview/#generating-a-cookie-secret)
143+
- [Generate a cookie secret](https://oauth2-proxy.github.io/oauth2-proxy/configuration/overview#generating-a-cookie-secret)
144144
and paste it in `CSAF_COOKIE_SECRET`.
145145
- restart compose
146146
- (required for exports) install [pandoc (tested with version 2.18)](https://pandoc.org/installing.html)
@@ -154,6 +154,7 @@ response from the server.
154154

155155
You should now be able to access Secvisogram, navigate to `http://localhost/`.
156156
There are the following default users:
157+
157158
|User |Password |Roles |
158159
|----- |-------- |----- |
159160
|registered |registered |**registered** |
@@ -178,12 +179,12 @@ When hostnames are changed, this has to adapted.
178179

179180
### build and execute tests
180181

181-
./mvnw clean verify
182+
`` ./mvnw clean verify``
182183

183184

184185
### start application
185186

186-
./mvnw spring-boot:run
187+
`` ./mvnw spring-boot:run``
187188

188189
with main class: de.bsi.secvisogram.csaf_cms_backend.SecvisogramApplication
189190

@@ -199,7 +200,7 @@ http://localhost:8081/swagger-ui/index.html
199200

200201
OpenAPI specification
201202

202-
http://localhost:8081/api-docs/
203+
http://localhost:8081/api-docs
203204

204205
### access couchDB
205206

@@ -221,10 +222,10 @@ You can find our guidelines here [CONTRIBUTING.md](https://github.com/secvisogra
221222

222223
### Check for Maven Plugin update
223224

224-
`` mvn versions:display-plugin-updates ``
225+
`` ./mvnw versions:display-plugin-updates ``
225226

226227
## Check for dependency update
227-
`` mvn versions:display-dependency-updates `
228+
`` ./mvnw versions:display-dependency-updates ``
228229

229230
### Spring Boot
230231

mvnw

Lines changed: 259 additions & 0 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

0 commit comments

Comments
 (0)