The various identity configurations that you can use when initializing a Ditto instance. More...

Inheritance diagram for ditto::Identity:

Static Public Member Functions
static DevelopmentIdentity	Development (std::string app_id="", uint64_t site_id=0, std::string persistence_dir="")
	Construct a new DevelopmentIdentity. More...

static OnlineIdentity	Online (std::string app_id, std::shared_ptr< AuthenticationCallback > callback, bool enable_ditto_cloud_sync=true, std::string custom_auth_url="", std::string persistence_dir="")
	Construct a new OnlineIdentity. More...

static OnlinePlaygroundIdentity	OnlinePlayground (std::string app_id, bool enable_ditto_cloud_sync=true, std::string persistence_dir="")
	Construct a new OnlinePlaygroundIdentity. More...

static SharedKeyIdentity	SharedKey (std::string app_id, std::string shared_key, uint64_t site_id=0, std::string persistence_dir="")
	Construct a new SharedKeyIdentity. More...

static ManualIdentity	Manual (std::string certificate_config)
	Construct a new ManualIdentity. More...

Detailed Description

The various identity configurations that you can use when initializing a Ditto instance.

The different supported identities and when they should be used are as follows:

Development: Develop peer-to-peer apps with no cloud connection. This mode offers no security and must only be used for development.
Online: Run Ditto in secure production mode, logging on to Ditto Cloud or on on-premises authentication server. User permissions are centrally managed.
OnlinePlayground: Test a Ditto Cloud app without authentication ("Playground mode"). This mode offers no security and must only be used for development.
SharedKey: A mode where any device is trusted provided they know the secret key. This is a simplistic authentication model normally only suitable for private apps where users and devices are both trusted.
Manual: A manually-provided certificate identity. This accepts a base64-encoded bundle.

Member Function Documentation

DevelopmentIdentity ditto::Identity::Development	(	std::string	app_id = `""`,
		uint64_t	site_id = `0`,
		std::string	persistence_dir = `""`
	)

static

Parameters

[in]	app_id	the ID of the app. If you are developing multiple apps, use distinct names to ensure they do not attempt to connect and sync with each other.
[in]	site_id	the site ID for the device. Use this to identity different users or devices. Site IDs are persisted between sessions when using a development identity. Site IDs should be unique and not reused by different users or devices.
[in]	persistence_dir	the directory to be used to cache identity-related data.

ManualIdentity ditto::Identity::Manual ( std::string certificate_config )

static

Construct a new ManualIdentity.

Parameters

[in] config a base64-encoded string representation of a certificate bundle.

OnlineIdentity ditto::Identity::Online	(	std::string	app_id,
		std::shared_ptr< AuthenticationCallback >	callback,
		bool	enable_ditto_cloud_sync = `true`,
		std::string	custom_auth_url = `""`,
		std::string	persistence_dir = `""`
	)

static

Construct a new OnlineIdentity.

Parameters

[in]	appID	a UUID identifying this app registration on the Ditto portal, which can be found at https://portal.ditto.live.
[in]	callback	a handler for when Ditto requires (re)authentication.
[in]	enable_ditto_cloud_sync	if true, auto-configure sync with Ditto Cloud.
[in]	custom_auth_url	if specified, use a custom authentication service instead of Ditto Cloud.
[in]	persistence_dir	the directory to be used to cache identity-related data.

OnlinePlaygroundIdentity ditto::Identity::OnlinePlayground	(	std::string	app_id,
		bool	enable_ditto_cloud_sync = `true`,
		std::string	persistence_dir = `""`
	)

static

Parameters

[in]	appID	a UUID identifying this app registration on the Ditto portal, which can be found at https://portal.ditto.live.
[in]	enable_ditto_cloud_sync	if true, auto-configure sync with Ditto Cloud.
[in]	persistence_dir	the directory to be used to cache identity-related data.

SharedKeyIdentity ditto::Identity::SharedKey	(	std::string	app_id,
		std::string	shared_key,
		uint64_t	site_id = `0`,
		std::string	persistence_dir = `""`
	)

static

Parameters

[in]	app_id	the ID of the app, specified in domain format, e.g. "app.ditto.live". All peers must use the same app ID to communicate.
[in]	shared_key	a base64-encoded DER private key. Refer to Ditto documentation for details about generating shared keys.
[in]	site_id	the site ID for the device. For shared key mode, this can be left unspecified to choose a random number.
[in]	persistence_dir	the directory to be used to cache identity-related data.