fix(calendar): TZID Europe/Berlin for timed events/tasks, resolve real resource href on delete/update, fix _report_tasks XML; sync deployed servers (owamail, openwearables, ghostfolio), docs and tests
This commit is contained in:
1 parent
7c01e7be53
commit
75185ef2ba
41 files changed
+8834
-324
No files matched your search
@@ -0,0 +1,295 @@
|
||||
"""Shared OWA (Exchange) JSON-API client for the BBS mailbox (Kati).
|
||||
|
||||
Used by the mail MCP server (server.py) and by the calendar fetcher
|
||||
(/opt/owa-kati-calendar/owa_fetch.py).
|
||||
|
||||
Exchange 2019 (S25-EXCHANGE) with classic OWA form login under
|
||||
https://bbsbex.bbsb.org/owa/. EWS basic auth is disabled (401), so access
|
||||
goes through the OWA form flow with an HTTP session and the internal
|
||||
OWA JSON API (/owa/service.svc?action=...).
|
||||
|
||||
HARTE REGEL (lockout protection): exactly ONE login attempt per process.
|
||||
On any login failure the caller aborts immediately, no retry, so Kati's work
|
||||
password is never locked by automatic repetitions.
|
||||
"""
|
||||
|
||||
import os
|
||||
import re
|
||||
import time
|
||||
import urllib.parse
|
||||
|
||||
import requests
|
||||
|
||||
OWA_BASE = os.environ.get("OWA_BASE", "https://bbsbex.bbsb.org/owa").rstrip("/")
|
||||
AUTH_FILE = os.environ.get(
|
||||
"OWA_AUTH_FILE", "/opt/mcp-servers/owamail/auth.txt"
|
||||
)
|
||||
LOGIN_URL = OWA_BASE + "/auth.owa"
|
||||
SERVICE_URL = OWA_BASE + "/service.svc"
|
||||
SESSION_MAX_AGE_S = 600 # 10 min, then a fresh login
|
||||
|
||||
|
||||
class OWASessionError(Exception):
|
||||
"""Session expired / login failed."""
|
||||
|
||||
|
||||
_DISTINGUISHED = {
|
||||
"msgfolderroot", "inbox", "sentitems", "drafts", "deleteditems",
|
||||
"junkemail", "outbox", "calendar", "contacts", "tasks", "notes",
|
||||
"journal", "searchfolders",
|
||||
}
|
||||
|
||||
_FOLDER_ALIASES = {
|
||||
"posteingang": "inbox",
|
||||
"inbox": "inbox",
|
||||
"gesendet": "sentitems",
|
||||
"sent": "sentitems",
|
||||
"gesendete objekte": "sentitems",
|
||||
"entwürfe": "drafts",
|
||||
"entwuerfe": "drafts",
|
||||
"drafts": "drafts",
|
||||
"gelöschte objekte": "deleteditems",
|
||||
"geloeschte objekte": "deleteditems",
|
||||
"papierkorb": "deleteditems",
|
||||
"deleted": "deleteditems",
|
||||
"junk": "junkemail",
|
||||
"spam": "junkemail",
|
||||
}
|
||||
|
||||
|
||||
def load_creds(auth_file: str = AUTH_FILE):
|
||||
with open(auth_file) as f:
|
||||
data = {}
|
||||
for line in f:
|
||||
line = line.strip()
|
||||
if "=" in line and not line.startswith("#"):
|
||||
k, v = line.split("=", 1)
|
||||
data[k.strip()] = v.strip()
|
||||
return data.get("BBS_USER", ""), data.get("BBS_PASSWORD", "")
|
||||
|
||||
|
||||
def new_session() -> requests.Session:
|
||||
s = requests.Session()
|
||||
s.headers.update({
|
||||
"User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 "
|
||||
"(KHTML, like Gecko) Chrome/120.0 Safari/537.36",
|
||||
"Accept": "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8",
|
||||
})
|
||||
return s
|
||||
|
||||
|
||||
class OWAClient:
|
||||
"""OWA JSON-API client with a single-process session cache."""
|
||||
|
||||
def __init__(self, base: str = OWA_BASE, auth_file: str = AUTH_FILE,
|
||||
session_max_age: int = SESSION_MAX_AGE_S):
|
||||
self.base = base.rstrip("/")
|
||||
self.auth_file = auth_file
|
||||
self.session_max_age = session_max_age
|
||||
self._session = None
|
||||
self._session_ts = 0.0
|
||||
|
||||
# ------------------------------------------------------------------
|
||||
# Login (lockout protection: EXACTLY ONE attempt)
|
||||
# ------------------------------------------------------------------
|
||||
|
||||
def login(self) -> str:
|
||||
"""Exactly ONE login attempt. Aborts immediately on failure, no retry."""
|
||||
user, password = load_creds(self.auth_file)
|
||||
if not user or not password:
|
||||
return f"Fehler: BBS-Credentials fehlen in {self.auth_file}"
|
||||
|
||||
s = new_session()
|
||||
login_url = self.base + "/auth.owa"
|
||||
try:
|
||||
r = s.get(login_url, timeout=30)
|
||||
r.raise_for_status()
|
||||
fields = {
|
||||
"destination": self.base,
|
||||
"flags": "4",
|
||||
"forcedownlevel": "0",
|
||||
"isUtf8": "1",
|
||||
"username": user,
|
||||
"password": password,
|
||||
"passwordText": "",
|
||||
}
|
||||
r2 = s.post(login_url, data=fields, allow_redirects=True, timeout=30)
|
||||
cookie_names = [c.name for c in s.cookies]
|
||||
# Exchange 2019 sets X-OWA-CANARY + X-BackEndCookie on success,
|
||||
# not an 'OWASession' cookie. These two are the success criterion.
|
||||
has_session_cookie = (
|
||||
"X-OWA-CANARY" in cookie_names and "X-BackEndCookie" in cookie_names
|
||||
)
|
||||
if has_session_cookie:
|
||||
self._session = s
|
||||
self._session_ts = time.time()
|
||||
return "LOGIN_OK"
|
||||
if r2.status_code == 200 and "logon.aspx" in r2.url:
|
||||
return ("LOGIN_FEHLGESCHLAGEN: OWA-Login abgelehnt (falsche "
|
||||
"Zugangsdaten oder Konto gesperrt). Kein Retry.")
|
||||
return (
|
||||
"LOGIN_FEHLGESCHLAGEN: Keine OWA-Session gesetzt "
|
||||
f"(Status {r2.status_code}, Cookies: {cookie_names}). Kein Retry."
|
||||
)
|
||||
except Exception as e:
|
||||
return f"LOGIN_FEHLGESCHLAGEN: {e}"
|
||||
|
||||
def ensure_session(self) -> str:
|
||||
if self._session is None:
|
||||
return self.login()
|
||||
if time.time() - self._session_ts > self.session_max_age:
|
||||
self._session = None
|
||||
return self.login()
|
||||
return "LOGIN_OK"
|
||||
|
||||
def session(self) -> requests.Session:
|
||||
res = self.ensure_session()
|
||||
if res != "LOGIN_OK":
|
||||
raise OWASessionError(res)
|
||||
return self._session
|
||||
|
||||
# ------------------------------------------------------------------
|
||||
# OWA JSON-API
|
||||
# ------------------------------------------------------------------
|
||||
|
||||
@staticmethod
|
||||
def header(server_version: str = "Exchange2013") -> dict:
|
||||
return {
|
||||
"__type": "JsonRequestHeaders:#Exchange",
|
||||
"RequestServerVersion": server_version,
|
||||
}
|
||||
|
||||
@staticmethod
|
||||
def get_canary(sess: requests.Session) -> str:
|
||||
for c in sess.cookies:
|
||||
if c.name == "X-OWA-CANARY" and c.value:
|
||||
return c.value
|
||||
return ""
|
||||
|
||||
def api(self, action: str, payload: dict, *, timeout: int = 30) -> dict:
|
||||
"""POST to the OWA JSON API. Raises OWASessionError on session expiry."""
|
||||
s = self.session()
|
||||
canary = self.get_canary(s)
|
||||
url = f"{self.base}/service.svc?action={action}&EP=1&ID=-1&AC=1"
|
||||
headers = {
|
||||
"Content-Type": "application/json; charset=utf-8",
|
||||
"Action": action,
|
||||
"X-OWA-CANARY": canary,
|
||||
"X-Requested-With": "XMLHttpRequest",
|
||||
}
|
||||
try:
|
||||
r = s.post(url, json=payload, headers=headers, timeout=timeout)
|
||||
except requests.exceptions.RequestException as e:
|
||||
raise OWASessionError(f"Request fehlgeschlagen: {e}")
|
||||
|
||||
new_canary = self.get_canary(s)
|
||||
if new_canary:
|
||||
s.cookies.set("X-OWA-CANARY", new_canary)
|
||||
|
||||
if r.status_code in (401, 440):
|
||||
raise OWASessionError(f"Session abgelaufen (HTTP {r.status_code})")
|
||||
if "text/html" in r.headers.get("Content-Type", ""):
|
||||
raise OWASessionError(
|
||||
f"Session abgelaufen oder ungueltige Action (HTML, HTTP {r.status_code})"
|
||||
)
|
||||
try:
|
||||
return r.json()
|
||||
except ValueError:
|
||||
raise OWASessionError(f"Unerwartete Antwort (HTTP {r.status_code})")
|
||||
|
||||
@staticmethod
|
||||
def items(data: dict) -> list:
|
||||
try:
|
||||
return data["Body"]["ResponseMessages"]["Items"]
|
||||
except (KeyError, TypeError):
|
||||
return []
|
||||
|
||||
def resolve_folder_id(self, name: str):
|
||||
"""Folder name (de/en) -> real numeric Exchange FolderId."""
|
||||
alias = _FOLDER_ALIASES.get(name.strip().lower(), name.strip().lower())
|
||||
if alias in _DISTINGUISHED:
|
||||
payload = {
|
||||
"__type": "GetFolderJsonRequest:#Exchange",
|
||||
"Header": self.header(),
|
||||
"Body": {
|
||||
"__type": "GetFolderRequest:#Exchange",
|
||||
"FolderShape": {
|
||||
"__type": "FolderResponseShape:#Exchange",
|
||||
"BaseShape": "IdOnly",
|
||||
},
|
||||
"FolderIds": [
|
||||
{"__type": "DistinguishedFolderId:#Exchange", "Id": alias}
|
||||
],
|
||||
},
|
||||
}
|
||||
data = self.api("GetFolder", payload)
|
||||
for msg in self.items(data):
|
||||
if "Folders" in msg:
|
||||
for f in msg["Folders"]:
|
||||
fid = f.get("FolderId", {}).get("Id")
|
||||
if fid:
|
||||
return fid
|
||||
payload = {
|
||||
"__type": "FindFolderJsonRequest:#Exchange",
|
||||
"Header": self.header(),
|
||||
"Body": {
|
||||
"__type": "FindFolderRequest:#Exchange",
|
||||
"FolderShape": {
|
||||
"__type": "FolderResponseShape:#Exchange",
|
||||
"BaseShape": "Default",
|
||||
},
|
||||
"ParentFolderIds": [
|
||||
{"__type": "DistinguishedFolderId:#Exchange", "Id": "msgfolderroot"}
|
||||
],
|
||||
"Traversal": "Shallow",
|
||||
"Paging": {
|
||||
"__type": "IndexedPageView:#Exchange",
|
||||
"BasePoint": "Beginning",
|
||||
"Offset": 0,
|
||||
"MaxEntriesReturned": 200,
|
||||
},
|
||||
},
|
||||
}
|
||||
data = self.api("FindFolder", payload)
|
||||
for msg in self.items(data):
|
||||
if "RootFolder" in msg and "Folders" in msg["RootFolder"]:
|
||||
for f in msg["RootFolder"]["Folders"]:
|
||||
if f.get("DisplayName", "").lower() == name.strip().lower():
|
||||
return f.get("FolderId", {}).get("Id")
|
||||
return None
|
||||
|
||||
def download_file(self, attachment_id: str, timeout: int = 60):
|
||||
"""Download an attachment via GetFileAttachment. Returns (bytes, filename, content_type)."""
|
||||
s = self.session()
|
||||
canary = self.get_canary(s)
|
||||
url = (
|
||||
f"{self.base}/service.svc/s/GetFileAttachment"
|
||||
f"?id={urllib.parse.quote(attachment_id)}&X-OWA-CANARY={urllib.parse.quote(canary)}"
|
||||
)
|
||||
try:
|
||||
resp = s.get(url, timeout=timeout)
|
||||
except requests.exceptions.RequestException as e:
|
||||
raise OWASessionError(f"Download fehlgeschlagen: {e}")
|
||||
if resp.status_code in (401, 440):
|
||||
raise OWASessionError(f"Session abgelaufen (HTTP {resp.status_code})")
|
||||
if "text/html" in resp.headers.get("Content-Type", ""):
|
||||
raise OWASessionError("Session abgelaufen (HTML-Antwort beim Download)")
|
||||
|
||||
filename = "attachment"
|
||||
cd = resp.headers.get("Content-Disposition", "")
|
||||
if cd:
|
||||
m = re.search(r'filename\*=(?:UTF-8\'\'|utf-8\'\')(.+?)(?:;|$)', cd)
|
||||
if m:
|
||||
filename = urllib.parse.unquote(m.group(1).strip())
|
||||
else:
|
||||
m = re.search(r'filename="?([^";]+)"?', cd)
|
||||
if m:
|
||||
filename = urllib.parse.unquote(m.group(1).strip())
|
||||
content_type = resp.headers.get("Content-Type", "application/octet-stream")
|
||||
if ";" in content_type:
|
||||
content_type = content_type.split(";", 1)[0].strip()
|
||||
return resp.content, filename, content_type
|
||||
|
||||
|
||||
# Default client for single-process consumers (mail MCP server).
|
||||
client = OWAClient()
|
||||
Reference in new issue
Block a user