BinaryNinja::EnterpriseServer Namespace Reference

Detailed Description

API for interacting with an Enterprise Server.

These methods will only do anything on Enterprise editions of Binary Ninja.

Classes
struct	EnterpriseException
	Custom exception class for all Enterprise functions that can throw exceptions. More...
class	LicenseCheckout
	RAII object for holding an Enterprise license in a scope. More...

Functions
bool	AuthenticateWithCredentials (const std::string &username, const std::string &password, bool remember)
	Authenticate to the server with username and password. More...
bool	AuthenticateWithMethod (const std::string &method, bool remember)
	Authenticate with an external provider. More...
std::vector< std::pair< std::string, std::string > >	GetAuthenticationMethods ()
	Get a list of accepted methods for authentication. More...
bool	Deauthenticate ()
	Forget saved credentials. More...
void	CancelAuthentication ()
	Cancel a currently running authentication task. More...
bool	Connect ()
	Perform initial connect to the server, pulling signing key and time limit. More...
bool	AcquireLicense (uint64_t timeout)
	Acquire or refresh a floating license. More...
bool	ReleaseLicense ()
	Release the current hold on a license. More...
bool	IsConnected ()
	Check if the server is connected. More...
bool	IsAuthenticated ()
	Check if the user has authenticated with the server. More...
std::string	GetUsername ()
	Get currently connected username. More...
std::string	GetToken ()
	Get token for current login session. More...
std::string	GetServerName ()
	Get the display name of the currently connected server. More...
std::string	GetServerId ()
	Get the internal id of the currently connected server. More...
uint64_t	GetServerVersion ()
	Get the version number of the currently connected server. More...
std::string	GetServerBuildId ()
	Get the build id string of the currently connected server. More...
uint64_t	GetLicenseExpirationTime ()
	Get the expiry time for the current license. More...
uint64_t	GetLicenseDuration ()
	Get the total length of the current license. More...
bool	IsFloatingLicense ()
	Determine if a floating license is currently active. More...
uint64_t	GetReservationTimeLimit ()
	Get the maximum time limit for reservations. More...
bool	IsLicenseStillActivated ()
	Check if the user's license is still activated. More...
std::string	GetLastError ()
	Get the last recorded error. More...
void	RegisterNotification (BNEnterpriseServerCallbacks *notify)
	Register an object to receive callbacks when enterprise server events happen. More...
void	UnregisterNotification (BNEnterpriseServerCallbacks *notify)
	Un-register a previously registered notification handler object. More...

Function Documentation

AuthenticateWithCredentials()

bool BinaryNinja::EnterpriseServer::AuthenticateWithCredentials	(	const std::string &	username,
		const std::string &	password,
		bool	remember
	)

Authenticate to the server with username and password.

Parameters

username	Username to authenticate with
password	Password to authenticate with
remember	Remember token in keychain

Returns

True if successful

AuthenticateWithMethod()

bool BinaryNinja::EnterpriseServer::AuthenticateWithMethod	(	const std::string &	method,
		bool	remember
	)

Authenticate with an external provider.

Parameters

method	Provider method
remember	Remember token in keychain

Returns

True if successful

GetAuthenticationMethods()

std::vector< std::pair< std::string, std::string > > BinaryNinja::EnterpriseServer::GetAuthenticationMethods

(

)

Get a list of accepted methods for authentication.

Returns

List of (method, name) pairs

Deauthenticate()

bool BinaryNinja::EnterpriseServer::Deauthenticate

(

)

Forget saved credentials.

Returns

True if successful

CancelAuthentication()

void BinaryNinja::EnterpriseServer::CancelAuthentication

(

)

Cancel a currently running authentication task.

Connect()

bool BinaryNinja::EnterpriseServer::Connect

(

)

Perform initial connect to the server, pulling signing key and time limit.

Returns

True if successful

AcquireLicense()

bool BinaryNinja::EnterpriseServer::AcquireLicense

(

uint64_t

timeout

)

Acquire or refresh a floating license.

Parameters

timeout

Time (in minutes)

Returns

True if successful

ReleaseLicense()

bool BinaryNinja::EnterpriseServer::ReleaseLicense

(

)

Release the current hold on a license.

Returns

True if successful

IsConnected()

bool BinaryNinja::EnterpriseServer::IsConnected

(

)

Check if the server is connected.

Returns

True if connected

IsAuthenticated()

bool BinaryNinja::EnterpriseServer::IsAuthenticated

(

)

Check if the user has authenticated with the server.

Returns

True if authenticated

GetUsername()

std::string BinaryNinja::EnterpriseServer::GetUsername

(

)

Get currently connected username.

Returns

Username of currently connected user

GetToken()

std::string BinaryNinja::EnterpriseServer::GetToken

(

)

Get token for current login session.

Returns

Token for currently connected user

GetServerName()

std::string BinaryNinja::EnterpriseServer::GetServerName

(

)

Get the display name of the currently connected server.

Returns

Display name of the currently connected server

GetServerId()

std::string BinaryNinja::EnterpriseServer::GetServerId

(

)

Get the internal id of the currently connected server.

Returns

Id of the currently connected server

GetServerVersion()

uint64_t BinaryNinja::EnterpriseServer::GetServerVersion

(

)

Get the version number of the currently connected server.

Returns

Version of the currently connected server

GetServerBuildId()

std::string BinaryNinja::EnterpriseServer::GetServerBuildId

(

)

Get the build id string of the currently connected server.

Returns

Build id of the currently connected server

GetLicenseExpirationTime()

uint64_t BinaryNinja::EnterpriseServer::GetLicenseExpirationTime

(

)

Get the expiry time for the current license.

Returns

Expiry time, in seconds from the epoch

GetLicenseDuration()

uint64_t BinaryNinja::EnterpriseServer::GetLicenseDuration

(

)

Get the total length of the current license.

Returns

Total time, in seconds

IsFloatingLicense()

bool BinaryNinja::EnterpriseServer::IsFloatingLicense

(

)

Determine if a floating license is currently active.

Returns

True if a floating license is active

GetReservationTimeLimit()

uint64_t BinaryNinja::EnterpriseServer::GetReservationTimeLimit

(

)

Get the maximum time limit for reservations.

Returns

Maximum reservation time, in seconds

IsLicenseStillActivated()

bool BinaryNinja::EnterpriseServer::IsLicenseStillActivated

(

)

Check if the user's license is still activated.

Returns

True if still activated

GetLastError()

std::string BinaryNinja::EnterpriseServer::GetLastError

(

)

Get the last recorded error.

Returns

Error text

RegisterNotification()

void BinaryNinja::EnterpriseServer::RegisterNotification

(

BNEnterpriseServerCallbacks *

notify

)

Register an object to receive callbacks when enterprise server events happen.

Parameters

notify

Object to receive callbacks

UnregisterNotification()

void BinaryNinja::EnterpriseServer::UnregisterNotification

(

BNEnterpriseServerCallbacks *

notify

)

Un-register a previously registered notification handler object.

Parameters

notify

Object to un-register