Single Sign-On dengan Microsoft
Perlu Saldo Tunnel HTTP
Di halaman ini 6 bagian
Biarkan pengunjung masuk dengan akun kerja atau sekolah Microsoft Entra ID, atau akun Microsoft pribadi, sebelum mereka dapat membuka tunnel HTTP. Anda mendaftarkan aplikasi di Microsoft Entra, menambahkannya ke Localtonet sebagai penyedia, lalu mengaktifkannya untuk tunnel.
Sebelum memulai #
- Tunnel HTTP dan Saldo di akun Anda. Lihat ikhtisar Single Sign-On.
- Akses ke Microsoft Entra admin center dengan peran yang boleh mendaftarkan aplikasi. Microsoft menyebut Application Developer sebagai peran minimum.
- Keputusan tentang siapa yang boleh masuk: hanya organisasi Anda, organisasi mana pun, atau akun pribadi juga. Keputusan ini menentukan dua dari alamat yang Anda masukkan di Localtonet. Lihat Jenis akun dan endpoint.
Langkah-langkah #
-
Mendaftarkan aplikasi di Microsoft Entra #
Panduan resmi Microsoft adalah Register an app in Microsoft Entra ID, Add a redirect URI, dan Add app credentials. Singkatnya:
- Di Microsoft Entra admin center, buka Entra ID › App registrations dan pilih New registration.
- Masukkan Name. Pengunjung melihatnya saat masuk.
- Di bawah Supported account types, pilih siapa yang dapat menggunakan aplikasi, lalu pilih Register.
- Di halaman Overview, salin Application (client) ID. Untuk aplikasi single-tenant, salin juga Directory (tenant) ID.
- Di bawah Manage, buka Authentication, pilih Add Redirect URI, pilih platform Web, masukkan redirect URI di bawah, lalu pilih Configure.
- Buka Certificates & secrets › Client secrets dan pilih New client secret. Tambahkan deskripsi, pilih masa berlaku, lalu pilih Add. Segera salin Value secret tersebut: Microsoft tidak pernah menampilkannya lagi setelah Anda meninggalkan halaman.
Redirect URI (platform: Web)http://auth.localtonet.com/auth/callbackClient secret kedaluwarsa. Microsoft membatasi masa berlakunya hingga 24 bulan. Saat kedaluwarsa, proses masuk berhenti berfungsi sampai Anda membuat secret baru dan menyimpannya di penyedia Localtonet.
-
Menambahkan penyedia di Localtonet #
Buka Tunnel Saya › HTTP dan pilih SSO di bagian atas halaman. Di dialog Penyedia SSO, pilih Tambah penyedia.
Kolom Nilai Nama penyedia Nama apa pun, misalnya Company Microsoft. Anda melihatnya di pengaturan tunnel.Jenis penyedia Microsoft. Mengubah jenis penyedia yang tersimpan akan mengosongkan Client ID, jadi masukkan lagi client ID dan client secret. Aktif Aktif Client ID Application (client) ID dari Microsoft Entra. Client secret Value secret, bukan Secret ID. Tidak pernah ditampilkan setelah disimpan. Buka Endpoint & callback. Nilai-nilai ini terisi otomatis:
Kolom Nilai yang terisi Perlu diubah? Endpoint otorisasi https://login.microsoftonline.com/common/oauth2/v2.0/authorizeGanti commonsesuai tabel di bagian berikutnya.Endpoint token https://login.microsoftonline.com/common/oauth2/v2.0/tokenGanti commondengan nilai yang sama seperti di atas.Endpoint info pengguna https://graph.microsoft.com/oidc/userinfoTidak. Tidak mengandung tenant. Path callback /auth/callback/microsoftTidak. Jika perlu, isi Aturan akses email, lalu pilih Simpan penyedia.
-
Mengaktifkannya untuk tunnel #
Di bawah Tunnel Anda, pilih Pengaturan pada tunnel, lalu Kelola di samping Penyedia SSO. Di dialog Single sign-on, aktifkan Wajibkan login dan sakelar penyedia Microsoft Anda. Pilih Simpan.
Daftar di bawah Siapa yang dapat login dan Path login bersifat opsional. Keduanya dijelaskan di ikhtisar.
-
Mengujinya #
Buka URL tunnel di jendela browser pribadi. Localtonet menampilkan Sign in to continue dengan tombol untuk penyedia Anda. Setelah Anda masuk di Microsoft, Anda dikembalikan ke tunnel dan layanan Anda dimuat.
Jenis akun dan endpoint #
Bagian alamat Microsoft setelah login.microsoftonline.com/ mengatur siapa yang dapat masuk. Bagian ini harus sesuai dengan Supported account types aplikasi Anda. Endpoint otorisasi dan Endpoint token selalu mendapat nilai yang sama. Endpoint info pengguna tidak pernah berubah.
| Supported account types di Microsoft Entra | Gunakan sebagai pengganti common | Siapa yang dapat masuk |
|---|---|---|
| Single tenant only | Directory (tenant) ID Anda | Pengguna dan tamu dari tenant Anda sendiri. |
| Multiple Entra ID tenants | organizations | Akun kerja atau sekolah dari organisasi mana pun. |
| Any Entra ID Tenant + Personal Microsoft accounts | Biarkan common | Akun kerja atau sekolah dan akun Microsoft pribadi. |
| Personal accounts only | consumers | Akun Microsoft pribadi. |
Contoh untuk aplikasi single-tenant. Ganti <TENANT_ID> dengan Directory (tenant) ID Anda:
Authorization endpoint: https://login.microsoftonline.com/<TENANT_ID>/oauth2/v2.0/authorize
Token endpoint: https://login.microsoftonline.com/<TENANT_ID>/oauth2/v2.0/token
User info endpoint: https://graph.microsoft.com/oidc/userinfoAplikasi single-tenant tidak berfungsi dengan common. Microsoft menjawab dengan error AADSTS50194. Masukkan tenant ID Anda ke kedua endpoint, atau ubah aplikasi ke jenis akun multitenant.
Dengan jenis akun multitenant atau pribadi, orang di luar organisasi Anda dapat masuk di Microsoft. Gunakan Domain email yang diizinkan pada penyedia, atau Siapa yang dapat login pada tunnel, untuk hanya menerima orang yang Anda inginkan.
Yang dibaca Localtonet dari Microsoft #
Endpoint info pengguna Microsoft hanya mengembalikan alamat email jika ada yang terkait dengan akun, sehingga akun tanpa alamat email mungkin tidak lolos aturan yang bekerja berdasarkan email.
Pemecahan masalah #
AADSTS50011: reply URL tidak cocok
Redirect URI dalam permintaan tidak terdaftar untuk aplikasi. Pesan menampilkan alamat yang dikirim. Alamat itu harus identik dengan salah satu redirect URI di halaman Authentication pada app registration, pada platform Web, termasuk huruf besar dan kecil. Daftarkan persis http://auth.localtonet.com/auth/callback.
AADSTS50194: aplikasi tidak dikonfigurasi sebagai aplikasi multitenant
Aplikasi bersifat single tenant, tetapi endpoint-nya masih mengandung common. Ganti common dengan Directory (tenant) ID Anda di Endpoint otorisasi dan Endpoint token, lalu pilih Simpan penyedia.
AADSTS700016: aplikasi tidak ditemukan di direktori
Client ID salah, atau endpoint mengarah ke tenant tempat aplikasi tidak ada. Periksa Application (client) ID dan tenant ID di endpoint.
AADSTS7000215 atau AADSTS7000222: client secret tidak valid atau kedaluwarsa
Buat client secret baru di bawah Certificates & secrets, tempel Value-nya ke Client secret di Localtonet, lalu pilih Simpan penyedia.
Microsoft meminta persetujuan admin
Tenant Anda tidak mengizinkan pengguna menyetujui aplikasi sendiri. Administrator tenant harus memberikan persetujuan untuk aplikasi di Microsoft Entra admin center.
“403 - Access Denied” setelah berhasil masuk di Microsoft
Aturan Localtonet menolak akun tersebut. Periksa Aturan akses email pada penyedia dan Siapa yang dapat login pada tunnel, serta apakah akun memiliki alamat email sama sekali. Setelah memperbaiki aturan, tunggu semenit lalu muat ulang.