Menghubungkan aplikasi

Memakai aplikasi Google milik perusahaan Anda

Buat satu aplikasi Google Internal untuk perusahaan Anda di Google Cloud dan tambahkan sekali ke Trina AX, agar Google Drive, Gmail, Calendar, Docs, dan Sheets masuk dengan nama perusahaan Anda dan tanpa peringatan.

Saat orang menghubungkan Google Drive, Gmail, Google Calendar, Google Docs, atau Google Sheets, mereka masuk di Google melalui aplikasi Google milik Trina. Perusahaan yang memakai Google Workspace bisa memakai aplikasi Google miliknya sendiri sebagai gantinya. Admin IT-nya membuat aplikasi itu sekali di Google Cloud dan menambahkannya sekali ke Trina AX. Sejak itu kelima aplikasi Google masuk dengan aplikasi tersebut, dan orang melihat nama perusahaan Anda di layar Google, tanpa peringatan "unverified app" dan tanpa batas jumlah orang yang bisa masuk.

Prosesnya sekitar 15 menit: sebagian besar di Google Cloud, lalu satu dialog di Trina AX.

Tips

Yang Anda perlukan

NilaiDari mana asalnyaKe mana perginya
Dua alamat kembaliDialog Trina AX, langkah Di Google Cloud, masing-masing dengan SalinGoogle Cloud › Clients › klien Anda › Authorized redirect URIs
Daftar izin (scope)Blok di halaman ini, Tambahkan izinGoogle Cloud › Data access › Manually add scopes
File JSON klien (atau Client ID dan Client secret)Google Cloud › Clients › Download JSON, tepat setelah Anda membuat klienDialog Trina AX, langkah Tambahkan di sini
Catatan

Tangkapan layar di halaman ini memakai tim rekaan, "Acme". Layar Google Cloud sendiri tidak ditampilkan karena sering berubah: halaman ini mengutip label Google dan menautkan ke setiap halaman Google Cloud sebagai gantinya.

#Untuk siapa

  • Perusahaan yang memakai Google Workspace (semua orang masuk dengan alamat perusahaan, seperti name@acme.com). Halaman ini untuk Anda. Anda harus menjadi owner tim atau admin di Trina AX, dan bisa membuat proyek di Google Cloud perusahaan Anda.
  • Orang dengan akun Gmail pribadi. Tetap pakai masuk milik Trina: aplikasi Internal hanya mengizinkan akun milik perusahaan Anda sendiri.

Bagi anggota tidak ada yang berubah: halamannya sama, tombol Hubungkan juga sama. Mereka menghubungkan Google lagi sekali, setelah Anda beralih.

Tips

Tim kecil tanpa Google Workspace bisa membuat aplikasi External dalam tahap Testing sebagai gantinya. Hanya orang yang Anda daftarkan sebagai pengguna uji yang bisa masuk (paling banyak 100), dan Google meminta mereka masuk lagi setiap 7 hari. Bagi sebagian besar tim, masuk milik Trina lebih sederhana.

#Di Google Cloud

