// This assembly is included in the following assemblies:
//
// master.adoc

:parent-context: {context}

[id='assembly-connecting-applications-{context}']
= Connecting applications to {ProductName}

You can connect your application to {ProductName} using one of the following client examples.

* xref:ref-python-example-messaging[{ClientAmqpPythonName}]
* xref:ref-jms-example-messaging[{ClientAmqpJmsName}]
* xref:ref-javascript-example-messaging[{ClientAmqpJavaScriptName}]
* xref:ref-cpp-example-messaging[{ClientAmqpCppName}]
* xref:ref-dotnet-example-messaging[{ClientAmqpDotNetName}]

To connect to the messaging service from outside the OpenShift 
ifdef::Kubernetes[or Kubernetes ]
cluster, TLS must be used with SNI set to specify the fully qualified host name for the address space. The port used is 443.

The messaging protocols supported depends on the type of address space used. For more information, see the  xref:con-address-space-messaging[address space] section.

//TODO: Add information about retrieving the CA certificate and using
//that in the client examples.

//TODO: Add information about authentication.

[id='client-examples-{context}']
== Client examples

include::../modules/ref-python-example.adoc[leveloffset=+1]

include::../modules/ref-jms-example.adoc[leveloffset=+2]

include::../modules/ref-javascript-example.adoc[leveloffset=+2]

include::../modules/ref-cpp-example.adoc[leveloffset=+2]

include::../modules/ref-dotnet-example.adoc[leveloffset=+2]


//TODO: add links for all these clients

:context: {parent-context}
