VMware GemFire Native C++ Reference  9.1
apache::geode::client::AuthInitialize Class Referenceabstract

Specifies the mechanism to obtain credentials for a client. More...

Inherits apache::geode::client::SharedBase.

Public Member Functions

virtual void close ()=0
 Invoked before the cache goes down. More...
 
virtual PropertiesPtr getCredentials (PropertiesPtr &securityprops, const char *server)=0
 initialize with the given set of security properties and return the credentials for the client as properties. More...
 
void preserveSB () const
 Atomically increment reference count. More...
 
int32_t refCount ()
 
void releaseSB () const
 Atomically decrement reference count, the SharedBase object is automatically deleted when its reference count goes to zero. More...
 

Detailed Description

Specifies the mechanism to obtain credentials for a client.

It is mandantory for clients when the server is running in secure mode having a security-client-authenticator module specified. Implementations should register the library path as security-client-auth-library system property and factory function (a zero argument function returning pointer to an AuthInitialize object) as the security-client-auth-factory system property.

Member Function Documentation

virtual void apache::geode::client::AuthInitialize::close ( )
pure virtual

Invoked before the cache goes down.

virtual PropertiesPtr apache::geode::client::AuthInitialize::getCredentials ( PropertiesPtr securityprops,
const char *  server 
)
pure virtual

initialize with the given set of security properties and return the credentials for the client as properties.

Parameters
propsthe set of security properties provided to the DistributedSystem.connect method
serverit is the ID of the current endpoint. The format expected is "host:port".
Returns
the credentials to be used for the given server
Remarks
This method can modify the given set of properties. For example it may invoke external agents or even interact with the user.
void apache::geode::client::SharedBase::preserveSB ( ) const
inherited

Atomically increment reference count.

int32_t apache::geode::client::SharedBase::refCount ( )
inlineinherited
Returns
the reference count
void apache::geode::client::SharedBase::releaseSB ( ) const
inherited

Atomically decrement reference count, the SharedBase object is automatically deleted when its reference count goes to zero.


Pivotal GemFire C++ Cache API Documentation