On-Premises Mavi Masa Kurulum Kılavuzu

İleri Düzey Konular

Bu belge, kurulum aşamalarını profesyonel ve sistematik biçimde tamamlamanız için rehberlik eder. Kurulum sürecinde herhangi bir konuda yardımcı olmaya hazırız.

SaaS vs On-Premises

Yerinde Mavi Masa Kurulum Kılavuzu

SaaS Karşısında Yerinde Kurulum

DestekSitesi, hem bulut (hosted) hem de kurum içi (on-premises) sürümlerini sunmaktadır. Bu kurulum kılavuzu, kendi sunucunuzda barındırılan, yani “self-hosted” on-premises sürüm içindir.

Bu kılavuz, DestekSitesi Mavi Masa uygulamasının web tabanlı yardım masası yazılımının kurulumu ve işletimini temel alan bir rehberdir. Size, DestekSitesi Mavi Masa Biletleme Sisteminin kurulumunu ve temel kullanımını adım adım anlatacağız.

Geçerli Sürüm

Bu kılavuz DestekSitesi Mavi Masa 10 ve üzeri sürümler için hazırlanmıştır. Önceki sürümlere ait kılavuzlar farklıdır ve bu dokümanda yer almamaktadır.

Genel Bakış

DestekSitesi Mavi Masa‘yı tercih ettiğiniz için teşekkür ederiz. Yazılım, müşteri destek ekiplerinin etkin ve etkili hizmet sunmasını sağlamak için tasarlanmış web tabanlı bir yardım masası uygulamasıdır. DestekSitesi, .NET 8 teknolojisi üzerine geliştirilmiş olup, kullanıcılar web tarayıcısı üzerinden erişim sağlayabilir.

Biletler ve Kategoriler

Biletler (tickets), “sorunlar”, “destek talepleri” veya “destek vakaları” olarak da anılır ve Mavi Masa sistemindeki temel birimlerdir. Kullanıcılar tarafından oluşturulur ve işlem kolaylığı açısından kategorilere ayrılır.

Kullanıcı Roller

DestekSitesi Mavi Masa’da 4 farklı kullanıcı rolü bulunmaktadır:

Normal Kullanıcı: Sisteme destek biletleri gönderen temel kullanıcıdır.
Yönetici Kullanıcı: Kendi şirketi içindeki diğer kullanıcıların biletlerini görebilen ve kapatabilen ek yetkilere sahip kullanıcıdır.
Teknisyen (Teknisyen / MaviMasa Agent): Yönetici tarafından en az bir kategori için biletleri yönetme yetkisi verilmiş kullanıcıdır. Katogorilerde yeni bilet açıldığında bu kullanıcılar e-posta bildirimleri alır. Not: Bir kullanıcıyı teknisyen yapmak için, yönetici kategori düzenleme veya kullanıcı profili üzerinden yetki vermelidir.
Yönetici (Administrator): En yetkili roldür. Sistem ayarlarını değiştirir, kullanıcıları kategorilere atar (böylece teknisyen yapar), kategoriler oluşturur ve kullanıcı ekleme veya silme işlemleri yapar. Not: Yönetici, varsayılan olarak yeni biletlerden e-posta bildirimi almaz, ancak teknisyen olarak atandığı kategorilerde bildirim alır.

Sistem Gereksinimleri

Platformlar

DestekSitesi Mavi Masa, aşağıdaki işletim sistemlerinden biri üzerinde çalışan sunuculara kurulabilir:

Microsoft Windows Server 2012 veya sonrası
Linux (Ubuntu, CentOS, WSL2, Debian test edilmiştir)
Docker

Mavi Masa, web tabanlı olduğu için istemci (client) tarafında işletim sistemi bağımsızdır. Chrome, Firefox, MS Edge, Safari gibi yaygın web tarayıcıları kullanılarak erişilebilir.

Gerekli Yetkinlikler

Bir web uygulamasını sunucuya kurmak karmaşık olabilir. MS SQL Server yükleme ve yönetimi, veritabanı oluşturma ve SQL scriptleri çalıştırma bilgisi gerektirir. Ayrıca, Windows için IIS veya Linux için Nginx web sunucusu ayarları hakkında temel deneyim faydalı olacaktır.

Önerimiz; eğer teknik bilgi ve deneyiminiz yoksa, DestekSitesi’nin bulut sürümünü kullanmanızdır. Sunucu sürümü, deneyimli kullanıcılar için uygundur.

