Dokümantasyon

KULLANIM REHBERI

← Geri

SeedPass Kullanım Rehberi

📋 İçindekiler

  1. Web Uygulaması Kurulumu
  2. Windows Uygulaması Kurulumu
  3. Chrome Extension Kurulumu
  4. İlk Kullanım
  5. Şifre Ekleme
  6. Chrome'dan Şifre İçe Aktarma
  7. Token Alma ve Kullanma
  8. Chrome Extension ile Şifre Kullanma
  9. Windows Uygulaması ile Şifre Görüntüleme

🌐 Web Uygulaması Kurulumu

Adım 1: Sunucu Hazırlığı

  1. Windows Server veya Windows 10/11 makinesinde çalıştırın
  2. .NET 8.0 Runtime veya .NET 8.0 SDK kurulu olmalı
  3. İndirme: .NET 8.0 Runtime

Adım 2: IIS Kurulumu (Opsiyonel)

Eğer IIS kullanmak istiyorsanız:

  1. Server Manager > Add Roles and Features
  2. Web Server (IIS) seçin
  3. .NET Core Hosting Bundle kurun: İndir

Adım 3: Uygulamayı Çalıştırma

Seçenek 1: Kestrel ile (Basit)

  1. C:\Publish\SeedPass\UI.Web klasörüne gidin
  2. Komut satırını açın: 
    cd C:\Publish\SeedPass\UI.Web
UI.Web.exe
  3. Uygulama http://localhost:5000 adresinde çalışacak

Seçenek 2: IIS ile (Production)

  1. IIS Manager'ı açın
  2. Application Pools > Add Application Pool
    • Name: SeedPassAppPool
    • .NET CLR Version: No Managed Code
  3. Sites > Add Website
    • Site name: SeedPass
    • Application pool: SeedPassAppPool
    • Physical path: C:\Publish\SeedPass\UI.Web
    • Binding: https port 443, hostname seedpass.seed.tr

Adım 4: Veritabanı Migration

  1. Komut satırını açın: 
    cd C:\Publish\SeedPass\UI.Web
dotnet ef database update --project "D:\Seed Bt\Sources\Cursor\SeedPass\Library\Infrastructure\Library.Infrastructure.csproj" --startup-project "C:\Publish\SeedPass\UI.Web\UI.Web.csproj"

Not: Eğer dotnet ef komutu bulunamazsa:

dotnet tool install --global dotnet-ef

Adım 5: Google Cloud Console Ayarları

  1. Google Cloud Console'a gidin
  2. API'ler ve Hizmetler > Kimlik Bilgileri
  3. OAuth 2.0 Client ID'nizi düzenleyin
  4. Authorized JavaScript origins: https://seedpass.seed.tr
  5. Authorized redirect URIs: https://seedpass.seed.tr/signin-google

Adım 6: DNS Ayarları

  1. DNS kaydınızı oluşturun:
    • Type: A
    • Name: seedpass.seed.tr
    • Value: Sunucunuzun IP adresi

Adım 7: SSL Sertifikası

  1. Let's Encrypt kullanarak ücretsiz SSL sertifikası alın
  2. Veya mevcut SSL sertifikanızı kullanın
  3. IIS'te SSL sertifikasını yapılandırın

🖥️ Windows Uygulaması Kurulumu

Adım 1: Gereksinimler

  • Windows 10/11 veya Windows Server 2016+
  • .NET 8.0 Runtime kurulu olmalı

Adım 2: Kurulum

  1. C:\Publish\SeedPass\UI.Windows klasörünü kullanıcıların erişebileceği bir yere kopyalayın
  2. UI.Windows.exe dosyasını çalıştırın

Adım 3: Kısayol Oluşturma

  1. UI.Windows.exe dosyasına sağ tıklayın
  2. Send to > Desktop (create shortcut)
  3. Kısayolu istediğiniz gibi adlandırın

🌐 Chrome Extension Kurulumu

Adım 1: Extension Dosyalarını Yükleme

  1. Chrome'da chrome://extensions/ adresine gidin
  2. Sağ üstte Developer mode'u açın
  3. Load unpacked butonuna tıklayın
  4. C:\Publish\SeedPass\ChromeExtension klasörünü seçin

Adım 2: Extension'ı Test Etme

  1. Extension icon'una tıklayın
  2. Extension popup'ının açıldığını kontrol edin

🚀 İlk Kullanım

Adım 1: Web Uygulamasına Giriş

  1. https://seedpass.seed.tr adresine gidin
  2. Google ile Giriş Yap butonuna tıklayın
  3. Google hesabınızla giriş yapın
  4. İlk girişte kullanıcı hesabınız otomatik oluşturulacak

