アプリをつなぐ

会社独自の Google アプリを使う

Google Cloud で会社用の Internal の Google アプリを 1 つ作り、Trina AX に 1 回追加すると、Google Drive、Gmail、カレンダー、ドキュメント、スプレッドシートのログインに会社名が表示され、警告も出なくなります。

Google Drive、Gmail、Google カレンダー、Google ドキュメント、Google スプレッドシートをつなぐとき、ふだんは Trina 自身の Google アプリを通して Google でログインします。Google Workspace を使う会社は、代わりに 会社独自の Google アプリ を使えます。IT 管理者が Google Cloud でアプリを 1 回作り、Trina AX に 1 回追加します。それ以降は 5 つの Google アプリすべてがそのアプリでログインし、Google の画面には会社名が表示されます。「未確認のアプリ」という警告は出ず、ログインできる人数の上限もありません。

所要時間は 15 分ほどです。大部分は Google Cloud での作業で、そのあと Trina AX でダイアログを 1 つ操作します。

ヒント

必要なもの

値入手先入れる場所
2 つの 戻り先アドレスTrina AX のダイアログの Google Cloud で の手順(それぞれに コピー があります)Google Cloud › Clients › あなたのクライアント › Authorized redirect URIs
権限(スコープ)の一覧このページのブロック(権限を追加する)Google Cloud › Data access › Manually add scopes
クライアントの JSON ファイル(または Client ID と Client secret)クライアントを作った直後の Google Cloud › Clients › Download JSONTrina AX のダイアログの ここに追加する の手順
注意

このページのスクリーンショットには、架空のチーム「Acme」を使っています。Google Cloud の画面はよく変わるので載せていません。代わりに Google の表示名を引用し、Google Cloud の各ページへのリンクを付けています。

#対象となる人

  • Google Workspace を使う会社(全員が name@acme.com のような会社のアドレスでログインする)。このページはあなた向けです。Trina AX でチームのオーナーまたは管理者であり、会社の Google Cloud でプロジェクトを作れる必要があります。
  • 個人の Gmail アカウントを使う人。 Trina のログインをそのまま使ってください。Internal のアプリは会社のアカウントしか受け付けません。

メンバーにとって変わることはほかにありません。同じページ、同じ 接続 ボタンです。切り替えたあと、Google を 1 回だけつなぎ直します。

ヒント

Google Workspace を使っていない小さなチームは、代わりに Testing 状態の External アプリを作れます。ログインできるのはテストユーザーとして登録した人だけ(最大 100 人)で、Google から 7 日ごとにログインし直すよう求められます。ほとんどのチームには、Trina のログインのほうが簡単です。

#Google Cloud で

