tenduke::se Namespace Reference

Detailed Description

Classes, functions and globals of 10Duke Scale C++ Client.

This namespace contains classes, functions and globals related to 10Duke Scale.

Namespaces
namespace	http
	10Duke Scale C++ Client -specific HTTP implementation.
namespace	licensing
	Licensing operations for 10Duke Scale.

Classes
class	AbstractClientFactory
	Class template for factories, which create 10Duke Scale client. More...
class	APIRequest
	Interface for 10Duke Scale API-requests. More...
class	BackendConfiguration
	Configuration for the 10Duke Scale backend to bootstrap the client. More...
class	BrowserAuthenticatingClientFactory
class	ClientProperties
	Properties of the client ("Client application claims") More...
class	ClientPropertiesBuilder
	For building the client properties fluently. More...
struct	ClientState
	Container for client state. More...
class	DeserializeStateFromJSON
	Service for deserializing client state from JSON. More...
class	DeviceAuthenticatingClientFactory
class	Filter
	Filter-definition for the REST-API. More...
class	Paging
	Paging-ocnfiguration for the REST-API. More...
class	ROPGAuthenticatingClientFactory
class	SerializeStateToJSON
	Serializes client state to JSON. More...
class	StatefulAPIRequest
	A tenduke::se::APIRequest, which uses tenduke::oidc::OIDCSession to maintain request authorization. More...
class	TendukeClient
	Base 10Duke Scale client, usable standalone for licensekey-based operations without user login. More...
class	TendukeClientWithOIDCSession
	10Duke Scale client, which authorizes requests with OIDC/OAuth and maintains the OIDC session state automatically. More...
class	TendukeClientWithOIDCSessionImpl
	Implementation of tenduke::se::TendukeClientWithOIDCSession. More...

Functions
std::unique_ptr<::tenduke::se::TendukeClientWithOIDCSession >	createROPGAuthenticatingClient (const std::string &clientIdentifier, const ::tenduke::se::BackendConfiguration &backendConfiguration, const ::tenduke::se::ClientProperties &clientProperties, const ::tenduke::oauth::OAuthBackendConfiguration &oauthBackendConfiguration, const ::tenduke::oidc::OIDCConfiguration &oidcConfiguration, const ::tenduke::oidc::ropg::ROPGAuthenticationConfig &authenticationConfig, const std::string &initialStateAsJSON="", const ::tenduke::ServiceConfiguration &serviceConfiguration=::tenduke::ServiceConfiguration())
	Creates stateful client, which authenticates user with OAuth Resource Owner Password Grant, configured with provided configuration.
std::unique_ptr<::tenduke::se::TendukeClientWithOIDCSession >	createROPGAuthenticatingClientUsingAutodiscovery (const std::string &clientIdentifier, const ::tenduke::se::BackendConfiguration &backendConfiguration, const ::tenduke::se::ClientProperties &clientProperties, const std::string &oidcAutodiscoveryURL, const ::tenduke::oidc::ropg::ROPGAuthenticationConfig &authenticationConfig, const std::string &initialStateAsJSON="", const ::tenduke::ServiceConfiguration &serviceConfiguration=::tenduke::ServiceConfiguration())
	Creates stateful client, which authenticates user with OAuth Resource Owner Password Grant, configured using OIDC auto discovery.
std::unique_ptr<::tenduke::se::TendukeClientWithOIDCSession >	createClient (const ::tenduke::TendukeServices &services, const ::tenduke::se::ClientProperties &clientProperties, const ::tenduke::se::BackendConfiguration &backendConfiguration, const std::shared_ptr< const ::tenduke::oauth::OAuthConfiguration > &oauthConfiguration, const std::shared_ptr< const ::tenduke::oidc::OIDCConfiguration > &oidcConfiguration, const ::tenduke::se::ClientState &initialState, const std::shared_ptr<::tenduke::oidc::OIDCSession > &oidcSession)
	Creates the 10Duke Scale client with given parameters.
std::unique_ptr<::tenduke::se::TendukeClientWithOIDCSession >	createTendukeClientForBrowser (const std::string &clientIdentifier, const ::tenduke::se::BackendConfiguration &backendConfiguration, const ::tenduke::se::ClientProperties &clientProperties, const ::tenduke::oauth::OAuthBackendConfiguration &oauthBackendConfiguration, const ::tenduke::oidc::OIDCConfiguration &oidcConfiguration, const ::tenduke::oidc::osbrowser::BrowserAuthenticationConfig &authenticationConfig, const std::string &initialStateAsJSON="", const ::tenduke::ServiceConfiguration &serviceConfiguration=::tenduke::ServiceConfiguration())
	Creates stateful client, which authenticates user with default OS-browser, using provided configuration.