Adım 2: Token Alma

  1. Ana sayfada sağ üstte Token Al butonuna tıklayın
  2. Açılan modalda token görünecek
  3. Kopyala butonuna tıklayarak token'ı kopyalayın
  4. Token'ı güvenli bir yerde saklayın

Adım 3: Chrome Extension Ayarlama

  1. Chrome Extension'ı açın (toolbar'daki icon'a tıklayın)
  2. API URL alanına: https://seedpass.seed.tr yazın
  3. Token alanına kopyaladığınız token'ı yapıştırın
  4. Token Kaydet butonuna tıklayın
  5. "Token kaydedildi!" mesajını göreceksiniz

Adım 4: Windows Uygulaması Ayarlama

  1. Windows uygulamasını açın
  2. Ayarlar butonuna tıklayın (sağ üstte)
  3. API URL alanına: https://seedpass.seed.tr yazın
  4. Token alanına kopyaladığınız token'ı yapıştırın
  5. Kaydet butonuna tıklayın
  6. Ayarlar penceresini kapatın

🔑 Şifre Ekleme

Adım 1: Web Uygulamasında Şifre Ekleme

  1. https://seedpass.seed.tr adresine gidin
  2. Ana sayfada Yeni Şifre Ekle butonuna tıklayın
  3. Formu doldurun:
    • Başlık: Şifrenin başlığı (örn: "Gmail Hesabı")
    • URL: Web sitesinin URL'i (örn: "https://gmail.com")
    • Kullanıcı Adı: Kullanıcı adı (örn: "[email protected]")
    • Şifre: Şifre (otomatik şifre oluşturmak için Şifre Oluştur butonuna tıklayın)
    • Notlar: Opsiyonel notlar
  4. Kaydet butonuna tıklayın
  5. Şifre şifrelenmiş şekilde veritabanına kaydedilecek

Adım 2: Şifre Oluşturma

  1. Yeni Şifre Ekle formunda Şifre alanının yanında Şifre Oluştur butonuna tıklayın
  2. Otomatik olarak güvenli bir şifre oluşturulacak
  3. Şifreyi kopyalayıp kullanabilirsiniz

📥 Chrome'dan Şifre İçe Aktarma

Adım 1: Chrome'dan Şifreleri Dışa Aktarma

  1. Chrome'da chrome://settings/passwords adresine gidin
  2. Export passwords butonuna tıklayın
  3. Chrome şifrenizi girin
  4. CSV dosyasını kaydedin (örn: chrome-passwords.csv)

Adım 2: Web Uygulamasına İçe Aktarma

  1. https://seedpass.seed.tr adresine gidin
  2. Ana sayfada Chrome'dan İçe Aktar butonuna tıklayın
  3. Açılan modalda Dosya Seç butonuna tıklayın
  4. Chrome'dan indirdiğiniz CSV dosyasını seçin
  5. İçe Aktar butonuna tıklayın
  6. İçe aktarma işlemi tamamlandığında başarı mesajı göreceksiniz
  7. Tüm şifreleriniz listede görünecek

🔐 Token Alma ve Kullanma

Token Nedir?

Token, Chrome Extension ve Windows uygulamasının API'ye erişmek için kullandığı kimlik doğrulama anahtarıdır.

Token Nasıl Alınır?

  1. Web uygulamasına giriş yapın
  2. Ana sayfada Token Al butonuna tıklayın
  3. Açılan modalda token görünecek
  4. Kopyala butonuna tıklayarak token'ı kopyalayın

Token Nasıl Kullanılır?

Chrome Extension

  1. Chrome Extension'ı açın
  2. API URL: https://seedpass.seed.tr
  3. Token: Kopyaladığınız token'ı yapıştırın
  4. Token Kaydet butonuna tıklayın

Windows Uygulaması

  1. Windows uygulamasını açın
  2. Ayarlar butonuna tıklayın
  3. API URL: https://seedpass.seed.tr
  4. Token: Kopyaladığınız token'ı yapıştırın
  5. Kaydet butonuna tıklayın

Token Güvenliği

  • ✅ Token'ı kimseyle paylaşmayın
  • ✅ Token'ı güvenli bir yerde saklayın
  • ✅ Token'ı düzenli olarak yenileyin
  • ✅ Token'ı başka bir cihazda kullanmak isterseniz, web uygulamasından yeni bir token alın

🎯 Chrome Extension ile Şifre Kullanma

Adım 1: Şifreyi Yapıştırma

  1. Herhangi bir web sitesinde şifre girmeniz gereken alana gidin
  2. Sayfada sağ tıklayın
  3. SeedPass menüsünü seçin
  4. Şifreyi Yapıştır seçeneğini tıklayın
  5. Birden fazla şifre varsa, birini seçin
  6. Şifre otomatik olarak yapıştırılacak

