EDataServer.SourceSecurity¶

Subclasses:: None

Methods¶

Inherited:: EDataServer.SourceExtension (4), GObject.Object (37)
Structs:: GObject.ObjectClass (5)

	`dup_method` ()
	`get_method` ()
	`get_secure` ()
	`set_method` (method)
	`set_secure` (secure)

Virtual Methods¶

Inherited:: GObject.Object (7)

Properties¶

Inherited:: EDataServer.SourceExtension (1)

Name	Type	Flags	Short Description
`method`	`str`	r/w/c/en	Security method
`secure`	`bool`	r/w/en	Secure the network connection

Signals¶

Inherited:: GObject.Object (1)

Fields¶

Inherited:: GObject.Object (1)

Name	Type	Access	Description
parent	`EDataServer.SourceExtension`	r

Class Details¶

class EDataServer.SourceSecurity(**kwargs)¶

Bases:: EDataServer.SourceExtension
Abstract:: No
Structure:: EDataServer.SourceSecurityClass

Contains only private data that should be read and manipulated using the functions below.

New in version 3.6.

dup_method()¶

Returns:: a newly-allocated copy of EDataServer.SourceSecurity :method
Return type:: str

Thread-safe variation of EDataServer.SourceSecurity.get_method(). Use this function when accessing self from multiple threads.

The returned string should be freed with GLib.free() when no longer needed.

New in version 3.6.

get_method()¶

Returns:: the method used to establish a secure network connection
Return type:: str

Returns the method used to establish a secure network connection to a remote account. There are no pre-defined method names; backends are free to set this however they wish. If a secure connection is not desired, the convention is to set EDataServer.SourceSecurity :method to “none”.

New in version 3.6.

get_secure()¶

Returns:: whether a secure network connection is desired
Return type:: bool

This is a convenience function which returns whether a secure network connection is desired, regardless of the method used. This relies on the convention of setting EDataServer.SourceSecurity :method to “none” when a secure network connection is not desired.

New in version 3.6.

set_method(method)¶

Parameters:: method (str or None) – security method, or None

Sets the method used to establish a secure network connection to a remote account. There are no pre-defined method names; backends are free to set this however they wish. If a secure connection is not desired, the convention is to set EDataServer.SourceSecurity :method to “none”. In keeping with that convention, EDataServer.SourceSecurity :method will be set to “none” if method is None or an empty string.

New in version 3.6.

set_secure(secure)¶

Parameters:: secure (bool) – whether a secure network connection is desired

This function provides a simpler way to set EDataServer.SourceSecurity :method when using a secure network connection is a yes or no option and the exact method name is unimportant. If secure is False, the EDataServer.SourceSecurity :method property is set to “none”. If secure is True, the function assumes the backend will use Transport Layer Security and sets the EDataServer.SourceSecurity :method property to “tls”.

New in version 3.6.

Property Details¶

EDataServer.SourceSecurity.props.method¶

Name:: method
Type:: str
Default Value:: 'none'
Flags:: READABLE, WRITABLE, CONSTRUCT, EXPLICIT_NOTIFY

Security method

EDataServer.SourceSecurity.props.secure¶

Name:: secure
Type:: bool
Default Value:: False
Flags:: READABLE, WRITABLE, EXPLICIT_NOTIFY

Secure the network connection