std::unique_ptr<::tenduke::se::TendukeClientWithOIDCSession >	createTendukeClientForBrowserUsingAutodiscovery (const std::string &clientIdentifier, const ::tenduke::se::BackendConfiguration &backendConfiguration, const ::tenduke::se::ClientProperties &clientProperties, const std::string &oidcAutodiscoveryURL, const ::tenduke::oidc::osbrowser::BrowserAuthenticationConfig &authenticationConfig, const std::string &initialStateAsJSON="", const ::tenduke::ServiceConfiguration &serviceConfiguration=::tenduke::ServiceConfiguration())
	Creates stateful client, which authenticates user with default OS-browser, using OIDC auto-discovery.
std::unique_ptr<::tenduke::se::TendukeClientWithOIDCSession >	createTendukeClientForDevice (const std::string &clientIdentifier, const ::tenduke::se::BackendConfiguration &backendConfiguration, const ::tenduke::se::ClientProperties &clientProperties, const ::tenduke::oauth::OAuthBackendConfiguration &oauthBackendConfiguration, const ::tenduke::oidc::OIDCConfiguration &oidcConfiguration, const ::tenduke::oidc::device::DeviceAuthenticationConfig &authenticationConfig, const std::string &initialStateAsJSON="", const ::tenduke::ServiceConfiguration &serviceConfiguration=::tenduke::ServiceConfiguration())
	Creates stateful client, which authenticates user with OAuth Device Flow, using provided configuration.
std::unique_ptr<::tenduke::se::TendukeClientWithOIDCSession >	createTendukeClientForDeviceClientUsingAutodiscovery (const std::string &clientIdentifier, const ::tenduke::se::BackendConfiguration &backendConfiguration, const ::tenduke::se::ClientProperties &clientProperties, const std::string &oidcAutodiscoveryURL, const ::tenduke::oidc::device::DeviceAuthenticationConfig &authenticationConfig, const std::string &initialStateAsJSON="", const ::tenduke::ServiceConfiguration &serviceConfiguration=::tenduke::ServiceConfiguration())
	Creates stateful client, which authenticates user with OAuth Device Flow, using OIDC auto-discovery.
std::unique_ptr<::tenduke::se::TendukeClient >	createTendukeClientForLicenseKeyUsage (const std::string &clientIdentifier, const ::tenduke::se::BackendConfiguration &backendConfiguration, const ::tenduke::se::ClientProperties &clientProperties, const std::string &initialStateAsJson="", const ::tenduke::ServiceConfiguration &serviceConfiguration=::tenduke::ServiceConfiguration())
	Creates a client for using license-key -operations only.

Variables
const std::string	VERSION = "version"
const std::string	LEASE_TOKEN = "token"
const std::string	LEASE_LICENSEKEY = "licenseKey"
const std::string	LEASE_METERED = "metered"
const std::string	LEASES = "leases"
const std::string	KEY_TYPE = "type"
const std::string	KEY_PEM = "pem"
const std::string	KEYS = "tokenValidationKeys"
const std::string	LICENSING = "licensing"
const std::string	OIDC_ACCESSTOKEN = "accessToken"
const std::string	OIDC_REFRESHTOKEN = "refreshToken"
const std::string	OIDC_IDTOKEN = "idToken"
const std::string	OIDC_EXPIRESAT = "expiresAt"
const std::string	OIDC_SESSION = "session"
const std::string	OIDC = "oidc"
const std::string	OIDC_USERINFOENDPOINT = "userinfoEndpoint"
const std::string	OIDC_ISSUER = "issuer"
const std::string	OIDC_DIGESTALGORITHM = "digestAlgorithm"
const std::string	OIDC_VERIFICATIONKEY = "verificationKey"
const std::string	OIDC_CONFIGURATION = "configuration"
const std::string	OAUTH_CLIENTID = "clientId"
const std::string	OAUTH_CLIENTSECRET = "clientSecret"
const std::string	OAUTH_FLOW = "flow"
const std::string	OAUTH_REDIRECTURI = "redirectURI"
const std::string	OAUTH_AUTHORIZATIONENDPOINTURL = "authorizationEndpointUrl"
const std::string	OAUTH_TOKENENDPOINTURL = "tokenEndpointUrl"
const std::string	OAUTH_DEVICEAUTHORIZATIONENDPOINTURL = "deviceAuthorizationEndpointUrl"
const std::string	OAUTH_CONFIGURATION = "configuration"
const std::string	OAUTH = "oauth"

Function Documentation

createClient()

