# ApacheNote

**Repository Path**: wizstriver1/ApacheNote

## Basic Information

- **Project Name**: ApacheNote
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-06-14
- **Last Updated**: 2020-12-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# tomcat PFX格式证书安装

## 前提条件

- 您的Tomcat服务器上已经开启了443端口（HTTPS服务的默认端口）。
- 已安装OpenSSL工具。
- 已下载Tomcat服务器所需要的证书文件。

### 安装OpenSSL工具

## 背景信息

本文教程以Tomcat 7为例。
Tomcat 9强制要求证书别名设置为tomcat。您需要使用以下keytool命令将protocol="HTTP/1.1"转换成protocol="org.apache.coyote.http11.Http11NioProtocol"。

```
keytool -changealias -keystore domain name.pfx -alias alias -destalias tomcat
```

本文档证书名称以domain name为示例，例如：证书文件名称为domain name.pfx，证书密码文件名称为pfx-password.txt。

## 操作步骤
1. 解压已下载保存到本地的Tomcat证书文件。
解压后您将看到文件夹中有2个文件，您可为两个证书文件重命名。
- 证书文件（domain name.pfx）：以.pfx为后缀或文件类型。
- 密码文件（pfx-password.txt）：以.txt为后缀或文件类型。

2. 在Tomcat安装目录下新建cert目录，将解压的证书和密码文件拷贝到cert目录下。

3. 修改配置文件server.xml，并保存。
文件路径：Tomcat安装目录/conf/server.xml
去掉以下内容的注释：
```
<Connector  port="8443"
protocol="HTTP/1.1"
  port="8443" SSLEnabled="true"
  maxThreads="150" scheme="https" secure="true"
  clientAuth="false" sslProtocol="TLS" />
```
参照以下内容修改<Connector port="443"标签内容。
```
<Connector port="443"   #port属性根据实际情况修改（https默认端口为443）。如果使用其他端口号，则您需要使用https://yourdomain:port的方式来访问您的网站。
    protocol="HTTP/1.1"
    SSLEnabled="true"
    scheme="https"
    secure="true"
    keystoreFile="Tomcat安装目录/cert/domain name.pfx" #证书名称前需加上证书的绝对路径，请使用您证书的文件名替换domain name。
    keystoreType="PKCS12"
    keystorePass="证书密码"  #请替换为密码文件pfx-password.txt中的内容。
    clientAuth="false"
    SSLProtocol="TLSv1+TLSv1.1+TLSv1.2"
    ciphers="TLS_RSA_WITH_AES_128_CBC_SHA,TLS_RSA_WITH_AES_256_CBC_SHA,TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA,TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256,TLS_RSA_WITH_AES_128_CBC_SHA256,TLS_RSA_WITH_AES_256_CBC_SHA256"/>
```
4. 可选： 配置web.xml文件，开启HTTP强制跳转HTTPS。
在文件</welcome-file-list>后添加以下内容：
```
<login-config>  
    <!-- Authorization setting for SSL -->  
    <auth-method>CLIENT-CERT</auth-method>  
    <realm-name>Client Cert Users-only Area</realm-name>  
</login-config>  
<security-constraint>  
    <!-- Authorization setting for SSL -->  
    <web-resource-collection >  
        <web-resource-name >SSL</web-resource-name>  
        <url-pattern>/*</url-pattern>  
    </web-resource-collection>  
    <user-data-constraint>  
        <transport-guarantee>CONFIDENTIAL</transport-guarantee>  
    </user-data-constraint>  
</security-constraint>
```
重启Tomcat。
执行以下命令关闭Tomcat服务器。
```
./shutdown.sh
```
执行以下命令开启Tomcat服务器。
```
./startup.sh
```
后续操作
证书安装完成后，可通过登录证书绑定域名的方式验证证书是否安装成功。
放大查看复制代码
https://domain name.com   #domain name替换成证书绑定的域名。
如果网页地址栏出现绿色小锁标志，表示证书安装成功。

验证证书是否安装成功时，如果网站无法通过https正常访问，需确认您安装证书的服务器443端口是否已开启或被其他工具拦截。

## Issues

### cmd运行tomcat时显示中文乱码问题

我们来到tomcat目录的conf子目录中，找到一个名为 "logging.properties" 的文件，打开这个文本文件，找到如下配置项：

java.util.logging.ConsoleHandler.encoding = UTF-8

将 UTF-8 修改为 GBK，修改后的效果为：

java.util.logging.ConsoleHandler.encoding = GBK

保存后，重启tomcat！