All Downloads are FREE. Search and download functionalities are using the official Maven repository.

org.apache.gravitino.server.web.JettyServerConfig Maven / Gradle / Ivy

Go to download

Gravitino is a high-performance, geo-distributed and federated metadata lake.

There is a newer version: 0.6.1-incubating
Show newest version
/*
 * Licensed to the Apache Software Foundation (ASF) under one
 * or more contributor license agreements.  See the NOTICE file
 * distributed with this work for additional information
 * regarding copyright ownership.  The ASF licenses this file
 * to you under the Apache License, Version 2.0 (the
 * "License"); you may not use this file except in compliance
 * with the License.  You may obtain a copy of the License at
 *
 *  http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing,
 * software distributed under the License is distributed on an
 * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
 * KIND, either express or implied.  See the License for the
 * specific language governing permissions and limitations
 * under the License.
 */
package org.apache.gravitino.server.web;

import com.google.common.annotations.VisibleForTesting;
import com.google.common.base.Preconditions;
import com.google.common.collect.Sets;
import java.security.KeyManagementException;
import java.security.NoSuchAlgorithmException;
import java.util.Collections;
import java.util.HashMap;
import java.util.Map;
import java.util.Optional;
import java.util.Set;
import javax.net.ssl.SSLContext;
import org.apache.commons.lang3.StringUtils;
import org.apache.gravitino.Config;
import org.apache.gravitino.OverwriteDefaultConfig;
import org.apache.gravitino.config.ConfigBuilder;
import org.apache.gravitino.config.ConfigConstants;
import org.apache.gravitino.config.ConfigEntry;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

public final class JettyServerConfig {
  private static final Logger LOG = LoggerFactory.getLogger(JettyServerConfig.class);
  public static final String GRAVITINO_SERVER_CONFIG_PREFIX = "gravitino.server.webserver.";
  private static final String SPLITTER = ",";
  public static final int DEFAULT_GRAVITINO_WEBSERVER_HTTP_PORT = 8090;
  public static final int DEFAULT_GRAVITINO_WEBSERVER_HTTPS_PORT = 8433;

  public static final ConfigEntry WEBSERVER_HOST =
      new ConfigBuilder("host")
          .doc("The host name of the Jetty web server")
          .version(ConfigConstants.VERSION_0_1_0)
          .stringConf()
          .createWithDefault("0.0.0.0");

  public static final ConfigEntry WEBSERVER_HTTP_PORT =
      new ConfigBuilder(ConfigConstants.WEBSERVER_HTTP_PORT)
          .doc("The http port number of the Jetty web server")
          .version(ConfigConstants.VERSION_0_1_0)
          .intConf()
          .checkValue(value -> value >= 0, ConfigConstants.NON_NEGATIVE_NUMBER_ERROR_MSG)
          .createWithDefault(DEFAULT_GRAVITINO_WEBSERVER_HTTP_PORT);

  public static final ConfigEntry WEBSERVER_MIN_THREADS =
      new ConfigBuilder("minThreads")
          .doc("The minimum number of threads in the thread pool used by Jetty webserver")
          .version(ConfigConstants.VERSION_0_2_0)
          .intConf()
          .checkValue(value -> value > 0, ConfigConstants.POSITIVE_NUMBER_ERROR_MSG)
          .createWithDefault(
              Math.max(Math.min(Runtime.getRuntime().availableProcessors() * 2, 100), 4));

  public static final ConfigEntry WEBSERVER_MAX_THREADS =
      new ConfigBuilder("maxThreads")
          .doc("The maximum number of threads in the thread pool used by Jetty webserver")
          .version(ConfigConstants.VERSION_0_1_0)
          .intConf()
          .checkValue(value -> value > 0, ConfigConstants.POSITIVE_NUMBER_ERROR_MSG)
          .createWithDefault(Math.max(Runtime.getRuntime().availableProcessors() * 4, 400));

