feat(cyberark-pas): new CyberArk PAS privileged-access integration

PVWA REST API, 11 commands: list/get accounts, change/verify/reconcile
credentials (CPM rotation), retrieve password, add/delete account, list safes,
list users. Session (logon) auth, stdlib-only.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

integrations/cyberark-pas/scripts/add_account.py

@@ -0,0 +1,119 @@
+import json, os, sys, ssl, urllib.parse, urllib.request, urllib.error
+
+
+def _cfg():
+    return json.loads(os.environ.get("INTEGRATION_SECRETS", "{}"))
+
+
+def _inputs():
+    return json.loads(os.environ.get("INTEGRATION_INPUTS", "{}"))
+
+
+def _ctx(cfg):
+    if cfg.get("insecure"):
+        c = ssl.create_default_context()
+        c.check_hostname = False
+        c.verify_mode = ssl.CERT_NONE
+        return c
+    return None
+
+
+class Client:
+    def __init__(self, cfg):
+        self.cfg = cfg
+        self.base = str(cfg.get("url", "")).rstrip("/") + "/PasswordVault"
+        self.ctx = _ctx(cfg)
+        self.token = None
+
+    def _open(self, method, path, body=None, params=None, auth=True):
+        url = self.base + path
+        if params:
+            clean = {k: v for k, v in params.items() if v not in (None, "")}
+            if clean:
+                url += "?" + urllib.parse.urlencode(clean)
+        data = json.dumps(body).encode("utf-8") if body is not None else None
+        headers = {"Accept": "application/json"}
+        if auth and self.token:
+            headers["Authorization"] = self.token
+        if data is not None:
+            headers["Content-Type"] = "application/json"
+        req = urllib.request.Request(url, data=data, headers=headers, method=method)
+        with urllib.request.urlopen(req, timeout=60, context=self.ctx) as r:
+            raw = r.read()
+            return json.loads(raw) if raw else {}
+
+    def logon(self):
+        method = str(self.cfg.get("auth_method") or "Cyberark").strip() or "Cyberark"
+        body = {
+            "username": self.cfg.get("username", ""),
+            "password": self.cfg.get("password", ""),
+            "concurrentSession": True,
+        }
+        tok = self._open("POST", "/API/auth/" + urllib.parse.quote(method, safe="") + "/Logon", body=body, auth=False)
+        # tok is the session token (a plain string when parsed from the JSON body)
+        self.token = tok if isinstance(tok, str) else str(tok)
+        return self.token
+
+    def logoff(self):
+        try:
+            self._open("POST", "/API/Auth/Logoff", body={})
+        except Exception:
+            pass
+
+    def call(self, method, path, body=None, params=None):
+        return self._open(method, path, body=body, params=params)
+
+
+def _run(fn):
+    try:
+        cfg = _cfg()
+        inputs = _inputs()
+        client = Client(cfg)
+        client.logon()
+        try:
+            result = fn(client, inputs)
+        finally:
+            client.logoff()
+        print(json.dumps(result))
+    except urllib.error.HTTPError as e:
+        print(json.dumps({"error": "HTTP " + str(e.code), "detail": e.read().decode("utf-8", "replace")}))
+        sys.exit(1)
+    except Exception as e:
+        print(json.dumps({"error": str(e)}))
+        sys.exit(1)
+
+
+def main(client, inputs):
+    name = inputs.get("name")
+    if not name:
+        raise Exception("name is required")
+    address = inputs.get("address")
+    if not address:
+        raise Exception("address is required")
+    user_name = inputs.get("user_name")
+    if not user_name:
+        raise Exception("user_name is required")
+    platform_id = inputs.get("platform_id")
+    if not platform_id:
+        raise Exception("platform_id is required")
+    safe_name = inputs.get("safe_name")
+    if not safe_name:
+        raise Exception("safe_name is required")
+    secret = inputs.get("secret")
+    secret_type = inputs.get("secret_type")
+
+    body = {
+        "name": name,
+        "address": address,
+        "userName": user_name,
+        "platformId": platform_id,
+        "safeName": safe_name,
+        "secretType": secret_type or "password",
+    }
+    if secret:
+        body["secret"] = secret
+
+    return client.call("POST", "/API/Accounts", body=body)
+
+
+_run(main)

integrations/cyberark-pas/scripts/change_credentials.py

