Çok kiracılı sunucu

Çok kiracılı sunucuyu yapılandırma

1. Developer Edition sunucusunu kurun

   Çok kiracılı modu etkinleştirmek için geçerli bir çok kiracılık lisansı gerekir.

   not

   Bu lisansı talep etmek için lütfen satış temsilcinizle iletişime geçin.

   Lütfen ürünü verilen talimatları izleyerek kaydedin.

2. local.json yapılandırma dosyasını açın ve baseDir alanını kiracı ayarlarını içeren klasörün yoluna ayarlayın. /var/www/onlyoffice/Data/tenants değerini kullanmanızı öneririz.

3. local.json dosyasında baseDomain alanını, tüm kiracılarınız için temel alan adı olacak ikinci düzey alan adına ayarlayın.

4. Ana lisansa ilişkin istatistikler varsayılan kiracıda toplanır.

   • Varsayılan kiracının adı, defaultTenant içindeki defaultTenant alanında belirtilir.

     not

     Bu adla başka bir kiracı oluşturamazsınız.

   • Kiracı belirtmeyen baseDomain istekleri otomatik olarak varsayılan kiracıya yönlendirilir.

   • Varsayılan kiracı için ek yapılandırma gerekmez. Ancak bu kiracıya yapılan istekler, local.json dosyasında tanımlanan bir gizli anahtarla imzalanır.

   • İstatistikleri varsayılan kiracının info sayfasında görüntüleyin.

Yeni kiracı ekleme

1. Yeni bir kiracı eklemek için:

   • Sunucuda baseDir dizini içinde yeni bir klasör oluşturun.

   • Kiracının adı, klasör adı ve baseDomain ile oluşturulur (örneğin klasörün adı tenant1 ve baseDomain example.com ise kiracı adı tenant1.example.com olur).

     not

     Bu klasörün, default.json dosyasının bulunduğu dosya sisteminde oluşturulduğundan emin olun.

   Her kiracı klasörünün içine aşağıdaki iki zorunlu dosyayı ekleyin:

   default.json:

   "tenants": {
       "baseDir": "/var/www/onlyoffice/Data/tenants",
       "baseDomain": "mydomain.example",
       "filenameConfig": "config.json",
       "filenameSecret": "secret.key",
       "filenameLicense": "license.lic",
       "defaultTenant": "localhost",
       "cache": {
           "stdTTL": 300,
           "checkperiod": 60,
           "useClones": false
       }
   }

   not

   Yalıtım ve güvenlik için her kiracıya bir secret.key dosyası ekleyin. Dosya yoksa ana kiracının gizli anahtarı kullanılır. Bir JWT gizli anahtarı belirtilmişse config.json içindeki anahtar önceliklidir.

   dosya sistemi:

   root@3694c287928a:/var/www/onlyoffice/Data/tenants# 1s -a
   . .. tenant1 tenant2
   root@3694c287928a:/var/www/onlyoffice/Data/tenants#

2. root@3694c287928a:~# 1s /var/www/onlyoffice/Data/tenants/tenant1
   config.json license.lic
   root@3694c287928a:~#

   • license.lic – kiracının lisansını içeren zorunlu dosya
   • config.json – ana sunucu yapılandırmasını geçersiz kılan zorunlu yapılandırma dosyası
   not

   JWT gizli anahtarını girmek zorunludur.

3. license.lic dosyası, ana lisansın belirli alanlarını kiracı için geçersiz kılar. Kuralları şunlardır:

   • İmza: Lisans imzası gerekmez.

   • Alan devralma: Ana lisanstaki alanların bir kısmını veya tamamını ekleyebilirsiniz. Belirtilmeyen alanlar ana lisanstaki değerleri alır ve buna göre doğrulanır.

   • Sınır ayarları: Değerleri ana lisansa göre artıramazsınız, ancak azaltabilirsiniz. Geçerli alanlar: connections, connections_view, users_count, users_expire, users_view_count, end_date, timelimited, advanced_api, branding, customization.

     Örnek: branding ve customization alanlarını kaldırabilir veya deneme modunu ayarlayabilirsiniz.

     not

     Ana lisans her seferinde yeniden kontrol edildiğinden değerleri artırmak etkisizdir.

   • Önbellek: Okunduktan sonra lisans değerleri 5 dakika boyunca önbellekte tutulur.

   Örneğin license.lic dosyası şu içeriğe sahip olabilir:

   {"branding":false,"connections":100,"users_count":0}

4. config.json dosyası, bazı sunucu ayarlarını geçersiz kılmanıza olanak tanır. Kurallar şunlardır:

   • Geçersiz kılınamayan ayarlar: Sunucu başlatılırken kullanılan ayarlar (harici hizmetlerin adresleri, günlük yolları, lisanslar ve dosya önbelleği gibi) geçersiz kılınamaz.
   • Geçersiz kılınabilen ayarlar: Çalışma zamanı işlemlerini etkileyen ayarları geçersiz kılabilirsiniz. Bunlar arasında WOPI yapılandırması, IP filtreleme, JWT gizli anahtarı, anonim erişimin devre dışı bırakılması ve dosya boyutu sınırları yer alır.
   • Önbellek: Okunduktan sonra yapılandırma değerleri 5 dakika boyunca önbellekte tutulur.

   Örneğin config.json dosyası şu içeriğe sahip olabilir:

   {
    "wopi": {
     "enable": true
    },
    "services": {
     "CoAuthoring": {
      "secret": {
       "inbox": {"string": "secret", "file": ""},
       "outbox": {"string": "secret", "file": ""},
       "session": {"string": "secret", "file": ""}
      },
      "token": {
       "enable": {
        "browser": true,
        "request": {
         "inbox": true,
         "outbox": true
        }
       }
      }
     }
    }
   }