SQL erweitert und Bruno hinzugefügt

2026-07-06 11:32:17 +02:00
parent 488426b1aa
commit eec5516e14
10 changed files with 426 additions and 0 deletions
@@ -0,0 +1,85 @@
+# Bruno: Session zur i-doit aufbauen
+
+In Bruno bekommst du eine "Session" über eine Kombination aus **Environment-Variablen** und dem **API-Key-Login von i-doit**. i-doit selbst nutzt keine klassischen Cookie-Sessions für die JSON-RPC-API, sondern authentifiziert jeden Request per Header – der "Session-Charakter" kommt also über gespeicherte Variablen, die alle Requests teilen.
+
+## 1. Environment anlegen
+
+Anlegen eines Environment `demo-idoit` mit:
+
+```
+base_url:   https://demo.i-doit.com/src/jsonrpc.php
+apikey:     c1ia5q
+username:   admin
+password:   admin
+```
+
+![](idoit01.png)
+
+![](idoit02.png)
+
+
+## 2. Login-Request (holt die Session-ID)
+
+i-doit unterstützt eine echte Session über `idoit.login`. Der Response liefert einen `X-RPC-Auth-Session`-Header, den du für Folge-Requests wiederverwendest.
+
+**POST** `{{base_url}}`
+
+Headers:
+
+```
+Content-Type: application/json
+X-RPC-Auth-Username: {{username}}
+X-RPC-Auth-Password: {{password}}
+```
+
+![](idoit03.png)
+
+
+Body (JSON):
+
+```json
+{
+  "version": "2.0",
+  "method": "idoit.login",
+  "params": { "apikey": "{{apikey}}" },
+  "id": 1
+}
+```
+
+Im **Script → Post Response** die Session-ID in eine Variable schreiben:
+
+```javascript
+bru.setEnvVar("session_id", res.getHeader("x-rpc-auth-session"));
+```
+
+## 3. Folge-Requests mit der Session
+
+Alle weiteren Requests nutzen dann statt Username/Passwort nur noch:
+
+```
+Content-Type: application/json
+X-RPC-Auth-Session: {{session_id}}
+```
+
+Body z. B. für eine Objektabfrage:
+
+```json
+{
+  "version": "2.0",
+  "method": "cmdb.objects.read",
+  "params": { "apikey": "{{apikey}}", "filter": { "type": 5 } },
+  "id": 1
+}
+```
+
+## 4. Logout (optional)
+
+```json
+{ "version": "2.0", "method": "idoit.logout", "params": { "apikey": "{{apikey}}" }, "id": 1 }
+```
+
+mit Header `X-RPC-Auth-Session: {{session_id}}`.
+
+---
+
+**Kernpunkt:** Die Session-ID aus dem Login-Response wird per Post-Response-Script als Environment-Variable gespeichert und von allen Requests im selben Environment geteilt. Damit sparst du dir den Login-Roundtrip pro Abfrage und hast quasi eine durchgehende Session.