@@ -0,0 +1,102 @@
+import json, os, sys, ssl, urllib.parse, urllib.request, urllib.error
+
+
+def _cfg():
+    return json.loads(os.environ.get("INTEGRATION_SECRETS", "{}"))
+
+
+def _inputs():
+    return json.loads(os.environ.get("INTEGRATION_INPUTS", "{}"))
+
+
+def _ctx(cfg):
+    if cfg.get("insecure"):
+        c = ssl.create_default_context()
+        c.check_hostname = False
+        c.verify_mode = ssl.CERT_NONE
+        return c
+    return None
+
+
+class Client:
+    def __init__(self, cfg):
+        self.cfg = cfg
+        self.base = str(cfg.get("url", "")).rstrip("/") + "/PasswordVault"
+        self.ctx = _ctx(cfg)
+        self.token = None
+
+    def _open(self, method, path, body=None, params=None, auth=True):
+        url = self.base + path
+        if params:
+            clean = {k: v for k, v in params.items() if v not in (None, "")}
+            if clean:
+                url += "?" + urllib.parse.urlencode(clean)
+        data = json.dumps(body).encode("utf-8") if body is not None else None
+        headers = {"Accept": "application/json"}
+        if auth and self.token:
+            headers["Authorization"] = self.token
+        if data is not None:
+            headers["Content-Type"] = "application/json"
+        req = urllib.request.Request(url, data=data, headers=headers, method=method)
+        with urllib.request.urlopen(req, timeout=60, context=self.ctx) as r:
+            raw = r.read()
+            return json.loads(raw) if raw else {}
+
+    def logon(self):
+        method = str(self.cfg.get("auth_method") or "Cyberark").strip() or "Cyberark"
+        body = {
+            "username": self.cfg.get("username", ""),
+            "password": self.cfg.get("password", ""),
+            "concurrentSession": True,
+        }
+        tok = self._open("POST", "/API/auth/" + urllib.parse.quote(method, safe="") + "/Logon", body=body, auth=False)
+        # tok is the session token (a plain string when parsed from the JSON body)
+        self.token = tok if isinstance(tok, str) else str(tok)
+        return self.token
+
+    def logoff(self):
+        try:
+            self._open("POST", "/API/Auth/Logoff", body={})
+        except Exception:
+            pass
+
+    def call(self, method, path, body=None, params=None):
+        return self._open(method, path, body=body, params=params)
+
+
+def _run(fn):
+    try:
+        cfg = _cfg()
+        inputs = _inputs()
+        client = Client(cfg)
+        client.logon()
+        try:
+            result = fn(client, inputs)
+        finally:
+            client.logoff()
+        print(json.dumps(result))
+    except urllib.error.HTTPError as e:
+        print(json.dumps({"error": "HTTP " + str(e.code), "detail": e.read().decode("utf-8", "replace")}))
+        sys.exit(1)
+    except Exception as e:
+        print(json.dumps({"error": str(e)}))
+        sys.exit(1)
+
+
+q = lambda v: urllib.parse.quote(str(v), safe="")
+
+
+def main(client, inputs):
+    account_id = inputs.get("account_id")
+    if not account_id:
+        raise Exception("account_id is required")
+    change_entire_group = bool(inputs.get("change_entire_group") or False)
+    result = client.call(
+        "POST",
+        "/API/Accounts/" + q(account_id) + "/Change",
+        body={"ChangeEntireGroup": change_entire_group},
+    )
+    return result if result else {"ok": True}
+
+
+_run(main)

integrations/cyberark-pas/scripts/delete_account.py

