五、進階設定

(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 目錄下。

先安裝 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

請進入 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應用元件網路儲存空間軟體」(一般安裝說明如第參章所示)進入點,此時可成為加密型態。


Revision #1
Created 29 December 2023 07:15:45 by Jeff Huang
Updated 29 December 2023 07:16:22 by Jeff Huang