  public static final ConfigEntry WEBSERVER_STOP_TIMEOUT =
      new ConfigBuilder("stopTimeout")
          .doc("Time in milliseconds to gracefully shutdown the Jetty webserver")
          .version(ConfigConstants.VERSION_0_2_0)
          .longConf()
          .checkValue(value -> value > 0, ConfigConstants.POSITIVE_NUMBER_ERROR_MSG)
          .createWithDefault(30 * 1000L);

  public static final ConfigEntry WEBSERVER_IDLE_TIMEOUT =
      new ConfigBuilder("idleTimeout")
          .doc("The timeout in milliseconds of idle connections")
          .version(ConfigConstants.VERSION_0_2_0)
          .intConf()
          .checkValue(value -> value > 0, ConfigConstants.POSITIVE_NUMBER_ERROR_MSG)
          .createWithDefault(30 * 1000);

  public static final ConfigEntry WEBSERVER_REQUEST_HEADER_SIZE =
      new ConfigBuilder("requestHeaderSize")
          .doc("Maximum size of HTTP requests")
          .version(ConfigConstants.VERSION_0_1_0)
          .intConf()
          .checkValue(value -> value > 0, ConfigConstants.POSITIVE_NUMBER_ERROR_MSG)
          .createWithDefault(128 * 1024);

  public static final ConfigEntry WEBSERVER_RESPONSE_HEADER_SIZE =
      new ConfigBuilder("responseHeaderSize")
          .doc("Maximum size of HTTP responses")
          .version(ConfigConstants.VERSION_0_1_0)
          .intConf()
          .checkValue(value -> value > 0, ConfigConstants.POSITIVE_NUMBER_ERROR_MSG)
          .createWithDefault(128 * 1024);

  public static final ConfigEntry WEBSERVER_THREAD_POOL_WORK_QUEUE_SIZE =
      new ConfigBuilder("threadPoolWorkQueueSize")
          .doc("The size of the queue in the thread pool used by Jetty webserver")
          .version(ConfigConstants.VERSION_0_1_0)
          .intConf()
          .checkValue(value -> value > 0, ConfigConstants.POSITIVE_NUMBER_ERROR_MSG)
          .createWithDefault(100);

  public static final ConfigEntry ENABLE_HTTPS =
      new ConfigBuilder("enableHttps")
          .doc("Enable https")
          .version(ConfigConstants.VERSION_0_3_0)
          .booleanConf()
          .createWithDefault(false);

  public static final ConfigEntry WEBSERVER_HTTPS_PORT =
      new ConfigBuilder(ConfigConstants.WEBSERVER_HTTPS_PORT)
          .doc("The https port number of the Jetty web server")
          .version(ConfigConstants.VERSION_0_3_0)
          .intConf()
          .checkValue(value -> value >= 0, ConfigConstants.NON_NEGATIVE_NUMBER_ERROR_MSG)
          .createWithDefault(DEFAULT_GRAVITINO_WEBSERVER_HTTPS_PORT);

  public static final ConfigEntry SSL_KEYSTORE_PATH =
      new ConfigBuilder("keyStorePath")
          .doc("Path to the key store file")
          .version(ConfigConstants.VERSION_0_3_0)
          .stringConf()
          .checkValue(StringUtils::isNotBlank, ConfigConstants.NOT_BLANK_ERROR_MSG)
          .create();

  public static final ConfigEntry SSL_KEYSTORE_PASSWORD =
      new ConfigBuilder("keyStorePassword")
          .doc("Password to the key store")
          .version(ConfigConstants.VERSION_0_3_0)
          .stringConf()
          .checkValue(StringUtils::isNotBlank, ConfigConstants.NOT_BLANK_ERROR_MSG)
          .create();

  public static final ConfigEntry SSL_MANAGER_PASSWORD =
      new ConfigBuilder("managerPassword")
          .doc("Manager password to the key store")
          .version(ConfigConstants.VERSION_0_3_0)
          .stringConf()
          .checkValue(StringUtils::isNotBlank, ConfigConstants.NOT_BLANK_ERROR_MSG)
          .create();

