Dokumentation

1. Authentifizierung: App-Passwörter

Die Identität der Orneos-Konten wird zentral über den OpenID-Connect-Anbieter von Orneos verwaltet. Zum Schutz des Hauptpassworts (das auch das Postfach @orneos.eu schützt) werden keine Geräteregistrierungs-Flows auf dem Cloud-Host verwendet.

Für den Zugriff auf die Cloud-APIs (WebDAV, OCS, CalDAV, CardDAV, Talk) aus Skripten, Serverdiensten oder Desktop-Clients erstellt der Nutzer unter https://app.orneos.eu/settings/user/security („Geräte & Sitzungen“) ein eigenes App-Passwort, das jederzeit einzeln widerrufen werden kann.

• HTTP-Basic-Authentifizierung: benutzername:app-passwort ausschließlich über HTTPS
• Senden Sie bei allen OCS-Aufrufen (/ocs/v2.php/...) den Pflicht-Header OCS-APIRequest: true
• Nutzen Sie ?format=json oder Accept: application/json für JSON-Antworten

2. Dateien (WebDAV)

Der Orneos-Drive-Speicher jedes Nutzers ist per WebDAV unter https://app.orneos.eu/remote.php/dav/files/<benutzername>/ erreichbar.

# Wurzelverzeichnis auflisten
curl -X PROPFIND -u "alice:APP_PASSWORD" \
  -H "Depth: 1" \
  https://app.orneos.eu/remote.php/dav/files/alice/

# Dokument hochladen
curl -X PUT -u "alice:APP_PASSWORD" \
  --data-binary @bericht.pdf \
  https://app.orneos.eu/remote.php/dav/files/alice/Documents/bericht.pdf

3. Cloud-Profil und Freigaben (OCS v2)

Über die OCS-v2-API fragen Sie den Speicherplatz ab und verwalten Freigabelinks in Orneos Drive.

# Kontingent abrufen
curl -u "alice:APP_PASSWORD" \
  -H "OCS-APIRequest: true" \
  "https://app.orneos.eu/ocs/v2.php/cloud/user?format=json"

# Öffentlichen Lese-Link erstellen (shareType=3)
curl -X POST -u "alice:APP_PASSWORD" \
  -H "OCS-APIRequest: true" \
  -d "path=/Documents/bericht.pdf&shareType=3&permissions=1" \
  "https://app.orneos.eu/ocs/v2.php/apps/files_sharing/api/v1/shares?format=json"

4. Kalender (CalDAV) und Kontakte (CardDAV)

Kalender und Adressbücher folgen den Standards CalDAV (RFC 4791) und CardDAV (RFC 6352) unter https://app.orneos.eu/remote.php/dav/.

• Principal-Discovery: https://app.orneos.eu/remote.php/dav/principals/users/<benutzername>/
• CalDAV-Kalender: https://app.orneos.eu/remote.php/dav/calendars/<benutzername>/<kalender>/
• CardDAV-Kontakte: https://app.orneos.eu/remote.php/dav/addressbooks/users/<benutzername>/contacts/

5. Orneos Meet / Talk (Räume und Nachrichten)

Erstellen Sie Videokonferenzräume oder senden Sie automatisierte Benachrichtigungen in Team-Unterhaltungen über die OCS-Talk-API.

# Unterhaltungen auflisten
curl -u "alice:APP_PASSWORD" \
  -H "OCS-APIRequest: true" \
  "https://app.orneos.eu/ocs/v2.php/apps/spreed/api/v4/room?format=json"

# Nachricht in Raum <token> senden
curl -X POST -u "alice:APP_PASSWORD" \
  -H "OCS-APIRequest: true" \
  -d "message=Deployment erfolgreich abgeschlossen." \
  "https://app.orneos.eu/ocs/v2.php/apps/spreed/api/v1/chat/ROOM_TOKEN?format=json"