管理員指南:Ascripto 與 Google Workspace
上次更新:2026 年 11 月 9 日
寫給被要求允許某項存取的 Google Workspace 管理員或超級管理員,以及任何想評估 Ascripto 會接觸哪些內容的人。先說明機制,並使用 Google 自己的用語。
Ascripto 要求什麼,以及向誰要求
| 授權 | 由誰授予 | 在何處 | 允許的內容 |
|---|---|---|---|
| 登入 | 每一位使用 Ascripto 的人 | Google 的登入畫面 | openid、email、profile。身分以 Google 帳戶固定不變的主體識別碼(subject)與託管網域(hosted domain)為依據,絕不以電子郵件地址為依據 |
| 目錄,唯讀 | 一位 Google Workspace 管理員 | 從 Ascripto 前往的 OAuth 同意畫面(「歡迎使用 Ascripto」頁面或「設定」→「連線」) | admin.directory.user.readonly 與 admin.directory.domain.readonly:使用者及其姓名、職稱、部門、電話、機構單位與自訂屬性;組織已驗證的網域。不會讀取群組 |
| 簽名 | 一位超級管理員 | 管理控制台 →「安全性」→「存取權與資料控管」→「API 控制項」→「管理全網域委派設定」 | 授予 Ascripto 服務帳戶的 www.googleapis.com/auth/gmail.settings.basic,其用戶端 ID 顯示在頁面上。僅用於 users.settings.sendAs |
Ascripto 絕不會讀取、傳送或刪除郵件。Ascripto 對 Google 資料的使用受《Google API 服務使用者資料政策》(Google API Services User Data Policy)約束,包括其中的「有限使用」(Limited Use)規定;相關聲明載於隱私權政策:ascripto.com/zh-tw/privacy/。
為何採用全網域委派,而不是從 Marketplace 安裝
有兩個原因,而且即使 Marketplace 上架之後,這兩個原因仍然成立:
- 要讀取或寫入非呼叫者本人信箱的「選擇寄件地址」(send-as)簽名,只有具備全網域授權的服務帳戶用戶端才做得到。個別使用者的同意無法做到。
- Google 沒有提供
gmail.settings.basic的唯讀版本。稽核只會讀取,但此授權必然同時允許寫入。
Google 已於 2026 年 10 月 17 日驗證 Ascripto 的 OAuth 應用程式(品牌資訊與機密範圍),因此目錄授權的同意畫面不會顯示「未經驗證的應用程式」警告。簽名的委派項目仍須在管理控制台中手動建立,而範圍就是上表所列的那些。
頻率與機制
| 活動 | 頻率 | 機制 |
|---|---|---|
| 目錄變更 | 發生時即時處理:Google 會將每項變更通知 Ascripto,Ascripto 會在當下、一分鐘後與五分鐘後各讀取該人員一次 | Admin SDK Directory API users.watch,每種變更(新增、變更、刪除、還原)各一個頻道,每兩天更新一次,並以 channels.stop 停止;以 users.get 讀取該人員 |
| 目錄讀取 | 每小時一次;缺少通知頻道期間每 15 分鐘一次;以及按下「立即讀取」時 | Admin SDK Directory API users.list、domains.list |
| 稽核 | 每天一次,以及按下「重新檢查」時 | 每個人一次 sendAs.list;將主要地址的簽名與目錄資料比對 |
| 部署 | 在經過檢閱的部署時;之後對新進人員與有變更的資料自動進行 | 每個人一次 sendAs.patch,每秒約寫入二十次。系統會先讀取每個信箱,只有在內容不同時才寫入,除非勾選了「即使已是最新也重新寫入」 |
| 匯入 | 依要求進行 | 對所選的人員執行 sendAs.get;將值與此人的目錄資料比對 |
使用的是 sendAs.patch 而不是 sendAs.update,因此部署絕不會清除人員的顯示名稱、回覆地址或別名旗標。只會寫入新郵件簽名:Gmail API 沒有對應回覆和轉寄選項的欄位,因此簽名的回覆版本不會部署至 Gmail。
稽核比對的內容
針對每個人,將 Gmail 用於新郵件的簽名與目錄資料比對。問題:
| 問題 | 檢測方式 |
|---|---|
| 沒有簽名 | 簽名為空 |
| 缺少姓名 | 文字中沒有此人的姓名 |
| 缺少職稱 | 文字中沒有目錄中的職稱 |
| 缺少公司電話 | 文字中沒有目錄中的公司電話 |
| 沒有標誌 | 簽名中沒有標誌圖片 |
| 無法讀取 | Google 拒絕存取該信箱;另外計算,絕不算作符合或不符合品牌規範 |
以下項目不在檢查範圍內,數字旁邊也會如此說明:某人可能為回覆和轉寄另外選取的簽名(Gmail 將其存放在網頁版設定中,沒有任何 API 會揭露目前使用的是哪一個)、在 Gmail 應用程式內設定的「行動版簽名」(僅存在於裝置上,任何 API 都看不到)、字型、大小與顏色,以及某人在部署的內容之外自行加入的任何內容。
部署寫入的內容
為該人員轉譯出的 HTML(圖片託管在 img.ascripto.com 之下您工作區專屬的名稱,因為 Gmail 簽名是一段 HTML 字串,無法內嵌圖片),以及相對應的純文字。Gmail 會在網頁版與 Gmail 應用程式中套用。部署會略過在目錄中已停權的人員、地址不在組織網域內的人員,以及沒有任何簽名觸及的人員。
離職人員
從目錄中移除的人員會移至 Ascripto 的資源回收筒(預設為 7 天,可在「設定」→「連線」中設定為最長一年),並停止受管理。Ascripto 不會再寫入此人的信箱,也不會清除其中既有的簽名。已停權的使用者在停權期間不會被寫入。
雙重簽名
如果管理控制台中啟用了「附加註腳」(Append footer)(「應用程式」→「Google Workspace」→「Gmail」→「法規遵循」),Google 會將註腳加在每位使用者自己的簽名下方,包括 Ascripto 寫入的簽名。一旦由 Ascripto 負責帶入法律文字,請在設定了註腳的每個機構單位關閉註腳。
故障模式,以及產品回報的方式
| 發生的情況 | Ascripto 顯示的內容 | 修正方式 |
|---|---|---|
| 委派項目不存在或已被刪除 | 「Google 拒絕開啟信箱。簽名存取權可能已在您的管理控制台中撤銷。」稽核或部署會停止;計數會停留在當時的進度 | 重新加入用戶端 ID 與範圍。這是在權杖端點偵測到的(unauthorized_client),因此期間不會接觸任何信箱 |
| 目錄的同意已被撤銷,或給予同意的管理員失去了該角色 | 「設定」→「連線」:「連線已撤銷。請重新連線以再次讀取目錄。」 | 以目前的管理員身分「重新連線」 |
| Google 需要一段時間才會套用新的委派 | 「尚未允許」,並每 20 秒重新檢查一次 | 請稍候;依 Google 的說明最多需要 24 小時,通常只要幾分鐘 |
| 檢查或讀取在 Ascripto 這一端失敗 | 會如實說明,並重試 | 不需要處理 |
撤銷 Ascripto 的存取權
- 簽名:管理控制台 →「安全性」→「存取權與資料控管」→「API 控制項」→「管理全網域委派設定」→ Ascripto 用戶端 →「刪除」。稽核與部署會立即停止。
- 目錄:由給予同意的管理員在其 Google 帳戶 →「連結的應用程式」(myaccount.google.com/linkedapps)中移除 Ascripto(或在「設定」→「連線」中:Google 拒絕下一次讀取後,該連線會標示為已撤銷)。
- 已寫入的簽名會留在人員的 Gmail 中;Ascripto 絕不會清除這些簽名。
資料處理方式
- 儲存的資料:姓名、電子郵件地址,以及簽名使用的目錄欄位;管理員的覆寫值;簽名設計與版本;品牌圖片;稽核發現的問題;在付費方案中,還有哪些人於何時計入當月帳單。圖片會從
img.ascripto.com之下您工作區專屬的名稱公開提供,因為收件者的用戶端必須載入這些圖片。 - 不儲存的資料:郵件、主旨、標頭,以及使用完畢後的 Google 權杖。目錄存取憑證存放在 Azure Key Vault 中。
- 存放位置:Microsoft Azure,Germany West Central(法蘭克福)。交易型郵件(登入驗證碼、邀請)由 Ascripto 自己位於歐盟的郵件伺服器寄出。付款由 Stripe 處理。
- 保留期間:目錄欄位在該人員仍在目錄中的期間保留,再加上資源回收筒的期間;管理員操作的稽核記錄與過去的稽核執行結果保留 13 個月;簽名變更記錄 90 天;計費計數 70 天;伺服器記錄 30 天;組織的資料在合約結束後有 30 天的匯出期,並於其後 30 天內刪除。完整的表格載於隱私權政策;DPA(ascripto.com/zh-tw/dpa/)符合 GDPR 第 28 條,且無需另行簽署。
- 員工存取:Ascripto 員工不會瀏覽客戶資料。客服只能透過客服存取權查看組織的資料,這項存取權有時限、須附理由、留有記錄,而且組織看得到。每個員工帳戶都使用多重要素驗證。
- 瀏覽器安全性:應用程式絕不會在瀏覽器中持有存取權杖;由伺服器端元件將權杖存放在
httpOnlyCookie 中。
計費使用者
在 Google Workspace 上,計費使用者是指當月任何時間點其 Gmail 帶有您目前簽名的人,不論是因為部署寫入了該簽名,或是部署或稽核發現該簽名仍在。整個月都處於停權或已移除狀態的人不計入。當月至今的人數顯示在「設定」→「帳單」中。