  public static final ConfigEntry SSL_KEYSTORE_TYPE =
      new ConfigBuilder("keyStoreType")
          .doc("The type to the key store")
          .version(ConfigConstants.VERSION_0_3_0)
          .stringConf()
          .createWithDefault("JKS");

  public static final ConfigEntry> SSL_PROTOCOL =
      new ConfigBuilder("tlsProtocol")
          .doc("TLS protocol to use. The protocol must be supported by JVM")
          .version(ConfigConstants.VERSION_0_3_0)
          .stringConf()
          .createWithOptional();

  public static final ConfigEntry ENABLE_CIPHER_ALGORITHMS =
      new ConfigBuilder("enableCipherAlgorithms")
          .doc("The collection of the cipher algorithms are enabled ")
          .version(ConfigConstants.VERSION_0_3_0)
          .stringConf()
          .createWithDefault("");

  public static final ConfigEntry ENABLE_CLIENT_AUTH =
      new ConfigBuilder("enableClientAuth")
          .doc("Enable the authentication of the client")
          .version(ConfigConstants.VERSION_0_3_0)
          .booleanConf()
          .createWithDefault(false);

  public static final ConfigEntry SSL_TRUST_STORE_PATH =
      new ConfigBuilder("trustStorePath")
          .doc("Path to the trust store file")
          .version(ConfigConstants.VERSION_0_3_0)
          .stringConf()
          .checkValue(StringUtils::isNotBlank, ConfigConstants.NOT_BLANK_ERROR_MSG)
          .create();

  public static final ConfigEntry SSL_TRUST_STORE_PASSWORD =
      new ConfigBuilder("trustStorePassword")
          .doc("Password to the trust store")
          .version(ConfigConstants.VERSION_0_3_0)
          .stringConf()
          .checkValue(StringUtils::isNotBlank, ConfigConstants.NOT_BLANK_ERROR_MSG)
          .create();

  public static final ConfigEntry SSL_TRUST_STORE_TYPE =
      new ConfigBuilder("trustStoreType")
          .doc("The type to the trust store")
          .version(ConfigConstants.VERSION_0_3_0)
          .stringConf()
          .createWithDefault("JKS");

  public static final ConfigEntry> CUSTOM_FILTERS =
      new ConfigBuilder("customFilters")
          .doc("Comma separated list of filter class names to apply to the APIs")
          .version(ConfigConstants.VERSION_0_4_0)
          .stringConf()
          .createWithOptional();
  public static final ConfigEntry ENABLE_CORS_FILTER =
      new ConfigBuilder("enableCorsFilter")
          .doc("Enable cross origin resource share filter")
          .version(ConfigConstants.VERSION_0_4_0)
          .booleanConf()
          .createWithDefault(false);

  public static final ConfigEntry ALLOWED_ORIGINS =
      new ConfigBuilder("allowedOrigins")
          .doc(
              "A comma separated list of origins that are allowed to access the resources."
                  + " Default value is *, means all origins")
          .version(ConfigConstants.VERSION_0_4_0)
          .stringConf()
          .createWithDefault("*");

  public static final ConfigEntry ALLOWED_TIMING_ORIGINS =
      new ConfigBuilder("allowedTimingOrigins")
          .doc(
              "A comma separated list of origins that are allowed to time the resource."
                  + " Default value is the empty string, means no origins.")
          .version(ConfigConstants.VERSION_0_4_0)
          .stringConf()
          .createWithDefault("");

  public static final ConfigEntry ALLOWED_METHODS =
      new ConfigBuilder("allowedMethods")
          .doc(
              "A comma separated list of HTTP methods that are allowed to be used when accessing the resources."
                  + " Default value is GET,POST,HEAD,DELETE")
          .version(ConfigConstants.VERSION_0_4_0)
          .stringConf()
          .createWithDefault("GET,POST,HEAD,DELETE,PUT");