会社のアカウントで Google Cloud にログインします。

  1. プロジェクトを作る

    New project を開きます。「acme-trina」など、わかりやすい名前を付け、Organization は会社のままにして Create を選びます。次の手順に進む前に、ページ上部で新しいプロジェクトが選ばれていることを確かめます。

  2. 5 つの API を有効にする

    下のページを 1 つずつ開き、Enable を選びます。

    今は一部の Google アプリしか使っていなくても、5 つすべてを有効にしてください。

  3. アプリに名前を付けて Internal にする

    Google Auth Platform を開きます。初回は Get started が表示されます。

    1. App Information:「Acme Trina」など、みんながわかる App name と、User support email を入力します。
    2. Audience:Internal を選びます。会社のアカウントだけがアプリを使え、Google の審査も不要です。
    3. Contact Information:このプロジェクトについて Google から連絡を受けるメールアドレスを入力します。
    4. Finish:Google のポリシーに同意して Create を選びます。

    これらはあとから Branding と Audience で変更できます。

  4. 権限を追加する

    Data access を開き、Add or remove scopes を選びます。Manually add scopes に下のブロックを丸ごと貼り付け、Add to table、Update、Save の順に選びます。

    openid
    https://www.googleapis.com/auth/userinfo.email
    https://www.googleapis.com/auth/userinfo.profile
    https://www.googleapis.com/auth/drive.readonly
    https://www.googleapis.com/auth/drive.file
    https://www.googleapis.com/auth/gmail.readonly
    https://www.googleapis.com/auth/gmail.send
    https://www.googleapis.com/auth/gmail.compose
    https://www.googleapis.com/auth/gmail.modify
    https://www.googleapis.com/auth/gmail.labels
    https://www.googleapis.com/auth/gmail.settings.basic
    https://www.googleapis.com/auth/calendar
    https://www.googleapis.com/auth/calendar.readonly
    https://www.googleapis.com/auth/calendar.events
    https://www.googleapis.com/auth/documents
    https://www.googleapis.com/auth/documents.readonly
    https://www.googleapis.com/auth/spreadsheets
    https://www.googleapis.com/auth/spreadsheets.readonly
    

    これは、Trina AX が 5 つのアプリ全体で求める権限そのものです。1 つも省かないでください。どれかが欠けたログインは拒否されます。

  5. ログイン用クライアントを作る

    Clients を開き、Create client を選びます。

    1. Application type:Web application。

    2. Name:「Trina AX」など、何でもかまいません。

    3. Authorized redirect URIs で Add URI を 2 回選び、2 つの戻り先アドレスを貼り付けます。アドレスは Trina AX からコピーします(次のパートのダイアログに、それぞれ コピー 付きで表示されます)。チームのアドレスが入った、次のような形です。

      https://<your team address>/api/integrations/google-drive/callback
      https://<your team address>/api/integrations/google-apps/callback
      
    4. Create を選びます。OAuth client created で Download JSON を選び、ファイルを保管します。シークレットが表示されるのはこのときだけです。なくした場合は、クライアントに新しいシークレットを作ります。

#Trina AX で

  1. Google のページを開く

    管理 › 連携サービス で、どれか 1 つの Google アプリ(たとえば Gmail)を選びます。5 つのページはどれも最後が チーム設定 で、その最初の行が Google ログイン です。「全員が Trina の Google アプリでログインします。代わりに会社独自の Google アプリを使うこともでき、ここにあるすべての Google アプリに適用されます。」

    チーム設定 › Google ログイン(Trina のアプリ)
  2. 会社のアプリを使うを押す

    会社の Google アプリを使う ダイアログが開きます。最初の手順 始める前に には、対象となる人と、このページへのリンクがあります。

    ダイアログの手順 1:始める前に
  3. Google Cloud で

    2 番目の手順には、上の Google Cloud での手順が各ページへのリンク付きで並び、チームの 2 つの戻り先アドレスがそれぞれ コピー 付きで表示されます。正確に入るよう、ここからコピーして Authorized redirect URIs に貼り付けます。

    ダイアログの手順 2:Google Cloud で
  4. ここに追加する

    Google からダウンロードしたファイルをドロップするか、選びます。手で入力したいときは、代わりに ID とシークレットを入力する を選ぶと クライアントID と クライアントシークレット の 2 つの欄が開きます。2 つの戻り先アドレスが両方とも入っていないファイルは拒否され、Google Cloud でどちらを追加すればよいかが表示されます。

    ダイアログの手順 3:ここに追加する
  5. 確認して保存する

    最後の手順 保存する前に には、何が変わるかがチームの数字とともに表示されます。Google をつなぎ直す必要がある人数と、チームで共有する Google アカウントやチームと共有した Drive は管理者がつなぎ直す必要があることです。保存 を選ぶまで何も変わりません。キャンセル を選ぶと、すべて元のままです。

    ダイアログの手順 4:保存する前に

保存 のあと、行には「全員が会社の Google アプリでログインします。Google ドライブ、Gmail、カレンダー、ドキュメント、スプレッドシートに適用されます。」と、設定した人と日時が表示されます。⋯ メニューには 置き換える(たとえば新しいシークレットを作ったあとに新しいファイルを追加する)と Trina の Google ログインに戻す があります。設定は 1 回だけです。この行は 5 つの Google のページすべてで同じです。