Masuk ke Google Cloud dengan akun perusahaan Anda.

  1. Buat proyek

    Buka New project. Beri nama yang mudah Anda kenali, misalnya "acme-trina", biarkan perusahaan Anda di Organization, lalu pilih Create. Pastikan proyek baru itu terpilih di bagian atas halaman sebelum langkah berikutnya.

  2. Aktifkan lima API

    Buka setiap halaman di bawah dan pilih Enable:

    Aktifkan kelimanya, meskipun tim Anda saat ini baru memakai sebagian aplikasi Google.

  3. Beri nama aplikasi dan atur ke Internal

    Buka Google Auth Platform. Pertama kali, halaman ini menampilkan Get started:

    1. App Information: App name yang dikenali orang, misalnya "Acme Trina", dan User support email.
    2. Audience: pilih Internal. Hanya akun perusahaan Anda yang bisa memakai aplikasi ini, dan Google tidak perlu meninjaunya.
    3. Contact Information: alamat email yang bisa dihubungi Google tentang proyek ini.
    4. Finish: setujui kebijakan Google dan pilih Create.

    Nanti Anda bisa mengubahnya di Branding dan Audience.

  4. Tambahkan izin

    Buka Data access dan pilih Add or remove scopes. Di bawah Manually add scopes, tempel seluruh blok di bawah, pilih Add to table, lalu Update, lalu 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
    

    Inilah tepatnya izin yang diminta Trina AX, untuk kelima aplikasi sekaligus. Jangan ada yang terlewat: proses masuk tanpa salah satunya akan ditolak.

  5. Buat klien masuk

    Buka Clients dan pilih Create client.

    1. Application type: Web application.

    2. Name: apa saja, misalnya "Trina AX".

    3. Di bawah Authorized redirect URIs, pilih Add URI dua kali dan tempel kedua alamat kembali. Salin dari Trina AX (dialog di bagian berikutnya menampilkannya, masing-masing dengan Salin). Bentuknya seperti ini, dengan alamat tim Anda:

      https://<your team address>/api/integrations/google-drive/callback
      https://<your team address>/api/integrations/google-apps/callback
      
    4. Pilih Create. Di OAuth client created, pilih Download JSON dan simpan file itu. Google hanya menampilkan rahasianya saat ini; jika hilang, buat rahasia baru untuk klien itu.

#Di Trina AX

  1. Buka halaman Google

    Di Admin › Aplikasi terhubung, pilih salah satu aplikasi Google, misalnya Gmail. Kelima halaman diakhiri dengan Pengaturan tim, dan baris pertamanya adalah Masuk Google: "Semua orang masuk dengan aplikasi Google milik Trina. Perusahaan Anda bisa memakai aplikasi Google sendiri sebagai gantinya, untuk semua aplikasi Google di sini."

    Pengaturan tim › Masuk Google, dengan aplikasi milik Trina
  2. Tekan Pakai aplikasi perusahaan

    Dialog Pakai aplikasi Google perusahaan Anda terbuka. Langkah pertamanya, Sebelum mulai, menjelaskan untuk siapa fitur ini dan menautkan ke halaman ini.

    Dialog, langkah 1: Sebelum mulai
  3. Di Google Cloud

    Langkah kedua mencantumkan langkah-langkah Google Cloud di atas, dengan tautan ke setiap halaman, serta dua alamat kembali tim Anda, masing-masing dengan Salin. Salin dari sini ke Authorized redirect URIs, agar alamatnya persis benar.

    Dialog, langkah 2: Di Google Cloud
  4. Tambahkan di sini

    Letakkan file yang Anda unduh dari Google, atau pilih file itu. Jika Anda lebih suka mengetik, Masukkan ID dan rahasia sebagai gantinya membuka dua kolom untuk Client ID dan Client secret. File yang tidak mencantumkan kedua alamat kembali akan ditolak, dengan keterangan alamat mana yang perlu ditambahkan di Google Cloud.

    Dialog, langkah 3: Tambahkan di sini
  5. Periksa dan simpan

    Langkah terakhir, Sebelum menyimpan, menjelaskan apa yang berubah, dengan angka tim Anda: berapa orang yang perlu menghubungkan Google lagi, dan bahwa akun Google bersama serta Drive yang dibagikan dengan tim perlu dihubungkan ulang oleh admin. Tidak ada yang berubah sampai Anda memilih Simpan. Batal membiarkan semuanya seperti semula.

    Dialog, langkah 4: Sebelum menyimpan

Setelah Simpan, barisnya menampilkan "Semua orang masuk dengan aplikasi Google perusahaan Anda, untuk Google Drive, Gmail, Calendar, Docs, dan Sheets." beserta siapa yang mengaturnya dan kapan. Menu ⋯-nya berisi Ganti (untuk menambahkan file baru, misalnya setelah rahasia baru) dan Pakai lagi masuk Google milik Trina. Anda cukup mengaturnya sekali: barisnya sama di kelima halaman Google.

Masuk Google, dengan aplikasi perusahaan Anda

Di ponsel, ⋯ tetap berada di samping nama baris, seperti di pengaturan ponsel.

Masuk Google di ponsel

#Yang dilihat anggota