  public static final ConfigEntry ALLOWED_HEADERS =
      new ConfigBuilder("allowedHeaders")
          .doc(
              "A comma separated list of HTTP headers that are allowed to be specified when accessing the resources."
                  + " Default value is X-Requested-With,Content-Type,Accept,Origin. If the value is a single *,"
                  + " this means that any headers will be accepted.")
          .version(ConfigConstants.VERSION_0_4_0)
          .stringConf()
          .createWithDefault("X-Requested-With,Content-Type,Accept,Origin");

  public static final ConfigEntry PREFLIGHT_MAX_AGE_IN_SECS =
      new ConfigBuilder("preflightMaxAgeInSecs")
          .doc(
              "The number of seconds that preflight requests can be cached by the client."
                  + " Default value is 1800 seconds, or 30 minutes")
          .version(ConfigConstants.VERSION_0_4_0)
          .intConf()
          .checkValue(value -> value > 0, ConfigConstants.POSITIVE_NUMBER_ERROR_MSG)
          .createWithDefault(1800);

  public static final ConfigEntry ALLOW_CREDENTIALS =
      new ConfigBuilder("allowCredentials")
          .doc(
              "A boolean indicating if the resource allows requests with credentials. Default value is true")
          .version(ConfigConstants.VERSION_0_4_0)
          .booleanConf()
          .createWithDefault(true);

  public static final ConfigEntry EXPOSED_HEADERS =
      new ConfigBuilder("exposedHeaders")
          .doc(
              "A comma separated list of HTTP headers that are allowed to be exposed on the client."
                  + " Default value is the empty list")
          .version(ConfigConstants.VERSION_0_4_0)
          .stringConf()
          .createWithDefault("");

  public static final ConfigEntry CHAIN_PREFLIGHT =
      new ConfigBuilder("chainPreflight")
          .doc(
              "If true preflight requests are chained to their target resource for normal handling "
                  + "(as an OPTION request). Otherwise the filter will response to the preflight. Default is true.")
          .version(ConfigConstants.VERSION_0_4_0)
          .booleanConf()
          .createWithDefault(true);

  private final String host;

  private final int httpPort;

  private final int minThreads;

  private final int maxThreads;

  private final long stopTimeout;

  private final int idleTimeout;

  private final int requestHeaderSize;

  private final int responseHeaderSize;

  private final int threadPoolWorkQueueSize;

  private final int httpsPort;
  private final String keyStorePath;
  private final String keyStorePassword;
  private final String managerPassword;
  private final boolean enableHttps;
  private final String keyStoreType;
  private final Optional tlsProtocol;
  private final Set enableCipherAlgorithms;
  private final boolean enableClientAuth;
  private final String trustStorePath;
  private final String trustStorePassword;
  private final Set customFilters;
  private final String trustStoreType;
  private final boolean enableCorsFilter;
  private final String allowedOrigins;
  private final String allowedTimingOrigins;
  private final int preflightMaxAgeInSecs;
  private final String allowedMethods;
  private final String allowedHeaders;
  private final boolean allowCredentials;
  private final String exposedHeaders;
  private final boolean chainPreflight;

  private final Config internalConfig;