Google ログイン(会社のアプリ)

スマートフォンでは、スマートフォンの設定画面と同じように、⋯ は行の名前の横にあります。

スマートフォンでの Google ログイン

#メンバーに表示されるもの

Google はログインを、それを作ったアプリに結び付けます。そのため、切り替えると、Trina のアプリを通して作った Google への接続はすべて使えなくなります。

  • 各自 の 設定 › コネクター の Google アプリに、いつもの 再接続 が 1 回表示されます。そのあと Google の画面には会社のアプリの名前が表示され、警告は出ません。
  • チームで共有する Google アカウントとチームと共有した Drive は、それぞれの Google のページの チーム設定 に 再接続 が表示されます。管理者がつなぎ直すまで、AI はそれらを使えません。
つなぎ直しを求めるメンバーの Gmail のページ

#任意:管理コンソールでアプリを信頼する

会社が Google アカウントを使えるアプリを制限している場合は、Google Workspace の特権管理者がこのアプリを信頼済みにします。管理コンソール で Security › Access and data control › API controls を開き、Manage Third-Party App Access › Configure new app を選びます。クライアント ID(ダウンロードしたファイルに入っています)で検索して選び、Trusted に設定します。これをしないと、接続するときに admin_policy_enforced と表示されることがあります。

#Trina AX が保存するもの

  • アプリの ID とシークレットは、チームのサーバー上の非公開ファイル に保存され、サーバーだけが読めます。二度と表示されません。ページにも、ログにも、操作ログにも出ません。
  • ホスト型のチームでは Trina のホスティングサービスがそのサーバーを運用している ため、そのファイルも Trina のホスティングサービスが運用する場所にあります。シークレットだけでは何も開けません。各自が Google でログインし、そこで同意する必要があります。
  • 各自の Google ログインは、これまでどおりサーバーに暗号化して保存されます。

#Trina のログインに戻す

どれかの Google のページの チーム設定 › Google ログイン で ⋯ を開き、Trina の Google ログインに戻す を選びます。まず 保存する前に と同じ数字が表示されます。確定すると、5 つの Google アプリはすべて再び Trina のアプリを通してログインするようになり、各自が Google を 1 回つなぎ直します。会社のアプリのファイルはサーバーから削除されます。そのあと、Google Cloud でクライアントを削除してかまいません。

チームのアドレスが変わると、Google ログインの行にそのことが表示されます。Google Cloud のクライアントに新しい 2 つの戻り先アドレスを追加し、ファイルをもう一度ダウンロードしてから、Trina AX で ⋯ › 置き換える を開きます。ダイアログが Google Cloud で の手順で開き、コピーする新しいアドレスが表示されます。それまでは、誰も Google をつなげません。

#困ったとき

表示対処
Google のページに redirect_uri_mismatchGoogle Cloud の戻り先アドレスが抜けているか、1 文字違います。Clients を開いてクライアントを選び、ダイアログの Google Cloud で の手順から 2 つのアドレスを貼り直してください。保存が反映されるまで数分かかることがあります。
「一部の権限にチェックが入っていませんでした。もう一度接続し、すべての項目にチェックを入れたままにしてください。」Google の画面でチェックが外されたか、Data access に権限が足りません。上のブロックがすべて載っているか確かめ、すべての項目にチェックを入れたまま、もう一度接続してください。
admin_policy_enforced会社の管理コンソールがアプリをブロックしています。信頼済みにしてください(上記 を参照)。
会社の外のアカウント が拒否される(このアプリは組織内でしか使えないと Google に表示される)それが Internal の意味です。会社のアカウントを使ってください。チームで共有する Google アカウントも会社のアカウントである必要があります。

開発者と運用担当者向けの詳しい情報:Google apps(英語)、Google Drive(英語)。

Trina AX は AGPL-3.0-only のフリーソフトウェアです。アイコン:Lucide(ISC)。 このページを編集