Herkese Açık Paylaşım
Atlas, dashboard'larını token tabanlı public link ile dışarı açma desteği sunar. Public link'e sahip herkes — Pirivision hesabı olmadan — dashboard'u görüntüleyebilir. Müşterilere paylaşılan KPI raporları, halka açık operasyon ekranları ve dış paydaşlara dashboard sunumu için kullanılır.
Ön Koşul
Public link üretilecek bir Atlas dashboard'u oluşturulmuş olmalıdır. Sadece sahip olduğunuz dashboard'lar için public link açılabilir.
Güvenlik Uyarısı
Public link, token'a sahip herkesin dashboard'u görmesini sağlar. Token URL'nin kendisidir — kim ele geçirirse erişebilir. Hassas veri içeren dashboard'larda public link kullanmayın veya kullandıysanız link'i düzenli olarak rotate edin.
1. Share Diyaloğunu Açın
Atlas liste ekranında dashboard kartı üzerindeki More (üç nokta) menüsünden Share seçeneğine basın.
Dialog iki bölümden oluşur:
- Sol panel: Username bazlı kullanıcı paylaşımı → Kullanıcı Paylaşımı
- Sağ panel: Public link yönetimi (bu sayfa)
2. Public Link Oluşturma
Sağ panelde Generate Public Link butonuna tıklayın. Backend create_public_link API tipini çağırır ve benzersiz bir token üretir.
Token üretildikten sonra link şu formatta görünür:
| Eylem | Davranış |
|---|---|
| Copy Link | Link clipboard'a kopyalanır |
| Open in New Tab | Yeni sekmede public görüntüleyici açılır |
| Revoke | Link iptal edilir; token artık çalışmaz |
3. Public Görüntüleyici Davranışı
Public link açıldığında:
| Davranış |
|---|
| Login ekranı görünmez; doğrudan dashboard yüklenir |
Backend bypassAuthMiddleware: true ile token doğrular |
isPublicMode = true set edilir; UI üst bar gizlenir veya minimal görünür |
canModify = false — edit mode, save, share, delete butonları yok |
| Kullanıcı global filtreyi değiştirebilir (oturum bazlı) |
| Refresh interval Cartography ayarına göre çalışır |
core-service çağrılarında public token bilgisi taşınır |
Public Mode Endpoint
Public görüntüleyici, dashboard layout'unu özel bir endpoint'ten alır:
Bu endpoint auth middleware tarafından bypass edilir.
4. Birden Fazla Public Link
Bir dashboard için birden fazla public link üretebilirsiniz. Tipik kullanım:
| Senaryo | Yaklaşım |
|---|---|
| Müşteri A için ayrı link, müşteri B için ayrı link | İki ayrı token oluşturup ayrı paylaş |
| Süresi dolan eski linki devre dışı bırakma | Yeni token üret, eskiyi revoke et |
| Geçici demo linki | Demo sonrası revoke |
Tüm aktif link'ler share dialog'unun sağ panelinde listelenir.
5. Link Revoke
Aktif link'in yanındaki Revoke butonuna basın. Token backend'den silinir; o link'i kullanan tarayıcılar 403 Forbidden alır.
Anlık Revoke
Revoke sonrası o linki açık tutan kullanıcılar sayfayı yenilediklerinde erişimi kaybeder. Sayfa açık kaldığı sürece görüntülemeye devam edebilirler (cached data).
6. Token Güvenliği
| Risk | Önlem |
|---|---|
| Token URL log'larında kalır (proxy, browser history, ekran görüntüsü) | Hassas dashboard'larda public link kullanmayın |
| Token sosyal mühendislik ile paylaşılabilir | Müşteri başına ayrı link üretip suistimal halinde sadece o linki revoke edin |
| Tarayıcı cache | Logout'tan sonra dashboard görünmeye devam edebilir |
7. Audit / Log
Public link erişimleri backend log'larına düşer (IP, timestamp). Hangi linkin ne kadar kullanıldığını sorgulamak için backend log'larına bakılır; UI'da görünmez.
8. Sık Karşılaşılan Hatalar
| Belirti | Olası Neden | Çözüm |
|---|---|---|
| Generate Public Link pasif | Sahip değilsiniz | Yetkili kullanıcıdan oluşturmasını isteyin |
| Public link açılınca 403 | Token revoke edilmiş veya yanlış | Yeni link üretin |
| Public mode'da widget'lar yüklemiyor | Compass sorgusu auth gerektiriyor | Sorgunun datasource yetkisini kontrol edin |
| Link kopyalanmıyor | Tarayıcı clipboard izni reddi | Manuel kopyalayın (Ctrl+C) |