Jorani 相關 Issues

Step 3：需有域名與 SSL 憑證 - 問題 2 - 解釋

BALET 解釋說明強調只支援 Https
補充：如果安裝在本機用於測試可支援 Localhost，但實務上給使用者用，必需解決上述 2 個問題(域名 + SSL)

第三部分：如何正確的安裝 & 配置憑證

Step 1：取得 Jorani 開源代碼

先進入官網取得 .git 連結

https://github.com/bbalet/jorani

Step 2：下載到部署主機

下載源代碼，並且複製到 Ubuntu 部署主機上

Step 3：調整 docker-compose.yml

如果直接執行 Docker 運行，會出現第二部分的錯誤，因此我們需要調整以下 2 個參數

version: '3.4'
services:
  jorani:
    build: .
    ports:
      - "8765:80"
    environment:
      - MYSQL_HOST=mysql
      - MYSQL_DATABASE=jorani
      - MYSQL_USER=jorani
      - MYSQL_PASSWORD=jorani
      - BASE_URL=https://jorani.company.local
  mysql:
    image: mysql:8
    ports:
      - "3306:3306"
    environment:
      - MYSQL_ROOT_PASSWORD=jorani
      - MYSQL_DATABASE=jorani
      - MYSQL_USER=jorani
      - MYSQL_PASSWORD=jorani
    volumes:
      - ./sql/jorani.sql:/docker-entrypoint-initdb.d/jorani.sql

Step 4：執行 docker-compose

調整完成後，可在部署主機上運行以下指令，使其容器化運行

docker-compose up -d

Step 5：建立 SSL 自簽憑證 - 建立資料夾

在部署主機上，建立資料夾，並且移動到該目錄下

mkdir -p /etc/nginx/certs
cd /etc/nginx/certs

Step 6：建立 SSL 自簽憑證 - 新增憑證

輸入以下指令，憑證有效期為 365 天，具體依照自己需求來配置，最重要的是域名 jorani.company.local
必需要與 jorani 的 docker-compose.yml 一致

openssl req -x509 -nodes -days 365 -newkey rsa:2048 \
  -keyout /etc/nginx/certs/jorani.key \
  -out /etc/nginx/certs/jorani.crt \
  -subj "/CN=jorani.company.local"

如果是內部環境使用，其實可以設定 **-days 36500 ** 約 100 年，因為 Jorani 為內部使用，可考量方便性

Step 7：建立 SSL 自簽憑證 - 確認憑證

若正確產生，應可看到對應路徑下出現公開憑證 jorani.crt 與 私有憑證 jorani.key

Step 8：Nginx 配置

在代理伺服器方面，我們還需對 jorani.company.local 域名做 Nginx 配置
將 .crt .key 綁定於 443 (Https) 並且對外域名為 jorani.company.local
以及 SSL 安全設定與配置 Web Crypto API

server {
    listen 443 ssl;
    server_name jorani.company.local;
    ssl_certificate     /etc/nginx/certs/jorani.crt;
    ssl_certificate_key /etc/nginx/certs/jorani.key;
    
    # 添加 SSL 安全設定
    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_ciphers HIGH:!aNULL:!MD5;
    
    location / {
        proxy_pass http://192.168.51.93:8765;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto https;
        
        # 添加這些 header 解決 Web Crypto API 問題
        proxy_set_header X-Forwarded-Host $host;
        proxy_set_header X-Forwarded-Server $host;
    }
}

# 添加 HTTP 重定向到 HTTPS
server {
    listen 80;
    server_name jorani.company.local;
    return 301 https://$server_name$request_uri;
}

第四部分：用戶端配置

Step 1：用戶端域名配置

通常公司內部需要 IT 人員協助配置域名解析，在測試、或少數內部人員使用，更快速的解法是讓使用者 Hosts 添加域名對應
到 Windows 以下目錄

C:\\Windows\\System32\\drivers\\etc

Step 2：添加域名對應

開啟 Hosts 檔案， 192.168.51.93 是我們 Jorani 的內部域名伺服器位置

## Jorani ##
192.168.51.93 jorani.company.local

第五部分：Demo 成果

Step 1：登入 Jorani WebUI

配置完成後，可以嘗試從本機開啟瀏覽器訪問 Jorani WebUI，以下是預設帳號、密碼：

https://jorani.company.local

Step 2：完成

登入後就可以看到 Jorani 最高權限的 請假管理系統 介面