Skip to main content

五、進階設定

(1)設定使用對外服務位置

本文件前面所描述之使用情境，皆預設在「內網 IP 環境」，若機關佈署的環境開放以下二種情境者，需額外進行進階的設定，二種情境如下：

  1. 使用真實 IP 對外開放服務(例如：117.56.68.133)
  2. 使用 FQDN 做為服務主機名稱(例如：odf.nat.gov.tw)

請進入 modaodfweb 主機上，修改 /etc/modaodfweb/modaodfweb.xml 的內容，找到以下這段：

<wopi desc="Allow/deny wopi storage. Mutually exclusive with webdav." allow="true">
<host desc="Regex pattern of hostname to allow or deny." allow="true">localhost</host>
<host desc="Regex pattern of hostname to allow or deny." allow="true">10\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}</host>
<host desc="Regex pattern of hostname to allow or deny." allow="true">172\.1[6789]\.[0-9]{1,3}\.[0-9]{1,3}</host>
<host desc="Regex pattern of hostname to allow or deny." allow="true">172\.2[0-9]\.[0-9]{1,3}\.[0-9]{1,3}</host>
<host desc="Regex pattern of hostname to allow or deny." allow="true">172\.3[01]\.[0-9]{1,3}\.[0-9]{1,3}</host>
<host desc="Regex pattern of hostname to allow or deny." allow="true">192\.168\.[0-9]{1,3}\.[0-9]{1,3}</host>
<host desc="Regex pattern of hostname to allow or deny." allow="true">117\.56\.68\.133</host>
<host desc="Regex pattern of hostname to allow or deny." allow="true">odf\.nat\.gov\.tw</host>
<host desc="Regex pattern of hostname to allow or deny." allow="false">192\.168\.1\.1</host>
<max_file_size desc="Maximum document size in bytes to load. 0 for unlimited." type="uint">0</max_file_size>
</wopi>

請加入上述 117.56.68.133 與 odf.nat.gov.tw 那二行的範例內容，儲存後跳出，重新啟動 modaodfweb 的服務即可。

# systemc restart modaodfweb

另外開放對外可連到這台主機以下的連接埠號：80、9980

就可正常使用 ODF 雲端編輯器。

(2)使用 ODF API 的額外設定

若要使用 ODF API 進行作業，因自 2.X 版開始已將 ODF API 伺服器整合至 ODF 雲端編輯元件中，必須在其設定檔中進行額外的設定才能正常運作，請進入 modaodfweb 主機上，修改 /etc/modaodfweb/modaodfweb.xml 的內容，找到以下這段：

<server_name desc="External hostname:port of the server running modaodfweb. If empty, it's derived from the request (please set it if this doesn't work). Must be specified when behind a reverse-proxy or when the hostname is not reachable directly." type="string" default=""></server_name>

請在 </server_name> 前，<……default=””> 後插入此 ODF 雲端編輯元件的完整 URL（一般情況下需包含連接埠號，例如192.168.3.1:9980），然後儲存後跳出，重新啟動 modaodfweb 的服務即可。

# systemc restart modaodfweb

(3)設定啟用 SSL 憑證

若服務的主機運作在 SSL 協定上時，則可透過以下設定方式啟動 SSL，憑證申請的流程可參考 GCA 資證申請作業流程。

https://gcp.nat.gov.tw/

申請好了之後，請將相關的憑證上傳至 modaodfweb 主機上，建議可將憑證檔案放在 /etc/httpd/ssl 目錄下。

  • Apache Web Server 的設定

先安裝 ssl 套件

# yum install -y mod_ssl
# vim /etc/httpd/conf.d/ssl.conf

修改以下三行（請依照實際的路徑設定）

SSLCertificateFile /etc/httpd/ssl/certificate.crt
SSLCertificateKeyFile /etc/httpd/ssl/private.key
SSLCACertificateFile /etc/httpd/ssl/ca_bundle.crt

存檔後，重啟服務。

# systemctl restart httpd

  • ODF文件Web應用元件主程式

請進入 modaodfweb 主機上，修改 /etc/modaodfweb/modaodfweb.xml 的內容，找到以下這段：

<enable type="bool" desc="Controls whether SSL encryption is enable (do not disable for production deployment). If default is false, must first be compiled with SSL support to enable." default="true">true</enable>

請將 </enable> 前由原本的 false 改為 true。

另外再指定以下三個憑證位置（路徑可與上述 httpd 的 SSL 憑證相同），例子如下：

<cert_file_path desc="Path to the cert file" relative="false">/etc/httpd/ssl/certificate.crt</cert_file_path>
<key_file_path desc="Path to the key file" relative="false">/etc/httpd/ssl/private.key</key_file_path>
<ca_file_path desc="Path to the ca file" relative="false">/etc/httpd/ssl/ca_bundle.crt</ca_file_path>

儲存後跳出，重新啟動 modaodfweb 的服務即可。

# systemc restart modaodfweb

依照上述設定，正常就可以使用以下的連結使用服務：

https://yourhostname:9980 → 為「ODF文件Web應用元件主程式」（一般安裝說明如第貳章所示）測試服務位置，出現OK字樣，並且瀏覽器端會顯示為合法憑證。

https://yourhostname/odfweb → 為預設「ODF文件Web應用元件網路儲存空間軟體」（一般安裝說明如第參章所示）進入點，此時可成為加密型態。

Back to top