@@ -0,0 +1,97 @@
+import json, os, sys, ssl, urllib.parse, urllib.request, urllib.error
+
+
+def _cfg():
+    return json.loads(os.environ.get("INTEGRATION_SECRETS", "{}"))
+
+
+def _inputs():
+    return json.loads(os.environ.get("INTEGRATION_INPUTS", "{}"))
+
+
+def _ctx(cfg):
+    if cfg.get("insecure"):
+        c = ssl.create_default_context()
+        c.check_hostname = False
+        c.verify_mode = ssl.CERT_NONE
+        return c
+    return None
+
+
+class Client:
+    def __init__(self, cfg):
+        self.cfg = cfg
+        self.base = str(cfg.get("url", "")).rstrip("/") + "/PasswordVault"
+        self.ctx = _ctx(cfg)
+        self.token = None
+
+    def _open(self, method, path, body=None, params=None, auth=True):
+        url = self.base + path
+        if params:
+            clean = {k: v for k, v in params.items() if v not in (None, "")}
+            if clean:
+                url += "?" + urllib.parse.urlencode(clean)
+        data = json.dumps(body).encode("utf-8") if body is not None else None
+        headers = {"Accept": "application/json"}
+        if auth and self.token:
+            headers["Authorization"] = self.token
+        if data is not None:
+            headers["Content-Type"] = "application/json"
+        req = urllib.request.Request(url, data=data, headers=headers, method=method)
+        with urllib.request.urlopen(req, timeout=60, context=self.ctx) as r:
+            raw = r.read()
+            return json.loads(raw) if raw else {}
+
+    def logon(self):
+        method = str(self.cfg.get("auth_method") or "Cyberark").strip() or "Cyberark"
+        body = {
+            "username": self.cfg.get("username", ""),
+            "password": self.cfg.get("password", ""),
+            "concurrentSession": True,
+        }
+        tok = self._open("POST", "/API/auth/" + urllib.parse.quote(method, safe="") + "/Logon", body=body, auth=False)
+        # tok is the session token (a plain string when parsed from the JSON body)
+        self.token = tok if isinstance(tok, str) else str(tok)
+        return self.token
+
+    def logoff(self):
+        try:
+            self._open("POST", "/API/Auth/Logoff", body={})
+        except Exception:
+            pass
+
+    def call(self, method, path, body=None, params=None):
+        return self._open(method, path, body=body, params=params)
+
+
+def _run(fn):
+    try:
+        cfg = _cfg()
+        inputs = _inputs()
+        client = Client(cfg)
+        client.logon()
+        try:
+            result = fn(client, inputs)
+        finally:
+            client.logoff()
+        print(json.dumps(result))
+    except urllib.error.HTTPError as e:
+        print(json.dumps({"error": "HTTP " + str(e.code), "detail": e.read().decode("utf-8", "replace")}))
+        sys.exit(1)
+    except Exception as e:
+        print(json.dumps({"error": str(e)}))
+        sys.exit(1)
+
+
+q = lambda v: urllib.parse.quote(str(v), safe="")
+
+
+def main(client, inputs):
+    account_id = inputs.get("account_id")
+    if not account_id:
+        raise Exception("account_id is required")
+    client.call("DELETE", "/API/Accounts/" + q(account_id))
+    return {"ok": True}
+
+
+_run(main)

integrations/cyberark-pas/scripts/get_account_details.py

@@ -0,0 +1,96 @@
+import json, os, sys, ssl, urllib.parse, urllib.request, urllib.error
+
+
+def _cfg():
+    return json.loads(os.environ.get("INTEGRATION_SECRETS", "{}"))
+
+
+def _inputs():
+    return json.loads(os.environ.get("INTEGRATION_INPUTS", "{}"))
+
+
+def _ctx(cfg):
+    if cfg.get("insecure"):
+        c = ssl.create_default_context()
+        c.check_hostname = False
+        c.verify_mode = ssl.CERT_NONE
+        return c
+    return None
+
+
+class Client:
+    def __init__(self, cfg):
+        self.cfg = cfg
+        self.base = str(cfg.get("url", "")).rstrip("/") + "/PasswordVault"
+        self.ctx = _ctx(cfg)
+        self.token = None
+
+    def _open(self, method, path, body=None, params=None, auth=True):
+        url = self.base + path
+        if params:
+            clean = {k: v for k, v in params.items() if v not in (None, "")}
+            if clean:
+                url += "?" + urllib.parse.urlencode(clean)
+        data = json.dumps(body).encode("utf-8") if body is not None else None
+        headers = {"Accept": "application/json"}
+        if auth and self.token:
+            headers["Authorization"] = self.token
+        if data is not None:
+            headers["Content-Type"] = "application/json"
+        req = urllib.request.Request(url, data=data, headers=headers, method=method)
+        with urllib.request.urlopen(req, timeout=60, context=self.ctx) as r:
+            raw = r.read()
+            return json.loads(raw) if raw else {}
+
+    def logon(self):
+        method = str(self.cfg.get("auth_method") or "Cyberark").strip() or "Cyberark"
+        body = {
+            "username": self.cfg.get("username", ""),
+            "password": self.cfg.get("password", ""),
+            "concurrentSession": True,
+        }
+        tok = self._open("POST", "/API/auth/" + urllib.parse.quote(method, safe="") + "/Logon", body=body, auth=False)
+        # tok is the session token (a plain string when parsed from the JSON body)
+        self.token = tok if isinstance(tok, str) else str(tok)
+        return self.token
+
+    def logoff(self):
+        try:
+            self._open("POST", "/API/Auth/Logoff", body={})
+        except Exception:
+            pass
+
+    def call(self, method, path, body=None, params=None):
+        return self._open(method, path, body=body, params=params)
+
+
+def _run(fn):
+    try:
+        cfg = _cfg()
+        inputs = _inputs()
+        client = Client(cfg)
+        client.logon()
+        try:
+            result = fn(client, inputs)
+        finally:
+            client.logoff()
+        print(json.dumps(result))
+    except urllib.error.HTTPError as e:
+        print(json.dumps({"error": "HTTP " + str(e.code), "detail": e.read().decode("utf-8", "replace")}))
+        sys.exit(1)
+    except Exception as e:
+        print(json.dumps({"error": str(e)}))
+        sys.exit(1)
+
+
+q = lambda v: urllib.parse.quote(str(v), safe="")
+
+
+def main(client, inputs):
+    account_id = inputs.get("account_id")
+    if not account_id:
+        raise Exception("account_id is required")
+    return client.call("GET", "/API/Accounts/" + q(account_id))
+
+
+_run(main)

