docs: update for v0.15.0 (#59)

Author: cugu

docs/catalyst/admin/install.md

@@ -8,21 +8,18 @@ Catalyst is a self-hosted application.
 You can install it on your own server or use a cloud provider.
 
 The latest release can be found on the [GitHub releases page](https://github.com/SecurityBrewery/catalyst/releases).
-The releases contain binaries for Linux and macOS.
+The releases contain binaries for Linux, macOS, and Windows.
 
-Once you have downloaded the binary, and unpacked it, you can start Catalyst with `cataylst serve`.
+Once you have downloaded the binary, and unpacked it, 
+you can create an admin user with `./catalyst admin create admin@example.com mysecretpassword`.
 
-The console shows the server's admin UI URL, e.g. http://127.0.0.1:8090/_/.
-Open it and create an admin account.
+Run the server with `./catalyst serve`.
 
-In the admin UI create users which can then log in to the user interface at http://127.0.0.1:8090/.
+For Windows you can use `catalyst.exe` instead of `./catalyst`.
 
 ## Configuration
 
-At `Settings -> Application` you can configure the `Application URL` and set it to the URL where Catalyst is reachable.
-This is important for Python actions to work correctly.
+In the `Settings` you can configure the `App URL` and the `SMTP` settings for email notifications and Python actions to
+work correctly.
 
-## Going to production
-
-As Catalyst is based on PocketBase you can follow their
-[Going to production](https://pocketbase.io/docs/going-to-production/) guide.
+![Settings](/screenshots/settings.png)

docs/catalyst/admin/login.md

@@ -4,7 +4,7 @@ sidebar_position: 45
 
 # Ticket Types
 
-Ticket types can be configured in the [admin interface](login.md), in the `types` collection.
+Ticket types can be configured in when you are logged in as an admin or a user with the `type:write` permission.
 
 There are two default ticket types: `Alert` and `Incident`, but you can add more types to fit your organization's needs.
 

docs/catalyst/admin/types.md

@@ -14,8 +14,6 @@ The Python code is executed in the same environment as the Catalyst server,
 so be careful with the code you write and who has access to it.
 :::
 
-[![Reactions](/screenshots/reaction_action_python.png)](/screenshots/reaction_action_python.png)
-
 ## Event Data
 
 The Python action receives the event data from the trigger in the first argument.
@@ -36,18 +34,16 @@ print("id", ticket["record"]["id"])
 
 The Python action provides a temporary `CATALYST_TOKEN` environment variable that can be used to authenticate with the
 Catalyst API.
-It can be used in combination with the [PocketBase Python SDK](https://github.com/vaphes/pocketbase)
-to interact with the Catalyst API
+It can be used to interact with the Catalyst API
 
 ```python
 import os
 
-from pocketbase import PocketBase
+import requests
 
-# Connect to the PocketBase server
-client = PocketBase('http://127.0.0.1:8090')
-client.auth_store.save(token=os.environ["CATALYST_TOKEN"])
+url = os.environ["CATALYST_APP_URL"]
+header = {"Authorization": "Bearer " + os.environ["CATALYST_TOKEN"]}
 
 # Get users
-users = client.collection("users").get_list(1, 200)
+users = requests.get(url + "/api/users", headers=header).json()
 ```

docs/catalyst/admin/users.md

@@ -4,5 +4,6 @@ sidebar_position: 20
 
 # HTTP / Webhook
 
-
-[![Reactions](/screenshots/reaction_action_webhook.png)](/screenshots/reaction_action_webhook.png)
+The HTTP/Webhook action allows you to send an HTTP request to a webhook URL.
+This action is useful when you want to notify an external system about an event that occurred in Catalyst
+(e.g. a new ticket was created, a ticket was updated, etc.).

docs/catalyst/admin/webhooks.md

@@ -16,21 +16,20 @@ import json
 import random
 import os
 
-from pocketbase import PocketBase
+import requests
 
 # Parse the ticket from the input
 ticket = json.loads(sys.argv[1])
 
-# Connect to the PocketBase server
-client = PocketBase('http://127.0.0.1:8090')
-client.auth_store.save(token=os.environ["CATALYST_TOKEN"])
+url = os.environ["CATALYST_APP_URL"]
+header = {"Authorization": "Bearer " + os.environ["CATALYST_TOKEN"]}
 
 # Get a random user
-users = client.collection("users").get_list(1, 200)
-random_user = random.choice(users.items)
+users = requests.get(url + "/api/users", headers=header).json()
+random_user = random.choice(users)
 
 # Assign the ticket to the random user
-client.collection("tickets").update(ticket["record"]["id"], {
-	"owner": random_user.id,
+requests.patch(url + "/api/tickets/" + ticket["record"]["id"], headers=header, json={
+    "owner": random_user["id"]
 })
 ```

docs/catalyst/engineer/reaction/action/python.md

@@ -4,7 +4,7 @@ sidebar_position: 5
 
 # Ingest Alerts
 
-This example demonstrates how to ingest alerts from a webhook into a PocketBase collection.
+This example demonstrates how to ingest alerts from a webhook.
 
 The trigger for this example is a [webhook trigger](../trigger/webhook.md) that receives alerts from an external system. 
 The webhook trigger passes a JSON event to the [Python action](../action/python.md) that contains the alert data.
@@ -15,20 +15,19 @@ import sys
 import json
 import os
 
-from pocketbase import PocketBase
+import requests
 
 # Parse the event from the webhook payload
 event = json.loads(sys.argv[1])
 body = json.loads(event["body"])
 
-# Connect to the PocketBase server
-client = PocketBase('http://127.0.0.1:8090')
-client.auth_store.save(token=os.environ["CATALYST_TOKEN"])
+url = os.environ["CATALYST_APP_URL"]
+header = {"Authorization": "Bearer " + os.environ["CATALYST_TOKEN"]}
 
 # Create a new ticket
-client.collection("tickets").create({
-	"name": body["name"],
-	"type": "alert",
-	"open": True,
+requests.post(url + "/api/tickets", headers=header, json={
+    "name": body["name"],
+    "type": "alert",
+    "open": True,
 })
 ```

docs/catalyst/engineer/reaction/action/webhook.md

@@ -24,4 +24,4 @@ The trigger listens for events and the action is executed when the trigger is ac
 ## Examples
 
 - [Assign new tickets to random users](./examples/assign_ticket): Assign new tickets to random users.
-- [Ingest alerts](./examples/ingest_alerts): Ingest alerts from a webhook into a PocketBase collection.
+- [Ingest alerts](./examples/ingest_alerts): Ingest alerts from a webhook.