ONLYOFFICE¶

Bu makalede

• ONLYOFFICE. Temel Özellikler
• Çalıştırma Özellikleri
• ONLYOFFICE'ı Çalıştırdıktan Sonra Başlangıç
• Web Arayüzüne Erişim
• JWT Gizli Anahtarı Yapılandırması
• Test İçin Örnekleri Etkinleştirme
• API kullanarak ONLYOFFICE ile bir sunucu siparişi

Bu makalede: - ONLYOFFICE. Temel Özellikler - Çalıştırma Özellikleri - OnlyOffice'ı Çalıştırdıktan Sonra Başlangıç - Web Arayüzüne Erişim - JWT Gizli Anahtarı Yapılandırması - Test İçin Örnekleri Etkinleştirme - API kullanarak ONLYOFFICE ile bir sunucu siparişi

ONLYOFFICE. Temel Özellikler¶

• Gerçek Zamanlı Belge Düzenleme: İşbirlikçi düzenleme özelliklerine sahip DOCX, XLSX, PPTX için tam özellikli düzenleyiciler;
• Microsoft Office Biçimleri ile Uyumluluk: Karmaşık biçimlendirmeler dahil olmak üzere MS Office biçimleri için tam destek;
• İşbirlikçi Düzenleme: Değişiklik izleme ile birden fazla kullanıcının eş zamanlı belge düzenlemesi;
• Gömülü Yorumlar ve Sohbet: Düzenleyici arayüzü içinde doğrudan belgeleri tartışmak için araçlar;
• Sürüm Kontrolü: Önceki sürümlere geri dönme yeteneği ile değişiklik geçmişi izleme;
• Eklentiler ve Entegrasyonlar: Eklentiler ve popüler depolama sistemleri ile entegrasyon yoluyla işlevselliği genişletme;
• Güvenlik: API'yi korumak ve iletim sırasında veri şifrelemesi için JWT belirteçleri desteği;
• Geliştiriciler için API: Özel uygulamalarla entegrasyon için REST API;
• Mobil Destek: Tabletler ve akıllı telefonlar için uyumlu arayüz.

Çalıştırma Özellikleri¶

ONLYOFFICE'ı Çalıştırdıktan Sonra Başlangıç¶

Kayıt sırasında belirtilen e-posta adresine yapılan sipariş ödemesinin ardından, sunucunun hazır olduğuna dair bir bildirim gönderilecektir. Bu bildirimde VPS IP adresi ile bağlantı için kullanıcı adı ve şifre yer alacaktır. Şirketimizin müşterileri ekipmanları sunucu yönetim paneli ve API — Invapi üzerinden yönetir.

Yetkilendirme verileri, sunucu yönetim panelinin Bilgi >> Etiketler sekmesinde veya gönderilen e-postada bulunabilir:

• ONLYOFFICE web arayüzü paneline erişim bağlantısı: webpanel etiketinde;
• Sunucuyu yönetmek için Kullanıcı Adı ve Şifre: Sunucu teslimi sırasında e-posta ile gönderilir.

Web Arayüzüne Erişim¶

ONLYOFFICE İşlevselliğini Kontrol Etme¶

1. Bir web tarayıcısı açın ve webpanel etiketindeki bağlantıya gidin;

2. ONLYOFFICE karşılama sayfasını görmelisiniz:

   

3. Düzenleyici işlevselliğini kontrol etmek için yerleşik örnekleri kullanın (bkz. "Test İçin Örnekleri Etkinleştirme" bölümü).

Hizmet Durumunu Kontrol Etme¶

Konteynerlerin durumunu kontrol etmek için sunucuda aşağıdaki komutu çalıştırın:

docker ps

CONTAINER ID   IMAGE                          STATUS        PORTS                    NAMES
527cd331a316   jonasal/nginx-certbot:latest   Up 19 hours                           nginx-nginx-1
e32700b1ac75   onlyoffice/documentserver      Up 19 hours   0.0.0.0:8080->80/tcp    onlyoffice-docs

JWT Gizli Anahtarı Yapılandırması¶

Mevcut JWT Gizli Anahtarını Görüntüleme¶

JWT gizli anahtarı, Document Server API'sini korumak için kullanılır. Mevcut değerini görüntülemek için:

sudo docker exec e32700b1ac75 /var/www/onlyoffice/documentserver/npm/json -f /etc/onlyoffice/documentserver/local.json 'services.CoAuthoring.secret.session.string'

JWT Belirteçlerinin Yapısı¶

ONLYOFFICE, farklı amaçlar için üç tür JWT gizli anahtarı kullanır:

• secret.inbox.string - Harici sistemlerden ONLYOFFICE'e gelen istekler için;
• secret.outbox.string - ONLYOFFICE'den harici sistemlere giden istekler için;
• secret.session.string - Dahili oturumlar ve bileşenler arası etkileşimler için.

JWT Gizli Anahtarlarını Değiştirme¶

JWT gizli anahtarlarını değiştirmek için şu adımları izleyin:

1. Yapılandırmanın bir yedeğini oluşturun:

   docker exec onlyoffice-docs cp /etc/onlyoffice/documentserver/local.json /etc/onlyoffice/documentserver/local.json.backup
   

2. OnlyOffice konteynerine giriş yapın:

   docker exec -it onlyoffice-docs /bin/bash
   

3. Yapılandırma dosyasını düzenleyin:

   nano /etc/onlyoffice/documentserver/local.json
   

4. services.CoAuthoring.secret bölümünü bulun ve değerleri değiştirin:

   "secret": {
     "inbox": {
       "string": "your_unique_secret_for_incoming_requests"
     },
     "outbox": {
       "string": "your_unique_secret_for_outgoing_requests"
     },
     "session": {
       "string": "your_unique_secret_for_sessions"
     }
   }
   

5. Dosyayı kaydedin ve düzenleyiciden çıkın (Ctrl+X, ardından Y, ardından Enter);
6. Değişiklikleri uygulamak için konteyneri yeniden başlatın:

   docker restart onlyoffice-docs
   

7. Hizmetin doğru şekilde başladığını kontrol edin:

   docker logs onlyoffice-docs --tail 100
   

Test İçin Örnekleri Etkinleştirme¶

ONLYOFFICE, belge düzenleyicilerini test etmek için yerleşik örnekler içerir. Varsayılan olarak bunlar devre dışıdır.

Örnekleri Etkinleştirme¶

Test örneklerini etkinleştirmek için aşağıdaki komutları çalıştırın:

Örnek hizmetini başlat:

sudo docker exec e32700b1ac75 sudo supervisorctl start ds:example

sudo docker exec e32700b1ac75 sudo sed 's,autostart=false,autostart=true,' -i /etc/supervisor/conf.d/ds-example.conf

1. Tarayıcıda açın: https://your-domain/welcome/;
2. Düzenleyici örneklerini içeren bir sayfa göreceksiniz;
3. Test etmek için herhangi bir belge türüne tıklayın:
   • Document - Metin belgeleri oluşturmak için;
   • Spreadsheet - Elektronik tablolar oluşturmak için;
   • Presentation - Sunumlar oluşturmak için;
   • PDF form - PDF formlarıyla çalışmak için.

API kullanarak ONLYOFFICE ile bir sunucu siparişi¶