Skip to content

How to fix mobile app issues caused by untrusted certificates

Author11/13/26Writing Date4 minReading TimeTroubleshootingCategoryTrueConf ServerTrueConf for AndroidCertificatesTag

With the release of version 3.3.1 of the TrueConf Android client app, security for handling SSL/TLS certificates received from TrueConf Server has been improved. As a result, some customers may have encountered certain issues on their mobile devices.

Instructions for TrueConf system administrators

Here is how the problems may manifest themselves:

  • The list of authentication providers (AD FS, Keycloak, etc.) is not displayed on the server connection screen.

  • Unable to access some sections of the app that are loaded from the server via the web (for example, opening surveys or another smart app).

  • The upcoming scheduled events are not displayed in the Conferences section.

The cause of these issues is the use of SSL/TLS certificates on the server side that are not trusted by the Android OS itself. These are the certificates configured in the Web → HTTPS section of the server control panel.

Fixing the untrusted certificate issue

Updating TrueConf Server to version 5.5.9+

The most reliable solution is to update TrueConf Server to version 5.5.9 or newer. Its release is expected between November 16 and 20, 2026. Starting with this release, the server will exchange its certificates with client applications in a secure manner with certificate verification.

Manually adding the required parameter for TrueConf Server versions 5.3.x - 5.5.8

You need to manually add a parameter with the public keys of your TLS/SSL certificates to your TrueConf Server. If your company uses TrueConf Enterprise 1.x, apply the setting described below on all servers of the complex. Once the parameter is added, it will be automatically sent to client applications.

Adding a parameter to resolve certificate issues:

  1. Prepare a JSON file containing the list of public keys of the certificates used on the server. To do this, go to the Web → HTTPS section and click the Download ca.crt link:

    Раздел Веб → HTTPS панели управления TrueConf Server, ссылка Скачать ca.crt в блоке Самоподписанный сертификат
  2. Replace all line breaks with /n by running a simple command in the terminal (command prompt):

    1. Linux

      sed -z 's|\n|/n|g' path/ca.crt

      where path is the path to the downloaded certificate.

    2. Windows

      powershell -NoProfile -Command "(Get-Content -Raw 'path\ca.crt') -replace '\r?\n','/n' | Set-Content path\cert_one_line.txt' -NoNewline"

      where path is the path to the downloaded certificate.

      The result will be saved to the cert_one_line.txt file next to the certificate.

  3. Paste the string obtained in cert_one_line.txt into the JSON template below:

    • For Windows OS (note the slash escaping):

      { \"certificates\": [ \"YOUR_KEY\" ] }
    • For Linux:

      {  "certificates": [ "YOUR_KEY" ] }

    Example of the expected result on Windows:

    {  \"certificates\": [ \"-----BEGIN CERTIFICATE-----\nMIIE123123ААА9jt6ZlDg==\n-----END CERTIFICATE-----\" ] }

    Example of the expected result on Linux:

    {  "certificates": [ "-----BEGIN CERTIFICATE-----\nMIIE123123ААА9jt6ZlDg==\n-----END CERTIFICATE-----" ] }
  4. Add the resulting string to the list of parameters on the servers:

    1. If the server is installed on Linux, log in to the OS where the server is running and run the following command in the terminal:

      sudo /opt/trueconf/server/bin/vcs/tc_regkey set appproperties web_ca str 'json'
    2. If the server is installed on Windows, open the cmd terminal (command prompt) as administrator and run the command

      cd "C:\Program Files\TrueConf Server"
      .\tc_regkey.exe set AppProperties web_ca str "json"

    where json is the text from step 3.

  5. Restart services:

    1. on Linux OS: trueconf and trueconf-manager

    2. on Windows OS: TrueConf Server and TrueConf Server Manager.

Please note that TrueConf officially provides security patches for 3 major releases of TrueConf Server, namely versions 5.5, 5.4, and 5.3. If your server version is lower than 5.3, we recommend that you contact us to discuss upgrading to the nearest secure release.