Ön Koşullar

Windows

Sunucuda aşağıdaki bileşenler yüklü olmalıdır:

Microsoft .NET 8 Hosting Bundle
Internet Information Services (IIS) web sunucusu, ASP.NET özelliği etkinleştirilmiş olmalı.
- Özellikleri açmak için:
  1. Başlat menüsünden “Windows özelliklerini aç veya kapat” aratın
  2. “Internet Information Services” → “World Wide Web Services” → “Application Development Features”
  3. CGI hariç tüm bileşenleri etkinleştirin
  4. “Common HTTP Features” altında WebDAV ve Directory Browsing dışındaki tüm özellikleri açın
  5. Windows Entegre Kimlik Doğrulaması kullanacaksanız, IIS’de “Windows Authentication” rolü kurulmalıdır
Microsoft SQL Server 2012 veya daha yeni sürümü, hem Windows hem de SQL kimlik doğrulamasını destekleyen “Mixed Mode” olarak yapılandırılmış olmalı
- SQL Server Express ve Developer sürümleri ücretsizdir (Developer sürümünün lisans şartlarına dikkat edilmelidir)
- DestekSitesi, SQL kimlik doğrulamasını kullanır; bu yüzden Mixed Mode ve SA kullanıcısı için parola belirtilmiş olmalıdır.
Full-Text Search (tam metin arama) özelliği isteğe bağlıdır, fakat şiddetle tavsiye edilir. SQL Server’ın güncel sürümleri bunu varsayılan olarak içerir.

Microsoft .NET 8, IIS ve SQL Server Express ücretsiz olarak temin edilebilir.

Linux

Güncel bir Linux dağıtımı (örneğin Ubuntu 22.04)
Microsoft SQL Server kurulumu (Windows ya da Linux üzerinde olabilir). Bu kılavuzda, SQL Server aynı makineye kurulacaktır fakat ölçeklenebilirlik için ayrı sunucu önerilir. SQL Server Express sürümleri ile başlanabilir.
.NET Runtime 8 veya sonrası kurulu olmalı. Ubuntu’da aşağıdaki komut ile kurulabilir:

bash

sudo apt-get update && sudo apt-get install -y aspnetcore-runtime-8.0

Docker

Herhangi bir Docker motoru yeterlidir. Docker Desktop en kullanışlı seçenektir.

DestekSitesi Mavi Masa Kurulumu

Teknik açıdan, DestekSitesi Mavi Masa iki temel bileşenden oluşur: web uygulaması ve SQL Server veritabanı.

Web uygulamasını sunucudaki bir klasöre açarsınız,
Veritabanını ise veritabanı sunucusuna kurarsınız.

Windows

DestekSitesi Mavi Masa Kurulumu Yöntemleri

DestekSitesi Mavi Masa, iki farklı şekilde kurulabilir:

Otomatik Kurulum:
- setup.exe kurulum dosyasını başlatarak yapılır.
- Yerel bir sunucuya kuruluyor ve fiziksel veya terminal erişiminiz varsa önerilir.
Manuel Kurulum:
- Sistem yöneticisi veya ileri düzey kullanıcılar için uygundur.
- Örneğin, yazılımı bir hosting ortamına yüklemek istediğinizde tercih edilir.

Setup.exe ile Kurulum

Öncelikle tüm ön koşulları yükleyin, özellikle .NET 8 Hosting Bundle
Dosyaları açın (unzip işlemi yapın)
install.bat dosyasını çalıştırın; bu dosya .NET 8’in yüklü olup olmadığını kontrol eder, ardından Setup.exe’yi başlatır
Kurulum talimatlarını takip edin

Veritabanı oluşturma aşamasında:

Kurulum, sizden SQL Server adını isteyecektir.
Eğer SQL Server Express Edition kullanıyorsanız, varsayılan olarak isimlendirilmiş örnek (named instance) olarak kurulur: SQLEXPRESS. Bu nedenle sunucu adı olarak (local)\SQLEXPRESS belirtmeniz gerekir.
Kurulum, belirtilen sunucuda “DestekMaviMasa” adlı veritabanını oluşturacaktır.
Ayrıca, “DestekMaviMasaUser” adında ve rastgele oluşturulmuş bir şifreye sahip SQL kullanıcısı yaratılacak (şifre appsettings.json dosyasına kaydedilir).

