{
 "byKey": {
  "cover": [
   { "say": "大家好,歡迎回到 Linux A I 助理開發實戰。這一章要進入多主機管理。我們會讓助理透過 S S H 去檢查遠端的主機,內容包括金鑰驗證、主機清單、指令白名單,還有並行檢查和批次操作的預演。", "item": 0 }
  ],
  "SSH 金鑰驗證與 known_hosts#1": [
   { "say": "前面十二章,助理都只管本機。可是真實的環境,常常有好幾台、甚至幾十台主機。這一章,我們要讓助理透過 S S H 管理遠端主機。一旦助理碰得到別台機器,風險也會跟著放大,所以先立下三條鐵則。", "item": 0 },
   { "say": "第一條,只用金鑰驗證,不用密碼。", "item": 1 },
   { "say": "第二條,一律驗證主機金鑰,也就是 known hosts 這個機制,絕對不關閉檢查。", "item": 2 },
   { "say": "第三條,只操作你自己授權的主機,而且要用專用的低權限帳號。", "item": 3 }
  ],
  "SSH 金鑰驗證與 known_hosts#2": [
   { "say": "好,第一步是建立專用的金鑰。", "item": 0 },
   { "say": "在助理所在的管理主機上,替助理建立一把專屬的金鑰,類型是 E D 二五五一九。記得,不要跟你個人的金鑰共用。", "item": 1 },
   { "say": "畫面上的指令,是用 S S H keygen 產生這把金鑰,並且指定檔名和註解,再把私鑰的權限改成六零零,只有擁有者可以讀寫。", "item": 2 },
   { "say": "私鑰建議加上通關密語,再交給 S S H agent 或系統的祕密管理機制來提供。如果是沒有人值守的 system D 服務,私鑰的權限一定要是六零零,只有服務帳號讀得到,而且這把金鑰只能對應到低權限的帳號。", "item": 3 }
  ],
  "SSH 金鑰驗證與 known_hosts#3": [
   { "say": "第二步,到被管理的主機上建立專用帳號。", "item": 0 },
   { "say": "每一台被管理的主機,都建立一個專用的帳號,而且不給它 sudo 權限。", "item": 1 },
   { "say": "畫面上的兩行指令,第一行建立一個叫 A I ops 的帳號,並且停用密碼登入。第二行替它建立點 S S H 目錄,權限是七零零。", "item": 2 },
   { "say": "接著把公鑰放進這個帳號的 authorized keys 檔案,並且加上限制選項。其中 restrict 這個選項,會一次關掉連接埠轉發、agent 轉發和 P T Y 這些功能。", "item": 3 },
   { "say": "實際寫出來就像畫面上這一行,最前面是限制選項,後面才是公鑰的內容。", "item": 4 },
   { "say": "裡面的 from 選項,是限制只有管理主機的 I P 可以使用這把金鑰。下一個單元,我們還會再加上強制指令,當作第二道防線。", "item": 5 }
  ],
  "SSH 金鑰驗證與 known_hosts#4": [
   { "say": "第三步是 known hosts,它的用途是防止中間人攻擊。", "item": 0 },
   { "say": "第一次連線的時候,S S H 會顯示對方主機的指紋。正確的做法叫做帶外確認,也就是透過另一個管道來核對。", "item": 1 },
   { "say": "你要先到那台主機的本機上,用 S S H keygen 讀出主機公鑰的指紋。", "item": 2 },
   { "say": "拿到指紋之後,跟你準備加入的值比對,確認一樣,才寫進 known hosts。", "item": 3 },
   { "say": "畫面上是用 S S H keyscan 把主機金鑰抓下來,附加到 known hosts 檔案的最後面,然後再把檔案裡的指紋一筆一筆列出來核對。", "item": 4 },
   { "say": "要特別注意,S S H keyscan 本身不會驗證對方的身分,它只是把金鑰抓回來。所以一定要跟帶外取得的指紋比對,不然就等於沒有驗證。", "item": 5 }
  ],
  "SSH 金鑰驗證與 known_hosts#5": [
   { "say": "接下來看不安全的反例,請不要用在正式環境。", "item": 0 },
   { "say": "網路上很常看到一些偷懶的寫法。", "item": 1 },
   { "say": "第一種是連線的時候,把嚴格主機金鑰檢查關掉,還把 known hosts 檔案指到空裝置。第二種是在 Paramiko 裡,設定成自動加入陌生的主機。這兩種都不安全。", "item": 2 },
   { "say": "這樣做等於放棄驗證對方的身分。攻擊者如果當中間人,助理會把指令和回傳的資料全部交給他。如果是主機重灌造成指紋改變,正確的做法是先查明原因,確認之後移除舊的紀錄再重新驗證,而不是把檢查關掉。", "item": 3 }
  ],
  "SSH 金鑰驗證與 known_hosts#6": [
   { "say": "被管理主機的 S S H 服務,也可以再強化。", "item": 0 },
   { "say": "建議在設定檔裡關閉密碼驗證、禁止 root 登入,並且限制哪些帳號可以登入。改完先檢查語法,再重新載入服務,Ubuntu 上的服務名稱是 S S H。修改之前,一定要保留一個已經登入的工作階段,免得把自己鎖在門外。", "item": 1 }
  ],
  "SSH 金鑰驗證與 known_hosts#7": [
   { "say": "最後來看這個單元的常見錯誤。", "item": 0 },
   { "say": "第一個,私鑰的權限太寬,例如六四四,S S H 會直接拒絕使用。", "item": 1 },
   { "say": "第二個,把私鑰或 A P I 金鑰寫進程式碼,或是放進 Git 倉庫。", "item": 2 },
   { "say": "第三個,用 root 帳號當作遠端管理的帳號。", "item": 3 },
   { "say": "第四個,一看到遠端主機識別已經改變的警告,就直接把檢查關掉。", "item": 4 }
  ],
  "主機清單與遠端指令白名單#1": [
   { "say": "好,接下來這個單元,要決定助理可以連到哪裡、可以做什麼。", "item": 0 },
   { "say": "助理要管理多台主機,第一步就是定義它能碰哪些主機。這份清單必須由人來維護,不能讓 L L M 自己決定要連到哪裡。", "item": 1 }
  ],
  "主機清單與遠端指令白名單#2": [
   { "say": "我們先來看主機清單,它是一個叫 hosts 點 YAML 的檔案。", "item": 0 },
   { "say": "它放在專案的 config 目錄裡。裡面不放任何密碼,也不放私鑰的內容,只放私鑰的路徑。", "item": 1 },
   { "say": "檔案的最上層是 hosts,底下每一台主機都有一個別名。", "item": 2 },
   { "say": "第一台是網頁主機,記錄了它的位址、連接埠、登入帳號、金鑰的路徑,還有標籤。", "item": 3 },
   { "say": "第二台是資料庫主機,欄位一模一樣,只有位址和標籤不同。", "item": 4 },
   { "say": "Python 載入這個檔案的時候,一定要驗證格式。而且要用 Py YAML 的安全載入函式,不要用一般的載入函式去讀不受信任的內容。", "item": 5 }
  ],
  "主機清單與遠端指令白名單#3": [
   { "say": "我們來看載入主機清單的程式。", "item": 0 },
   { "say": "最前面先匯入需要的模組。", "item": 1 },
   { "say": "接著定義別名的規則。只能用小寫英文、數字和連字號,第一個字不可以是連字號,最長三十二個字元。", "item": 2 },
   { "say": "再來是一個不能修改的資料類別,用來描述一台主機,欄位有別名、位址、連接埠、使用者、金鑰和標籤。", "item": 3 },
   { "say": "載入的函式會把檔案安全地讀進來,一台一台檢查別名。不合規則就丟出錯誤,合格的才建立成主機物件。", "item": 4 },
   { "say": "這樣設計之後,L L M 只能提供別名,真實的位址由程式從清單查出來。不在清單裡的名稱一律拒絕,助理就不會被誘導去連任意的主機或內網設備。別名的格式限制,也能擋掉用減號開頭、想被 S S H 當成選項的字串。", "item": 5 }
  ],
  "主機清單與遠端指令白名單#4": [
   { "say": "回頭再看一次清單裡的兩個別名。", "item": 0 },
   { "say": "第一個是 web 零一,代表網頁主機。", "item": 1 },
   { "say": "第二個是 D B 零一,代表資料庫主機。模型能說出口的,就只有這樣的別名。", "item": 2 }
  ],
  "主機清單與遠端指令白名單#5": [
   { "say": "主機限制好了,接著要限制指令,也就是遠端指令白名單。", "item": 0 },
   { "say": "原則是,不要讓 L L M 產生任意的 shell 字串,再丟到遠端去執行。做法是定義具名的操作,每個操作對應一組固定的指令。", "item": 1 },
   { "say": "畫面上定義了五個操作,分別是查看開機時間、磁碟用量、記憶體、系統負載,還有啟動失敗的服務。每一個背後的指令和參數都是寫死的。", "item": 2 },
   { "say": "所以 L L M 的工具呼叫,只能指定主機別名和操作名稱。如果需要參數,例如服務名稱,就要再用正規表示式或列舉嚴格驗證,而且只允許查看狀態這種唯讀的動作,不能是重啟。", "item": 3 }
  ],
  "主機清單與遠端指令白名單#6": [
   { "say": "再來是第二道防線,設在伺服器端的強制指令。", "item": 0 },
   { "say": "就算助理這一端的程式被攻破,或是被提示注入,被管理的主機還是可以自己設限。", "item": 1 },
   { "say": "做法是在 authorized keys 裡,用 command 這個選項指定一支包裝腳本。不管用戶端要求執行什麼,伺服器都只會執行這支腳本。", "item": 2 },
   { "say": "這支腳本的擁有者是 root。它會讀取用戶端原本想執行的指令,拿來一項一項比對。", "item": 3 },
   { "say": "只有在白名單裡的才放行,比對到這裡結束。", "item": 4 },
   { "say": "這樣一來,用戶端送來的只是動作的名稱,真正要執行什麼,由伺服器決定。兩端都有白名單,才是縱深防禦。", "item": 5 }
  ],
  "主機清單與遠端指令白名單#7": [
   { "say": "我們把腳本裡的比對內容看清楚。", "item": 0 },
   { "say": "收到 uptime,就執行查看開機時間的指令。", "item": 1 },
   { "say": "收到 disk,就執行查看磁碟用量的指令。", "item": 2 },
   { "say": "收到 memory,就查看記憶體。", "item": 3 },
   { "say": "收到 load,就讀取系統負載。", "item": 4 },
   { "say": "其他任何內容,一律回覆拒絕,並且用錯誤代碼結束。", "item": 5 }
  ],
  "Paramiko、asyncssh 與 ssh 子行程的安全用法#1": [
   { "say": "接下來這個單元,我們來看 Python 怎麼安全地呼叫 S S H。", "item": 0 },
   { "say": "常見的路線有三條,三條都可以做到安全。關鍵在四件事,驗證主機金鑰、用金鑰驗證、設定逾時、不拼接 shell 字串。實際的 A P I 和參數,請以各套件的官方文件和你安裝的版本為準。", "item": 1 }
  ],
  "Paramiko、asyncssh 與 ssh 子行程的安全用法#2": [
   { "say": "路線一,是直接呼叫系統的 S S H 指令,這是最簡單的做法。優點是直接沿用 known hosts,還有 Open S S H 成熟的實作。重點是用參數列表來呼叫,不要打開 shell 模式。", "item": 0 },
   { "say": "程式會先確認操作在白名單裡,再組出指令。選項包括不詢問密碼、連線逾時五秒、嚴格檢查主機金鑰,而且只使用指定的那把金鑰。指令的最後,才接上白名單裡的固定指令。", "item": 1 },
   { "say": "另外,輸出要截斷,避免塞爆 L L M 的上下文,逾時的例外也要接住。還有一點要注意,S S H 會把遠端指令的參數用空白串起來,交給遠端的 shell,所以遠端指令只能來自固定的白名單,不要放使用者的輸入。", "item": 1 }
  ],
  "Paramiko、asyncssh 與 ssh 子行程的安全用法#3": [
   { "say": "路線二是 Paramiko,它是同步的寫法,使用的人也很多。", "item": 0 },
   { "say": "先把套件匯入。", "item": 1 },
   { "say": "函式裡會先讀取系統的 known hosts,並且把陌生主機的處理方式設成直接拒絕。連線的時候,各種逾時都要設定,也不去找其他的金鑰,只用我們指定的那一把。執行完,輸出只讀取有限的長度,最後一定把連線關掉。", "item": 2 },
   { "say": "重點是,拒絕陌生主機才是安全的選擇。自動加入的那種做法,會信任任何陌生的主機,不要用在正式環境。另外,Paramiko 的指令還是一個字串,所以同樣只能傳白名單裡的內容。", "item": 3 }
  ],
  "Paramiko、asyncssh 與 ssh 子行程的安全用法#4": [
   { "say": "路線三是 async S S H,它是非同步的寫法,適合大量並行。", "item": 0 },
   { "say": "它要搭配 Python 的 asyncio 一起使用。", "item": 1 },
   { "say": "連線的時候,一樣提供位址、連接埠、帳號和金鑰,還要明確指定 known hosts 檔案的路徑。執行指令的時候,外面再包一層總逾時,這是最直觀的保險。", "item": 2 },
   { "say": "要小心,known hosts 這個參數如果設成 None,就是關閉驗證,屬於不安全的做法。請務必提供檔案路徑。", "item": 3 }
  ],
  "Paramiko、asyncssh 與 ssh 子行程的安全用法#5": [
   { "say": "那這三條路線要怎麼選呢?", "item": 0 },
   { "say": "如果只管少數幾台主機,又想要最少的相依套件,就用系統的 S S H 指令。", "item": 1 },
   { "say": "如果需要在同一條連線裡執行好幾個步驟,或是你的程式本來就是同步的寫法,就選 Paramiko。", "item": 2 },
   { "say": "如果要對幾十台以上的主機並行,就用 async S S H,或是把呼叫 S S H 指令的工作放進執行緒池。", "item": 3 }
  ],
  "Paramiko、asyncssh 與 ssh 子行程的安全用法#6": [
   { "say": "寫好之後,別忘了把它註冊成工具。", "item": 0 },
   { "say": "依照第五章的註冊表,註冊一個查詢遠端狀態的工具。主機參數用列舉限制成清單裡的別名,操作參數用列舉限制成白名單。工具回傳的是結構化的 JSON,包含結束代碼和輸出,不要把整段原始輸出毫無限制地傳回去。", "item": 1 }
  ],
  "Paramiko、asyncssh 與 ssh 子行程的安全用法#7": [
   { "say": "這個單元的常見錯誤有四個。", "item": 0 },
   { "say": "第一個,把錯誤輸出裡的主機資訊和路徑,原封不動回給所有使用者。", "item": 1 },
   { "say": "第二個,忘記設定逾時,結果一台掛掉的主機,就把整個助理卡死。", "item": 2 },
   { "say": "第三個,打開 shell 模式,或是用執行系統指令的函式來拼接指令。", "item": 3 },
   { "say": "第四個,把自動加入陌生主機、或是關閉 known hosts 驗證的寫法,當成方便,就這樣留在正式的程式碼裡。", "item": 4 }
  ],
  "並行、逾時與批次操作的 dry-run#1": [
   { "say": "好,最後一個單元,來談並行、逾時,還有批次操作的預演。", "item": 0 },
   { "say": "管理多台主機,最常見的需求就是一次檢查全部。並行可以縮短時間,但是要控制好同時連線的數量、逾時,還有失敗的隔離。而任何會改變主機的批次操作,都必須有預演,也就是 dry run,再加上人工確認。", "item": 1 }
  ],
  "並行、逾時與批次操作的 dry-run#2": [
   { "say": "先看並行檢查。做法是以上個單元的函式為基礎,用執行緒池同時對多台主機執行,再把結果收集起來。設計上有四個重點。", "item": 0 },
   { "say": "第一,同時工作的數量要有上限,例如八個。這樣可以避免瞬間對管理網段產生大量連線,也避免被對方的 fail2ban 誤判成攻擊。", "item": 1 },
   { "say": "第二,每一台都有自己的逾時,包括連線逾時和指令逾時。而且逾時是預期之內的錯誤,要記錄到結果裡,不是讓程式崩潰。單獨一台失敗,也不會影響其他台。", "item": 2 },
   { "say": "第三,錯誤訊息只回傳例外的類型,避免洩漏內部路徑或主機的細節。", "item": 3 },
   { "say": "第四,結果用主機別名當作索引,方便 L L M 閱讀,第十四章做報告的時候也會用到。如果是非同步的版本,可以用號誌把並行數量限制在八個。", "item": 4 }
  ],
  "並行、逾時與批次操作的 dry-run#3": [
   { "say": "結果拿回來之後,要怎麼給 L L M 看呢?", "item": 0 },
   { "say": "多台主機的輸出會很長,所以先在程式這一端做摘要,再交給 L L M。例如先算出每一台的磁碟使用率,把超過百分之八十五的標記出來。", "item": 1 },
   { "say": "畫面上的函式就是在做這件事。連不上的主機,標記成無法連線並附上原因。連得上的,就把每個掛載點的使用率取出來,八十五以上標成警告,其他標成正常。", "item": 2 },
   { "say": "這樣 L L M 看到的是精簡的結構化資料,用的 token 比較少,也比較不容易讀錯。", "item": 3 }
  ],
  "並行、逾時與批次操作的 dry-run#4": [
   { "say": "再來是會改變主機的批次操作。假設要在一組主機上重啟某個服務,流程必須照五個步驟來走。", "item": 0 },
   { "say": "第一步是計畫。助理只產生打算做什麼,列出目標主機、動作和預期的影響,但是不執行。", "item": 1 },
   { "say": "第二步是預演。能預演的就預演,例如用模擬的方式跑套件升級,或是先檢查服務目前的狀態。不能預演的,就只列出計畫。", "item": 2 },
   { "say": "第三步是人工確認。把計畫摘要顯示出來,由有權限的人輸入明確的確認,例如輸入主機的數量,或是一段確認碼。不能是模型自己回答 yes。", "item": 3 }
  ],
  "並行、逾時與批次操作的 dry-run#5": [
   { "say": "後面還有兩個步驟。", "item": 0 },
   { "say": "第四步是分批執行。先做一台,成功了再做其他的。只要有任何一台失敗,後面的就全部停下來。", "item": 1 },
   { "say": "第五步是稽核紀錄,記下誰、在什麼時候、對哪些主機、做了什麼、結果如何。還有一個重點,真正套用計畫的那個函式,不能由 L L M 來呼叫。它必須來自人操作的確認介面,像是命令列的提示,或是第十五章網頁介面裡,需要登入和授權的按鈕。", "item": 2 }
  ],
  "並行、逾時與批次操作的 dry-run#6": [
   { "say": "再提醒一次授權範圍和稽核。", "item": 0 },
   { "say": "只對自己擁有、或是明確取得書面授權的主機操作。稽核紀錄要寫進助理專用的日誌檔,欄位包含時間、操作者、目標、動作和結果。但是不要把金鑰,或是指令輸出裡的敏感資料寫進去。", "item": 1 }
  ],
  "並行、逾時與批次操作的 dry-run#7": [
   { "say": "最後看這個單元的常見錯誤。", "item": 0 },
   { "say": "第一個,不限制並行數量,一次對上百台主機同時連線。", "item": 1 },
   { "say": "第二個,一台逾時就讓整批失敗,或是反過來,把錯誤完全吞掉。", "item": 2 },
   { "say": "第三個,讓 L L M 的輸出直接觸發批次變更,中間沒有任何人把關。", "item": 3 },
   { "say": "第四個,沒有稽核紀錄,事後完全無法追查。", "item": 4 }
  ],
  "closing": [
   { "say": "這一章就到這裡。我們學會用金鑰和 known hosts 安全地連線,用主機清單和兩端的白名單限制助理,也知道批次變更一定要先預演、再由人確認。", "item": 0 },
   { "say": "請記得動手完成這一章的 Lab,再做章末小測驗,檢查自己學會了多少。我們下一章見!", "item": 1, "pause": 1 }
  ]
 }
}
