Dokümantasyon

DEPLOYMENT GUIDE

← Geri

SeedPass Deployment Rehberi

📦 Publish Edilen Projeler

  • UI.Web: Web uygulaması (C:\Publish\SeedPass\UI.Web)
  • UI.Windows: Windows uygulaması (C:\Publish\SeedPass\UI.Windows)

🚀 Web Uygulaması (UI.Web) Kurulumu

1. Sunucu Gereksinimleri

  • .NET 8.0 Runtime (veya .NET 8.0 SDK)
  • IIS (Internet Information Services) veya Kestrel
  • SQL Server bağlantısı
  • SSL Sertifikası (HTTPS için)

2. IIS Kurulumu (Windows Server)

2.1. IIS Kurulumu

  1. Server Manager'ı açın
  2. Add Roles and Features seçin
  3. Web Server (IIS) seçin
  4. Aşağıdaki özellikleri seçin:
    • ASP.NET Core Module V2
    • .NET Core Hosting Bundle
    • Windows Authentication (opsiyonel)

2.2. .NET 8.0 Hosting Bundle Kurulumu

  1. .NET 8.0 Hosting Bundle indirin
  2. Kurulum dosyasını çalıştırın
  3. Sunucuyu yeniden başlatın

3. IIS'te Web Uygulaması Kurulumu

3.1. Application Pool Oluşturma

  1. IIS Manager'ı açın
  2. Application Pools > Add Application Pool
  3. Ayarlar:
    • Name: SeedPassAppPool
    • .NET CLR Version: No Managed Code
    • Managed Pipeline Mode: Integrated

3.2. Web Site Oluşturma

  1. Sites > Add Website
  2. Ayarlar:
    • Site name: SeedPass
    • Application pool: SeedPassAppPool
    • Physical path: C:\Publish\SeedPass\UI.Web
    • Binding:
      • Type: https
      • IP address: All Unassigned
      • Port: 443
      • Host name: seedpass.seed.tr
      • SSL certificate: SSL sertifikanızı seçin

3.3. appsettings.json Yapılandırması

  1. C:\Publish\SeedPass\UI.Web\appsettings.json dosyasını açın
  2. Aşağıdaki ayarları yapın:
{
  "ConnectionStrings": {
    "DefaultConnection": "Server=91.198.66.11;Database=SeedPassDb;User Id=SeedDbAdmin;Password=Sed232398@;MultipleActiveResultSets=true;TrustServerCertificate=true"
  },
  "GoogleAuth": {
    "ClientId": "96398944958-bkuog9t2hbrqqdmjdeh6h34665u3vpmk.apps.googleusercontent.com",
    "ClientSecret": "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"
  },
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft.AspNetCore": "Warning"
    }
  },
  "AllowedHosts": "seedpass.seed.tr;localhost"
}

3.4. Klasör İzinleri

  1. C:\Publish\SeedPass\UI.Web klasörüne sağ tıklayın
  2. Properties > Security > Edit
  3. IIS_IUSRS kullanıcısına Read & Execute izni verin
  4. IIS AppPool\SeedPassAppPool kullanıcısına Read & Execute izni verin

4. Veritabanı Migration'ı

  1. Sunucuda .NET 8.0 SDK kurulu olmalı
  2. Komut satırını açın ve şu komutu çalıştırı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 Entity Framework Core tools kurulu değilse:

dotnet tool install --global dotnet-ef

5. Google Cloud Console Ayarları

  1. Google Cloud Console'a gidin
  2. Projenizi seçin
  3. API'ler ve Hizmetler > Kimlik Bilgileri menüsüne gidin
  4. OAuth 2.0 Client ID'nizi bulun ve düzenleyin
  5. Authorized JavaScript origins bölümüne ekleyin: 
    https://seedpass.seed.tr
  6. Authorized redirect URIs bölümüne ekleyin: 
    https://seedpass.seed.tr/signin-google

