Date: Fri, 29 Mar 2024 11:38:37 -0400 (EDT) Message-ID: <1700616901.974.1711726717856@prodopencatalystconfluence.catalyst> Subject: Exported From Confluence MIME-Version: 1.0 Content-Type: multipart/related; boundary="----=_Part_973_1825840979.1711726717853" ------=_Part_973_1825840979.1711726717853 Content-Type: text/html; charset=UTF-8 Content-Transfer-Encoding: quoted-printable Content-Location: file:///C:/exported.html
After importing the signed certificates in addition to the Hub C= A and HTTPS certificate, configure your Tomcat server.xml file to use the c= orrect certificate to serve SHRINE https requests. Tomcat normally uses por= t 6443 to serve SHRINE.
To serve SSL find this section and change it to use the right keystore p= assword and key alias to serve https from tomcat. Although you can use the = same keyAlias to sign shrine queries and to support TLS for https most site= s choose to use their own cert signed by a CA in a public cert tree. This p= revents dire warnings from browsers. Follow standard procedures for serving= https via TLS from tomcat. Find the example in shrine-setup/server.xml&nbs= p;.
<!-- Defin= e a SSL/TLS HTTP/1.1 Connector on port 8443 This connector uses the NIO implementation that requires the JSSE style configuration. When using the APR/native implementation, the OpenSSL style configuration is required as described in the APR/na= tive documentation --> <Connector port=3D"6443" protocol=3D"org.apache.coyote.http11.Http11= NioProtocol" maxThreads=3D"150" SSLEnabled=3D"true" scheme=3D"https" secu= re=3D"true" clientAuth=3D"false" sslProtocol=3D"TLS" keystoreFile=3D"/opt/shrine/shrine.keystore" keystorePass=3D"password" keyAlias=3D"<name_of_keystore_PrivateKeyEntry>" />
The URLs to the SHRINE webclient, steward, and dashboard changed in SHRI= NE 2.0.0. If you would like to add redirects to the old URLs, add a Rewrite= Valve to the server.xml file and copy the shrine-setup/rewrite.config file = to /opt/shrine/tomcat/conf/Catalina/localhost. =
<Host name=3D"= localhost" appBase=3D"webapps" unpackWARs=3D"true" autoDeploy=3D"true"> <Valve className=3D"org.apache.catalina.valves.rewrite.RewriteValve"= /> ........
Here's a sample server.xml file (note the 'Connector port =3D "6443"' se= ction):
<?xml version= =3D'1.0' encoding=3D'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 =20 http://www.apache.org/licenses/LICENSE-2.0 =20 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=3D"8005" shutdown=3D"SHUTDOWN"> <Listener className=3D"org.apache.catalina.startup.VersionLoggerListen= er" /> <!-- Security listener. Documentation at /docs/config/listeners.html <Listener className=3D"org.apache.catalina.security.SecurityListener" = /> --> <!--APR library loader. Documentation at /docs/apr.html --> <Listener className=3D"org.apache.catalina.core.AprLifecycleListener" = SSLEngine=3D"on" /> <!-- Prevent memory leaks due to use of particular java/javax APIs--&g= t; <Listener className=3D"org.apache.catalina.core.JreMemoryLeakPreventio= nListener" /> <Listener className=3D"org.apache.catalina.mbeans.GlobalResourcesLifec= ycleListener" /> <Listener className=3D"org.apache.catalina.core.ThreadLocalLeakPrevent= ionListener" /> <!-- 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=3D"UserDatabase" auth=3D"Container" type=3D"org.apache.catalina.UserDatabase" description=3D"User database that can be updated and saved" factory=3D"org.apache.catalina.users.MemoryUserDatabaseFactor= y" pathname=3D"conf/tomcat-users.xml" /> </GlobalNamingResources> <!-- A "Service" is a collection of one or more "Connectors" that shar= e 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=3D"Catalina"> <!--The connectors can use a shared executor, you can define one or = more named thread pools--> <!-- <Executor name=3D"tomcatThreadPool" namePrefix=3D"catalina-exec-" maxThreads=3D"150" minSpareThreads=3D"4"/> --> <!-- A "Connector" represents an endpoint by which requests are rece= ived and responses are returned. Documentation at : Java HTTP Connector: /docs/config/http.html (blocking & non-bl= ocking) Java AJP Connector: /docs/config/ajp.html APR (HTTP/AJP) Connector: /docs/apr.html Define a non-SSL/TLS HTTP/1.1 Connector on port 8080 --> <Connector port=3D"6060" protocol=3D"HTTP/1.1" connectionTimeout=3D"20000" redirectPort=3D"6443" /> <!-- A "Connector" using the shared thread pool--> <!-- <Connector executor=3D"tomcatThreadPool" port=3D"8080" protocol=3D"HTTP/1.1" connectionTimeout=3D"20000" redirectPort=3D"8443" /> --> <!-- Define a SSL/TLS HTTP/1.1 Connector on port 8443 This connector uses the NIO implementation that requires the JSSE style configuration. When using the APR/native implementation, the OpenSSL style configuration is required as described in the APR/na= tive documentation --> <Connector port=3D"6443" protocol=3D"org.apache.coyote.http11.Http11= NioProtocol" maxThreads=3D"150" SSLEnabled=3D"true" scheme=3D"https" secu= re=3D"true" clientAuth=3D"false" sslProtocol=3D"TLS" keystoreFile=3D"/opt/shrine/shrine.keystore" keystorePass=3D"password" keyAlias=3D"<name_of_keystore_PrivateKeyEntry>"=20 /> =20 <!-- Define an AJP 1.3 Connector on port 8009 --> <Connector port=3D"6009" protocol=3D"AJP/1.3" redirectPort=3D"8443" = /> =20 <!-- An Engine represents the entry point (within Catalina) that pro= cesses every request. The Engine implementation for Tomcat stand alone analyzes the HTTP headers included with the request, and passes th= em 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=3D"Catalina" defaultHost=3D"localhost" jvmRoute=3D"jvm1= "> --> <Engine name=3D"Catalina" defaultHost=3D"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=3D"org.apache.catalina.ha.tcp.SimpleTcpCluster"= /> --> <!-- Use the LockOutRealm to prevent attempts to guess user passwo= rds via a brute-force attack --> <Realm className=3D"org.apache.catalina.realm.LockOutRealm"> <!-- This Realm uses the UserDatabase configured in the global J= NDI resources under the key "UserDatabase". Any edits that are performed against this UserDatabase are immediately available for use by the Realm. --> <Realm className=3D"org.apache.catalina.realm.UserDatabaseRealm" resourceName=3D"UserDatabase"/> </Realm> <Host name=3D"localhost" appBase=3D"webapps" unpackWARs=3D"true" autoDeploy=3D"true"> <Valve className=3D"org.apache.catalina.valves.rewrite.RewriteValv= e" /> <!-- SingleSignOn valve, share authentication between web applic= ations Documentation at: /docs/config/valve.html --> <!-- <Valve className=3D"org.apache.catalina.authenticator.SingleSign= On" /> --> <!-- Access log processes all example. Documentation at: /docs/config/valve.html Note: The pattern used is equivalent to using pattern=3D"commo= n" --> <Valve className=3D"org.apache.catalina.valves.AccessLogValve" d= irectory=3D"logs" prefix=3D"localhost_access_log" suffix=3D".txt" pattern=3D"%h %l %u %t "%r" %s %b" /> </Host> </Engine> </Service> </Server>