你的帳號
管理密碼、兩步驟驗證、已登入裝置、腳本使用的應用程式密碼、語言與介面風格、登入紀錄和通知。
本頁所有功能都在帳號選單中:按一下左側清單底部的名字即可開啟。選單最後一行顯示伺服器執行的 ThirtyFile 版本,例如 ThirtyFile 0.5.0。
密碼
變更密碼需要輸入目前密碼和新密碼。修改後,其他裝置會登出。新密碼至少需要 6 個字元;如果管理員設定了更高的最低長度,則需滿足該要求。
如果密碼由管理員設定(新建帳號或重設密碼),首次登入時需要自行設定密碼。忘記密碼時,登入頁的忘記密碼?會向你的電子郵件信箱傳送連結,前提是管理員已設定郵件服務和網站網址,而且帳號已填寫電子郵件信箱(參閱通知設定)。
兩步驟驗證
開啟兩步驟驗證後,只有密碼還不足以登入:輸入密碼後,還需輸入手機驗證器 App產生的六位驗證碼,例如 Microsoft Authenticator、Google Authenticator 或 1Password。驗證碼每 30 秒更換一次,只能使用一次。
- 開啟兩步驟驗證,選擇設定,輸入密碼。
- 使用App 掃描 QR 碼。無法掃描時,把 QR 碼下方顯示的金鑰輸入 App。
- 輸入 App顯示的驗證碼確認,即可開啟兩步驟驗證。
- 儲存接下來顯示的十個復原碼,例如放在密碼管理器中或寫在紙上。手機遺失時,每個復原碼可代替驗證碼登入一次。復原碼只顯示這一次。
在同一個對話方塊中,可以產生新的復原碼(舊復原碼隨即失效),透過更換 App改用其他手機或 App,或者關閉兩步驟驗證。每項操作都需要密碼和目前 App 的驗證碼(或復原碼)。
- 驗證碼連續錯誤五次後,必須重新輸入密碼。一個帳號累計十次驗證碼錯誤後,系統會拒絕繼續驗證,最長持續 15 分鐘。
- 單一登入(Microsoft、Google、GitHub 或 OpenID Connect 服務)不要求此驗證碼:身分提供者有自己的兩步驟驗證。應用程式密碼也不要求驗證碼。
- 如果管理員要求使用兩步驟驗證,下次輸入密碼登入後會立即要求設定,而且不能關閉。
已登入裝置
裝置列出所有已登入你帳號的瀏覽器,包括瀏覽器和系統、最近使用的位址、登入時間和上次使用時間。目前使用的裝置標為這個裝置。
- 裝置旁的登出會立即結束其工作階段。該裝置必須重新登入。
- 登出其他所有裝置會讓目前裝置以外的所有裝置登出。
裝置 14 天沒有使用就會登出;每個裝置在登入 30 天後也一律會登出。
應用程式密碼
腳本、備份工具和檔案用戶端無法透過登入頁登入。請在應用程式密碼中為每一個工具建立獨立應用程式密碼。使用單一登入且沒有本機密碼的帳號也採用這種方式。
- 為它填寫能說明用途的名稱,選擇只能讀取檔案還是也能更改檔案,並設定到期時間。
- 輸入目前密碼;如果開啟了兩步驟驗證,還需 App 的驗證碼。單一登入帳號沒有本機密碼,必須在登入後的 10 分鐘內建立應用程式密碼。
- 每次為帳號建立應用程式密碼都會收到通知,幫助你發現非本人建立的密碼。
- 應用程式密碼只在建立後顯示一次,請立即複製。系統只保留密碼指紋,任何人都無法再次顯示原密碼。
- 清單顯示每個密碼的上次使用時間及來源位址。選擇移除後,使用它的工具會立即失效。
透過 Authorization 請求標頭傳送,或者將其作為 HTTP Basic 登入的密碼,與使用者名稱一起使用:
curl -H "Authorization: Bearer tfa_…" https://drive.example.com/api/auth/me
curl -u "amy:tfa_…" -o report.pdf "https://drive.example.com/api/files/<file id>/content?download=1"
API 的回應
- 錯誤以 JSON 回傳:
{"error": "…"},訊息為英文,有時另附給程式用的"code"(例如upload_discarded)。 - 狀態碼:
400無法照要求進行(名稱無效,或超過上限,例如 50 組應用程式密碼);401未登入,或應用程式密碼無效;403看得到項目,但不能對它這樣做;404不存在,或不是你看得到的(沒有存取權的項目一律回「找不到」,不透露它是否存在);409衝突(名稱已被使用、期間有變動);413超過上限或空間大小;429同時太多,請稍後再試;507伺服器磁碟空間不足。 - 清單:資料夾的項目以陣列回傳。加上
?limit=時改為分頁,回傳{"items": […], "next": "…"}:把next當作?after=取下一頁,直到沒有next。
應用程式密碼也能讓檔案在檔案總管、Finder 或相容的手機檔案 App 中顯示為磁碟機:參閱連線為網路磁碟機。
應用程式密碼僅用於檔案操作:瀏覽、搜尋、下載、上傳,以及整理檔案與資料夾。不能修改帳號密碼、建立應用程式密碼、關聯登入方式、建立分享連結或使用控制台,也不會取得 cookie。唯讀應用程式密碼會被拒絕執行任何更改操作。
語言
帳號選單中的語言決定 ThirtyFile 的顯示語言。選擇會隨帳號儲存,因此在其他電腦和手機登入後也會使用同一語言。尚未選擇時,使用管理員設定的預設語言或瀏覽器語言。登入頁和分享連結使用瀏覽器語言,或頁面底部清單中選擇的語言。
介面風格
帳號選單中的介面風格決定檔案瀏覽器的版面和按鍵行為。預設的自動按照目前電腦選擇:Mac 使用 Mac 風格,Windows、Linux 和 ChromeOS 使用 Windows 風格。手機和平板在兩種風格下使用相同版面。選擇隨帳號儲存。無論選擇哪種風格,修飾鍵始終跟隨電腦:Mac 使用 ⌘,其他系統使用 Ctrl。
- Windows 風格:類似檔案總管,包含位址列、資料夾樹和命令欄。參閱檔案操作。
- Mac 風格:類似 Mac 的 Finder,包含分組側欄、路徑欄、可在清單檢視原地展開的資料夾、快速查看和 Finder 快捷鍵(Enter 重新命名,⌘ + ↓ 開啟)。參閱Mac 風格。
兩種風格具備相同的檔案功能,取代或刪除項目前也會詢問同樣的確認問題。
登入紀錄
我的登入紀錄顯示成功登入、失敗嘗試、登出、修改密碼,以及應用程式密碼的建立、移除或使用錯誤密碼的紀錄,並列出對應位址和瀏覽器。
通知
右上角分頁旁的鈴鐺會通知以下情況:
- 與你分享:有人向你分享資料夾或檔案,或者將你加入空間(直接加入,或透過你所屬的群組)。給所有人的存取權限不會通知;已有權限的變動也不會通知。
- 空間即將用滿:你擁有或管理的空間已用滿 90%。包含個人空間,以及你是擁有者或管理者的團隊空間。只通知一次,直到空間恢復可用容量後再次接近用滿才重新通知。
- 存取權即將結束:別人給你的存取權限將在 3 天內到期。如果最初設定的期限不足 3 天,分享通知本身已說明期限。
- 透過連結收到檔案:有人透過你建立的收件連結上傳檔案。同一連結在一小時內持續收到的檔案合併為同一通知,只傳送一封郵件(即使只選擇電子郵件通知也一樣)。
- 新應用程式密碼:帳號建立了應用程式密碼,同時顯示建立時使用的位址。
- 新登入方式:Microsoft、Google、GitHub 或 OpenID Connect 單一登入帳號已關聯到你的帳號(參閱自行關聯帳號)。
鈴鐺上的數字表示未讀通知數。按一下通知可開啟對應項目。清單底部提供全部標示為已讀和清除全部。通知保留 90 天。
鈴鐺清單底部或帳號選單中的通知設定可以分別開啟或關閉每類應用程式內通知和電子郵件通知。郵件傳送到這裡填寫的電子郵件位址。使用單一登入時,首次會填入外部帳號提供的位址,之後可以修改。留空則不收郵件。密碼重設連結也寄到這個位址,因此修改位址需要目前密碼(兩步驟驗證帳號還需驗證碼;無密碼帳號需在登入後 10 分鐘內修改),原電子郵件信箱也會收到變更通知。同一位址每 15 分鐘最多收到五封同類郵件;應用程式內通知全部保留。