integrations/cyberark-pas/scripts/get_password.py

@@ -0,0 +1,99 @@
+import json, os, sys, ssl, urllib.parse, urllib.request, urllib.error
+
+
+def _cfg():
+    return json.loads(os.environ.get("INTEGRATION_SECRETS", "{}"))
+
+
+def _inputs():
+    return json.loads(os.environ.get("INTEGRATION_INPUTS", "{}"))
+
+
+def _ctx(cfg):
+    if cfg.get("insecure"):
+        c = ssl.create_default_context()
+        c.check_hostname = False
+        c.verify_mode = ssl.CERT_NONE
+        return c
+    return None
+
+
+class Client:
+    def __init__(self, cfg):
+        self.cfg = cfg
+        self.base = str(cfg.get("url", "")).rstrip("/") + "/PasswordVault"
+        self.ctx = _ctx(cfg)
+        self.token = None
+
+    def _open(self, method, path, body=None, params=None, auth=True):
+        url = self.base + path
+        if params:
+            clean = {k: v for k, v in params.items() if v not in (None, "")}
+            if clean:
+                url += "?" + urllib.parse.urlencode(clean)
+        data = json.dumps(body).encode("utf-8") if body is not None else None
+        headers = {"Accept": "application/json"}
+        if auth and self.token:
+            headers["Authorization"] = self.token
+        if data is not None:
+            headers["Content-Type"] = "application/json"
+        req = urllib.request.Request(url, data=data, headers=headers, method=method)
+        with urllib.request.urlopen(req, timeout=60, context=self.ctx) as r:
+            raw = r.read()
+            return json.loads(raw) if raw else {}
+
+    def logon(self):
+        method = str(self.cfg.get("auth_method") or "Cyberark").strip() or "Cyberark"
+        body = {
+            "username": self.cfg.get("username", ""),
+            "password": self.cfg.get("password", ""),
+            "concurrentSession": True,
+        }
+        tok = self._open("POST", "/API/auth/" + urllib.parse.quote(method, safe="") + "/Logon", body=body, auth=False)
+        # tok is the session token (a plain string when parsed from the JSON body)
+        self.token = tok if isinstance(tok, str) else str(tok)
+        return self.token
+
+    def logoff(self):
+        try:
+            self._open("POST", "/API/Auth/Logoff", body={})
+        except Exception:
+            pass
+
+    def call(self, method, path, body=None, params=None):
+        return self._open(method, path, body=body, params=params)
+
+
+def _run(fn):
+    try:
+        cfg = _cfg()
+        inputs = _inputs()
+        client = Client(cfg)
+        client.logon()
+        try:
+            result = fn(client, inputs)
+        finally:
+            client.logoff()
+        print(json.dumps(result))
+    except urllib.error.HTTPError as e:
+        print(json.dumps({"error": "HTTP " + str(e.code), "detail": e.read().decode("utf-8", "replace")}))
+        sys.exit(1)
+    except Exception as e:
+        print(json.dumps({"error": str(e)}))
+        sys.exit(1)
+
+
+q = lambda v: urllib.parse.quote(str(v), safe="")
+
+
+def main(client, inputs):
+    account_id = inputs.get("account_id")
+    if not account_id:
+        raise Exception("account_id is required")
+    reason = inputs.get("reason")
+    body = {"reason": reason} if reason else {}
+    result = client.call("POST", "/API/Accounts/" + q(account_id) + "/Password/Retrieve", body=body)
+    return {"password": result}
+
+
+_run(main)

integrations/cyberark-pas/scripts/list_accounts.py

