115-1 雲端運算與邊緣運算應用 Cloud Computing and Edge Computing Applications
第一筆事件
可送入、查詢並顯示
Week 04|Sprint 4:收得下第一筆可信的事件
個人部署
謝昇憲|四資管 AI 技優專班三A
上週的主機
Start 之後位址會變
一個請求
方法、路徑、標頭、本文
三道檢查
你是誰、能不能做、資料對不對
一筆事件
查得到、看得到
開場
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 段。
需求情境
115-1 CloudXEdge · W04
03 / 51
同一個服務,這週多一塊:收得下第一筆事件
已完成
W3
服務雛型上線
打開就知道活著、是哪一版
今天
W4
第一筆事件
送得進、查得到、看得到
下週
W5
重啟不丟
事件存進資料庫、重送不重複
之後
W6
多個設備
十個設備同時回報
本週明講的範圍:事件只放在程式的記憶體裡,服務重開就不見——這是刻意的,W5 才解決。今天不宣稱「重啟持久」。
需求情境
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
「擋得住」和「收得下」一樣重要
需求情境
115-1 CloudXEdge · W04
05 / 51
今天怎麼走
A 服務會搬家
5–25 分
→ T1 恢復
B 請求長什麼樣
40–60 分
→ T2 契約
C 誰能送、送錯怎麼辦
95–120 分
→ T3 換版與拒絕
需求情境
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 段
誰能送、誰能查、資料不對怎麼辦;權杖放哪裡
01
Section 1
A 上週的主機回來了嗎?
Your host moved: addresses, channels, scripted deploy
範圍:Stop/Start 與公開位址 → 控制通道與資料通道 → 開機自啟與 /32 → 腳本部署
引導問題
主機明明啟動了,
為什麼上週的網址打不開?
07 / 51
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 能改
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:只看「這次最快」
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 進去手改檔案
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)」可以固定位址,但會另外計費,本課不用。費用依當期官方計價頁。
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,位址不變。
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。壞掉的樣子也不一樣。
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(逾時)→ 原樣加回。
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 會是什麼樣子?(連線被拒絕)
A 服務會搬家
分支 A4
A 服務會搬家 › A4 怎麼換新版
115-1 CloudXEdge · W04
16 / 51
要上新版程式:進主機手改,還是用腳本從 commit 裝?
進主機手改檔案
快,但:
· 改動只存在這一台
· 健康頁的版本和實際程式對不上
· 主機壞了重建,改動就不見
· 別人無法照做一次
腳本部署
先 commit
用打包器從這個 commit 產生安裝腳本
在同一台主機上重跑它
· 版本=commit
· 主機壞了,用 up.sh 從同一個 commit 重建
本課規則:程式的唯一來源是 Git 的 commit;主機上的檔案一律由腳本裝上去。
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 都能裝出一樣的。
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)
回到本段問題:主機啟動了、網址卻打不開——不是壞了,是搬家了。
A 服務會搬家
115-1 CloudXEdge · W04
19 / 51
T1 恢復:把上週的服務接回來
01
一上課就 Start;查新的公開位址,和上週的舊位址對照
02
核對 Codespace 出口 /32:沒變就不動;變了列舊/新,經審查者核准再改 SG
03
/health 回 200,version 與上週相同
02
Section 2
B 一個請求長什麼樣?
Anatomy of a request, and the event contract
範圍:方法與路徑 → 標頭與本文 → 狀態碼與 201 → 事件契約
引導問題
/health 只能看;
要「送」一筆事件進去,請求要怎麼不一樣?
20 / 51
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 看瀏覽器
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,送出端就分不出情況
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。
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。
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)。
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。
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 實作。
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)。寬鬆接收看起來友善,但之後每一週都要付代價。
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 會細分) |
B 請求長什麼樣
115-1 CloudXEdge · W04
30 / 51
T2 實作:照契約寫測資,再請 Copilot 寫
01
每人照 README 的契約寫 1 筆成功、2 筆拒絕的測資,放 tests/fixtures/(合成資料)
02
請 Copilot 實作四個端點與顯示頁,並寫離線測試
契約由人決定;Copilot 只照契約實作。它自己「順手」加的欄位,一律退回。
03
Section 3
C 誰可以送?送錯了怎麼辦?
Authentication, authorization, validation, secrets
範圍:認證與權杖 → 授權與角色 → 輸入驗證與檢查順序 → 秘密檔
引導問題
SG 只放行你們的 /32,
這樣服務就知道「是誰」送的嗎?
33 / 51
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 看檔案權限
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
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 的檔案
C 誰能送
分支 C1
C 誰能送 › C1 認證與權杖
115-1 CloudXEdge · W04
37 / 51
同一個出口位址的兩個人,服務分得出來嗎?
組員 A
同一個 Codespace
同一個出口位址
SG
只看來源位址
服務
看 Authorization 標頭
SG 的 /32
管「從哪一台機器」:擋掉全世界其他人,但擋不住同一台機器上的任何人
權杖
管「是誰」:一段只有持有者知道的字串,放在 Authorization: Bearer <權杖>
服務怎麼比對
和自己保存的權杖比對;不對或沒帶就回 401,而且不告訴對方錯在哪一段
本週的權杖只是課內的最小認證骨架,不是完整的登入系統;
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
「我知道你是誰,但你不能做這件事」
身分正確、角色不允許
→ 換一個有權限的人來做
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 權限無關。
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」。
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 | 全部通過 |
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
C 誰能送
分支 C4
C 誰能送 › C4 秘密檔
115-1 CloudXEdge · W04
43 / 51
本週是 HTTP 明文:為什麼現在可以,之後不行
現在可以的條件
① 只放行你們 Codespace 的 /32 ② 全部是合成資料 ③ 權杖是課內測試用、隨時可換
明文的代價
權杖和事件在網路上是可讀的;任何能看到這段流量的人都能拿走權杖
之後怎麼補
W6 講憑證與 TLS:先用在設備與 broker 的連線;把自己的 API 換成 HTTPS 列為延伸
報告要寫:「本週 API 為 HTTP,來源限 /32、資料為合成資料」——不能寫成「已完成安全傳輸」。
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 會細分) |
回到本週問題:能看網頁,只要第一道門;能收一筆可信的事件,四道都要對。
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 重建。
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 審查紀錄
收尾
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 分鐘 | 記下最後成功的那一層與錯誤訊息,再求助 |
收尾
115-1 CloudXEdge · W04
50 / 51
這週要交的東西
誰交 | 內容 |
個人 | T1 舊/新位址與 /health;拒絕矩陣七列結果;Copilot 第一次沒過審查的地方;顯示頁截圖(不含權杖);一段自己的話寫「三道檢查」 |
收尾
115-1 CloudXEdge · W04
51 / 51
回顧
W3
打開就知道活著
W4
收得下一筆可信的事件
W5
重開不丟、重送不重複
01
位址會變;新版用 deploy.sh 從 commit 裝上去
02
一個請求=方法+路徑+標頭+本文;回應是狀態碼
03
三道檢查:認證 401、授權 403、驗證 400