Not: Yukarıdaki işlemler için Windows hesabınızda SQL yönetici yetkilerine sahip olmanız gerekir.

Manuel Kurulum

1. Web Uygulaması Kurulumu

Ön koşulları yükleyin, özellikle .NET 8 Hosting Bundle
Dosyaları açın (unzip)
“mavimasa” klasörünün içeriğini web sunucusundaki sanal dizine kopyalayın (örneğin, c:\inetpub\wwwroot\MaviMasa) veya web hosting ortamınıza yükleyin
Oluşturulan klasörü IIS’de uygulama (application) olarak yapılandırın (inetmgr.exe ile)

2. Veritabanı Kurulumu

Aşağıdaki seçeneklerden birini kullanabilirsiniz:

Kurulum klasöründeki sql klasörünü bulun (c:\inetpub\wwwroot\MaviMasa\sql örnek yol). İçinde bulunan SQL scriptlerini kullanın:
1. CreateEmptyDB.sql scriptini çalıştırarak boş veritabanı oluşturun,
2. CreateTables.sql scriptini boş veritabanına uygulayın. Bu işlemi SQL Server Management Studio ile gerçekleştirebilirsiniz.
appsettings.json dosyasını herhangi bir metin editörü ile açarak bağlantı dizesini (connection string) uygun şekilde güncelleyin.
- Örneğin; (local) yerine IP adresi koyabilirsiniz.
- Dikkat: Dosyada atlama karakteri için ters eğik çizgiler (\) çift ters eğik çizgi (\\) ile escape edilmelidir.
- Güncellemeden önce doğrulayıcı (validator) kullanmanızı öneririz.

Linux Kurulumu

Bu bölüm, DestekSitesi Mavi Masa’nın Linux sistemine kurulumunu ele almaktadır.

Önemli: Linux üzerinde Mavi Masa çalıştırmak için ileri düzey Linux yönetimi bilgisine sahip olmalısınız. Eğer bu konuda deneyimli bir Linux yöneticiniz yoksa, bulut sürümünü tercih etmenizi veya Windows üzerinde kurulum yapmanızı öneririz.

Örnek Kurulum: Ubuntu

1. SQL Server Kurulumu

Bu örnekte SQL Server Linux üzerinde kurulacaktır.

Kurulum komutları:

bash

wget -qO- https://packages.microsoft.com/keys/microsoft.asc | sudo apt-key add -
sudo add-apt-repository "$(wget -qO- https://packages.microsoft.com/config/ubuntu/20.04/mssql-server-2019.list)"
sudo apt-get update
sudo apt-get install -y mssql-server
sudo /opt/mssql/bin/mssql-conf setup

Komutlar Ubuntu 20.04 içindir. Kendi dağıtımınız için Microsoft’un belgelerine bakınız.
Kurulum sırasında lisans kabulü isteyecek ve SQL admin kullanıcı “sa” için parola belirlemeniz istenecektir.
Kurulum sonrası SQL Server çalışıyor olmalıdır.

Komut satırı araçlarını yükleyin:

bash

curl https://packages.microsoft.com/config/ubuntu/20.04/prod.list | sudo tee /etc/apt/sources.list.d/msprod.list
sudo apt-get update
sudo apt-get install mssql-tools unixodbc-dev

2. Veritabanını Oluşturma

En son DestekSitesi paketini indirip açın.
Açılan klasörde sql klasörünü bulun.
Aşağıdaki komutlarla sırasıyla veritabanını oluşturun ve tabloları yükleyin:

bash

/opt/mssql-tools/bin/sqlcmd -S localhost -U SA -P 'SA_PASSWORD' -i CreateEmptyDB.sql
/opt/mssql-tools/bin/sqlcmd -S localhost -U SA -P 'SA_PASSWORD' -i CreateTables.sql

Not: Scriptler varsayılan bir MaviMasa SQL Kullanıcısı oluşturur, parolasını daha sonra değiştirip appsettings.json dosyasını güncellemeniz tavsiye edilir.

3. DestekSitesi Mavi Masa’yı Çalıştırma

.NET Runtime 8 veya üstü yükleyin:

sudo apt-get update && sudo apt-get install -y aspnetcore-runtime-8.0

Kurulumun başarılı olduğunu kontrol edin:

dotnet --list-runtimes

Çıktıda şöyle bir liste görmelisiniz:

Microsoft.AspNetCore.App 8.0.0 [/usr/share/dotnet/shared/Microsoft.AspNetCore.App] Microsoft.NETCore.App 8.0.0 [/usr/share/dotnet/shared/Microsoft.NETCore.App]

appsettings.json dosyasını açarak bağlantı dizesini şu şekilde güncelleyin:

json

"DBConnectionString": "user id=DestekMaviMasaUser;data source=localhost;initial catalog=DestekMaviMasa;password=HDPassword1"

Veritabanınız farklı bir sunucuda ise bağlantı adresini ona göre değiştirin.

Uygulamanın bulunduğu dizinde şu komutu çalıştırarak DestekSitesi Mavi Masa’yı başlatın:

bash

 MaviMasa.dll

Başarı mesajı olarak Destek MaviMasa[2170]: MaviMasa app started. göreceksiniz.

Tarayıcıdan http://localhost:5000/ adresine giderek uygulamanın açıldığını kontrol edin.
Farklı portta çalıştırmak isterseniz:

bash

dotnet MaviMasa.dll --urls http://0.0.0.0:8080

4. Nginx Reverse Proxy Yapılandırması

Bu dokümanın kapsamı dışındadır. Ancak, bir web uygulamasını ters proxy arkasında çalıştırmak tavsiye edilir. Microsoft’un resmi belgesine bakabilirsiniz. Apache için de benzer bir rehber mevcuttur.

5. Sunucu Yeniden Başlatıldığında Otomatik Başlatma

Yardım masası uygulamasının sunucu yeniden başlatıldığında otomatik başlaması için bir servis oluşturmanız gerekir.

Servis dosyasını oluşturun:

bash

sudo nano /etc/systemd/system/mavimasa.service

Dosyaya aşağıdaki içeriği yapıştırın:

ini

[Unit]
Description=Mavimasa

[Service]
WorkingDirectory=/path/to/app
ExecStart=/usr/bin/dotnet /path/to/app/MaviMasa.dll
Restart=always
RestartSec=10
KillSignal=SIGINT
SyslogIdentifier=mavimasa
User=MyUsername
Environment=ASPNETCORE_ENVIRONMENT=Production
Environment="ASPNETCORE_URLS=http://127.0.0.1:5001"

[Install]
WantedBy=multi-user.target

Servisi etkinleştirin:

bash

sudo systemctl enable mavimasa.service

Servisi başlatın:

bash

sudo systemctl start mavimasa.service

Docker ile Kurulum

Docker ile Mavi Masa Kurulumu ve Çalıştırma

Bu bölüm, Docker kullanarak Mavi Masa’nın nasıl kurulacağı ve çalıştırılacağına ilişkin adımları detaylı olarak açıklar. Testlerimiz, Docker Desktop 4.20.1 sürümüyle yapılmıştır.

Mavi Masa, resmi olarak Docker üzerinden barındırılmasını desteklemektedir.

🚨 Apple Silikon Chip Kullanıcıları İçin Önemli Not:
Mac cihazınızda x86/amd64 emülasyonu için “Use Rosetta for x86/amd64 emulation on Apple Silicon” ayarını etkinleştirmeniz gerekmektedir. Bu ayarı, Docker Desktop’ta Settings → Features in Development kısmından aktif hale getirebilirsiniz.

Kurulum Adımları

Mavi Masa yazılımını DestekSitesi üzerinden indirin (deneme veya lisanslı sürüm).
İndirdiğiniz dosyayı, çalıştırmak istediğiniz bir klasöre çıkarın ve içeri girin: MaviMasa klasörüne.
Klasör içindeyken terminalde aşağıdaki komutu çalıştırın:
```
docker compose up --build
```
✅ Arka planda çalıştırmanız isterseniz:
docker compose up --build -d
Tüm konteynerler başarıyla başladığında, tarayıcınızdan şu adresi açabilirsiniz:
http://localhost

💡 Tüm Mavi Masa sürümleri, docker-compose.yml dosyasını içermektedir. Deneyimli kullanıcılar için bu dosya özelleştirilebilir. Örneğin, ters proxy kullanacaksanız port numarasını 80’den farklı bir değere değiştirebilirsiniz.

İlk Giriş

Mavi Masa başarıyla kurulduktan sonra, tarayıcınızdan aşağıdaki adreslere erişerek giriş yapabilirsiniz:

Windows: http://myserver/MaviMasa
Linux: http://localhost:5000/

⚠️ Varsayılan Kullanıcı Bilgileri (İlk Giriş İçin):

admin / şifre: admin

client / şifre: client

Bu hesaplar sadece ilk giriş için kullanılmalıdır. Güvenlik nedeniyle, kullanım öncesi şifreleri mutlaka değiştirin.

ℹ️ Uygulamanın çoğu sayfasının alt kısmında “bu sayfa için yardım al” bağlantısı bulunur. Bu bağlantı, o sayfaya özel detaylı bilgi sağlar.

Sık Karşılaşılan Sorunların Çözümü

Tarayıcıda Mavi Masa açılırken hata alıyorsanız, lütfen DestekMaviMasa’ya başvurmadan önce aşağıdaki kontrolleri yapın:

✅ Windows Sunucuları İçin:

ASP.NET Core Hosting Bundle yüklü olmalı (doğrudan indirme)
IIS’te Anonymous Authentication modülü etkinleştirilmeli. Aksi takdirde API ve diğer bileşenlerde sorun yaşanabilir.
Kullanılan kimlik doğrulama türüne göre:
- Windows Integrated Auth kullanıyorsanız → Windows Authentication modülü açık olmalı.
- Forms Auth kullanıyorsanız → Forms Authentication modülü açık olmalı.
❗ Diğer tüm kimlik doğrulama modülleri (Anonymous hariç) devre dışı bırakılmalıdır.

✅ Mobil Uygulamalar İçin:

API’nin düzgün çalışıp çalışmadığını test etmek için şu aracı kullanın:
http://full_mavimasa_url/api/test

Mavi Masa Güncelleme Yöntemleri

Windows Sistemlerde Güncelleme

🔄 Otomatik Güncelleme (Önerilen):
Uygulama klasöründeki Setup.exe dosyasını çalıştırın. Lisanslı kullanıcılar, önce şifre girmeleri istenebilir. Güncellemeler otomatik olarak indirilir, dosyalar ve veritabanı şeması güncellenir.

⚠️ Kaynak kodlarında değişiklik yaptıysanız, bu değişiklikler kaybolabilir.

📌 Adım adım video rehberi hazırlanmaktadır.

Manuel Güncelleme (Otomatik Güncelleme Başarısız Olursa)

Mevcut indirme şifrenizi kullanarak güncellemeyi indirin (lisanslı kullanıcılar için). Deneme sürümü indirmek isterseniz, deneme versiyonunu seçin.
Geçici bir klasöre çıkarın. Ardından:
- Basit yöntem: Setup.exe’yi çalıştırın.
- Veya manuel güncelleme yapmak istiyorsanız, aşağıdaki adımlara devam edin.
Mavi Masa uygulamasının kurulu olduğu klasörü yedekleyin.
appsettings.json hariç tüm dosyaları silin.
⚠️ Dosyaların kullanımda olduğunu belirten hata alırsanız:
- Windows: Application Pool’u durdurun.
- Linux: dotnet sürecini sonlandırın.
Yeni dosyaları, mevcut uygulama dizinine çıkartın.
Veritabanını güncelleyin:
- Setup.exe’yi çalıştırın, ya da
- /sql/UpgradeFromOlderVersions.sql betiğini SQL Server Management Studio üzerinden çalıştırın.
  
  Bağlantı: DestekMaviMasa veritabanına (varsayılan isim).

Linux Sistemlerde Güncelleme

Güncelleme işlemi, deneme sürümünden lisanslı sürüme geçiş veya en son sürüme yükseltme için aynıdır.

En son sürümü indirip çıkarın.
Veritabanını güncellemek için:
bash
```
/opt/mssql-tools/bin/sqlcmd -S localhost -U SA -P 'YOUR PASSWORD' -i sql/UpgradeFromOlderVersions.sql
```
🔁 SQL Server başka bir sunucuda ise, betiği orada manuel olarak çalıştırın.
appsettings.json hariç tüm yerel dosyaları yeni dosyalarla değiştirin.
Uygulamayı yeniden başlatın.

Docker Üzerinden Güncelleme

Paketi DestekSitesi üzerinden indirip çıkarın.
Eski dosyaları yeni dosyalarla değiştirin.

⚠️ Değişiklik yaptığınız appsettings.json dosyasını koruyun.
Terminalde:
bash
```
docker compose stop
docker compose up --build
```
🔄 Bu işlem, veritabanı şemasını otomatik olarak güncelleyecektir.

Önemli Sürüm Geçişleri

Sürüm Öncesi → .NET 8’e Geçiş

Windows: .NET 8 Hosting Bundle yükleyin.
Linux: .NET 8 SDK yükleyin.

❗ .NET 5/6’ya ihtiyaç yoktur. Kaldırmanıza gerek yoktur.

Sürüm Öncesi → .NET Core’a Geçiş

Önce Microsoft .NET 8 Hosting Bundle’ı yükleyin.
Ardından Setup.exe’yi çalıştırın. Otomatik olarak geçiş yapılacaktır.

⚙️ Manuel güncelleme yapmak isterseniz:

web.config dosyasındaki ayarları appsettings.json dosyasına taşıyın.

Veritabanı bağlantı dizesi, Windows kimlik doğrulaması ve diğer ayarlar bu dosyada tanımlanmalıdır.

✅ Tavsiye: Manuel güncelleme yerine Setup.exe kullanımı önerilir.

Gelişmiş Özellikler

appsettings.json Dosyasını Düzenleme

Bazı gelişmiş özellikler, kök dizindeki appsettings.json dosyasında saklanır. Herhangi bir metin düzenleyici ile açabilirsiniz. Değişikliklerin etkin olması için IIS’yi yeniden başlatmanız gerekir.

⚠️ JSON formatına dikkat edin. Yanlış yazılmış bir satır, uygulamanın çökmesine neden olabilir.
✅ Değişiklik yapmadan önce bir JSON validator kullanın.

Tam Metin Arama (Full-Text Search)

Varsayılan olarak, arama yalnızca talep konusu ve metni üzerinde yapılır. Talep yanıtlarını (yorumları) da aramaya dahil etmek ve performansı artırmak için SQL Server’da Full-Text Search bileşenlerini yüklemeniz gerekir.

🔍 Kurulu olup olmadığını kontrol etmek için:

sql

SELECT FULLTEXTSERVICEPROPERTY('IsFullTextInstalled')

Sonuç 1 ise → Kurulu.
Sonuç 0 ise → Kurulum gereklidir.

Kurulum Adımları:

SQL Server’da Full-Text Search bileşenlerini yükleyin.
SQL Server Express kullanıyorsanız, SQL Server Express with Advanced Services sürümünü indirin.
Veritabanınızda en son Mavi Masa sürümünün yükseltme betiklerini çalıştırın.
IIS’te Mavi Masa uygulama havuzunu yeniden başlatın.

💡 Full-Text bileşenleri zorunlu değildir ancak arama hızını ve kalitesini önemli ölçüde artırır.

Otomatik Giriş Özelliği (Autologin)

Mavi Masa, kullanıcıların ana web siteniz üzerinden önceden kimlik doğrulanmış olarak otomatik giriş yapmasına olanak tanır. Özellikle geliştiriciler ve sistem yöneticileri için tasarlanmıştır.

Nasıl Çalışır?

Kullanıcı zaten ana sitede kimlik doğrulandıysa, aşağıdaki URL formatını kullanabilirsiniz:

http://Mavimasa_Url/User/AutoLogin?username=xxx&email=yyy&userHash=HASH

Mavimasa_Url: Tam Mavi Masa URL’si
username: Kullanıcı adı
email: E-posta adresi
HASH: MD5(name + email + shared-secret + day + month)

🔐 Shared Secret: Yönetici panelinde belirlenmelidir. En az 10 karakterli güçlü bir anahtar seçin.
📅 Day & Month: İki haneli format (örneğin, 1 Ocak → 0101)

Ek Parametreler:

FirstName=xxx, LastName=xxx → Yeni kullanıcıya isim ve soyisim atar.
CompanyName=xxx → Şirket bilgisi ekler.
&new_ticket=1 → Kullanıcıyı “Yeni Talep” sayfasına yönlendirir.

📌 Bu özelliğin güncel bilgileri için: DestekSitesi Autologin Dokümantasyonu

Mavi Masa URL Ayarı

⚙️ Sürüm sonrası için:
Yönetim → Genel Ayarlar → Mavi Masa URL kısmında ayarlanabilir.

