***********************************
Connect to the Coordinator with TLS
***********************************

Problem
=======

You want to connect to a Coordinator requiring a secured connection.



Solution
========


If the Coordinator and Agent(s) are using secured communications, any client code submitting jobs must also 
enable the option to use SSL.
To do this, set the ClusterJobScheduler's :py:attr:`use_ssl <agiparallel.client.ClusterJobScheduler.use_ssl>` 
property to :py:obj:`True`.
If using self-signed certificates, set the :py:attr:`allow_self_signed_certificates 
<agiparallel.client.ClusterJobScheduler.allow_self_signed_certificates>` property to :py:obj:`True`.


If the Coordinator and Agent(s) are using mutual SSL, any client code must provide a client certificate.
To do this, set the ClusterJobScheduler's 
:py:attr:`provide_client_certificate <agiparallel.client.ClusterJobScheduler.provide_client_certificate>` 
property to :py:obj:`True`. Then, to specify a certificate, set the :py:attr:`client_certificate_certfile <agiparallel.client.ClusterJobScheduler.client_certificate_certfile>` property 
to the path of a certificate file.


To verify the Coordinator's certificate, set the :py:attr:`coordinator_thumbprint <agiparallel.client.ClusterJobScheduler.coordinator_thumbprint>` property to the Coordinator's certificate thumbprint (found on the Coordinator's connection settings page).

All of these properties need to be set in the ClusterJobScheduler's initialization.

.. literalinclude:: ..\..\..\code\HowTos\SecuredConnection.py
	:language: python
	:linenos: