1 of 47

115-1 雲端運算與邊緣運算應用 Cloud Computing and Edge Computing Applications

第一筆事件

可送入、查詢並顯示

Week 04|Sprint 4:收得下第一筆可信的事件

個人部署

謝昇憲|四資管 AI 技優專班三A

上週的主機

Start 之後位址會變

一個請求

方法、路徑、標頭、本文

三道檢查

你是誰、能不能做、資料對不對

一筆事件

查得到、看得到

2 of 47

開場

115-1 CloudXEdge · W04

02 / 51

第一件事:現在就啟動上週保留的主機

# 主機 ID 在你的 .local/resources.json 裡

ID=<你的 instance id>

aws ec2 start-instances --instance-ids $ID

aws ec2 describe-instances --instance-ids $ID \

--query "Reservations[].Instances[].[State.Name,PublicIpAddress]"

開機的這一兩分鐘,先做三件事

01

把「舊的公開位址」抄下來(等一下要對照)

02

查你現在 Codespace 的出口位址

03

打開上週的報告,找出 /health 的版本

主機不見了?

被回收或 Lab 重置,就用上週方法重建

先按 Start,再聽課。等主機開機的時間,正好是 A 段。

3 of 47

需求情境

115-1 CloudXEdge · W04

03 / 51

同一個服務,這週多一塊:收得下第一筆事件

已完成

W3

服務雛型上線

打開就知道活著、是哪一版

今天

W4

第一筆事件

送得進、查得到、看得到

下週

W5

重啟不丟

事件存進資料庫、重送不重複

之後

W6

多個設備

十個設備同時回報

本週明講的範圍:事件只放在程式的記憶體裡,服務重開就不見——這是刻意的,W5 才解決。今天不宣稱「重啟持久」。

4 of 47

需求情境

115-1 CloudXEdge · W04

04 / 51

需求:一筆事件送得進來,而且擋得住不該收的

使用者故事

身為巡檢負責人,我要讓現場回報的一筆事件進到服務裡、在畫面上查得到;沒有身分或格式不對的,要被擋下並說清楚原因。

POST /events

{"event_id":"…","device_id":"…",

"observed_at":"2026-09-29T10:00:00+08:00",

"type":"anomaly"}

完成定義

01

一筆合成事件走完:送入 → 查詢 → 顯示

02

拒絕矩陣七列,實際結果和契約一致

03

權杖不在 Git、不在 user data、不在畫面上

04

新版用 deploy.sh 裝到同一台主機,版本等於 commit

「擋得住」和「收得下」一樣重要

5 of 47

需求情境

115-1 CloudXEdge · W04

05 / 51

今天怎麼走

A 服務會搬家

5–25 分

→ T1 恢復

B 請求長什麼樣

40–60 分

→ T2 契約

C 誰能送、送錯怎麼辦

95–120 分

→ T3 換版與拒絕

6 of 47

需求情境

115-1 CloudXEdge · W04

來源:W04 知識鏈表 v1

06 / 51

本週地圖:兩條通道,三道檢查

資料通道(W3 的路,今天最後一格變厚)

Codespace

出口 /32

SG

80

nginx:80

轉給後面

inspection

認證 → 授權 → 驗證

記憶體

本週只到這裡

控制通道(A 段)

Codespace

AWS 憑證

AWS API

開關、查詢主機

A 段

主機 Start 之後位址會變;哪條通道還能用;新版怎麼換上去

B 段

一個請求由什麼組成;一筆事件的欄位雙方怎麼講好

C 段

誰能送、誰能查、資料不對怎麼辦;權杖放哪裡

7 of 47

01

Section 1

A 上週的主機回來了嗎?

Your host moved: addresses, channels, scripted deploy

範圍:Stop/Start 與公開位址 → 控制通道與資料通道 → 開機自啟與 /32 → 腳本部署

引導問題

主機明明啟動了,

為什麼上週的網址打不開?

07 / 51

8 of 47

A 服務會搬家

115-1 CloudXEdge · W04

08 / 51

快問快答 A:先預測,再舉手

Q1

主機 Stop 再 Start,原本的公開位址會不會變?

A 不會,位址跟著主機

B 會,重新分配一個

C 看區域而定

D 只有重建才會變

Q2

你把 SG 的 80 撤掉,此時 aws ec2 describe-instances 還能用嗎?

A 不能,主機被擋住了

B 能,走的是另一條通道

C 要先加回 80

D 看憑證有沒有過期

Q3

要上這週的新版程式,SSH 進主機直接改檔案最快。缺點是什麼?

A 沒缺點,就是最快

B 下次重建時改動不見,也說不出現在跑哪一版

C 會被 AWS 禁止

D 只有 root 能改

9 of 47

A 服務會搬家

115-1 CloudXEdge · W04

09 / 51

快問快答 A:答案

Q1

B 會,重新分配一個

公開位址屬於「這一次開機」,不屬於主機。Stop 時收回,Start 時再分配一個新的。私有位址、磁碟、SG、key pair 都還在。

常見錯選:A:把位址當成主機的財產

Q2

B 能,走的是另一條通道

AWS CLI 是對 AWS 的 API 下指令(控制通道),看的是你的憑證,不經過 SG;curl 和 SSH 才走到主機本身(資料通道)。

常見錯選:A:把兩條通道當成同一條

Q3

B 改動不見,也說不出跑哪一版

部署的是 commit,不是你手邊的檔案。手改的主機一旦重建就回到原樣,而且健康頁回報的版本會和實際跑的程式對不上。

常見錯選:A:只看「這次最快」

10 of 47

A 服務會搬家

115-1 CloudXEdge · W04

10 / 51

概念清單 A:這一段只有四件事

A1

位址屬於這次開機

Stop 收回公開位址,Start 再給一個新的;磁碟與 SG 都還在

A2

兩條通道各走各的

控制通道對 AWS 下指令(憑證);資料通道連主機上的服務(路由、SG)

A3

服務會自己回來

systemd 的 enable 讓服務開機就啟動;Codespace 出口位址也可能變,要重新核對 /32

A4

換版用腳本部署

deploy.sh 從 commit 產生安裝腳本,在同一台主機上重跑;不 SSH 進去手改檔案

11 of 47

A 服務會搬家

分支 A1

A 服務會搬家 › A1 位址會變

115-1 CloudXEdge · W04

11 / 51

主機啟動了,為什麼上週的網址打不開?

動作

主機

磁碟資料

公開位址

計費

Stop(上週做的)

關機

保留

收回

運算停止,磁碟仍計費

Start(剛剛做的)

開機

還在

重新分配一個新的

重新計運算

Reboot

重開機

還在

不變

照常

Terminate(W3 做過)

刪除

依設定刪除

收回

停止

預測:用上週報告裡的舊網址 curl,會看到什麼?

(a)馬上被拒絕 (b)等到逾時 (c)正常 200 (d)502

延伸:固定位址(EIP)

AWS 有「彈性 IP(Elastic IP)」可以固定位址,但會另外計費,本課不用。費用依當期官方計價頁。

12 of 47

A 服務會搬家

分支 A1

A 服務會搬家 › A1 位址會變

115-1 CloudXEdge · W04

12 / 51

位址屬於「這一次開機」,不屬於主機

上週:Stop

公開位址收回

這週:Start

重新分配一個

你要做的事

查新位址、對 /32

跟著主機走

磁碟(EBS)與上面的檔案、SG 規則、key pair、私有位址

跟著這次開機

公開 IPv4 位址:Stop 收回、Start 重給

跟著你的環境

Codespace 的出口位址:重開 Codespace 也可能變(W3 實測 .132 → .133)

回到問題:所以「服務的網址」每週都要重查;SG 的來源也要重新核對。換條件:只 Reboot 不 Stop,位址不變。

13 of 47

A 服務會搬家

分支 A2

A 服務會搬家 › A2 兩條通道

115-1 CloudXEdge · W04

13 / 51

網址變了,為什麼 AWS CLI 照樣查得到主機?

控制通道 control plane

Codespace

AWS 憑證

AWS API 端點

開關、查詢、改 SG

資料通道 data plane

Codespace

curl/SSH

SG

看來源與 port

主機上的服務

nginx、sshd

兩條通道用不同的身分、不同的路:CLI 看 AWS 憑證;curl 看路由與 SG。壞掉的樣子也不一樣。

14 of 47

A 服務會搬家

分支 A2

A 服務會搬家 › A2 兩條通道

115-1 CloudXEdge · W04

14 / 51

故障先問一句:壞在哪一條通道?

你看到的

哪一條通道

先查什麼

aws 指令回 ExpiredToken

控制通道

重新設定暫時憑證(Lab 綠燈)

aws 指令回 AccessDenied

控制通道

身分、資源、政策;不要改 SG

curl 等到逾時

資料通道

位址對不對、路由、SG 來源與 port

curl 連線被拒絕

資料通道

請求到了主機,但那個 port 沒人在聽

curl 回 502

資料通道

nginx 在、後面的程式沒起來

SSH 連不上、但 curl 正常

資料通道

SG 的 22 那一條、金鑰

教師示範:撤掉 SG 的 80 → 同時做 aws ec2 describe-instances(還能用)與 curl(逾時)→ 原樣加回。

15 of 47

A 服務會搬家

分支 A3

A 服務會搬家 › A3 服務自己回來了嗎

115-1 CloudXEdge · W04

15 / 51

主機重開,服務會自己起來嗎?

Start

送出指令

running

AWS 說開機了

systemd

enable 過的服務自動啟動

/health 200

version 同上週

T1 要核對的

預期

記什麼

/health 的 version

和上週報告相同(同一個 commit)

版本字串

/health 的 started_at

今天的時間,不是上週

時間

Start → 200

W3 全新開機約 3 分鐘;W4理論開機快很多(老師實測約 20 秒)

秒數

Codespace 出口 /32

沒變就不動;變了要列舊/新並經審查者核准

舊/新 /32

換條件:如果服務沒有 enable,Start 之後 /health 會是什麼樣子?(連線被拒絕)

16 of 47

A 服務會搬家

分支 A4

A 服務會搬家 › A4 怎麼換新版

115-1 CloudXEdge · W04

16 / 51

要上新版程式:進主機手改,還是用腳本從 commit 裝?

進主機手改檔案

快,但:

· 改動只存在這一台

· 健康頁的版本和實際程式對不上

· 主機壞了重建,改動就不見

· 別人無法照做一次

腳本部署

先 commit

用打包器從這個 commit 產生安裝腳本

在同一台主機上重跑它

· 版本=commit

· 主機壞了,用 up.sh 從同一個 commit 重建

本課規則:程式的唯一來源是 Git 的 commit;主機上的檔案一律由腳本裝上去。

17 of 47

A 服務會搬家

分支 A4

A 服務會搬家 › A4 怎麼換新版

115-1 CloudXEdge · W04

17 / 51

腳本部署的四步:打包 → 安裝 → 放秘密 → 驗版本

① 打包

打包器取這個 commit

② 安裝

經 SSH 在原主機重跑

③ 放秘密

app.env,權限 600

④ 驗版本

/health version=commit

和 up.sh 的關係

同一份安裝腳本:up.sh 交給新主機開機時跑;deploy.sh 經 SSH 在原主機上跑

平常用哪一支

更新程式用 deploy.sh;主機壞了、Lab 被重置才用 up.sh 重建

為什麼要驗版本

沒 commit 的修改不會被裝上去;只有 /health 的 version 能證明現在跑的是哪一版

回到問題:手改的主機說不出自己是哪一版;腳本部署的主機,任何人拿同一個 commit 都能裝出一樣的。

18 of 47

A 服務會搬家

115-1 CloudXEdge · W04

18 / 51

收斂 A:這一段會變的三件事

Codespace

出口位址會變

SG

來源要重對

主機

公開位址會變

nginx:80

inspection

版本會換

01

主機的公開位址:Stop/Start 之後重查

02

Codespace 的出口位址:變了就列舊/新,經審查者核准再改 SG

03

程式的版本:用 deploy.sh 從 commit 裝上去,不進主機手改

不會變的

· 磁碟與上面的檔案

· SG 與 key pair 本身

· 控制通道(AWS API)

回到本段問題:主機啟動了、網址卻打不開——不是壞了,是搬家了。

19 of 47

A 服務會搬家

115-1 CloudXEdge · W04

19 / 51

T1 恢復:把上週的服務接回來

01

一上課就 Start;查新的公開位址,和上週的舊位址對照

02

核對 Codespace 出口 /32:沒變就不動;變了列舊/新,經審查者核准再改 SG

03

/health 回 200,version 與上週相同

20 of 47

02

Section 2

B 一個請求長什麼樣?

Anatomy of a request, and the event contract

範圍:方法與路徑 → 標頭與本文 → 狀態碼與 201 → 事件契約

引導問題

/health 只能看;

要「送」一筆事件進去,請求要怎麼不一樣?

20 / 51

21 of 47

B 請求長什麼樣

115-1 CloudXEdge · W04

21 / 51

快問快答 B:先預測,再舉手

Q1

curl http://…/events 後面什麼都不加,送出去的是哪個方法?

A POST

B GET

C 看伺服器決定

D PUT

Q2

一筆 JSON 事件,放在請求的哪個部分?

A 路徑裡

B 標頭裡

C 本文裡

D 網址的問號後面

Q3

同樣是成功,回 201 和回 200 差在哪?

A 沒差,都是成功

B 201 建立了新資料

C 201 是舊寫法

D 看瀏覽器

22 of 47

B 請求長什麼樣

115-1 CloudXEdge · W04

22 / 51

快問快答 B:答案

Q1

B GET

curl 預設送 GET,也就是「讀」。要送資料得自己指定方法(例如 -X POST),並附上本文。

常見錯選:A:以為有資料就會自動變 POST

Q2

C 本文裡

路徑說「對哪個東西」,標頭描述這次請求(例如 Content-Type、Authorization),真正的資料放在本文。

常見錯選:D:把資料塞進網址,會被記進紀錄檔

Q3

B 201 表示因此建立了新資料

2xx 都是成功,但 201 專指「新建了一筆」。同一筆重送時該回什麼,是 W5 冪等要處理的問題。

常見錯選:A:所有成功都回 200,送出端就分不出情況

23 of 47

B 請求長什麼樣

115-1 CloudXEdge · W04

23 / 51

概念清單 B:一個請求由四樣東西組成

POST /events HTTP/1.1 ← 方法+路徑

Host: 34.x.x.x ← 標頭

Content-Type: application/json ← 標頭:本文是什麼格式

Authorization: Bearer <權杖> ← 標頭:你是誰(C 段)

​

{"event_id":"g03-0001","device_id":"g03-d01",

"observed_at":"2026-09-29T10:00:00+08:00",

"type":"anomaly"} ← 本文

組成

一句話

分支

方法 method

要做什麼:GET 讀、POST 新增

B1

路徑 path

對哪個東西:/health、/events

B1

標頭 header

描述這次請求:格式、身分

B2

本文 body

真正要送的資料(JSON)

B2

狀態碼

伺服器的回答:201/400/401…

B3

事件契約

欄位、必填、格式,雙方先講好

B4

本週只加四個端點:POST /events、GET /events、GET /events/{id}、GET /(顯示頁)。/health 只多回報一個 auth_configured。

24 of 47

B 請求長什麼樣

分支 B1

B 請求長什麼樣 › B1 方法與路徑

115-1 CloudXEdge · W04

24 / 51

同一個位址,不同的方法與路徑,做不同的事

方法+路徑

意思

本週誰能用

GET /health

服務還活著嗎?(W3 做過)

任何人

POST /events

交一筆新的事件進來

reporter

GET /events

看最近的事件清單

operator

GET /events/{event_id}

看其中一筆的細節

operator

GET /

顯示頁(網頁)

任何人(內容要權杖才讀得到)

沒有對應的方法+路徑會怎樣?

· 路徑不存在 → 404 Not Found(W3 對 /events 就是這樣)

· 路徑存在、方法不對 → 405 Method Not Allowed(例如用 PUT 送事件)

換條件:W3 時 curl /events 得到 404,因為那時程式只認得 /health。

25 of 47

B 請求長什麼樣

分支 B2

B 請求長什麼樣 › B2 標頭與本文

115-1 CloudXEdge · W04

25 / 51

資料放在本文;標頭負責說明這次請求

# 示意:一次 POST /events 的樣子(權杖只寫佔位字)

> POST /events HTTP/1.1 ← 方法+路徑

> Content-Type: application/json ← 標頭

> Authorization: Bearer <權杖> ← 標頭(C 段)

> ← 空行

> {"event_id":"g03-0001", …} ← 本文

​

< HTTP/1.1 201 Created ← 回應:狀態碼

< {"event_id":"g03-0001","received_at":"…Z"}

Content-Type

告訴服務「本文是 JSON」;沒寫或寫錯 → 400

Authorization

告訴服務「我是誰」;C 段會講

本文的大小

本週限 4 KiB;再大的(照片)W7 才處理

注意:資料不要放在網址裡。網址會被寫進各種紀錄檔;本文不會(我們的 nginx 也關掉了 access log)。

26 of 47

B 請求長什麼樣

分支 B3

B 請求長什麼樣 › B3 狀態碼

115-1 CloudXEdge · W04

26 / 51

狀態碼的第一個數字就是分類

分類

意思

本週會出現的

送出端該怎麼辦

2xx

成功

200 讀到了、201 建立了新的

繼續

4xx

送出端的問題

400 格式、401 沒身分、403 沒權限、404 找不到、409 重複

先改再送;原樣重送沒用

5xx

服務端的問題

502(W3 看過:nginx 在、程式沒起來)

稍後再試

沒有狀態碼

根本沒收到回答

curl 逾時、連線被拒絕(W3 C 段)

查通道:位址、SG、服務

201 Created 的意思:因為這個請求,服務多了一筆資料

所以「同一筆事件送兩次」該回什麼,就是一個要先講好的問題。本週先一律回 409(重複),W5 有了資料庫再細分成「同內容回 200、不同內容回 409」。

換條件:逾時沒拿到狀態碼時,事件到底收了沒?這題留到 W5。

27 of 47

B 請求長什麼樣

分支 B4

B 請求長什麼樣 › B4 事件契約

115-1 CloudXEdge · W04

27 / 51

兩個人各寫各的,第一筆事件就對不上

// 甲寫的

{

"id": 1,

"device": "d01",

"time": "2026/9/29 10:00",

"kind": "異常"

}

// 乙寫的

{

"eventId": "g03-0001",

"deviceId": "g03-d01",

"observedAt": 1790000000,

"type": "ANOMALY"

}

欄位名稱不同

id/eventId、time/observedAt:兩邊的程式都拿不到對方的值

時間寫法不同

「2026/9/29 10:00」是哪個時區?數字時間戳又是另一種寫法

識別碼誰產生

流水號 1 由誰決定?重送時會不會變成另一個號碼?

所以先寫契約,再請 Agent 實作。可以討論後請Agent 實作。

28 of 47

B 請求長什麼樣

分支 B4

B 請求長什麼樣 › B4 事件契約

115-1 CloudXEdge · W04

28 / 51

本週的事件契約:四個必填欄位

欄位

必填

規則

event_id

是

1–64 字元,英數與 - _;由送出端產生,重送同一筆時不能換

device_id

是

1–32 字元,規則同上

observed_at

是

ISO 8601,必須帶時區,例如 2026-09-29T10:00:00+08:00

type

是

status、anomaly、test 三選一

note

否

字串,最多 200 字元

received_at

服務加

服務收下的時間,UTC,結尾 Z

為什麼時間一定要帶時區?

現場的人寫「10:00」指的是台灣時間;伺服器與資料庫用 UTC 記錄。不帶時區,服務只能用猜的,事件的先後順序就會亂掉。

多出或缺少欄位都拒絕(400)。寬鬆接收看起來友善,但之後每一週都要付代價。

29 of 47

B 請求長什麼樣

115-1 CloudXEdge · W04

29 / 51

收斂 B:一次 POST /events 的完整樣子

方法+路徑

POST /events

標頭

Content-Type、Authorization

本文

一筆事件 JSON

服務

檢查後決定

狀態碼+回應

201 或 4xx

服務的回答

什麼時候

201 Created

欄位都對,建立了一筆新的

400 Bad Request

格式或欄位不符合契約

401 Unauthorized

沒帶權杖或權杖不對(C 段)

403 Forbidden

身分對,但這個角色不能做(C 段)

409 Conflict

這個 event_id 已經有了(W5 會細分)

30 of 47

B 請求長什麼樣

115-1 CloudXEdge · W04

30 / 51

T2 實作:照契約寫測資,再請 Copilot 寫

01

每人照 README 的契約寫 1 筆成功、2 筆拒絕的測資,放 tests/fixtures/(合成資料)

02

請 Copilot 實作四個端點與顯示頁,並寫離線測試

契約由人決定;Copilot 只照契約實作。它自己「順手」加的欄位,一律退回。

31 of 47

03

Section 3

C 誰可以送?送錯了怎麼辦?

Authentication, authorization, validation, secrets

範圍:認證與權杖 → 授權與角色 → 輸入驗證與檢查順序 → 秘密檔

引導問題

SG 只放行你們的 /32,

這樣服務就知道「是誰」送的嗎?

33 / 51

32 of 47

C 誰能送

115-1 CloudXEdge · W04

34 / 51

快問快答 C:先預測,再舉手

Q1

當使用者發送請求,若發生沒帶權杖、權杖錯、角色不對,伺服器端服務分別該回什麼?

A 都回 403

B 401、401、403

C 都回 401

D 400、401、403

Q2

同一個 Codespace 裡的兩個組員各送一筆事件,服務分得出是誰嗎?

A 分得出,看來源位址

B 分不出,兩人同一個出口位址

C 看瀏覽器

D 要開兩個 Codespace

Q3

主機上要放權杖,可以寫在開機時執行的 user data 裡嗎?

A 可以,方便

B 不行,查主機設定就看得到

C 可以,反正有加密

D 看檔案權限

33 of 47

C 誰能送

115-1 CloudXEdge · W04

35 / 51

快問快答 C:答案

Q1

B 401、401、403

沒帶和帶錯都是「認不出你是誰」,回 401;認出來了但角色不允許,回 403。兩者分開,送出端才知道要補身分還是要換人做。

常見錯選:A:把兩種拒絕混成一種

Q2

B 分不出,兩人同一個出口位址

/32 管的是「從哪一台機器來」,不是「誰」。同一個 Codespace 出去的請求,來源位址完全一樣,要靠權杖才分得出人。

常見錯選:A:把網路來源當成身分

Q3

B 不行,查主機設定就看得到

user data 可以用 AWS API 讀回來,等於把權杖寫在一個誰有權限就看得到的地方。秘密要開機後另外放,權限 600。

常見錯選:D:以為設了檔案權限就沒事——問題在它先進了 user data

34 of 47

C 誰能送

115-1 CloudXEdge · W04

36 / 51

概念清單 C:三道檢查,加一個放秘密的地方

① 認證

你是誰?不對 → 401

② 授權

你能做嗎?不行 → 403

③ 輸入驗證

資料對嗎?不對 → 400

④ 重複?

已經有了 → 409

建立

201

C1

認證與權杖

/32 管機器,權杖管人;Authorization: Bearer <權杖>

C2

授權與角色

reporter 只能送、operator 只能查;401 與 403 不同

C3

輸入驗證與順序

依契約逐欄檢查;先查身分再查格式

C4

秘密檔

權杖不進 Git、不進 user data;開機後放進 600 的檔案

35 of 47

C 誰能送

分支 C1

C 誰能送 › C1 認證與權杖

115-1 CloudXEdge · W04

37 / 51

同一個出口位址的兩個人,服務分得出來嗎?

組員 A

同一個 Codespace

同一個出口位址

SG

只看來源位址

服務

看 Authorization 標頭

SG 的 /32

管「從哪一台機器」:擋掉全世界其他人,但擋不住同一台機器上的任何人

權杖

管「是誰」:一段只有持有者知道的字串,放在 Authorization: Bearer <權杖>

服務怎麼比對

和自己保存的權杖比對;不對或沒帶就回 401,而且不告訴對方錯在哪一段

本週的權杖只是課內的最小認證骨架,不是完整的登入系統;

36 of 47

C 誰能送

分支 C2

C 誰能送 › C2 授權與角色

