Method setExternalConnections

app/src/API/Server.cpp:471–519

* @brief Sets whether the server accepts connections from external hosts. */

 * @brief Sets whether the server accepts connections from external hosts.
 */
void API::Server::setExternalConnections(const bool enabled)
{
  if (m_externalConnections == enabled)
    return;

  if (enabled) {
    const int result = Misc::Utilities::showMessageBox(
      tr("Allow External API Connections?"),
      tr("Exposing the API server to external hosts allows other devices on your "
         "network to connect to Serial Studio on port 7777.\n\n"
         "Only enable this on trusted networks. "
         "Untrusted clients may read live data or send commands to your device."),
      QMessageBox::Warning,
      QString(),
      QMessageBox::Yes | QMessageBox::No,
      QMessageBox::No);

    if (result == QMessageBox::No) {
      m_externalConnections = false;
      m_settings.setValue("API/ExternalConnections", false);
      Q_EMIT externalConnectionsChanged();
      return;
    }
  }

  m_externalConnections = enabled;
  m_settings.setValue("API/ExternalConnections", m_externalConnections);
  Q_EMIT externalConnectionsChanged();

  if (m_externalConnections)
    ensureAuthToken();

  if (m_enabled) {
    m_server.close();
    m_connections.clear();
    auto* worker = static_cast<ServerWorker*>(m_worker);
    QMetaObject::invokeMethod(worker, "closeResources", Qt::QueuedConnection);

    const auto address = m_externalConnections ? QHostAddress::Any : QHostAddress::LocalHost;
    m_server.setMaxPendingConnections(kMaxApiClients);
    if (!m_server.listen(address, API_TCP_PORT)) {
      Misc::Utilities::showMessageBox(
        tr("Unable to restart API TCP server"), m_server.errorString(), QMessageBox::Warning);
      m_server.close();
      m_enabled = false;
      Q_EMIT enabledChanged();
    }
  }
}

//--------------------------------------------------------------------------------------------------
// Server: authentication (external connections)