Masaüstü istemcisini hesabınızla eşleştirme

Genel bakış

Whisperer macOS istemcisinin oturumlarınızla, aboneliğinizle ve bilgi tabanınızla çalışabilmesi için onu hesabınızla bir kez eşleştirmeniz gerekir. Uygulamayı yalnızca kurmak erişim sağlamaz — cihazın yetkilendirilmesi gerekir (cihaz kimlik doğrulaması).

Eşleştirme, güvenli bir tek kullanımlık kod akışı üzerine kurulmuştur: uygulama oturum açmayı başlatır, tarayıcıda kimlik doğrulaması yaparsınız, tek kullanımlık bir kod alırsınız ve tarayıcı sizi uygulamaya geri döndürür. Kod tek kullanımlıktır ve 30 dakika geçerlidir.

Ne zaman kullanılır

  • İstemciyi kurduktan ve izin sihirbazını tamamladıktan hemen sonra.
  • Yeni veya yeniden kurulmuş bir bilgisayarda oturum açarken.
  • Uygulama hesabınızı görmeyi bıraktığında (tüm cihazlarda oturumu kapattınız, parolanızı değiştirdiniz vb.) ve yeniden eşleştirilmesi gerektiğinde.

Adım adım

  1. Uygulamada oturum açmayı başlatın. Mac'inizde Whisperer'ı açın ve oturum açmayı/eşleştirmeyi başlatın. Uygulama, sunucudan tek kullanımlık bir kod ister (POST /v1/auth/desktop/code) ve tarayıcınızda eşleştirme web sayfasını açar — /app/connect.
  2. Tarayıcıda hesabınıza oturum açın. /app/connect sayfasında e-postanız ve parolanızla oturum açın. Henüz bir hesabınız yoksa — kaydolun ve e-postanızı onaylayın (bkz. Kayıt ve oturum açma). E-postanız onaylanana kadar oturum açmak mümkün değildir.
  3. Cihaz eşleştirmesini onaylayın. Oturum açtıktan sonra web paneli, tek kullanımlık kodu hesabınıza bağlar.
  4. Uygulamaya dönün. Tarayıcı, whisperer://auth?code=...&state=... şeması aracılığıyla sizi otomatik olarak Whisperer'a geri yönlendirir. "Whisperer'da açılsın mı?" şeklinde bir sistem istemi belirirse — onaylayın.
  5. Kod-token değişimini bekleyin. Uygulama, tek kullanımlık kodu erişim token'larıyla değiştirir ve bunları güvenli depolama alanında (şifrelenmiş olarak) saklar. Bundan sonra istemci hesabınızla eşleştirilmiş olur.
  6. Doğrulayın. Uygulamanın hesabınızı ve planınızı gösterdiğinden emin olun. Artık oturumları başlatabilirsiniz.

Ekran görüntüleri

📸 [Ekran görüntüsü: macOS istemcisinde oturum açma başlatma ekranı]

📸 [Ekran görüntüsü: oturum açma formuyla /app/connect web sayfası]

📸 [Ekran görüntüsü: "Whisperer'da açılsın mı?" macOS sistem istemi (whisperer:// şeması)]

Sık yapılan hatalar

  • Kodun süresi doldu. Tek kullanımlık kod 30 dakika geçerlidir. Daha uzun sürdüyse veya araya bir kesinti girdiyse eşleştirme tamamlanmaz. Çözüm: uygulamaya dönün ve oturum açmayı yeniden başlatın — yeni bir kod düzenlenecektir.
  • Tarayıcı uygulamaya dönmedi. whisperer:// şema yönlendirmesi otomatik olarak çalışmadıysa, Whisperer'ın "Uygulamalar" klasöründe kurulu olduğundan emin olun ve oturum açmayı tekrarlayın. Uygulamayı açmak için bir sistem istemi belirdiğinde — onaylayın.
  • Oturum açma başarısız — e-posta onaylanmadı. E-postanız 6 haneli kodla onaylanana kadar oturum açamazsınız. E-postanızı onaylayın ve tekrar deneyin.
  • Birden fazla /app/connect sekmesi. Aynı anda birkaç eşleştirme sayfası açmak akışı bozar. Fazlalıkları kapatın ve eşleştirmeyi uygulamadan yeniden çalıştırın.
  • Hesap donduruldu veya yasaklandı. Hesap durumu frozen/banned ise eşleştirme tamamlanmaz — destek ekibiyle iletişime geçin.

En iyi uygulamalar

  • Eşleştirmeyi kurulumdan hemen sonra, gecikmeden çalıştırın — böylece kodun 30 dakikalık TTL süresine rahatça sığarsınız.
  • /app/connect sayfasını yalnızca tek bir sekmede açık tutun.
  • Parolanızı değiştirdiyseniz veya tüm cihazlarda oturumu kapattıysanız, istemciyi yeniden eşleştirin — eski token'lar geçersiz kılınır (token_version).
  • Tek kullanımlık kodu elle iletmeyin ve whisperer://auth?... bağlantısını paylaşmayın — bu, cihazınıza özel bir gizli bilgidir.

İlgili makaleler