115-1 CloudXEdge · W04

38 / 51

認出你是誰之後,還要問:你能做什麼?

角色

代表誰

POST /events

GET /events

reporter

現場回報端(W6 之後是設備)

✓ 可以

✗ 403

operator

值班查看的人

✗ 403

✓ 可以

沒帶權杖

不知道是誰

✗ 401

✗ 401

401 Unauthorized

「我不知道你是誰」

沒帶權杖、權杖錯、格式不對都算

→ 送出端要補上正確的身分

403 Forbidden

「我知道你是誰,但你不能做這件事」

身分正確、角色不允許

→ 換一個有權限的人來做

37 of 47

C 誰能送

分支 C2

C 誰能送 › C2 授權與角色

115-1 CloudXEdge · W04

39 / 51

同樣是 403:W2 那個和這個不是同一層

哪一層

誰在拒絕

身分是什麼

例子

要查哪裡

AWS 權限層

AWS 的 API

你的 AWS 憑證(LabRole)

W2 匿名讀 S3 物件被拒

IAM、資源政策

你的程式層

你自己寫的服務

reporter/operator 權杖

reporter 想讀事件清單

程式裡的角色判斷

為什麼要分清楚?

兩種 403 的修法完全不同。改錯地方的代價是:有人為了讓程式「過」,去放寬 AWS 權限或把 SG 開大——這是本課明確禁止的。

回到問題:本週所有的 401/403 都是你自己的程式回的,和 AWS 權限無關。

38 of 47

C 誰能送

分支 C3

C 誰能送 › C3 輸入驗證

115-1 CloudXEdge · W04

40 / 51

身分對了,資料不對呢?檢查有先後順序

① 認證

401

② 授權

403

③ 格式

400

④ 重複

409

⑤ 建立

201

為什麼身分先

不讓沒有身分的人用錯誤訊息一步一步試出欄位規則

錯誤要說清楚,但只說一點

回 {"error":"invalid_field","field":"observed_at"};不回整份本文、不回權杖

驗證要照契約

多一個欄位也拒絕;不要「猜使用者的意思」自動補值

換條件:同一個 event_id 送第二次?本週回 409;W5 有資料庫後改成「同內容 200、不同內容 409」。

39 of 47

C 誰能送

分支 C3

C 誰能送 › C3 輸入驗證

115-1 CloudXEdge · W04

41 / 51

拒絕矩陣:T3 要跑的七列

#

請求

預期

擋在哪一道

1

reporter 送一筆合法事件

201

全部通過

2

同上,不帶權杖

401

認證

3

operator 權杖送事件

403

授權

4

reporter,observed_at 沒有時區

400

驗證

5

reporter,再送一次 #1

409(W5 會改)

重複檢查

6

reporter 權杖讀清單

403

授權

7

operator 權杖讀清單

200,含 #1

全部通過

40 of 47

C 誰能送

分支 C4

C 誰能送 › C4 秘密檔

115-1 CloudXEdge · W04

42 / 51

權杖要放在主機上,放哪裡才對?

寫進 Git

誰 clone 到這個 repo 就有;刪掉也還留在歷史裡

寫進 user data

可以用 AWS API 讀回來;也會留在主機的紀錄裡

寫死在程式裡

等於寫進 Git,而且每換一次要重新部署

開機後放進秘密檔

/etc/inspection/app.env,擁有者 root、權限 600,服務啟動時讀入

# deploy.sh 第 2 條:經 SSH 的標準輸入送進去,不落地成暫存檔、不出現在命令列

ssh -i ~/.ssh/<金鑰> ec2-user@<位址> \

'sudo install -m 600 -o root -g root /dev/stdin /etc/inspection/app.env' < .local/app.env

ssh … 'sudo systemctl restart inspection' # 再確認 /health 的 auth_configured 是 true

41 of 47

C 誰能送

分支 C4

C 誰能送 › C4 秘密檔

115-1 CloudXEdge · W04

43 / 51

本週是 HTTP 明文:為什麼現在可以,之後不行

現在可以的條件

① 只放行你們 Codespace 的 /32 ② 全部是合成資料 ③ 權杖是課內測試用、隨時可換

