createSessionFromSecureConnection()

std::optional< SessionPrx > Glacier2::RouterPrx::createSessionFromSecureConnection

(

const Ice::Context &

context = Ice::noExplicitContext

)

const

Creates a per-client session with the router.

The user is authenticated through the SSL certificate(s) associated with the connection. If an Glacier2::SSLSessionManagerPrx is configured, a proxy to a Glacier2::SessionPrx object is returned to the client. Otherwise, null is returned and only an internal session (i.e., not visible to the client) is created. If a non-null session proxy is returned, it must be configured to route through the router that created it. This occurs automatically when the router is configured as the client's default router at the time the session proxy is created in the client application; otherwise, the client must configure the session proxy explicitly.

Parameters

context

The request context.

Returns

A proxy for the newly created session, or null if no Glacier2::SSLSessionManagerPrx is configured.

Exceptions

Glacier2::CannotCreateSessionException	Thrown when the session cannot be created.
Glacier2::PermissionDeniedException	Thrown when an authentication or authorization failure occurs.

See also

Session

SessionManager

PermissionsVerifier