  private JettyServerConfig(Map configs) {
    this.internalConfig = new Config(false) {};
    internalConfig.loadFromMap(configs, t -> true);

    this.host = internalConfig.get(WEBSERVER_HOST);
    this.httpPort = internalConfig.get(WEBSERVER_HTTP_PORT);

    int minThreads = internalConfig.get(WEBSERVER_MIN_THREADS);
    int maxThreads = internalConfig.get(WEBSERVER_MAX_THREADS);
    Preconditions.checkArgument(
        maxThreads >= minThreads,
        String.format("maxThreads:%d should not less than minThreads:%d", maxThreads, minThreads));
    // at lease acceptor thread + select thread + 1 (worker thread)
    if (minThreads < 8) {
      LOG.info("The configuration of minThread is too small, adjust to 8");
      minThreads = 8;
    }
    if (maxThreads < 8) {
      LOG.info("The configuration of maxThread is too small, adjust to 8");
      maxThreads = 8;
    }
    this.minThreads = minThreads;
    this.maxThreads = maxThreads;

    this.stopTimeout = internalConfig.get(WEBSERVER_STOP_TIMEOUT);
    this.idleTimeout = internalConfig.get(WEBSERVER_IDLE_TIMEOUT);
    this.requestHeaderSize = internalConfig.get(WEBSERVER_REQUEST_HEADER_SIZE);
    this.responseHeaderSize = internalConfig.get(WEBSERVER_RESPONSE_HEADER_SIZE);
    this.threadPoolWorkQueueSize = internalConfig.get(WEBSERVER_THREAD_POOL_WORK_QUEUE_SIZE);

    this.enableHttps = internalConfig.get(ENABLE_HTTPS);
    this.httpsPort = internalConfig.get(WEBSERVER_HTTPS_PORT);
    this.tlsProtocol = internalConfig.get(SSL_PROTOCOL);
    this.enableCipherAlgorithms =
        Collections.unmodifiableSet(
            Sets.newHashSet(internalConfig.get(ENABLE_CIPHER_ALGORITHMS).split(SPLITTER)));
    this.enableClientAuth = internalConfig.get(ENABLE_CLIENT_AUTH);

    this.customFilters =
        internalConfig
            .get(CUSTOM_FILTERS)
            .map(filters -> Collections.unmodifiableSet(Sets.newHashSet(filters.split(SPLITTER))))
            .orElse(Collections.emptySet());

    this.keyStoreType = internalConfig.get(SSL_KEYSTORE_TYPE);
    this.trustStoreType = internalConfig.get(SSL_TRUST_STORE_TYPE);

    if (this.enableHttps) {
      this.keyStorePath = internalConfig.get(SSL_KEYSTORE_PATH);
      this.keyStorePassword = internalConfig.get(SSL_KEYSTORE_PASSWORD);
      this.managerPassword = internalConfig.get(SSL_MANAGER_PASSWORD);
    } else {
      this.keyStorePath = null;
      this.keyStorePassword = null;
      this.managerPassword = null;
    }
    if (this.enableHttps && this.enableClientAuth) {
      this.trustStorePath = internalConfig.get(SSL_TRUST_STORE_PATH);
      this.trustStorePassword = internalConfig.get(SSL_TRUST_STORE_PASSWORD);
    } else {
      this.trustStorePath = null;
      this.trustStorePassword = null;
    }

    this.enableCorsFilter = internalConfig.get(ENABLE_CORS_FILTER);
    this.allowedOrigins = internalConfig.get(ALLOWED_ORIGINS);
    this.allowedTimingOrigins = internalConfig.get(ALLOWED_TIMING_ORIGINS);
    this.preflightMaxAgeInSecs = internalConfig.get(PREFLIGHT_MAX_AGE_IN_SECS);
    this.allowedMethods = internalConfig.get(ALLOWED_METHODS);
    this.allowedHeaders = internalConfig.get(ALLOWED_HEADERS);
    this.allowCredentials = internalConfig.get(ALLOW_CREDENTIALS);
    this.exposedHeaders = internalConfig.get(EXPOSED_HEADERS);
    this.chainPreflight = internalConfig.get(CHAIN_PREFLIGHT);
  }

  public static JettyServerConfig fromConfig(Config config, String prefix) {
    Map configs = config.getConfigsWithPrefix(prefix);
    if (config instanceof OverwriteDefaultConfig) {
      configs = overwriteJettyDefaultConfig(configs, (OverwriteDefaultConfig) config);
    }
    return new JettyServerConfig(configs);
  }

  public static JettyServerConfig fromConfig(Config config) {
    return fromConfig(config, "");
  }