6. DNS Ayarları

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

7. Firewall Ayarları

  1. Windows Firewall'u açın
  2. Inbound Rules > New Rule
  3. Port seçin
  4. TCP ve 443 portunu seçin
  5. Allow the connection seçin
  6. Kuralı kaydedin

8. Test

  1. Tarayıcıda https://seedpass.seed.tr adresine gidin
  2. Google ile giriş yapın
  3. Token al butonuna tıklayın
  4. Token'ı kopyalayın

🖥️ Windows Uygulaması (UI.Windows) Kurulumu

1. Gereksinimler

  • .NET 8.0 Runtime (veya .NET 8.0 SDK)
  • Windows 10/11 veya Windows Server 2016+

2. Kurulum

2.1. Manuel Kurulum

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

2.2. Ayarlar

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

3. Kısayol Oluşturma

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

🌐 Chrome Extension Kurulumu

1. Extension Dosyalarını Yükleme

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

2. Ayarlar

  1. Extension icon'una tıklayın
  2. API URL: https://seedpass.seed.tr
  3. Token: Web uygulamasından aldığınız token'ı yapıştırın
  4. Token Kaydet butonuna tıklayın

3. Kullanım

  1. Herhangi bir web sitesinde sağ tıklayın
  2. SeedPass menüsünü seçin
  3. Şifreyi Yapıştır veya Şifre Oluştur seçeneklerini kullanın

📝 Kullanım Adımları

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

2. Token Alma

  1. Ana sayfada Token Al butonuna tıklayın
  2. Açılan modalda token görünecek
  3. Kopyala butonuna tıklayarak token'ı kopyalayın

3. Chrome Extension Ayarlama

  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

4. Windows Uygulaması Ayarlama

  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

5. Şifre Ekleme

  1. Web uygulamasında Yeni Şifre Ekle butonuna tıklayın
  2. Formu doldurun:
    • Başlık: Şifrenin başlığı
    • URL: Web sitesinin URL'i
    • Kullanıcı Adı: Kullanıcı adı
    • Şifre: Şifre
    • Notlar: Opsiyonel notlar
  3. Kaydet butonuna tıklayın

6. Chrome'dan Şifre İçe Aktarma

  1. Chrome'da chrome://settings/passwords adresine gidin
  2. Export passwords butonuna tıklayın
  3. CSV dosyasını kaydedin
  4. Web uygulamasında Chrome'dan İçe Aktar butonuna tıklayın
  5. CSV dosyasını seçin
  6. İçe Aktar butonuna tıklayın

7. Chrome Extension ile Şifre Kullanma

  1. Herhangi bir web sitesinde sağ tıklayın
  2. SeedPass > Şifreyi Yapıştır seçin
  3. Birden fazla şifre varsa, birini seçin
  4. Şifre otomatik olarak yapıştırılacak

8. Windows Uygulaması ile Şifre Görüntüleme

  1. Windows uygulamasını açın
  2. Tüm şifreleriniz listede görünecek
  3. Şifreleri görüntüleyebilir, düzenleyebilir ve silebilirsiniz

🔒 Güvenlik Notları

  1. Token Güvenliği: Token'ı kimseyle paylaşmayın
  2. SSL Sertifikası: HTTPS kullanın
  3. Firewall: Gereksiz portları kapatın
  4. Güncellemeler: Düzenli olarak güncelleyin
  5. Yedekleme: Veritabanını düzenli olarak yedekleyin

🐛 Sorun Giderme

Web Uygulaması Çalışmıyor

  1. IIS Logs'u kontrol edin: C:\inetpub\logs\LogFiles
  2. Event Viewer'ı kontrol edin: Windows Logs > Application
  3. Application Pool'un çalıştığından emin olun
  4. .NET 8.0 Runtime'ın kurulu olduğundan emin olun

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
  4. SQL Server Authentication'ın doğru 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