# Copyright (c) 2015-2026 Vector 35 Inc # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to # deal in the Software without restriction, including without limitation the # rights to use, copy, modify, merge, publish, distribute, sublicense, and/or # sell copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING # FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS # IN THE SOFTWARE. import abc import ctypes from json import dumps import sys import traceback from typing import Any, Optional from urllib.parse import urlencode # Binary Ninja Components import binaryninja import binaryninja._binaryninjacore as core from . import settings from .log import log_error_for_exception def to_bytes(field): if type(field) == bytes: return field if type(field) == str: return field.encode() return str(field).encode() class _SecretsProviderMetaclass(type): def __iter__(self): binaryninja._init_plugins() count = ctypes.c_ulonglong() types = core.BNGetSecretsProviderList(count) try: for i in range(0, count.value): yield SecretsProvider(types[i]) finally: core.BNFreeSecretsProviderList(types) def __getitem__(self, value): binaryninja._init_plugins() provider = core.BNGetSecretsProviderByName(str(value)) if provider is None: raise KeyError(f"'{value}' is not a valid secrets provider") return SecretsProvider(provider) def __contains__(cls: '_SecretsProviderMetaclass', name: object) -> bool: if not isinstance(name, str): return False try: cls[name] return True except KeyError: return False def get(cls: '_SecretsProviderMetaclass', name: str, default: Any = None) -> Optional['SecretsProvider']: try: return cls[name] except KeyError: if default is not None: return default return None class SecretsProvider(metaclass=_SecretsProviderMetaclass): name = None instance_class = None _registered_providers = [] def __init__(self, handle=None): if handle is not None: self.handle = core.handle_of_type(handle, core.BNSecretsProvider) self.__dict__["name"] = core.BNGetSecretsProviderName(handle) def register(self): self._cb = core.BNSecretsProviderCallbacks() self._cb.context = 0 self._cb.hasData = self._cb.hasData.__class__(self._has_data) self._cb.getData = self._cb.getData.__class__(self._get_data) self._cb.storeData = self._cb.storeData.__class__(self._store_data) self._cb.deleteData = self._cb.deleteData.__class__(self._delete_data) self.handle = core.BNRegisterSecretsProvider(self.__class__.name, self._cb) self.__class__._registered_providers.append(self) def _has_data(self, ctxt, key: str) -> bool: try: return self.perform_has_data(key) except: log_error_for_exception("Unhandled Python exception in SecretsProvider._has_data") return False def _get_data(self, ctxt, key: str): try: data = self.perform_get_data(key) return core.BNAllocString(data) except: log_error_for_exception("Unhandled Python exception in SecretsProvider._get_data") return None def _store_data(self, ctxt, key: str, data: str) -> bool: try: return self.perform_store_data(key, data) except: log_error_for_exception("Unhandled Python exception in SecretsProvider._store_data") return False def _delete_data(self, ctxt, key: str) -> bool: try: return self.perform_delete_data(key) except: log_error_for_exception("Unhandled Python exception in SecretsProvider._delete_data") return False def perform_has_data(self, key: str) -> bool: raise NotImplementedError("Not implemented") def perform_get_data(self, key: str) -> str: raise NotImplementedError("Not implemented") def perform_store_data(self, key: str, data: str) -> bool: raise NotImplementedError("Not implemented") def perform_delete_data(self, key: str) -> bool: raise NotImplementedError("Not implemented") def has_data(self, key: str) -> bool: return core.BNSecretsProviderHasData(self.handle, key) def get_data(self, key: str) -> str: return core.BNGetSecretsProviderData(self.handle, key) def store_data(self, key: str, data: str) -> bool: return core.BNStoreSecretsProviderData(self.handle, key, data) def delete_data(self, key: str) -> bool: return core.BNDeleteSecretsProviderData(self.handle, key)