x2gobroker.uccsjson module¶
This modules provides various helper functions and classes for the UCCS web frontend of the X2Go Session Broker.
The UCCS protocol was originally brought to life by Canonical and was part of Unity Greeter in Ubuntu 12.10.
See early blog posts about that topic:
The UCCS web frontend of the X2Go Session Broker offers remote logon support to the Unity Greeter fork called Arctica Greeter.
- class x2gobroker.uccsjson.AdditionalManagementServer[source]¶
Bases:
object
Instantiate a to-be-cascaded sub-management UCCS server.
In UCCS, other than terminal servers, you can add
AdditionalManagementServer
instances and cascade UCCS setups.- Parameters:
url (
str
) – URL of the UCCS broker servername (
str
) – human-readable, descriptive server nameapi_version (
int
) – API version used between remote logon service and broker
- class x2gobroker.uccsjson.ICAServer(host, name, username='', password='', api_version=5)[source]¶
Bases:
object
Instantiate a UCCS compatible ICA server session profile object.
- Parameters:
host (
str
) – hostname of ICA server hostname (
str
) – session profile nameusername (
str
) – username to be used for loginpassword (
str
) – password to be used for loginapi_version (
int
) – API version used between remote logon service and broker
- class x2gobroker.uccsjson.ManagementServer(url, name, api_version=5)[source]¶
Bases:
object
Generate a UCCS compatible JSON object for a UCCS management server.
A
ManagementServer
in UCCS terminology is a host offering a UCCS compliant API for handling remote logons from clients over the web.The
ManagementServer
is the entry point for all clients.- Parameters:
url (
str
) – URL of the UCCS broker servername (
str
) – human-readable, descriptive server nameapi_version (
int
) – API version used between remote logon service and broker
- add_additional_management_server(amserver)[source]¶
Add / cascade a managemnet server to this management server object.
- Parameters:
server (
obj
) – instance of classAdditionalManagementServer
- add_terminalserver(server)[source]¶
Add a terminal server to this management server object.
- Parameters:
server (
obj
) – instance of classRDPServer
orX2GoServer
- class x2gobroker.uccsjson.RDPServer(host, name, username='', password='', api_version=5)[source]¶
Bases:
object
Instantiate a UCCS compatible RDP server session profile object.
- Parameters:
host (
str
) – hostname of RDP server hostname (
str
) – session profile nameusername (
str
) – username to be used for loginpassword (
str
) – password to be used for loginapi_version (
int
) – API version used between remote logon service and broker
- class x2gobroker.uccsjson.X2GoServer(host, name, username='', password='', api_version=5)[source]¶
Bases:
object
Instantiate a UCCS compatible X2Go Server session profile object.
- Parameters:
host (
str
) – hostname of X2Go Server hostname (
str
) – session profile nameusername (
str
) – username to be used for loginpassword (
str
) – password to be used for loginapi_version (
int
) – API version used between remote logon service and broker
- set_command(command)[source]¶
Set the command to be used on this X2Go Server.
Added since APIv5 of the UCCS protocol.
- Parameters:
command (
str
) – the session type to be set- Raises:
TypeError – command has to be
str
- set_session_type(session_type)[source]¶
Set the session type to be used on this X2Go Server.
This method is a legacy method formerly used by APIv4 of the UCCS protocol. In APIv5, the method
set_command()
gets used instead.- Parameters:
command (
str
) – the session type to be set- Raises:
TypeError – command has to be
str