  public String getHost() {
    return host;
  }

  public int getHttpPort() {
    return httpPort;
  }

  public int getMinThreads() {
    return minThreads;
  }

  public int getMaxThreads() {
    return maxThreads;
  }

  public long getStopTimeout() {
    return stopTimeout;
  }

  public int getRequestHeaderSize() {
    return requestHeaderSize;
  }

  public int getResponseHeaderSize() {
    return responseHeaderSize;
  }

  public int getThreadPoolWorkQueueSize() {
    return threadPoolWorkQueueSize;
  }

  public int getIdleTimeout() {
    return idleTimeout;
  }

  public int getHttpsPort() {
    return httpsPort;
  }

  public String getKeyStorePath() {
    return keyStorePath;
  }

  public String getKeyStorePassword() {
    return keyStorePassword;
  }

  public String getManagerPassword() {
    return managerPassword;
  }

  public boolean isEnableHttps() {
    return enableHttps;
  }

  public String getKeyStoreType() {
    return keyStoreType;
  }

  public Optional getTlsProtocol() {
    return tlsProtocol;
  }

  public boolean isEnableClientAuth() {
    return enableClientAuth;
  }

  public String getTrustStorePath() {
    return trustStorePath;
  }

  public String getTrustStorePassword() {
    return trustStorePassword;
  }

  public String getTrustStoreType() {
    return trustStoreType;
  }

  public Set getSupportedAlgorithms() {
    if (enableCipherAlgorithms.isEmpty()) {
      return Collections.emptySet();
    }

    Set supportedAlgorithms = Sets.newHashSet(enableCipherAlgorithms);
    supportedAlgorithms.retainAll(getSupportedCipherSuites());
    return supportedAlgorithms;
  }

  public Map getAllWithPrefix(String prefix) {
    return internalConfig.getConfigsWithPrefix(prefix);
  }

  public Set getCustomFilters() {
    return customFilters;
  }

  public boolean isEnableCorsFilter() {
    return enableCorsFilter;
  }

  public String getAllowedOrigins() {
    return allowedOrigins;
  }

  public String getAllowedTimingOrigins() {
    return allowedTimingOrigins;
  }

  public int getPreflightMaxAgeInSecs() {
    return preflightMaxAgeInSecs;
  }

  public String getAllowedMethods() {
    return allowedMethods;
  }

  public boolean isAllowCredentials() {
    return allowCredentials;
  }

  public String getExposedHeaders() {
    return exposedHeaders;
  }

  public boolean isChainPreflight() {
    return chainPreflight;
  }

  public String getAllowedHeaders() {
    return allowedHeaders;
  }

  private SSLContext getDefaultSSLContext() {
    try {
      return SSLContext.getDefault();
    } catch (NoSuchAlgorithmException nsa) {
      return null;
    }
  }

  private SSLContext getSSLContextInstance(String protocol) {
    try {
      SSLContext context = SSLContext.getInstance(protocol);
      context.init(null, null, null);
      return context;
    } catch (NoSuchAlgorithmException | KeyManagementException e) {
      return null;
    }
  }

  @VisibleForTesting
  Set getSupportedCipherSuites() {
    SSLContext context =
        tlsProtocol.map(this::getSSLContextInstance).orElseGet(this::getDefaultSSLContext);
    if (context == null) {
      return Collections.emptySet();
    }
    return Sets.newHashSet(context.getServerSocketFactory().getSupportedCipherSuites());
  }

  private static Map overwriteJettyDefaultConfig(
      Map properties, OverwriteDefaultConfig config) {
    if (config.getOverwriteDefaultConfig().isEmpty()) return properties;
    Map newProperties = new HashMap<>(properties);
    config.getOverwriteDefaultConfig().forEach((k, v) -> newProperties.putIfAbsent(k, v));
    return newProperties;
  }
}




© 2015 - 2024 Weber Informatics LLC | Privacy Policy