@@ -0,0 +1,93 @@
+import json, os, sys, ssl, urllib.parse, urllib.request, urllib.error
+
+
+def _cfg():
+    return json.loads(os.environ.get("INTEGRATION_SECRETS", "{}"))
+
+
+def _inputs():
+    return json.loads(os.environ.get("INTEGRATION_INPUTS", "{}"))
+
+
+def _ctx(cfg):
+    if cfg.get("insecure"):
+        c = ssl.create_default_context()
+        c.check_hostname = False
+        c.verify_mode = ssl.CERT_NONE
+        return c
+    return None
+
+
+class Client:
+    def __init__(self, cfg):
+        self.cfg = cfg
+        self.base = str(cfg.get("url", "")).rstrip("/") + "/PasswordVault"
+        self.ctx = _ctx(cfg)
+        self.token = None
+
+    def _open(self, method, path, body=None, params=None, auth=True):
+        url = self.base + path
+        if params:
+            clean = {k: v for k, v in params.items() if v not in (None, "")}
+            if clean:
+                url += "?" + urllib.parse.urlencode(clean)
+        data = json.dumps(body).encode("utf-8") if body is not None else None
+        headers = {"Accept": "application/json"}
+        if auth and self.token:
+            headers["Authorization"] = self.token
+        if data is not None:
+            headers["Content-Type"] = "application/json"
+        req = urllib.request.Request(url, data=data, headers=headers, method=method)
+        with urllib.request.urlopen(req, timeout=60, context=self.ctx) as r:
+            raw = r.read()
+            return json.loads(raw) if raw else {}
+
+    def logon(self):
+        method = str(self.cfg.get("auth_method") or "Cyberark").strip() or "Cyberark"
+        body = {
+            "username": self.cfg.get("username", ""),
+            "password": self.cfg.get("password", ""),
+            "concurrentSession": True,
+        }
+        tok = self._open("POST", "/API/auth/" + urllib.parse.quote(method, safe="") + "/Logon", body=body, auth=False)
+        # tok is the session token (a plain string when parsed from the JSON body)
+        self.token = tok if isinstance(tok, str) else str(tok)
+        return self.token
+
+    def logoff(self):
+        try:
+            self._open("POST", "/API/Auth/Logoff", body={})
+        except Exception:
+            pass
+
+    def call(self, method, path, body=None, params=None):
+        return self._open(method, path, body=body, params=params)
+
+
+def _run(fn):
+    try:
+        cfg = _cfg()
+        inputs = _inputs()
+        client = Client(cfg)
+        client.logon()
+        try:
+            result = fn(client, inputs)
+        finally:
+            client.logoff()
+        print(json.dumps(result))
+    except urllib.error.HTTPError as e:
+        print(json.dumps({"error": "HTTP " + str(e.code), "detail": e.read().decode("utf-8", "replace")}))
+        sys.exit(1)
+    except Exception as e:
+        print(json.dumps({"error": str(e)}))
+        sys.exit(1)
+
+
+def main(client, inputs):
+    search = inputs.get("search")
+    filter_ = inputs.get("filter")
+    limit = int(inputs.get("limit") or 50)
+    return client.call("GET", "/API/Accounts", params={"search": search, "filter": filter_, "limit": limit})
+
+
+_run(main)

integrations/cyberark-pas/scripts/list_safes.py

@@ -0,0 +1,92 @@
+import json, os, sys, ssl, urllib.parse, urllib.request, urllib.error
+
+
+def _cfg():
+    return json.loads(os.environ.get("INTEGRATION_SECRETS", "{}"))
+
+
+def _inputs():
+    return json.loads(os.environ.get("INTEGRATION_INPUTS", "{}"))
+
+
+def _ctx(cfg):
+    if cfg.get("insecure"):
+        c = ssl.create_default_context()
+        c.check_hostname = False
+        c.verify_mode = ssl.CERT_NONE
+        return c
+    return None
+
+
+class Client:
+    def __init__(self, cfg):
+        self.cfg = cfg
+        self.base = str(cfg.get("url", "")).rstrip("/") + "/PasswordVault"
+        self.ctx = _ctx(cfg)
+        self.token = None
+
+    def _open(self, method, path, body=None, params=None, auth=True):
+        url = self.base + path
+        if params:
+            clean = {k: v for k, v in params.items() if v not in (None, "")}
+            if clean:
+                url += "?" + urllib.parse.urlencode(clean)
+        data = json.dumps(body).encode("utf-8") if body is not None else None
+        headers = {"Accept": "application/json"}
+        if auth and self.token:
+            headers["Authorization"] = self.token
+        if data is not None:
+            headers["Content-Type"] = "application/json"
+        req = urllib.request.Request(url, data=data, headers=headers, method=method)
+        with urllib.request.urlopen(req, timeout=60, context=self.ctx) as r:
+            raw = r.read()
+            return json.loads(raw) if raw else {}
+
+    def logon(self):
+        method = str(self.cfg.get("auth_method") or "Cyberark").strip() or "Cyberark"
+        body = {
+            "username": self.cfg.get("username", ""),
+            "password": self.cfg.get("password", ""),
+            "concurrentSession": True,
+        }
+        tok = self._open("POST", "/API/auth/" + urllib.parse.quote(method, safe="") + "/Logon", body=body, auth=False)
+        # tok is the session token (a plain string when parsed from the JSON body)
+        self.token = tok if isinstance(tok, str) else str(tok)
+        return self.token
+
+    def logoff(self):
+        try:
+            self._open("POST", "/API/Auth/Logoff", body={})
+        except Exception:
+            pass
+
+    def call(self, method, path, body=None, params=None):
+        return self._open(method, path, body=body, params=params)
+
+
+def _run(fn):
+    try:
+        cfg = _cfg()
+        inputs = _inputs()
+        client = Client(cfg)
+        client.logon()
+        try:
+            result = fn(client, inputs)
+        finally:
+            client.logoff()
+        print(json.dumps(result))
+    except urllib.error.HTTPError as e:
+        print(json.dumps({"error": "HTTP " + str(e.code), "detail": e.read().decode("utf-8", "replace")}))
+        sys.exit(1)
+    except Exception as e:
+        print(json.dumps({"error": str(e)}))
+        sys.exit(1)
+
+
+def main(client, inputs):
+    search = inputs.get("search")
+    limit = int(inputs.get("limit") or 50)
+    return client.call("GET", "/API/Safes", params={"search": search, "limit": limit})
+
+
+_run(main)