std::unique_ptr<::tenduke::se::TendukeClientWithOIDCSession > tenduke::se::createClient	(	const ::tenduke::TendukeServices &	services,
		const ::tenduke::se::ClientProperties &	clientProperties,
		const ::tenduke::se::BackendConfiguration &	backendConfiguration,
		const std::shared_ptr< const ::tenduke::oauth::OAuthConfiguration > &	oauthConfiguration,
		const std::shared_ptr< const ::tenduke::oidc::OIDCConfiguration > &	oidcConfiguration,
		const ::tenduke::se::ClientState &	initialState,
		const std::shared_ptr<::tenduke::oidc::OIDCSession > &	oidcSession )

Creates the 10Duke Scale client with given parameters.

This factory function is mostly for internal use.

Parameters

services	-
clientProperties	-
backendConfiguration	-
oauthConfiguration	-
oidcConfiguration	-
initialState	-
oidcSession	-

Returns

-

createROPGAuthenticatingClient()

std::unique_ptr<::tenduke::se::TendukeClientWithOIDCSession > tenduke::se::createROPGAuthenticatingClient	(	const std::string &	clientIdentifier,
		const ::tenduke::se::BackendConfiguration &	backendConfiguration,
		const ::tenduke::se::ClientProperties &	clientProperties,
		const ::tenduke::oauth::OAuthBackendConfiguration &	oauthBackendConfiguration,
		const ::tenduke::oidc::OIDCConfiguration &	oidcConfiguration,
		const ::tenduke::oidc::ropg::ROPGAuthenticationConfig &	authenticationConfig,
		const std::string &	initialStateAsJSON = "",
		const ::tenduke::ServiceConfiguration &	serviceConfiguration = ::tenduke::ServiceConfiguration() )

Creates stateful client, which authenticates user with OAuth Resource Owner Password Grant, configured with provided configuration.

Parameters

clientIdentifier	identifies the client, used as User-Agent in HTTP-requests
backendConfiguration	configuration of 10Duke Scale backend
clientProperties	client properties, see the class for details
oauthBackendConfiguration	OAuth backend configuration (for user authentication)
oidcConfiguration	OIDC configuration (for user authentication)
authenticationConfig	configuration for ROPG OIDC authentication
initialStateAsJSON	initial client state as JSON. Optional.
serviceConfiguration	generic service configuration. Optional.

Returns

-

createROPGAuthenticatingClientUsingAutodiscovery()

std::unique_ptr<::tenduke::se::TendukeClientWithOIDCSession > tenduke::se::createROPGAuthenticatingClientUsingAutodiscovery	(	const std::string &	clientIdentifier,
		const ::tenduke::se::BackendConfiguration &	backendConfiguration,
		const ::tenduke::se::ClientProperties &	clientProperties,
		const std::string &	oidcAutodiscoveryURL,
		const ::tenduke::oidc::ropg::ROPGAuthenticationConfig &	authenticationConfig,
		const std::string &	initialStateAsJSON = "",
		const ::tenduke::ServiceConfiguration &	serviceConfiguration = ::tenduke::ServiceConfiguration() )

Creates stateful client, which authenticates user with OAuth Resource Owner Password Grant, configured using OIDC auto discovery.

Parameters

clientIdentifier	identifies the client, used as User-Agent in HTTP-requests
backendConfiguration	10Duke Scale backend configuration
clientProperties	Client properties
oidcAutodiscoveryURL	URL to OIDC-autodiscovery document
authenticationConfig	configuration for browser-based OIDC authentication
initialStateAsJSON	initial client state as JSON. Optional.
serviceConfiguration	generic service configuration. Optional.

Returns

-

createTendukeClientForBrowser()

std::unique_ptr<::tenduke::se::TendukeClientWithOIDCSession > tenduke::se::createTendukeClientForBrowser	(	const std::string &	clientIdentifier,
		const ::tenduke::se::BackendConfiguration &	backendConfiguration,
		const ::tenduke::se::ClientProperties &	clientProperties,
		const ::tenduke::oauth::OAuthBackendConfiguration &	oauthBackendConfiguration,
		const ::tenduke::oidc::OIDCConfiguration &	oidcConfiguration,
		const ::tenduke::oidc::osbrowser::BrowserAuthenticationConfig &	authenticationConfig,
		const std::string &	initialStateAsJSON = "",
		const ::tenduke::ServiceConfiguration &	serviceConfiguration = ::tenduke::ServiceConfiguration() )

Creates stateful client, which authenticates user with default OS-browser, using provided configuration.

Parameters

clientIdentifier	identifies the client, used as User-Agent in HTTP-requests
backendConfiguration	configuration of 10Duke Scale backend
clientProperties	client properties, see the class for details
oauthBackendConfiguration	OAuth backend configuration (for user authentication)
oidcConfiguration	OIDC configuration (for user authentication)
authenticationConfig	configuration for browser-based OIDC authentication
initialStateAsJSON	initial client state as JSON. Optional.
serviceConfiguration	generic service configuration. Optional.

Returns

