管理者ガイド: Ascripto と Google Workspace
最終確認日: 2026年11月9日
何かを許可するよう依頼された Google Workspace の管理者または特権管理者と、Ascripto が何にアクセスするのかを評価する方のためのガイドです。まず仕組みを、Google 自身の用語で説明します。
Ascripto が求める権限と、その付与者
| 権限 | 付与者 | 場所 | 許可される内容 |
|---|---|---|---|
| ログイン | Ascripto を使う各ユーザー | Google のログイン | openid、email、profile。ID は、Google アカウントの不変の識別子 (subject) とホスト ドメインに基づき、メール アドレスには基づきません |
| ディレクトリ (読み取り専用) | 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 がメールを読み取ったり、送信したり、削除したりすることはありません。Google のデータの使用は、Google API サービスのユーザーデータに関するポリシー (Google API Services User Data Policy) と、その使用制限 (Limited Use) の要件に従います。この表明は、ascripto.com/ja/privacy/ のプライバシー ポリシーにあります。
Marketplace からのインストールではなくドメイン全体の委任を使う理由
理由は 2 つあり、どちらも Marketplace に掲載された後も変わりません:
- 呼び出し元以外のメールボックスのエイリアス (send-as) の署名を読み書きできるのは、ドメイン全体の権限を持つサービス アカウントのクライアントだけです。ユーザーごとの同意ではできません。
- Google には
gmail.settings.basicの読み取り専用版がありません。監査は読み取るだけですが、この権限では必然的に書き込みも許可されます。
Google は 2026年10月17日に Ascripto の OAuth アプリ (ブランディングと機密性の高いスコープ) を確認したため、ディレクトリの権限の同意画面に “未確認のアプリ” の警告は表示されません。署名用の委任のエントリは、引き続き管理コンソールで手作業で作成します。スコープは上の表のとおりです。
頻度と仕組み
| 処理 | 頻度 | 仕組み |
|---|---|---|
| ディレクトリの変更 | 発生のたび: Google が変更ごとに Ascripto に通知し、そのユーザーをその時点、1 分後、5 分後に読み取ります | Admin SDK Directory API の users.watch。変更の種類 (追加、変更、削除、復元) ごとに 1 つのチャネルを使い、2 日ごとに更新し、channels.stop で停止します。ユーザーの読み取りは users.get |
| ディレクトリの読み取り | 1 時間ごと。通知チャネルが欠けている間は 15 分ごと。[今すぐ読み取る] の操作時にも | Admin SDK Directory API の users.list、domains.list |
| 監査 | 1 日 1 回と、[再確認] の操作時 | ユーザーごとに sendAs.list。メインのアドレスの署名をディレクトリの登録内容と比較します |
| 配布 | 確認を経た配布の実行時。その後は、入社した人と変更された登録内容に対して自動的に | ユーザーごとに sendAs.patch、1 秒あたり約 20 件の書き込み。[最新の署名も書き換える] がオンでない限り、各メールボックスは最初に読み取られ、異なる場合にのみ書き込まれます |
| インポート | 要求時 | 選択したユーザーに sendAs.get。値をそのユーザーのディレクトリの登録内容と照合します |
sendAs.update ではなく sendAs.patch を使うため、配布によってユーザーの表示名、返信先、エイリアスのフラグが消去されることはありません。書き込まれるのは新規メールの署名だけです。Gmail API には返信・転送用の選択を表すフィールドがないため、署名の返信用のバージョンは Gmail には配布されません。
監査で比較する内容
ユーザーごとに、Gmail が新規メールに使う署名をディレクトリの登録内容と比較します。指摘事項は次のとおりです:
| 指摘事項 | 判定条件 |
|---|---|
| 署名なし | 署名が空である |
| 氏名なし | ユーザーの氏名が本文にない |
| 役職なし | ディレクトリの役職が本文にない |
| 勤務先電話番号なし | ディレクトリの勤務先電話番号が本文にない |
| ロゴなし | 署名にロゴ画像がない |
| 読み取り不可 | Google がメールボックスへのアクセスを拒否した。別に集計され、準拠にも非準拠にも含まれません |
確認の対象外で、数値の横にもその旨が表示されるもの: ユーザーが返信・転送用に選択できる別の署名 (Gmail は Web の設定に保持し、どれが使われているかを公開する API はありません)、Gmail アプリ内で設定された [モバイル署名] (デバイス内にのみ存在し、どの API からも見えません)、フォント、サイズ、色、そして配布した内容にユーザーが追加したもの。
配布で書き込む内容
そのユーザー向けにレンダリングした HTML と、それに対応するテキスト形式です。Gmail の署名は HTML 文字列で、画像を埋め込めないため、画像は img.ascripto.com の下の、ワークスペース専用の名前でホストされます。Gmail は Web と Gmail アプリでこの署名を適用します。配布では、ディレクトリで停止中のユーザー、アドレスが組織のドメイン外のユーザー、どの署名の対象にもならないユーザーをスキップします。
退職者
ディレクトリから削除されたユーザーは Ascripto のごみ箱に移動し (既定では 7 日間、[設定] > [接続] で 1 年まで設定可能)、管理の対象から外れます。Ascripto がそのメールボックスに書き込むことは二度となく、すでにある署名を消去することもありません。停止中のユーザーには、停止中は書き込みません。
署名の二重表示
管理コンソールでフッターを追加 (Append footer) が有効になっている場合 ([アプリ] > [Google Workspace] > [Gmail] > [コンプライアンス])、Google はすべてのユーザー自身の署名の下にフッターを追加します。Ascripto が書き込む署名も例外ではありません。法的な文言を Ascripto の署名に入れたら、フッターが設定されているすべての組織部門でフッターをオフにしてください。
障害時の動作と、製品での表示
| 発生した事象 | Ascripto の表示 | 対処 |
|---|---|---|
| 委任のエントリがない、または削除された | “Google がメールボックスを開くことを拒否しました。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 (フランクフルト)。トランザクション メール (ログイン用のコード、招待) は、EU 内にある Ascripto 自身のメール サーバーから送信されます。決済は Stripe が扱います。
- 保持期間: ディレクトリのフィールドは、ユーザーがディレクトリにいる間とごみ箱の期間。管理者の操作の監査記録と過去の監査の実行結果は 13 か月。署名の変更履歴は 90 日間。請求の集計は 70 日間。サーバー ログは 30 日間。組織のデータは、30 日間のエクスポート期間の後、契約終了から 30 日以内に削除されます。完全な表はプライバシー ポリシーにあります。ascripto.com/ja/dpa/ の DPA は GDPR 第 28 条に基づくもので、個別の締結手続きは不要です。
- スタッフのアクセス: Ascripto のスタッフが顧客のデータを閲覧することはありません。サポートが組織のデータを見られるのは、期限付きで、理由が記載され、記録され、組織から確認できるサポート アクセスを通じた場合だけです。すべてのスタッフ アカウントは多要素認証を使います。
- ブラウザーのセキュリティ: アプリがブラウザー内にアクセス トークンを保持することはありません。サーバー側のコンポーネントが
httpOnlyCookie に保持します。
課金対象のユーザー
Google Workspace での課金対象のユーザーとは、その月のいずれかの時点で、Gmail に現在の署名が入っていたユーザーです。配布で書き込まれた場合と、配布または監査でまだ入っていることが確認された場合が該当します。その月を通して停止中または削除済みだったユーザーは数えません。その月のこれまでの人数は [設定] > [お支払い] にあります。