明文的代價

權杖和事件在網路上是可讀的;任何能看到這段流量的人都能拿走權杖

之後怎麼補

W6 講憑證與 TLS:先用在設備與 broker 的連線;把自己的 API 換成 HTTPS 列為延伸

報告要寫:「本週 API 為 HTTP,來源限 /32、資料為合成資料」——不能寫成「已完成安全傳輸」。

42 of 47

C 誰能送

115-1 CloudXEdge · W04

44 / 51

收斂 C:三道門,和它們各擋下什麼

Codespace

/32

SG

網路層的門

nginx:80

認證

401

授權

403

驗證

400/409

記憶體

201

擋下的東西

哪一道

看到什麼

全世界其他機器

SG(網路層)

逾時,沒有任何 HTTP 回應

沒有身分的人

認證

401

身分對、角色不對

授權

403

格式不符合契約

驗證

400,說明哪一欄

同一個 event_id 再送一次

重複檢查

409(W5 會細分)

回到本週問題:能看網頁,只要第一道門;能收一筆可信的事件,四道都要對。

43 of 47

C 誰能送

115-1 CloudXEdge · W04

45 / 51

deploy.sh 的四條:同一台主機、從 commit 更新

01

只部署已 commit 的版本:用打包器產生安裝腳本(和 up.sh 同一份)

02

經 SSH 在原本那台主機上執行(Start 後位址變了,用 accept-new 記住新位址的指紋);再把 .local/app.env 經標準輸入放到 /etc/inspection/app.env(root、600)

03

結束時確認 /health 的 version 等於這次的 commit、auth_configured 是 true

04

執行前印出目標主機與 commit,等你確認;腳本要 commit

審查時實際去看

· 腳本裡有沒有 echo 出權杖

· 秘密有沒有先寫成暫存檔

· 主機上 ls -l 看權限

· /health 的 version

平常更新用 deploy.sh;主機壞了、Lab 被重置才用 up.sh 重建。

44 of 47

C 誰能送

115-1 CloudXEdge · W04

46 / 51

T3 部署與拒絕:把新版裝上去,再跑七列

01

產生兩個權杖到 .local/app.env(不要 cat、不要 echo)

02

請 Copilot 寫 deploy.sh;用上一頁四條審查

03

部署到同一台主機:/health version=這次的 commit、auth_configured=true

04

跑拒絕矩陣七列(一支小腳本一次跑完)

05

看一次顯示頁:private forwarded port,貼 operator 權杖(截圖前清空輸入框)

交出來的證據

· /health 的 version

· 矩陣七列的結果

· 顯示頁截圖(無權杖)

· deploy.sh 審查紀錄

45 of 47

收尾

115-1 CloudXEdge · W04

48 / 51

卡點:遇到這些,先這樣做

你看到的

先這樣做

Start 後舊網址逾時

正常,位址換了。用 AWS CLI 查新位址(控制通道還能用)

Codespace 也重開過

列出舊/新 /32,經審查者核准再改 SG;不要放寬來源

/health 的 auth_configured 是 false

秘密檔沒放到或服務沒重啟;不要把權杖改寫進程式

所有請求都 401

先看標頭格式(Bearer),再比對兩邊檔案的 SHA-256 前 8 碼;不要把權杖印出來

筆電瀏覽器打不開顯示頁

用 private forwarded port 轉送,報告註明「轉送檢視」

同一個卡點超過 10 分鐘

記下最後成功的那一層與錯誤訊息,再求助

46 of 47

收尾

115-1 CloudXEdge · W04

50 / 51

這週要交的東西

誰交

內容

個人

T1 舊/新位址與 /health;拒絕矩陣七列結果;Copilot 第一次沒過審查的地方;顯示頁截圖(不含權杖);一段自己的話寫「三道檢查」

47 of 47

收尾

115-1 CloudXEdge · W04

51 / 51

回顧

W3

打開就知道活著

W4

收得下一筆可信的事件

W5

重開不丟、重送不重複

01

位址會變;新版用 deploy.sh 從 commit 裝上去

02

一個請求=方法+路徑+標頭+本文;回應是狀態碼

03

三道檢查:認證 401、授權 403、驗證 400