-

createTendukeClientForBrowserUsingAutodiscovery()

std::unique_ptr<::tenduke::se::TendukeClientWithOIDCSession > tenduke::se::createTendukeClientForBrowserUsingAutodiscovery	(	const std::string &	clientIdentifier,
		const ::tenduke::se::BackendConfiguration &	backendConfiguration,
		const ::tenduke::se::ClientProperties &	clientProperties,
		const std::string &	oidcAutodiscoveryURL,
		const ::tenduke::oidc::osbrowser::BrowserAuthenticationConfig &	authenticationConfig,
		const std::string &	initialStateAsJSON = "",
		const ::tenduke::ServiceConfiguration &	serviceConfiguration = ::tenduke::ServiceConfiguration() )

Creates stateful client, which authenticates user with default OS-browser, using OIDC auto-discovery.

Parameters

clientIdentifier	identifies the client, used as User-Agent in HTTP-requests
backendConfiguration	10Duke Scale backend configuration
clientProperties	Client properties
oidcAutodiscoveryURL	URL to OIDC-autodiscovery document
authenticationConfig	configuration for browser-based OIDC authentication
initialStateAsJSON	initial client state as JSON. Optional.
serviceConfiguration	generic service configuration. Optional.

Returns

-

createTendukeClientForDevice()

std::unique_ptr<::tenduke::se::TendukeClientWithOIDCSession > tenduke::se::createTendukeClientForDevice	(	const std::string &	clientIdentifier,
		const ::tenduke::se::BackendConfiguration &	backendConfiguration,
		const ::tenduke::se::ClientProperties &	clientProperties,
		const ::tenduke::oauth::OAuthBackendConfiguration &	oauthBackendConfiguration,
		const ::tenduke::oidc::OIDCConfiguration &	oidcConfiguration,
		const ::tenduke::oidc::device::DeviceAuthenticationConfig &	authenticationConfig,
		const std::string &	initialStateAsJSON = "",
		const ::tenduke::ServiceConfiguration &	serviceConfiguration = ::tenduke::ServiceConfiguration() )

Creates stateful client, which authenticates user with OAuth Device Flow, using provided configuration.

Parameters

clientIdentifier	identifies the client, used as User-Agent in HTTP-requests
oauthBackendConfiguration	OAuth backend configuration (for user authentication)
oidcConfiguration	OIDC configuration (for user authentication)
backendConfiguration	10Duke Scale backend configuration
clientProperties	Client properties
authenticationConfig	-
initialStateAsJSON	Initial client state as JSON.
serviceConfiguration	-

Returns

-

createTendukeClientForDeviceClientUsingAutodiscovery()

std::unique_ptr<::TendukeClientWithOIDCSession > tenduke::se::createTendukeClientForDeviceClientUsingAutodiscovery	(	const std::string &	clientIdentifier,
		const ::tenduke::se::BackendConfiguration &	backendConfiguration,
		const ::tenduke::se::ClientProperties &	clientProperties,
		const std::string &	oidcAutodiscoveryURL,
		const ::tenduke::oidc::device::DeviceAuthenticationConfig &	authenticationConfig,
		const std::string &	initialStateAsJSON = "",
		const ::tenduke::ServiceConfiguration &	serviceConfiguration = ::tenduke::ServiceConfiguration() )

Creates stateful client, which authenticates user with OAuth Device Flow, using OIDC auto-discovery.

Parameters

clientIdentifier	identifies the client, used as User-Agent in HTTP-requests
backendConfiguration	10Duke Scale backend configuration
clientProperties	Client properties
oidcAutodiscoveryURL	URL to OIDC discovery document
authenticationConfig	-
initialStateAsJSON	Initial client state as JSON.
serviceConfiguration	-

Returns

-

createTendukeClientForLicenseKeyUsage()

std::unique_ptr<::tenduke::se::TendukeClient > tenduke::se::createTendukeClientForLicenseKeyUsage	(	const std::string &	clientIdentifier,
		const ::tenduke::se::BackendConfiguration &	backendConfiguration,
		const ::tenduke::se::ClientProperties &	clientProperties,
		const std::string &	initialStateAsJson = "",
		const ::tenduke::ServiceConfiguration &	serviceConfiguration = ::tenduke::ServiceConfiguration() )

Creates a client for using license-key -operations only.

This client does not maintain or do any logins and is really useful only for license-key operations (checkouts, heartbeats and releases or metered use with license key).

Calling any other endpoints of LicensingClient will cause errors.

Parameters

clientIdentifier	identifies the client, used as User-Agent in HTTP-requests
backendConfiguration	10Duke Scale backend configuration
clientProperties	Client properties
initialStateAsJson	Initial client state as JSON.
serviceConfiguration	Generic service configuration

Returns

-