Talep olaylarına ilişkin e-posta bildirimlerinde, talebe bağlantı verilir. Bu bağlantı, uygulamanın ilk başlatıldığında ilk isteğin yapıldığı URL’ye göre belirlenir.

🔁 Örneğin, ilk istek http://localhost/mavimasaise, tüm e-postalarda bu URL kullanılacaktır. Uygulama havuzunu yeniden başlatana kadar değişmez.

✅ İstediğiniz URL’yi sabitlemek için, yukarıda belirtildiği gibi ayar yapabilirsiniz.

Dosyaları Disk Üzerinde Saklama

Varsayılan olarak, ek dosyalar veritabanında saklanır. Ancak, disk üzerine depolamayı tercih edebilirsiniz:

Diskte bir klasör oluşturun (örneğin: C:\hdfiles)
IIS Management Console’da MaviMasa uygulama havuzunu bulun.
Sağ tıklayıp Advanced Settings → Identity özelliğini kontrol edin.
Bu kullanıcıya, oluşturduğunuz klasöre tam erişim izni verin.
appsettings.json dosyasını Notepad ile açın.
Aşağıdaki satırı bulun ve değiştirin:
json
```
"AttachmentsPath": "C:\\path\\to\\folder"
```
⚠️ JSON formatı nedeniyle ters slash (\) karakterleri \\ olarak kaçırılmalıdır.
Uygulama havuzunu yeniden başlatın.

Windows Entegre Kimlik Doğrulama

Mavi Masa, Active Directory entegrasyonunu destekler. Aktif etmek için:

appsettings.json dosyasında şu satırı açın:
json
```
"Auth": "Windows"
```
IIS’te MaviMasa dizininin Windows Authentication modülünün aktif olduğundan emin olun.
Değişiklik sonrası IIS’yi yeniden başlatın.

⚙️ IIS üzerinde Windows kimlik doğrulaması kullanacaksanız, Windows Authentication Role Service yüklü olmalıdır.

🛡️ Not: Bir kullanıcı ilk kez giriş yaptığında, otomatik olarak veritabanına eklenir. Ayrıca, Active Directory’dan e-posta bilgileri de otomatik olarak çekilir.

Windows Kullanıcı Yöneticisi Ekleme

Setup.exe ile kurulum yaparken, yönetici olarak eklenecek Windows kullanıcı adı istenebilir. Eğer böyle bir seçenek yoksa:

json

"WindowsAdminUsername": "DOMAIN\\User"

⚠️ Kullanıcı adı büyük/küçük harfe duyarlıdır. Doğru yazımı öğrenmek için cmd.exe’de whoami komutunu çalıştırın.
📝 JSON içindeki ters slash (\) karakterleri \\ olarak kaçırılmalıdır.

API ve E-posta API

MaviMasa, diğer uygulamalarla entegrasyon için RESTful API sunmaktadır.

API Adresi: http://servername/mavimasa/api/
API Dokümantasyonu: DestekSitesi API Dokümanı
E-posta API Kılavuzu: DestekSitesi Email API

appsettings.json Doğrulayıcı

Yapılan hatalar uygulamayı çökebilir. Bu nedenle, değişiklik yapmadan önce JSON Validator kullanmanız önerilir.

🧪 Doğrulayıcı: DestekSitesi JSON Validator

Gelişmiş appsettings.json Ayarları

Aşağıdaki ayarlar, ileri düzey kullanıcılar için предназначены. Dikkatli kullanın.

json

"WindowsAdminUsername": "DOMAIN\\User",
"LogErrors": true,
"EmailErrorTo": "admin-john@test.com, admin-pete@test.com",
"DisallowChangingAvatars": "false",
"AttachmentsPath": "c:\\hdfiles",
"DisableMailChecker": "true",
"AllowedFileExtensions": ".png,.pdf",
"ProxyIP": "192.168.1.1",
"MailPswEncryptKey": "18d6fg81"

⚠️ MailPswEncryptKey:

8 karakterli, Latin harf/rakam içermelidir.

Anahtarı mutlaka yedekleyin ve hiç değiştirmeyin. Aksi takdirde veritabanındaki e-posta şifreleri kaybedilir.

Herhangi bir sorunuz veya teknik desteğe ihtiyacınız varsa, DestekMaviMasa ekibine ulaşmaktan çekinmeyin.