Adım 2: Şifre Oluşturma

  1. Herhangi bir web sitesinde şifre oluşturmanız gereken alana gidin
  2. Sayfada sağ tıklayın
  3. SeedPass menüsünü seçin
  4. Şifre Oluştur seçeneğini tıklayın
  5. Otomatik olarak güvenli bir şifre oluşturulacak ve yapıştırılacak
  6. Şifreyi web uygulamasına kaydedebilirsiniz

Adım 3: Birden Fazla Şifre Varsa

  1. Şifreyi Yapıştır seçeneğini tıklayın
  2. Açılan popup'ta kayıtlı şifreleriniz listelenecek
  3. İstediğiniz şifreyi seçin
  4. Şifre otomatik olarak yapıştırılacak

🖥️ Windows Uygulaması ile Şifre Görüntüleme

Adım 1: Şifreleri Görüntüleme

  1. Windows uygulamasını açın
  2. Tüm şifreleriniz listede görünecek
  3. Her şifre için şu bilgiler görüntülenir:
    • Başlık: Şifrenin başlığı
    • URL: Web sitesinin URL'i
    • Kullanıcı Adı: Kullanıcı adı
    • Şifre: Şifre (görüntülemek için tıklayın)

Adım 2: Şifre Düzenleme

  1. Listeden düzenlemek istediğiniz şifreyi seçin
  2. Düzenle butonuna tıklayın
  3. Formu düzenleyin
  4. Kaydet butonuna tıklayın

Adım 3: Şifre Silme

  1. Listeden silmek istediğiniz şifreyi seçin
  2. Sil butonuna tıklayın
  3. Onay mesajını onaylayın
  4. Şifre silinecek

Adım 4: Ayarları Değiştirme

  1. Ayarlar butonuna tıklayın
  2. API URL ve Token bilgilerini güncelleyin
  3. Kaydet butonuna tıklayın

🔒 Güvenlik Notları

  1. Token Güvenliği: Token'ı kimseyle paylaşmayın
  2. SSL Sertifikası: HTTPS kullanın
  3. Şifre Güvenliği: Şifreleriniz şifrelenmiş şekilde saklanır
  4. Güncellemeler: Düzenli olarak güncelleyin
  5. Yedekleme: Veritabanını düzenli olarak yedekleyin

🐛 Sorun Giderme

Web Uygulaması Çalışmıyor

  1. .NET 8.0 Runtime'ın kurulu olduğundan emin olun
  2. appsettings.json dosyasını kontrol edin
  3. Veritabanı bağlantısını kontrol edin
  4. IIS Logs'u kontrol edin: C:\inetpub\logs\LogFiles

Token Çalışmıyor

  1. Token'ın doğru kopyalandığından emin olun
  2. API URL'in doğru olduğundan emin olun: https://seedpass.seed.tr
  3. Web uygulamasından yeni bir token alın
  4. Chrome Extension veya Windows uygulamasında token'ı yenileyin

Veritabanı Bağlantısı Hatası

  1. Connection String'in doğru olduğundan emin olun
  2. SQL Server'ın erişilebilir olduğundan emin olun
  3. Firewall'da SQL Server portunun açık olduğundan emin olun

Google Authentication Hatası

  1. Google Cloud Console'da redirect URI'lerin doğru olduğundan emin olun
  2. ClientId ve ClientSecret'ın doğru olduğundan emin olun
  3. appsettings.json dosyasını kontrol edin

📞 Destek

Sorun yaşarsanız:

  1. Logs'ları kontrol edin
  2. Event Viewer'ı kontrol edin
  3. Google Cloud Console'u kontrol edin
  4. DNS ayarlarını kontrol edin

📚 Ek Kaynaklar

✅ Hızlı Başlangıç Checklist

  • [ ] .NET 8.0 Runtime kurulu
  • [ ] Web uygulaması çalışıyor
  • [ ] Veritabanı migration'ı yapıldı
  • [ ] Google Cloud Console ayarları yapıldı
  • [ ] DNS ayarları yapıldı
  • [ ] SSL sertifikası kuruldu
  • [ ] Web uygulamasına giriş yapıldı
  • [ ] Token alındı
  • [ ] Chrome Extension kuruldu ve ayarlandı
  • [ ] Windows uygulaması kuruldu ve ayarlandı
  • [ ] İlk şifre eklendi
  • [ ] Chrome Extension ile şifre test edildi

🎉 SeedPass'ı kullanmaya hazırsınız!