mirror of
https://github.com/apache/cloudstack.git
synced 2025-10-26 08:42:29 +01:00
This introduces a new certificate authority framework that allows pluggable CA provider implementations to handle certificate operations around issuance, revocation and propagation. The framework injects itself to `NioServer` to handle agent connections securely. The framework adds assumptions in `NioClient` that a keystore if available with known name `cloud.jks` will be used for SSL negotiations and handshake. This includes a default 'root' CA provider plugin which creates its own self-signed root certificate authority on first run and uses it for issuance and provisioning of certificate to CloudStack agents such as the KVM, CPVM and SSVM agents and also for the management server for peer clustering. Additional changes and notes: - Comma separate list of management server IPs can be set to the 'host' global setting. Newly provisioned agents (KVM/CPVM/SSVM etc) will get radomized comma separated list to which they will attempt connection or reconnection in provided order. This removes need of a TCP LB on port 8250 (default) of the management server(s). - All fresh deployment will enforce two-way SSL authentication where connecting agents will be required to present certificates issued by the 'root' CA plugin. - Existing environment on upgrade will continue to use one-way SSL authentication and connecting agents will not be required to present certificates. - A script `keystore-setup` is responsible for initial keystore setup and CSR generation on the agent/hosts. - A script `keystore-cert-import` is responsible for import provided certificate payload to the java keystore file. - Agent security (keystore, certificates etc) are setup initially using SSH, and later provisioning is handled via an existing agent connection using command-answers. The supported clients and agents are limited to CPVM, SSVM, and KVM agents, and clustered management server (peering). - Certificate revocation does not revoke an existing agent-mgmt server connection, however rejects a revoked certificate used during SSL handshake. - Older `cloudstackmanagement.keystore` is deprecated and will no longer be used by mgmt server(s) for SSL negotiations and handshake. New keystores will be named `cloud.jks`, any additional SSL certificates should not be imported in it for use with tomcat etc. The `cloud.jks` keystore is stricly used for agent-server communications. - Management server keystore are validated and renewed on start up only, the validity of them are same as the CA certificates. New APIs: - listCaProviders: lists all available CA provider plugins - listCaCertificate: lists the CA certificate(s) - issueCertificate: issues X509 client certificate with/without a CSR - provisionCertificate: provisions certificate to a host - revokeCertificate: revokes a client certificate using its serial Global settings for the CA framework: - ca.framework.provider.plugin: The configured CA provider plugin - ca.framework.cert.keysize: The key size for certificate generation - ca.framework.cert.signature.algorithm: The certificate signature algorithm - ca.framework.cert.validity.period: Certificate validity in days - ca.framework.cert.automatic.renewal: Certificate auto-renewal setting - ca.framework.background.task.delay: CA background task delay/interval - ca.framework.cert.expiry.alert.period: Days to check and alert expiring certificates Global settings for the default 'root' CA provider: - ca.plugin.root.private.key: (hidden/encrypted) CA private key - ca.plugin.root.public.key: (hidden/encrypted) CA public key - ca.plugin.root.ca.certificate: (hidden/encrypted) CA certificate - ca.plugin.root.issuer.dn: The CA issue distinguished name - ca.plugin.root.auth.strictness: Are clients required to present certificates - ca.plugin.root.allow.expired.cert: Are clients with expired certificates allowed UI changes: - Button to download/save the CA certificates. Misc changes: - Upgrades bountycastle version and uses newer classes - Refactors SAMLUtil to use new CertUtils Signed-off-by: Rohit Yadav <rohit.yadav@shapeblue.com>
158 lines
7.1 KiB
XML
Executable File
158 lines
7.1 KiB
XML
Executable File
<?xml version='1.0' encoding='utf-8'?>
|
|
<!--
|
|
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.
|
|
-->
|
|
<!-- Note: A "Server" is not itself a "Container", so you may not
|
|
define subcomponents such as "Valves" at this level.
|
|
Documentation at /docs/config/server.html
|
|
-->
|
|
<Server port="8005" shutdown="SHUTDOWN">
|
|
|
|
<!--APR library loader. Documentation at /docs/apr.html -->
|
|
<Listener className="org.apache.catalina.core.AprLifecycleListener" SSLEngine="on" />
|
|
<!--Initialize Jasper prior to webapps are loaded. Documentation at /docs/jasper-howto.html -->
|
|
<Listener className="org.apache.catalina.core.JasperListener" />
|
|
<!-- JMX Support for the Tomcat server. Documentation at /docs/non-existent.html -->
|
|
<Listener className="org.apache.catalina.mbeans.ServerLifecycleListener" />
|
|
<Listener className="org.apache.catalina.mbeans.GlobalResourcesLifecycleListener" />
|
|
|
|
<!-- Global JNDI resources
|
|
Documentation at /docs/jndi-resources-howto.html
|
|
-->
|
|
<GlobalNamingResources>
|
|
<!-- Editable user database that can also be used by
|
|
UserDatabaseRealm to authenticate users
|
|
-->
|
|
<Resource name="UserDatabase" auth="Container"
|
|
type="org.apache.catalina.UserDatabase"
|
|
description="User database that can be updated and saved"
|
|
factory="org.apache.catalina.users.MemoryUserDatabaseFactory"
|
|
pathname="conf/tomcat-users.xml" />
|
|
</GlobalNamingResources>
|
|
|
|
<!-- A "Service" is a collection of one or more "Connectors" that share
|
|
a single "Container" Note: A "Service" is not itself a "Container",
|
|
so you may not define subcomponents such as "Valves" at this level.
|
|
Documentation at /docs/config/service.html
|
|
-->
|
|
<Service name="Catalina">
|
|
|
|
<!--The connectors can use a shared executor, you can define one or more named thread pools-->
|
|
<Executor name="tomcatThreadPool" namePrefix="catalina-exec-"
|
|
maxThreads="150" minSpareThreads="25"/>
|
|
|
|
|
|
<!-- A "Connector" represents an endpoint by which requests are received
|
|
and responses are returned. Documentation at :
|
|
Java HTTP Connector: /docs/config/http.html (blocking & non-blocking)
|
|
Java AJP Connector: /docs/config/ajp.html
|
|
APR (HTTP/AJP) Connector: /docs/apr.html
|
|
Define a non-SSL HTTP/1.1 Connector on port 8080
|
|
-->
|
|
<!--
|
|
<Connector port="8080" protocol="HTTP/1.1"
|
|
connectionTimeout="20000"
|
|
redirectPort="8443" />
|
|
-->
|
|
<!-- A "Connector" using the shared thread pool-->
|
|
<!--
|
|
<Connector executor="tomcatThreadPool"
|
|
port="8080" protocol="org.apache.coyote.http11.Http11NioProtocol"
|
|
connectionTimeout="20000" disableUploadTimeout="true"
|
|
acceptCount="150" enableLookups="false" maxThreads="150"
|
|
maxHttpHeaderSize="8192" redirectPort="8443" />
|
|
-->
|
|
<!-- Define a SSL HTTP/1.1 Connector on port 8443
|
|
This connector uses the JSSE configuration, when using APR, the
|
|
connector should be using the OpenSSL style configuration
|
|
described in the APR documentation -->
|
|
<!--
|
|
<Connector port="8443" protocol="HTTP/1.1" SSLEnabled="true"
|
|
maxThreads="150" scheme="https" secure="true"
|
|
clientAuth="false" sslProtocol="TLS" sslEnabledProtocols="TLSv1.2,TLSv1.1"
|
|
keystoreType="PKCS12"
|
|
keystoreFile="conf/cloud-localhost.pk12"
|
|
keystorePass="password"
|
|
/>
|
|
-->
|
|
|
|
<!-- Listen on 6443 instead of 8443 because tomcat6 will change 8443 to a random one when CATALINA_HOME is not /usr/share/tomcat6 -->
|
|
<Connector port="6443" protocol="org.apache.coyote.http11.Http11NioProtocol" SSLEnabled="true"
|
|
maxThreads="150" scheme="https" secure="true" URIEncoding="UTF-8"
|
|
clientAuth="false" sslProtocol="TLS"
|
|
keystoreType="JKS"
|
|
keystoreFile="/etc/cloudstack/management/cloud.jks"
|
|
keystorePass="vmops.com"/>
|
|
|
|
<!-- Define an AJP 1.3 Connector on port 20400 -->
|
|
<Connector port="20400" protocol="AJP/1.3" redirectPort="6443" />
|
|
|
|
|
|
<!-- An Engine represents the entry point (within Catalina) that processes
|
|
every request. The Engine implementation for Tomcat stand alone
|
|
analyzes the HTTP headers included with the request, and passes them
|
|
on to the appropriate Host (virtual host).
|
|
Documentation at /docs/config/engine.html -->
|
|
|
|
<!-- You should set jvmRoute to support load-balancing via AJP ie :
|
|
<Engine name="Catalina" defaultHost="localhost" jvmRoute="jvm1">
|
|
-->
|
|
<Engine name="Catalina" defaultHost="localhost">
|
|
|
|
<!--For clustering, please take a look at documentation at:
|
|
/docs/cluster-howto.html (simple how to)
|
|
/docs/config/cluster.html (reference documentation) -->
|
|
<!--
|
|
<Cluster className="org.apache.catalina.ha.tcp.SimpleTcpCluster"/>
|
|
-->
|
|
|
|
<!-- The request dumper valve dumps useful debugging information about
|
|
the request and response data received and sent by Tomcat.
|
|
Documentation at: /docs/config/valve.html -->
|
|
<!--
|
|
<Valve className="org.apache.catalina.valves.RequestDumperValve"/>
|
|
-->
|
|
|
|
<!-- This Realm uses the UserDatabase configured in the global JNDI
|
|
resources under the key "UserDatabase". Any edits
|
|
that are performed against this UserDatabase are immediately
|
|
available for use by the Realm. -->
|
|
<Realm className="org.apache.catalina.realm.UserDatabaseRealm"
|
|
resourceName="UserDatabase"/>
|
|
|
|
<!-- Define the default virtual host
|
|
Note: XML Schema validation will not work with Xerces 2.2.
|
|
-->
|
|
<Host name="localhost" appBase="webapps"
|
|
unpackWARs="true" autoDeploy="true"
|
|
xmlValidation="false" xmlNamespaceAware="false">
|
|
|
|
<!-- SingleSignOn valve, share authentication between web applications
|
|
Documentation at: /docs/config/valve.html -->
|
|
<!--
|
|
<Valve className="org.apache.catalina.authenticator.SingleSignOn" />
|
|
-->
|
|
|
|
<!-- Access log processes all example.
|
|
Documentation at: /docs/config/valve.html -->
|
|
<Valve className="org.apache.catalina.valves.FastCommonAccessLogValve" directory="logs"
|
|
prefix="access_log." suffix=".txt" pattern="common" resolveHosts="false"/>
|
|
|
|
</Host>
|
|
</Engine>
|
|
</Service>
|
|
</Server>
|