Setiap koneksi ke Google yang dibuat lewat aplikasi Trina berhenti berfungsi saat Anda beralih, karena Google mengikat proses masuk ke aplikasi yang membuatnya.

  • Setiap orang melihat Hubungkan kembali seperti biasa pada aplikasi Google mereka di Pengaturan › Konektor, sekali saja. Google lalu menampilkan nama aplikasi perusahaan Anda, tanpa peringatan.
  • Akun Google bersama dan Drive yang dibagikan dengan tim menampilkan Hubungkan kembali di bawah Pengaturan tim pada halaman Google-nya. Admin yang menghubungkannya ulang; sampai saat itu AI tidak bisa memakainya.
Halaman Gmail anggota, meminta dihubungkan lagi

#Opsional: memercayai aplikasi di Admin console

Jika perusahaan Anda membatasi aplikasi mana yang boleh memakai akun Google, super admin Google Workspace menandai aplikasi ini sebagai tepercaya. Di Admin console, buka Security › Access and data control › API controls, lalu Manage Third-Party App Access › Configure new app. Cari client ID-nya (ada di file yang diunduh), pilih, lalu atur ke Trusted. Tanpa ini, orang mungkin melihat admin_policy_enforced saat menghubungkan.

#Yang disimpan Trina AX

  • ID dan rahasia aplikasi disimpan di file privat di server tim Anda, yang hanya bisa dibaca oleh server. Keduanya tidak pernah ditampilkan lagi: tidak di halaman, tidak di log, tidak di log aktivitas.
  • Di tim yang di-hosting, layanan hosting Trina yang menjalankan server itu, jadi layanan itu berjalan di tempat file tersebut berada. Rahasia itu saja tidak membuka apa pun: setiap orang tetap masuk di Google dan memberi persetujuan di sana.
  • Data masuk Google milik setiap orang tetap disimpan tersegel di server, seperti sebelumnya.

#Kembali ke masuk milik Trina

Di halaman Google mana pun, di Pengaturan tim › Masuk Google, buka ⋯ dan pilih Pakai lagi masuk Google milik Trina. Pertama-tama ditampilkan angka yang sama seperti di Sebelum menyimpan. Setelah Anda mengonfirmasi, kelima aplikasi Google kembali masuk lewat aplikasi Trina, orang menghubungkan Google lagi sekali, dan file aplikasi perusahaan dihapus dari server. Setelah itu Anda bisa menghapus klien di Google Cloud.

Jika alamat tim Anda berubah, baris Masuk Google akan memberi tahu. Tambahkan dua alamat kembali yang baru ke klien di Google Cloud, unduh lagi filenya, lalu buka ⋯ › Ganti di Trina AX: dialog terbuka di Di Google Cloud dengan alamat baru untuk disalin. Sampai saat itu, tidak ada yang bisa menghubungkan Google.

#Masalah

Yang Anda lihatYang perlu dilakukan
redirect_uri_mismatch di halaman GoogleAda alamat kembali di Google Cloud yang hilang atau berbeda satu huruf. Buka Clients, pilih klien Anda, lalu tempel lagi kedua alamat dari langkah Di Google Cloud di dialog. Perubahan yang disimpan bisa butuh beberapa menit untuk berlaku.
"Beberapa izin tidak dicentang. Hubungkan lagi dan biarkan semua kotak tetap dicentang."Orang itu menghapus centang sebuah kotak di layar Google, atau ada izin yang tidak ada di Data access. Pastikan seluruh blok di atas tercantum di sana, lalu hubungkan lagi dengan semua kotak dicentang.
admin_policy_enforcedAdmin console perusahaan Anda memblokir aplikasi ini. Tandai sebagai tepercaya (lihat di atas).
Akun dari luar perusahaan ditolak (Google mengatakan aplikasi hanya bisa dipakai di dalam organisasinya)Itulah arti Internal. Pakai akun perusahaan Anda. Akun Google bersama juga harus akun perusahaan.

Detail lengkap untuk pengembang dan operator: Google apps (bahasa Inggris) dan Google Drive (bahasa Inggris).

Trina AX adalah perangkat lunak bebas dengan lisensi AGPL-3.0-only. Ikon: Lucide (ISC). Edit halaman ini