integrations/cyberark-pas/scripts/list_users.py

@@ -0,0 +1,92 @@
+import json, os, sys, ssl, urllib.parse, urllib.request, urllib.error
+
+
+def _cfg():
+    return json.loads(os.environ.get("INTEGRATION_SECRETS", "{}"))
+
+
+def _inputs():
+    return json.loads(os.environ.get("INTEGRATION_INPUTS", "{}"))
+
+
+def _ctx(cfg):
+    if cfg.get("insecure"):
+        c = ssl.create_default_context()
+        c.check_hostname = False
+        c.verify_mode = ssl.CERT_NONE
+        return c
+    return None
+
+
+class Client:
+    def __init__(self, cfg):
+        self.cfg = cfg
+        self.base = str(cfg.get("url", "")).rstrip("/") + "/PasswordVault"
+        self.ctx = _ctx(cfg)
+        self.token = None
+
+    def _open(self, method, path, body=None, params=None, auth=True):
+        url = self.base + path
+        if params:
+            clean = {k: v for k, v in params.items() if v not in (None, "")}
+            if clean:
+                url += "?" + urllib.parse.urlencode(clean)
+        data = json.dumps(body).encode("utf-8") if body is not None else None
+        headers = {"Accept": "application/json"}
+        if auth and self.token:
+            headers["Authorization"] = self.token
+        if data is not None:
+            headers["Content-Type"] = "application/json"
+        req = urllib.request.Request(url, data=data, headers=headers, method=method)
+        with urllib.request.urlopen(req, timeout=60, context=self.ctx) as r:
+            raw = r.read()
+            return json.loads(raw) if raw else {}
+
+    def logon(self):
+        method = str(self.cfg.get("auth_method") or "Cyberark").strip() or "Cyberark"
+        body = {
+            "username": self.cfg.get("username", ""),
+            "password": self.cfg.get("password", ""),
+            "concurrentSession": True,
+        }
+        tok = self._open("POST", "/API/auth/" + urllib.parse.quote(method, safe="") + "/Logon", body=body, auth=False)
+        # tok is the session token (a plain string when parsed from the JSON body)
+        self.token = tok if isinstance(tok, str) else str(tok)
+        return self.token
+
+    def logoff(self):
+        try:
+            self._open("POST", "/API/Auth/Logoff", body={})
+        except Exception:
+            pass
+
+    def call(self, method, path, body=None, params=None):
+        return self._open(method, path, body=body, params=params)
+
+
+def _run(fn):
+    try:
+        cfg = _cfg()
+        inputs = _inputs()
+        client = Client(cfg)
+        client.logon()
+        try:
+            result = fn(client, inputs)
+        finally:
+            client.logoff()
+        print(json.dumps(result))
+    except urllib.error.HTTPError as e:
+        print(json.dumps({"error": "HTTP " + str(e.code), "detail": e.read().decode("utf-8", "replace")}))
+        sys.exit(1)
+    except Exception as e:
+        print(json.dumps({"error": str(e)}))
+        sys.exit(1)
+
+
+def main(client, inputs):
+    search = inputs.get("search")
+    filter_ = inputs.get("filter")
+    return client.call("GET", "/API/Users", params={"search": search, "filter": filter_})
+
+
+_run(main)

integrations/cyberark-pas/scripts/reconcile_credentials.py

