İçeriğe geç
Oleaflyv0.4.12

Sunucu çalıştırma

Oturum açma ve erişim

Oleafly Server için oturum açma sağlayıcılarını ve e-postayı ayarlayın, erişim kuralları, açık kayıt, roller ve konuklarla kimin gireceğine karar verin, tarayıcı erişimini açın ve sunucuyu Oleafly'deki yönetici konsolundan yönetin.

Kişiler, Oleafly Server’a sizin yapılandırdığınız sağlayıcılar üzerinden oturum açar; böylece sunucu hiçbir zaman parolalarla uğraşmaz. Kimin gireceğine erişim kurallarıyla siz karar verirsiniz. Geri kalanını yöneticiler, Oleafly’deki yönetici konsolundan yönetir.

En az bir sağlayıcı yapılandırın. Sağlayıcı olmadan sunucu başlamaz ve sunucunun günlüğü, eklenmesi gereken ayarların adını yazar. İlk yönetici bu sağlayıcıyla oturum açar, çünkü e-posta bağlantısıyla oturum açma, bir yönetici açana kadar kapalı kalır. Her sağlayıcı, kişileri sunucunuzdaki bir geri çağırma adresine geri gönderir:

https://collab.example.org/auth/callback/<provider>

OLEAFLY_PUBLIC_URL bir yol içeriyorsa geri çağırma adresi de yol içerir; örneğin https://www.cs.example.edu/oleafly/auth/callback/github.

  1. GitHub’da profil fotoğrafınızı, ardından Ayarlar › Geliştirici ayarları › OAuth uygulamaları seçeneklerini seçin ve Yeni OAuth uygulaması’nı seçin. Bir kuruluşa ait uygulama için bunun yerine kuruluş ayarlarındaki Geliştirici ayarları’nı kullanın.
  2. Uygulama adı alanını doldurun (örneğin Smith Lab Oleafly), Ana sayfa URL’si (https://collab.example.org) ve Yetkilendirme geri çağırma URL’si (https://collab.example.org/auth/callback/github) alanlarını da. Cihaz akışını etkinleştir seçeneğini kapalı bırakın.
  3. Uygulamayı kaydet’i seçin. İstemci Kimliği’ni kopyalayın, ardından Yeni istemci parolası oluştur’u seçip parolayı kopyalayın.
  4. OLEAFLY_GITHUB_CLIENT_ID ve OLEAFLY_GITHUB_CLIENT_SECRET değişkenlerini ayarlayın ve sunucuyu yeniden başlatın.

Sunucu, GitHub’dan yalnızca kişinin profilini ve e-posta adreslerini ister (read:user ve user:email). OLEAFLY_GITHUB_LABEL, oturum açma düğmesindeki metni değiştirir.

GitHub Enterprise Server için uygulamayı orada kaydedin ve OLEAFLY_GITHUB_URL değişkenine de adresini yazın; örneğin https://github.example.edu. OLEAFLY_GITHUB_API_URL değişkenini yalnızca API adresiniz alışılmışın dışındaysa ayarlayın.

OpenID Connect; GitLab, Google, Microsoft Entra ID, Keycloak, Authentik, Okta ve çoğu üniversite tek oturum sistemini kapsar. Üniversiteniz yalnızca SAML sunuyorsa araya Keycloak veya Dex koyun.

  1. Harfler ve rakamlardan oluşan kısa bir ad seçin, örneğin GITLAB. Bu ad, değişken adlarının parçası olur ve küçük harfe çevrildiğinde geri çağırma adresinin parçası olur. Compose .env dosyasında UNIVERSITY satırlarını yeniden adlandırın ya da ikinci bir blok ekleyin.

  2. Sağlayıcınızda bir uygulama kaydedin. Gizli (confidential) veya web uygulaması türünü seçin, yeniden yönlendirme URI’sini https://collab.example.org/auth/callback/gitlab olarak ayarlayın ve openid, email ve profile kapsamlarına izin verin.

  3. Sağlayıcının bilgilerini ekleyin:

    OLEAFLY_OIDC_GITLAB_ISSUER=https://gitlab.com
    OLEAFLY_OIDC_GITLAB_CLIENT_ID=example-client-id
    OLEAFLY_OIDC_GITLAB_CLIENT_SECRET=example-client-secret
    OLEAFLY_OIDC_GITLAB_LABEL=GitLab
  4. Sunucuyu yeniden başlatın.

Etiket, oturum açma düğmesindeki metindir; örneğin University login. Issuer ise sağlayıcının /.well-known/openid-configuration belgesini yayımladığı adrestir. Sık görülen bazıları:

SağlayıcıIssuer
GitLab.comhttps://gitlab.com
Kendi yönettiğiniz GitLabGitLab adresiniz, örneğin https://gitlab.example.edu
Googlehttps://accounts.google.com
Microsoft Entra IDhttps://login.microsoftonline.com/ ve ardından kiracı kimliğiniz ile /v2.0
Keycloakhttps://sso.example.edu/realms/ ve ardından realm adı

İzin listesi girdileri ve alan adı kuralları yalnızca doğrulanmış e-posta adresleriyle eşleşir. Sunucu bir adresi, yalnızca sağlayıcı böyle dediğinde doğrulanmış sayar: GitHub adresi doğrulanmış olarak işaretler ya da OpenID Connect email_verified claim’i true olur.

Bazı kurumsal sağlayıcılar bu claim’i hiç göndermez. Sağlayıcınız böyleyse ve yalnızca kurumunuzun denetlediği adresleri dağıtıyorsa OLEAFLY_OIDC_<NAME>_TRUST_EMAIL=true ayarını yapın. Kişilerin istediği herhangi bir e-posta adresini yazabildiği bir sağlayıcı için bunu asla ayarlamayın. Yoksa biri, izin listenizdeki bir kişi olarak oturum açabilir.

Üniversiteniz, vekil sunucusu veya oturum açma servisi için kendi sertifikalarını imzalıyorsa sunucunun bu sertifika yetkilisine güvenmesi gerekir. Oleafly çalıştıran her bilgisayarın da güvenmesi gerekir.

Docker kullanmıyorsanız sertifikayı işletim sistemine ekleyin. Debian ve Ubuntu’da sertifikayı, adı .crt ile biten bir dosya olarak /usr/local/share/ca-certificates/ klasörüne kopyalayın ve sudo update-ca-certificates komutunu çalıştırın.

Docker imgesinde paket yöneticisi olmadığından, kendi sertifikanızı da içeren bir sertifika listesi verin. Debian veya Ubuntu bir makinede, docker-compose.yml dosyasının yanında:

Terminal penceresi
cat /etc/ssl/certs/ca-certificates.crt university-ca.pem > ca-bundle.pem
chmod 644 ca-bundle.pem

Ardından dosyayı docker-compose.override.yml içinde sunucuya ekleyin ve docker compose up -d komutunu yeniden çalıştırın:

services:
oleafly-server:
volumes:
- ./ca-bundle.pem:/etc/ssl/certs/ca-certificates.crt:ro

E-posta isteğe bağlıdır; başka her şey onsuz da çalışır. E-posta olmadan sunucunun adresini kişilere kendiniz gönderirsiniz ve Oleafly, her kişiyle paylaşılan projeleri Sizinle paylaşılanlar altında listeler.

Ayarlamak için sunucuya bir SMTP hesabı verin:

OLEAFLY_SMTP_URL=smtps://oleafly%40example.org:example-app-password@smtp.example.org:465
OLEAFLY_MAIL_FROM=Smith Lab <oleafly@example.org>

Ya iki satırı da ayarlayın ya da hiçbirini. Kullanıcı adı ve paroladaki özel karakterleri URL biçiminde yazın; örneğin @ için %40.

  • smtps://, baştan itibaren TLS kullanır; başka bir port belirtmedikçe 465 portunda.
  • smtp://, başka bir port belirtmedikçe 587 portunu kullanır ve ardından STARTTLS ile TLS’ye geçer. Posta sunucusu STARTTLS sunmuyorsa sunucu göndermez.
  • Aynı makinedeki bir e-posta aktarıcısı istisnadır: smtp://localhost, smtp://127.0.0.1 ve smtp://[::1] TLS olmadan gönderir.
  • Aynı özel ağdaki bir aktarıcı, ?tls=none eklediğinizde TLS’yi atlayabilir; örneğin smtp://mailpit:1025?tls=none. Bu durumda adres kullanıcı adı veya parola taşıyamaz, çünkü bunlar şifrelenmeden ağdan geçerdi. Yalnızca başka kimsenin o ağa erişemediğinden eminseniz kullanın.

Sunucu, posta sunucusunun sertifikasını sistemin güvenilen sertifikalarıyla karşılaştırır.

Altı tür e-posta vardır. Hesabı bulunan birine giden e-posta yalnızca o kişinin doğrulanmış adreslerine gider ve GitHub’ın noreply adresleri her zaman atlanır.

E-postaNe zaman gönderilir
Sunucuya eklendiBir yönetici, birini e-posta adresiyle izin listesine ekler. İçinde sunucunun adı, bir Oleafly’ye ekle bağlantısı ve sunucunun adresi bulunur. GitHub kullanıcı adıyla veya bir alan adı kuralıyla biri eklendiğinde hiçbir şey gönderilmez, çünkü sunucunun henüz onun adresi yoktur.
Proje paylaşıldıBir proje sahibi birini projeye ekler. İçinde proje başlığı, paylaşan kişi, rolü ve projeyi açan bir bağlantı, ayrıca bağlantı uygulamayı açmadığında işe yarayacak projenin web sayfası bulunur. Rolün sonradan değiştirilmesi hiçbir şey göndermez. Her kişi bunları Ayarlar → İş Birliği bölümündeki sunucu kartından kapatabilir.
Yeni cihazBir hesap başka bir cihazda oturum açar. İçinde cihazın adı, sistemi ve sunucunun saat dilimindeki saat, ayrıca o kişi değilse cihazın oturumunu kapatması için bir anımsatma bulunur. Yeni bir hesabın ilk cihazına e-posta gitmez. Saat dilimini seçmek için TZ ayarlayın, örneğin TZ=Europe/Berlin.
Konuk davetiBir proje sahibi bir konuğu davet eder. İçinde proje başlığı, davet eden kişi, bir Oleafly’ye ekle bağlantısı ve oturum açılacak adres bulunur. Onaylama açıksa, davet onaylandığında gönderilir.
BahsetmeBiri bir üyeyi yorumda veya yanıtta anar. İçinde onu anan kişi, proje ve dosya, yorumun yapıldığı metin ve yorumun kendisi, ayrıca yorumu Oleafly’de açan bir bağlantı bulunur. Yorum sunucuya ulaştıktan yaklaşık bir dakika sonra gönderilir ve o dakika içinde aynı kişiye yapılan bahsetmeler tek e-postada toplanır. Kimse kendi yorumları için veya açamadığı bir projeyle ilgili e-posta almaz ve bir yorumu düzenlemek aynı bahsetmeyi iki kez göndermez. Her kişi, Ayarlar → İş Birliği bölümündeki sunucu kartındaki Biri bir yorumda benden bahsettiğinde bana e-posta gönder seçeneğiyle bunları kapatabilir.
Oturum açma bağlantısıBiri, sunucunun oturum açma sayfasında bağlantı ister.

Yöneticiler, sunucu ayarlarındaki E-posta bildirimleri seçeneğiyle oturum açma bağlantıları dışındaki her türü durdurabilir. Oturum açma bağlantıları her zaman gider, çünkü kişiler onsuz oturum açamaz.

Yönetici konsolunda E-posta bölümünü açın. E-postanın açık olup olmadığını ve Kimden adresini gösterir; parolayı asla göstermez. Bir yönetici, kendi doğrulanmış adresine bir tane göndermek için Deneme e-postası gönder’i seçebilir. Sayfa, e-postanın gidip gitmediğini ya da posta sunucusunun ne yanıtladığını söyler.

E-posta kapalıyken sayfa, Oleafly’ye ekle bağlantısını ve sunucu adresini gösterir; böylece bunları kendiniz gönderebilirsiniz.

Gönderim, arkasındaki eylemi asla bekletmez. Sunucu e-postaları bellekteki bir kuyrukta tutar ve 30 saniye, 2 dakika, 10 dakika, 30 dakika ve 2 saat sonra yeniden dener. Başarısız her deneme sunucu günlüğünde bir uyarıdır ve E-posta sayfası en son hatayı gösterir. Son deneme de başarısız olursa sunucu bir hata kaydeder ve o e-postayı bırakır. Sunucu yeniden başladığında hâlâ bekleyen e-postalar kaybolur.

Kişiler, sunucunun e-postayla gönderdiği bir bağlantıyla da oturum açabilir; böylece bir GitHub veya OpenID Connect hesabına ihtiyaç duymazlar. Bunun için e-posta gerekir. Ardından bir yönetici, sunucu ayarlarındaki E-postayla oturum açma seçeneğini açar. Varsayılan olarak kapalıdır.

Kişi Oleafly’de E-posta ile devam et’i seçer, tarayıcıda adresini girer ve Bana bağlantıyı e-postayla gönder’i seçer. Bağlantı, onu isteyen bilgisayarda, 15 dakika boyunca ve yalnızca bir kez çalışır. Bağlantıyı açmak, üzerinde bir Oturum aç düğmesi bulunan bir sayfa gösterir. Bağlantıyı yalnızca açmak onu kullanmaz; dolayısıyla bağlantıları izleyen bir e-posta tarayıcısı onu tüketemez.

Kimin gireceğine yine erişim kurallarınız karar verir: o e-posta adresi için bir izin listesi girdisi, bir alan adı kuralı veya bir konuk daveti. GitHub kullanıcı adıyla yapılmış bir izin listesi girdisi e-posta bağlantısıyla eşleşmez. Sayfa, sunucu adresi içeri alsa da almasa da aynı şeyi söyler; böylece kimse sayfayı kullanarak kimin hesabı olduğunu bulamaz.

Bu seçeneği açmak, var olan hesapları da e-posta bağlantılarına açar. Bir bağlantı, o adresi doğrulanmış adres olarak barındıran hesapta oturum açar. Sunucu, bir hesap için bir sağlayıcının bildirdiği her doğrulanmış adresi saklar; yalnızca ana adresi değil. Kişi adresi sağlayıcıdan kaldırdıktan sonra bile sunucu adresi tutmaya devam eder. Örneğin GitHub, GitHub hesabındaki her doğrulanmış adresi bildirir. Dolayısıyla o adreslerden birinin e-postasını okuyabilen herkes, o hesaba e-postayla oturum açabilir. Açmadan önce, kişilerin hesaplarındaki her adresi hâlâ denetlediklerinden emin olun.

Bir adres birden fazla hesaba aitse bağlantı hiçbirinde oturum açmaz. O adrese sahip tek hesap askıya alınmışsa veya kaldırılmışsa, o kişiyi yeniden içeri alana kadar bağlantı reddedilir.

Sunucu, 15 dakikada bir e-posta adresine en fazla 3, bir IP adresine en fazla 100 bağlantı gönderir; böylece tek adresten 50 kişilik bir sınıfın tamamı oturum açabilir. OLEAFLY_EMAIL_LINKS_PER_ADDRESS ve OLEAFLY_EMAIL_LINKS_PER_IP bu sayıları değiştirir. Tek bir /64 ağındaki tüm IPv6 adresleri tek adres sayılır. E-postayla oturum açma seçeneğini kapatmak, önceden gönderilmiş bağlantıları geçersiz kılar.

Tarayıcı, oturum açtıktan sonra Oleafly’ye geri dönemiyorsa, örneğin kısıtlı bir bilgisayarda, kişiler kodla oturum açabilir. Ayar gerektirmez ve sunucudaki her oturum açma seçeneğiyle çalışır.

Oleafly, sunucunuzun adresinin ardından /auth/device ve sekiz harften oluşan bir kod gösterir. Kişi o adresi herhangi bir telefonda veya bilgisayarda açar, kodu yazar, sayfanın gösterdiği bilgisayar adını denetler ve oturum açar. Oturum açmanın, kodun yazıldığı tarayıcıda tamamlanması gerekir; bu yüzden başka birinin kendisine bağlantı olarak gönderdiği bir oturum açma sayfası kimseyi oturum açtırmaz.

Bir kod bir kez çalışır, 10 dakika sonra çalışmayı bırakır ve yalnızca onu isteyen Oleafly kopyası oturum açmayı tamamlayabilir. Dur, bu ben değildim bunu iptal eder. Bir IP adresi 10 dakikada 100 kod isteyebilir ve 10 yanlış kod yazabilir. Bu, tek bir adresi paylaşan 50 kişilik bir sınıf için yeterlidir ve OLEAFLY_DEVICE_CODES_PER_IP bunu değiştirir.

Oturum açmak içeri girmek için yeterli değildir. Kişiyi bir erişim kuralının içeri alması gerekir. Bunları yönetici konsolundaki Erişim kuralları bölümünden yönetin:

  • İzinli kişiler: bir kişiyi e-posta adresiyle veya GitHub kullanıcı adıyla, alacağı rolle birlikte ekleyin. Kullanıcı adları yalnızca GitHub için çalışır, çünkü diğer sağlayıcılar kişilere kendi kullanıcı adlarını seçme veya değiştirme imkânı verir. Sunucu e-posta gönderiyorsa, birini e-posta adresiyle eklemek ona sunucunun adresini ve bir Oleafly’ye ekle bağlantısı gönderir.
  • Alan adları: cs.example.edu gibi bir alan adındaki doğrulanmış bir e-posta adresi olan herkesin, seçtiğiniz rolle oturum açmasına izin verin.

Kişileri ekledikten sonra, Oleafly’de sunucuyu ekleyip oturum açabilirler.

Kişiler altında bir kişinin rolünü değiştirebilir, kişiyi askıya alabilir veya yeniden etkinleştirebilir, kaldırabilir ve cihazlarının oturumunu kapatabilirsiniz. Askıya alınan bir kişi hesabını korur ama siz yeniden etkinleştirene kadar eşitleyemez. Değişiklikleri kendi bilgisayarında kalır.

Kaldırdığınız bir kişi, bir alan adı kuralı adresini kapsasa ya da bir proje sahibi onu konuk olarak davet etse bile dışarıda kalır. Onu yeniden içeri almak için e-posta adresiyle veya kullanıcı adıyla tekrar ekleyin. Eski hesabını, sahip olduğu her projeyle birlikte geri alır.

Herkesin kullanabileceği bir sunucu için OLEAFLY_OPEN_SIGNUP=true ayarlayın ve sunucuyu yeniden başlatın. Bundan sonra sağlayıcılarınızdan biriyle oturum açan herkes, izinli kişiler listesinde bir kayıt ya da bir alan adı kuralı olmadan Üye rolüyle bir hesap alır. E-postayla oturum açma açıksa e-posta bağlantısı da aynı şekilde çalışır.

Açık kayıt yine de kaldırdığınız ya da askıya aldığınız kişileri ve doğrulanmış adresi kaldırılmış bir hesaba ait olan herkesi dışarıda tutar. Konuklara izin veriliyorsa, konuk daveti olan biri oturum açınca üye olur ve davet edildiği projeleri yine alır.

Açık kayıt ayrıca hesap başına limitleri açar: başka değerler ayarlamadıkça her hesap 100 MB depolayabilir, 50 paylaşılan projeye sahip olabilir ve saatte 300 yükleme yapabilir.

Yönetici konsolu, açık kaydın açık olup olmadığını göstermez. Sunucunun günlüğü bunu her başlangıçta yazar: “Open sign-up is on, so anyone who signs in gets an account as a member.” Üyeler bir proje paylaşırken birbirlerini arayabilir; bu yüzden açık bir sunucuda sunucu ayarlarındaki Üye dizini’ni kapatmayı düşünün.

Her kişinin, yöneticilerin ve sorumluların verdiği bir sunucu rolü vardır. Eklendiği her projede, o projenin sahibinin verdiği bir proje rolü de bulunur. Roller, proje rollerini listeler: Sahip, Düzenleyen, İnceleyen, Yorumcu ve Görüntüleyen.

Hiçbir sunucu rolü tek başına bir proje açmaz. Proje erişimi yalnızca projenin sahibinden gelir.

EylemYöneticiSorumluÜyeKonuk
Sunucuyu Oleafly’ye eklemekEvetEvetEvetEvet
Üye listesini görmekEvetEvetEvet, bir yönetici gizlemedikçeHayır
Proje paylaşmakEvetEvetEvetHayır
Güvenlik günlüğünü okumakEvetEvetHayırHayır
Sunucuya üye eklemekEvetEvetHayırHayır
Sorumlu atamakEvetHayırHayırHayır
Sunucu ayarlarını değiştirmekEvetHayırHayırHayır
Depolama alanını boşaltmak için proje silmekEvetHayırHayırHayır
Birinin cihazının oturumunu kapatmakEvetEvet, ama diğer yöneticilerin veya sorumluların cihazları hariçYalnızca kendi cihazlarıYalnızca kendi cihazları
Depolanan projeleri doğrudan sunucu erişimiyle okumakUygulamadan yapılamazUygulamadan yapılamazUygulamadan yapılamazUygulamadan yapılamaz

En son satır en önemlisidir. Projeler sunucuda şifrelenmez; dolayısıyla makineyi kim çalıştırıyorsa, rolü her ne olursa olsun, depolanan her projeyi okuyabilir. Oleafly, yönetici dahil hiçbir rola bunu uygulamadan yapma imkânı vermez. Bir yönetici depolama alanını boşaltmak için bir projeyi sildiğinde, projenin sahibine ve üyelerine bildirilir ve kendi kopyaları kendi bilgisayarlarında kalır.

Konuk, sunucunuzun dışından gelen ve bir proje sahibinin bir projeye davet ettiği kişidir; örneğin başka bir üniversitedeki bir yazarkadaşınız. Konuklar yalnızca davet edildikleri projeleri görür.

Yeni bir sunucuda konuklar kapalıdır. Bir yönetici, sunucu ayarlarındaki Konuklara izin ver seçeneğiyle açar. Konukları önce onayla varsayılan olarak açıktır; bu yüzden her davet, çalışmadan önce bir yönetici veya sorumlu tarafından onaylanır. Davetlerin hemen çalışmasını istiyorsanız bu seçeneği kapatın. Bir yönetici veya sorumlu davet gönderdiğinde davet hemen onaylanır.

Konuklara izin ver’i daha sonra kapatırsanız, sahipler yeni davet gönderemez ve kullanılmayan davetler çalışmayı bırakır. Oturum açmış konuklar, bir sahip onları projeden kaldırana ya da siz onları Kişiler altından kaldırana kadar projelerini korur.

Yalnızca projenin sahibi, projeye konuk davet edebilir; bunu projenin Paylaş iletişim kutusundan yapar.

  • Bir davet tek bir adres ve tek bir proje içindir ve 14 gün sonra sona erer.
  • Bir kişi saatte en fazla 20 davet gönderebilir.
  • Onaylama açıkken davet, Kişiler’in en üstündeki Bekleyen konuklar altında bekler. Yöneticiler ve sorumlular daveti orada onaylar, reddeder veya geri çeker. Sahip de geri çekebilir.
  • Sunucu e-posta gönderiyorsa ve E-posta bildirimleri açıksa konuk bir davet e-postası alır. Aksi halde Oleafly, sahibe kendisinin göndermesi için bir Oleafly’ye ekle bağlantısı verir.
  • Projede sunucunun izin verdiği kadar kişi zaten varsa davet bekler ve biri ayrıldıktan sonra kişinin bir sonraki oturum açışında çalışır.

Konuk, sunucuyu ekler ve sunucuya davet edilen adresi doğrulanmış adres olarak veren her seçenekle oturum açar: GitHub, bir OpenID Connect sağlayıcısı veya bir e-posta bağlantısı. Doğrulanmamış bir adres sayılmaz. İlk oturum açma bir konuk hesabı oluşturur ve o adresin davet edildiği her projeyi açar.

Konuklar, davet edildikleri projeleri açabilir ve derleyebilir, rolleri izin veriyorsa düzenleyebilir ve kendi cihazlarının oturumunu kapatabilir. Üye dizinini veya kimsenin e-posta adresini göremez, proje paylaşamaz, başka kişileri davet edemez veya bir projeye bağlantısıyla katılamaz. Bir konuğa başka bir proje vermek için o projenin sahibi aynı adresi davet eder.

Bir konuk son projesinden kaldırıldığında ya da projeyi bıraktığında sunucu erişimini sonlandırır. Hesabı kaldırır ve her cihazın oturumunu kapatır. Yeni bir davet aynı hesabı geri getirir. Bir konuğun hâlâ projesi varken onu Kişiler altından kaldırırsanız, yeni bir davet onu geri getirmez.

Bir sahip, bir kişiyi projeden kaldırdığında, konuk olsun ya da olmasın, o kişi bağlantıyla paylaşım açık olsa bile projenin bağlantısıyla geri gelemez. Her deneme güvenlik günlüğünde görünür. Kişiyi yeniden içeri almak için sahip tekrar ekler ya da konuksa yeni bir davet gönderir. Bir projeyi kendi isteğiyle bırakan kişi yine de projenin bağlantısıyla yeniden katılabilir.

Tarayıcı erişimi açıkken kişiler kendileriyle paylaşılan projeleri, Oleafly’yi kurmadan bir web tarayıcısında açabilir. Düzenler, değişiklik önerir, yorum yapar, sohbet eder ve derlenen en yeni PDF’i okurlar. Ne gördüklerini Tarayıcıda çalışma sayfası anlatır.

OLEAFLY_WEB=true ayarlayın ve sunucuyu yeniden başlatın. Yayımlanan kapsayıcı imajı tarayıcı uygulamasını içerir. Onu içermeyen bir derleme günlüğe şunu yazar: “OLEAFLY_WEB is true, but this build of Oleafly Server has no browser app, so browser access stays off.”

Açıldıktan sonra:

  • Tarayıcı uygulaması, sunucunuzun adresinin sonuna /web/ eklenen yerdedir; örneğin https://collab.example.org/web/. /p/ altındaki her projenin sayfası da bir Tarayıcıda aç bağlantısı alır.
  • Kişiler /web/sign-in adresinde, Oleafly’dekiyle aynı sağlayıcılar ve e-posta bağlantılarıyla oturum açar; kimin gireceğine aynı erişim kuralları karar verir. Bir tarayıcıda oturum 30 gün açık kalır.
  • Her tarayıcı o hesabın bir cihazı sayılır ve “Safari on macOS” gibi bir ad alır. Kişinin cihaz listesinde ve güvenlik günlüğünde görünür; tarayıcının oturumunu kapatmak, o tarayıcıdaki oturumu sonlandırır.
  • Tarayıcı /web/ws adresine bir WebSocket ile bağlanır ve daha yavaş bir yolu yoktur; bu yüzden vekil sunucunuz WebSocket yükseltmelerini oraya geçirmelidir. Caddy ile Ters vekil sunucu arkasında bölümündeki nginx ve Apache örnekleri bunu zaten yapar.
  • Kişilerin okuduğu PDF, bir sahibin ya da düzenleyenin Oleafly’de derlediği en yeni PDF’tir. Oraya nasıl ulaştığını Derlenmiş PDF’ler açıklar.

Tarayıcı uygulaması başka bir sitedeki bir çerçevenin içinde gösterilemez. Kişilerin avatar resimlerini yüklemek dışında yalnızca sunucunuza bağlanır.

Yönetici konsolu, Oleafly içinden tek bir sunucuyu yönetmek için kullanılan bir penceredir. Yöneticiler ve sorumlular açabilir. Ayarlar → İş Birliği bölümünde sunucunun kartındaki Yönetici konsolunu aç’ı ya da Sunucuyu yönet’in en üstündeki düğmeyi seçin. Her sunucu kendi penceresini alır.

BölümNe gösterir, ne yapar
Genel bakışSunucunun sağlıklı olup olmadığı; kaç kişi, cihaz ve projeye sahip olduğu; kimin çevrimiçi olduğu; ne kadar depolama alanı kullandığı; e-posta ve oturum açma seçenekleri ve ayarları bir bakışta. Sunucunun oturum açma seçeneği yoksa Kimse oturum açamıyor, veri klasörüne yazılamıyorsa Sunucu dosyaları kaydedemiyor uyarısını gösterir.
KişilerOturum açmış herkes. Rolleri değiştirin, kişileri askıya alın veya kaldırın, cihazlarının oturumunu kapatın. Onay bekleyen konuk davetleri en üsttedir.
Erişim kurallarıİzinli kişiler listesi ve alan adı kuralları.
ProjelerSunucuda paylaşılan her proje; sahibiyle, kişi sayısıyla, boyutuyla ve son etkinliğiyle. Başlığa veya sahibe göre arayın, yalnızca paylaşılan, arşivlenmiş veya karşıya yüklenmekte olan projeleri gösterin, bir projeyi arşivleyin veya geri yükleyin.
Sunucu ayarlarıSunucu ayarları.
E-postaE-postanın ayarlanmış olup olmadığı, Kimden adresi ve son hata. Buradan bir deneme e-postası gönderin.
Güvenlik günlüğüOturum açmalar ve reddedilen oturum açmalar, cihazlar, kişiler, ayarlar, projeler ve konuklar. Her girdi kimin, ne zaman ve hangi IP adresinden yaptığını söyler; ayrıntı olarak proje, kullanılan oturum açma seçeneği veya bir oturum açmanın neden reddedildiği gibi bilgiler bulunur.
Bağlantı denetimleriBağlantıyı test et düğmesindekiyle aynı denetimler; bilgisayarınızdan sunucuya çalıştırılır.

Sorumlular her bölümü kullanabilir; ama kimseyi yönetici veya sorumlu yapamaz, başka bir yöneticinin veya sorumlunun cihazlarını göremez veya oturumunu kapatamaz, depolama kullanımını göremez, projeleri arşivleyemez veya geri yükleyemez, sunucu ayarlarını değiştiremez veya deneme e-postası gönderemez. Yöneticiler tümünü yapabilir.

Bir projeyi arşivlemek, onu herkes için paylaşmayı durdurur. Kişiler onu eşitlemeyi bırakır ve kendi kopyalarını korur; sunucu, bir yönetici önce geri yüklemedikçe onu OLEAFLY_ARCHIVE_DAYS gün sonra siler. Geri yüklemek, onu aynı kişilerle yeniden paylaşır. İlk karşıya yüklemesini hiç tamamlayamamış bir proje geri yüklenemez. İkisi de güvenlik günlüğünde görünür.

Konsol asla bir proje açmaz. Başlıkları, sahipleri ve boyutları gösterir; içindekilerin hiçbirini göstermez.

Bunlar sunucudaki herkese uygulanır. Yalnızca yöneticiler değiştirebilir.

AyarNe yapar
Konuklara izin verÜyeler, sunucu dışından kişileri sahip oldukları projelere davet edebilir.
Konukları önce onaylaBir sorumlu veya yönetici, her konuk davetini çalışmadan önce onaylar.
Üye diziniÜyeler, bir proje paylaşırken birbirlerini adıyla arayabilir.
Dizinde e-posta adreslerini gösterÜyeler, birini aradıklarında birbirlerinin e-posta adreslerini görür.
Bağlantıyla paylaşıma izin verProje sahipleri, herhangi bir üyenin projeyi bağlantısından açmasına izin verebilir.
Herkese açık not bağlantılarına izin verÜyeler, bir notun salt okunur kopyasını, oturum açmadan herkesin açabileceği bir bağlantıda yayımlayabilir. Varsayılan olarak kapalıdır. Kapatmak, siz yeniden açana kadar yayımlanmış her bağlantıyı durdurur. Salt okunur bir kopya yayımlayın bölümüne bakın.
Proje erişim günlüklerine izin verProje sahipleri, projesini kimin açtığının günlüğünü tutabilir.
Yorumlara izin verPaylaşılan projelerdeki kişiler metne yorum yapabilir ve yanıt verebilir. Kapatmak, yorumları her yerde gizler ama saklanmalarını sürdürür.
E-posta bildirimleriSunucunun oturum açma bağlantıları dışındaki e-postalarını herkes için durdurmak için kapatın.
E-postayla oturum açmaKişiler, e-posta adreslerine gönderilen bir bağlantıyla oturum açabilir. Bu, sunucunun e-posta ayarlarını gerektirir.
Görsel önizlemesi

Yapay zekâ yanıtları yüklenemedi

Yeniden deneyin ya da dokümanlarda arama yapın.