跳轉到

三、開通(取得授權)

這章在講什麼:把裝好的系統「啟用」,讓全部功能可以使用。

就像買了一台新設備,機器搬進來、電接上了,還要向原廠登記機號、拿到啟用碼,才能開始正式使用。這裡的「啟用」靠的是一張授權檔——由原廠簽發,而且只對這台主機有效

什麼時候看第二章安裝完成、畫面印出那組設定碼之後。

本章分兩段:

  • 3.1~3.4 設定精靈:在瀏覽器建立管理員帳號、取得機器碼
  • 3.5~3.7 開通:把機器碼交給原廠、收到授權檔後匯入

3.1 為什麼要分兩段做

結論:授權檔綁的是這台主機的機器碼,而機器碼要裝好之後才算得出來,所以「取號」與「開通」註定分成兩趟。

機器碼是系統依這台主機的特徵算出來的一串固定識別碼,可以想成這台機器的身分證號。流程一定是這樣:

裝好 → 取得機器碼 → (離線交給原廠,可能要等一段時間)→ 收到授權檔 → 匯入 → 全功能可用

等待原廠簽發的期間,系統是可以登入的,只是選單上只看得到少數幾項不受授權管制的功能(「專案儀表板」「待辦任務」「我的授權狀態」)。匯入授權檔後,選單才會展開為授權內的完整功能清單。


3.2 進入設定精靈

這一步在做什麼:用瀏覽器連進剛裝好的系統,開始初始設定。

https://<您安裝時填的主機名或 IP>

網址就是安裝完成畫面上印出的那一個。

成功長什麼樣:先跳憑證安全警告(正常現象,見 2.4)→ 點「繼續前往」→ 看到標題為「系統初始設定」的精靈畫面。

看到別的畫面時

直接看到登入畫面,代表這套系統已經完成過初始設定(可能是重裝到既有系統上,或有人先一步完成了)。請直接登入。

看到「系統暫時無法使用」,代表資料庫還沒完全就緒。稍等 1~2 分鐘後重新載入頁面。持續如此請聯繫原廠並附上安裝紀錄檔。


3.3 第一步:貼上設定碼

這一步在做什麼:證明「操作的人就是剛剛裝這台機器的人」。精靈第一步要求輸入安裝設定碼,就是安裝完成畫面上印出的那一串。

安裝設定碼: [                              ]

找不到設定碼時,回到主機上執行這行把它印出來:

sudo cat /srv/guidant-ai/pki/setup-token

成功長什麼樣:貼上正確的設定碼後按「下一步」,畫面進到「建立管理員」。

為什麼要這一關:系統剛裝好、還沒有任何帳號的那段期間,設定精靈對任何連得到這台機器的人都是開的。要求貼上這串只有安裝者看得到的設定碼,才能進入建立帳號的流程——防止有人搶先建立管理員帳號(與 Jenkins 首次啟動要貼一組初始密碼是同樣的作法)。

設定碼用過即失效,管理員帳號建立成功後這條通道就永久關閉。


3.4 第二步:建立管理員帳號

這一步在做什麼:建立貴單位第一個、也是權限最高的帳號。

欄位 怎麼填
貴單位名稱 顯示在系統中的單位名稱,日後可於租戶設定中修改
管理員登入帳號 日後登入用的帳號。🔴 不可使用 admin——這個名稱是原廠系統帳號的保留字,已由安裝程式建立佔用,填了會被擋下並顯示「帳號已存在」。請改用其他名稱(例如 itadmin、貴單位縮寫加 admin
管理員顯示名稱 系統畫面上顯示的名字
管理員電子郵件 🔴 請務必填寫正確且收得到的信箱——忘記密碼時系統會寄重設信到這裡
管理員密碼 至少 12 個字元,且需同時包含大寫英文字母、小寫英文字母與數字
再次輸入密碼

這組密碼由您自己決定,安裝程式不會產生也不會顯示任何帳號密碼。請妥善保管。

成功長什麼樣:按「建立管理員帳號」後,畫面進到「取得授權」,顯示「管理員帳號已建立」。


3.5 第三步:抄下機器碼

這一步在做什麼:把這台主機的機器碼抄下來,等一下要交給原廠。

畫面上會顯示一串 64 個字元的本機機器碼,旁邊有「複製機器碼」按鈕。

本機機器碼
9f8e7d6c5b4a...(共 64 個字元)        [ 複製機器碼 ]

成功長什麼樣:按下複製按鈕後出現「已複製機器碼」提示。

按了沒反應? 請確認網址列是 https:// 開頭。瀏覽器的剪貼簿功能只在 HTTPS 下可用。也可以直接用滑鼠選取那串文字複製。

在主機上也查得到(網頁開不起來時的備援手段):

sudo guidant fingerprint

成功長什麼樣:印出的那一串,跟網頁上顯示的應該完全相同

🔴 機器碼是這台主機的身分。 只要不換機器、不重新產生 /etc/machine-id,這串就不會變——重新安裝系統也不會變,所以既有的授權檔在重裝後仍然可用。


3.6 把機器碼交給原廠,取得授權檔

結論:這是一段離線往返,這台主機全程不需要連上網際網路。

  1. 透過既有管道(電子郵件、電話)把機器碼連同開通序號(訂購時原廠提供)交給原廠。
  2. 原廠簽發一份綁定該機器碼的授權檔(副檔名 .license)回覆給您。
  3. 收到後進行下一節的匯入。

這段期間可以先按精靈的「前往登入」,用剛建立的管理員帳號登入系統。選單上只會有少數幾項功能,這是正常的。


3.7 匯入授權檔

先說結論:匯入不在設定精靈裡,而是登入之後的「License 開通」頁。

這一步在做什麼:把原廠回覆的授權檔上傳進系統,讓全部功能解鎖。

  1. 用管理員帳號登入系統
  2. 系統偵測到尚未取得授權,會自動導向「License 開通」頁(也可從選單「授權管理」→「我的授權狀態」進入)。
  3. 在「上傳授權檔」選擇原廠回覆的 .license 檔,按「開通」。

成功長什麼樣

  • 一則訊息:「開通成功,授權已生效;功能選單已更新,授權內的功能現在都可以使用了」。
  • 畫面導向「我的授權狀態」頁。
  • 左側選單當下就展開成完整的功能清單(實際項數依購買的方案而定)——不需要重新登入

若選單沒有立刻更新,畫面上會出現一則黃色提示與一顆「重新登入」按鈕,按它登出重登即可。授權本身已經生效,這只是選單沒抓到新的。

線上開通(有網路時的替代路徑)

若這台主機連得上原廠的開通伺服器,同一頁上還有一條更快的路:在「線上開通序號」欄輸入原廠提供的開通序號,按「線上開通」——系統會自動連線換取授權檔並立即生效,不需要抄機器碼、不需要等待往返

封閉網路(air-gap,完全連不到網際網路的環境)請走上面的離線路徑。


3.8 開通完成後

至此安裝與開通全部完成。接下來可以:

  • 建立其他使用者帳號(選單「系統管理」→「帳號管理」),並在「權限管理」指派各人可用的功能 → 見 3.9
  • 設定寄信、AI 功能、雲端硬碟整合等選配功能 → 見 第十章
  • 政府組態基準(GCB)檢測內容出廠已內建、不需匯入,可直接使用 → 見 第十章 10.3
  • 把本機憑證登錄進貴單位的密碼保險庫 → 見 第四章 4.5

授權到期、續約、換機時怎麼辦

情形 怎麼做
續約 / 加購 原廠簽發新的授權檔,在同一頁上傳即可。新照生效前現行授權不受影響
換機器 機器碼會改變,需聯繫原廠辦理換綁(人工受理,不提供自助操作)
授權檔遺失 聯繫原廠補發
重新安裝(同一台機器) 機器碼不變,原授權檔可直接再次匯入

更完整的授權說明(到期前後的系統行為、停權等)見《授權管理使用指南》。


3.9 把系統設定的維護權分給其他人

先說結論:不必把管理員帳號共用給同仁,也不必把對方設成最高權限——在「權限管理」勾選對應功能就好。

精靈建立的那個管理員帳號預設擁有貴單位全部的功能權限。若要讓其他同仁也能維護系統設定(儲存設備、郵件伺服器、LDAP、通知),照下表勾給他所屬的角色即可。

要讓對方能維護的頁面 在「權限管理」要勾的項目
儲存設備設定 儲存設備設定(讀取/修改)
郵件伺服器設定 郵件伺服器設定(讀取/修改)
LDAP伺服器設定 LDAP伺服器設定(讀取/修改)
通知設定 通知設定(讀取/修改)

四頁各自獨立:勾了郵件伺服器不代表能改儲存設備,反之亦然。要能按下該頁的「儲存」按鈕,需要的是修改權限;只給讀取的人看得到內容但存不下去。

這四頁在 1.15.0 版之前有一個已修正的問題:即使角色已勾選、進到頁面按儲存仍會被拒絕(只有最高權限的帳號能存)。1.15.0 起已依上表正常運作,勾了就能用。

郵件伺服器與 LDAP 這兩頁全系統共用同一組設定——不論由誰維護,改的都是同一份,不會每個單位各自一份。