@@ -0,0 +1,97 @@
+import json, os, sys, ssl, urllib.parse, urllib.request, urllib.error
+
+
+def _cfg():
+    return json.loads(os.environ.get("INTEGRATION_SECRETS", "{}"))
+
+
+def _inputs():
+    return json.loads(os.environ.get("INTEGRATION_INPUTS", "{}"))
+
+
+def _ctx(cfg):
+    if cfg.get("insecure"):
+        c = ssl.create_default_context()
+        c.check_hostname = False
+        c.verify_mode = ssl.CERT_NONE
+        return c
+    return None
+
+
+class Client:
+    def __init__(self, cfg):
+        self.cfg = cfg
+        self.base = str(cfg.get("url", "")).rstrip("/") + "/PasswordVault"
+        self.ctx = _ctx(cfg)
+        self.token = None
+
+    def _open(self, method, path, body=None, params=None, auth=True):
+        url = self.base + path
+        if params:
+            clean = {k: v for k, v in params.items() if v not in (None, "")}
+            if clean:
+                url += "?" + urllib.parse.urlencode(clean)
+        data = json.dumps(body).encode("utf-8") if body is not None else None
+        headers = {"Accept": "application/json"}
+        if auth and self.token:
+            headers["Authorization"] = self.token
+        if data is not None:
+            headers["Content-Type"] = "application/json"
+        req = urllib.request.Request(url, data=data, headers=headers, method=method)
+        with urllib.request.urlopen(req, timeout=60, context=self.ctx) as r:
+            raw = r.read()
+            return json.loads(raw) if raw else {}
+
+    def logon(self):
+        method = str(self.cfg.get("auth_method") or "Cyberark").strip() or "Cyberark"
+        body = {
+            "username": self.cfg.get("username", ""),
+            "password": self.cfg.get("password", ""),
+            "concurrentSession": True,
+        }
+        tok = self._open("POST", "/API/auth/" + urllib.parse.quote(method, safe="") + "/Logon", body=body, auth=False)
+        # tok is the session token (a plain string when parsed from the JSON body)
+        self.token = tok if isinstance(tok, str) else str(tok)
+        return self.token
+
+    def logoff(self):
+        try:
+            self._open("POST", "/API/Auth/Logoff", body={})
+        except Exception:
+            pass
+
+    def call(self, method, path, body=None, params=None):
+        return self._open(method, path, body=body, params=params)
+
+
+def _run(fn):
+    try:
+        cfg = _cfg()
+        inputs = _inputs()
+        client = Client(cfg)
+        client.logon()
+        try:
+            result = fn(client, inputs)
+        finally:
+            client.logoff()
+        print(json.dumps(result))
+    except urllib.error.HTTPError as e:
+        print(json.dumps({"error": "HTTP " + str(e.code), "detail": e.read().decode("utf-8", "replace")}))
+        sys.exit(1)
+    except Exception as e:
+        print(json.dumps({"error": str(e)}))
+        sys.exit(1)
+
+
+q = lambda v: urllib.parse.quote(str(v), safe="")
+
+
+def main(client, inputs):
+    account_id = inputs.get("account_id")
+    if not account_id:
+        raise Exception("account_id is required")
+    result = client.call("POST", "/API/Accounts/" + q(account_id) + "/Reconcile", body={})
+    return {"ok": True} if not result else result
+
+
+_run(main)

integrations/cyberark-pas/scripts/test_connection.py

@@ -0,0 +1,91 @@
+import json, os, sys, ssl, urllib.parse, urllib.request, urllib.error
+
+
+def _cfg():
+    return json.loads(os.environ.get("INTEGRATION_SECRETS", "{}"))
+
+
+def _inputs():
+    return json.loads(os.environ.get("INTEGRATION_INPUTS", "{}"))
+
+
+def _ctx(cfg):
+    if cfg.get("insecure"):
+        c = ssl.create_default_context()
+        c.check_hostname = False
+        c.verify_mode = ssl.CERT_NONE
+        return c
+    return None
+
+
+class Client:
+    def __init__(self, cfg):
+        self.cfg = cfg
+        self.base = str(cfg.get("url", "")).rstrip("/") + "/PasswordVault"
+        self.ctx = _ctx(cfg)
+        self.token = None
+
+    def _open(self, method, path, body=None, params=None, auth=True):
+        url = self.base + path
+        if params:
+            clean = {k: v for k, v in params.items() if v not in (None, "")}
+            if clean:
+                url += "?" + urllib.parse.urlencode(clean)
+        data = json.dumps(body).encode("utf-8") if body is not None else None
+        headers = {"Accept": "application/json"}
+        if auth and self.token:
+            headers["Authorization"] = self.token
+        if data is not None:
+            headers["Content-Type"] = "application/json"
+        req = urllib.request.Request(url, data=data, headers=headers, method=method)
+        with urllib.request.urlopen(req, timeout=60, context=self.ctx) as r:
+            raw = r.read()
+            return json.loads(raw) if raw else {}
+
+    def logon(self):
+        method = str(self.cfg.get("auth_method") or "Cyberark").strip() or "Cyberark"
+        body = {
+            "username": self.cfg.get("username", ""),
+            "password": self.cfg.get("password", ""),
+            "concurrentSession": True,
+        }
+        tok = self._open("POST", "/API/auth/" + urllib.parse.quote(method, safe="") + "/Logon", body=body, auth=False)
+        # tok is the session token (a plain string when parsed from the JSON body)
+        self.token = tok if isinstance(tok, str) else str(tok)
+        return self.token
+
+    def logoff(self):
+        try:
+            self._open("POST", "/API/Auth/Logoff", body={})
+        except Exception:
+            pass
+
+    def call(self, method, path, body=None, params=None):
+        return self._open(method, path, body=body, params=params)
+
+
+def _run(fn):
+    try:
+        cfg = _cfg()
+        inputs = _inputs()
+        client = Client(cfg)
+        client.logon()
+        try:
+            result = fn(client, inputs)
+        finally:
+            client.logoff()
+        print(json.dumps(result))
+    except urllib.error.HTTPError as e:
+        print(json.dumps({"error": "HTTP " + str(e.code), "detail": e.read().decode("utf-8", "replace")}))
+        sys.exit(1)
+    except Exception as e:
+        print(json.dumps({"error": str(e)}))
+        sys.exit(1)
+
+
+def main(client, inputs):
+    client.call("GET", "/API/Safes", params={"limit": 1})
+    return {"ok": True}
+
+
+_run(main)

