臺灣社家署基礎實作指引
0.0.1 - ci-build

臺灣社家署基礎實作指引, published by 衛生福利部社會及家庭署. This guide is not an authorized publication; it is the continuous build for version 0.0.1 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/sfaassn2025-source/base/ and changes regularly. See the Directory of published versions

## 安全性

### 實作者 建議應該(SHOULD) 了解與FHIR交易相關的安全考量，特別是與以下相關

### 通訊(Communication)

### 授權/存取控制(Authorization/Access Control)

每一次存取RESTful服務時，必須在傳送的HTTP Header加入署方認可的API識別碼，以參數KeyId表示。

- 例，KeyId = API識別碼

  - 回覆 400(參數不正確) - 傳送的參數不合法。

  - 回覆 401(未經授權) - 參數KeyId不合法。

  - 回覆 403(禁止存取) - 終端路徑不合法。

  - 回覆 404(找不到網頁) - 終端路徑不存在。

### 數位簽章(Digital Signatures)

以醫事憑證管理中心核發之有效憑證進行數位簽章操作，申請方式依醫事憑證管理中心要求辦理。 於成功申請並取得憑證後，將欲上傳資料透過憑證SDK(函式P12Sign)產生上傳資料的數位簽章值，將取得的數位簽章值進一步以BASE64函式加密，取得一行經過BASE64函式加密的長字串，加入傳送的HTTP Header中，以參數AUTH表示。

- 例，AUTH = 一行經過BASE64函式加密的數位簽章值。

  - 函式P12Sign參數：

    iFlags = CG_FLAG_DETACHMSG

    iKeyUsage = CG_KU_NON_REPUDIATION

    HashFlag = CG_ALGOR_SHA256

### 本專案安全一致性要求如下

- 系統 必須(SHALL) 保留各種交易的稽核日誌(audit logs)
- 系統 必須(SHALL) 符合FHIR通訊安全(Communications Security)要求
- 系統 必須(SHALL) 依據國家、地方和機構政策實作同意要求。業務夥伴協定(Business Associate Agreements) 建議應該(SHOULD)記錄系統相互同意的要求。
- 對於認證和授權，系統 必須(SHALL) 支援本署權責中心核發的API識別碼
- 對於數位簽章，系統 必須(SHALL) 支援醫事憑證管理中心核發且在有效期內的憑證。注意：憑證必須(SHALL)為機構非IC卡符記憑證
- 系統 可以(MAY) 透過加密和相關存取控制來保護資料的機密性。所使用的策略和方法不在此規範的範圍內。