integrations/cyberark-pas/scripts/verify_credentials.py

@@ -0,0 +1,97 @@
+import json, os, sys, ssl, urllib.parse, urllib.request, urllib.error
+
+
+def _cfg():
+    return json.loads(os.environ.get("INTEGRATION_SECRETS", "{}"))
+
+
+def _inputs():
+    return json.loads(os.environ.get("INTEGRATION_INPUTS", "{}"))
+
+
+def _ctx(cfg):
+    if cfg.get("insecure"):
+        c = ssl.create_default_context()
+        c.check_hostname = False
+        c.verify_mode = ssl.CERT_NONE
+        return c
+    return None
+
+
+class Client:
+    def __init__(self, cfg):
+        self.cfg = cfg
+        self.base = str(cfg.get("url", "")).rstrip("/") + "/PasswordVault"
+        self.ctx = _ctx(cfg)
+        self.token = None
+
+    def _open(self, method, path, body=None, params=None, auth=True):
+        url = self.base + path
+        if params:
+            clean = {k: v for k, v in params.items() if v not in (None, "")}
+            if clean:
+                url += "?" + urllib.parse.urlencode(clean)
+        data = json.dumps(body).encode("utf-8") if body is not None else None
+        headers = {"Accept": "application/json"}
+        if auth and self.token:
+            headers["Authorization"] = self.token
+        if data is not None:
+            headers["Content-Type"] = "application/json"
+        req = urllib.request.Request(url, data=data, headers=headers, method=method)
+        with urllib.request.urlopen(req, timeout=60, context=self.ctx) as r:
+            raw = r.read()
+            return json.loads(raw) if raw else {}
+
+    def logon(self):
+        method = str(self.cfg.get("auth_method") or "Cyberark").strip() or "Cyberark"
+        body = {
+            "username": self.cfg.get("username", ""),
+            "password": self.cfg.get("password", ""),
+            "concurrentSession": True,
+        }
+        tok = self._open("POST", "/API/auth/" + urllib.parse.quote(method, safe="") + "/Logon", body=body, auth=False)
+        # tok is the session token (a plain string when parsed from the JSON body)
+        self.token = tok if isinstance(tok, str) else str(tok)
+        return self.token
+
+    def logoff(self):
+        try:
+            self._open("POST", "/API/Auth/Logoff", body={})
+        except Exception:
+            pass
+
+    def call(self, method, path, body=None, params=None):
+        return self._open(method, path, body=body, params=params)
+
+
+def _run(fn):
+    try:
+        cfg = _cfg()
+        inputs = _inputs()
+        client = Client(cfg)
+        client.logon()
+        try:
+            result = fn(client, inputs)
+        finally:
+            client.logoff()
+        print(json.dumps(result))
+    except urllib.error.HTTPError as e:
+        print(json.dumps({"error": "HTTP " + str(e.code), "detail": e.read().decode("utf-8", "replace")}))
+        sys.exit(1)
+    except Exception as e:
+        print(json.dumps({"error": str(e)}))
+        sys.exit(1)
+
+
+q = lambda v: urllib.parse.quote(str(v), safe="")
+
+
+def main(client, inputs):
+    account_id = inputs.get("account_id")
+    if not account_id:
+        raise Exception("account_id is required")
+    result = client.call("POST", "/API/Accounts/" + q(account_id) + "/Verify", body={})
+    return {"ok": True} if not result else result
+
+
+_run(main)