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.
Oturum açma sağlayıcıları
Bölüm başlığı “Oturum açma sağlayıcıları”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.
GitHub
Bölüm başlığı “GitHub”- 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.
- 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. - Uygulamayı kaydet’i seçin. İstemci Kimliği’ni kopyalayın, ardından Yeni istemci parolası oluştur’u seçip parolayı kopyalayın.
OLEAFLY_GITHUB_CLIENT_IDveOLEAFLY_GITHUB_CLIENT_SECRETdeğ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
Bölüm başlığı “OpenID Connect”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.
-
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.envdosyasındaUNIVERSITYsatırlarını yeniden adlandırın ya da ikinci bir blok ekleyin. -
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/gitlabolarak ayarlayın veopenid,emailveprofilekapsamlarına izin verin. -
Sağlayıcının bilgilerini ekleyin:
OLEAFLY_OIDC_GITLAB_ISSUER=https://gitlab.comOLEAFLY_OIDC_GITLAB_CLIENT_ID=example-client-idOLEAFLY_OIDC_GITLAB_CLIENT_SECRET=example-client-secretOLEAFLY_OIDC_GITLAB_LABEL=GitLab -
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.com | https://gitlab.com |
| Kendi yönettiğiniz GitLab | GitLab adresiniz, örneğin https://gitlab.example.edu |
https://accounts.google.com | |
| Microsoft Entra ID | https://login.microsoftonline.com/ ve ardından kiracı kimliğiniz ile /v2.0 |
| Keycloak | https://sso.example.edu/realms/ ve ardından realm adı |
Doğrulanmış e-posta adresleri
Bölüm başlığı “Doğrulanmış e-posta adresleri”İ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.
Üniversitenizin imzaladığı sertifikalar
Bölüm başlığı “Üniversitenizin imzaladığı sertifikalar”Ü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:
cat /etc/ssl/certs/ca-certificates.crt university-ca.pem > ca-bundle.pemchmod 644 ca-bundle.pemArdı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:roE-posta
Bölüm başlığı “E-posta”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:465OLEAFLY_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.1vesmtp://[::1]TLS olmadan gönderir. - Aynı özel ağdaki bir aktarıcı,
?tls=noneeklediğinizde TLS’yi atlayabilir; örneğinsmtp://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.
Sunucunun gönderdikleri
Bölüm başlığı “Sunucunun gönderdikleri”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-posta | Ne zaman gönderilir |
|---|---|
| Sunucuya eklendi | Bir 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 cihaz | Bir 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 daveti | Bir 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. |
| Bahsetme | Biri 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.
Test edin
Bölüm başlığı “Test edin”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.
Posta sunucusu çalışmadığında
Bölüm başlığı “Posta sunucusu çalışmadığında”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.
E-posta bağlantısıyla oturum açma
Bölüm başlığı “E-posta bağlantısıyla oturum açma”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.
Kodla oturum açma
Bölüm başlığı “Kodla oturum açma”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.
Erişim kuralları
Bölüm başlığı “Erişim kuralları”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.edugibi 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.
Açık kayıt
Bölüm başlığı “Açık kayıt”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.
Roller ve izinler
Bölüm başlığı “Roller ve izinler”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.
| Eylem | Yönetici | Sorumlu | Üye | Konuk |
|---|---|---|---|---|
| Sunucuyu Oleafly’ye eklemek | Evet | Evet | Evet | Evet |
| Üye listesini görmek | Evet | Evet | Evet, bir yönetici gizlemedikçe | Hayır |
| Proje paylaşmak | Evet | Evet | Evet | Hayır |
| Güvenlik günlüğünü okumak | Evet | Evet | Hayır | Hayır |
| Sunucuya üye eklemek | Evet | Evet | Hayır | Hayır |
| Sorumlu atamak | Evet | Hayır | Hayır | Hayır |
| Sunucu ayarlarını değiştirmek | Evet | Hayır | Hayır | Hayır |
| Depolama alanını boşaltmak için proje silmek | Evet | Hayır | Hayır | Hayır |
| Birinin cihazının oturumunu kapatmak | Evet | Evet, 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 okumak | Uygulamadan yapılamaz | Uygulamadan yapılamaz | Uygulamadan yapılamaz | Uygulamadan 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.
Konuklar
Bölüm başlığı “Konuklar”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.
Konukları etkinleştirme
Bölüm başlığı “Konukları etkinleştirme”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.
Davetler
Bölüm başlığı “Davetler”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 neler yapabilir
Bölüm başlığı “Konuklar neler yapabilir”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.
Kaldırma kalıcıdır
Bölüm başlığı “Kaldırma kalıcıdır”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
Bölüm başlığı “Tarayıcı erişimi”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ğinhttps://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-inadresinde, 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/wsadresine 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
Bölüm başlığı “Yönetici konsolu”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üm | Ne 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şiler | Oturum 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ı. |
| Projeler | Sunucuda 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-posta | E-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ı denetimleri | Bağ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.
Sunucu ayarları
Bölüm başlığı “Sunucu ayarları”Bunlar sunucudaki herkese uygulanır. Yalnızca yöneticiler değiştirebilir.
| Ayar | Ne yapar |
|---|---|
| Konuklara izin ver | Üyeler, sunucu dışından kişileri sahip oldukları projelere davet edebilir. |
| Konukları önce onayla | Bir 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 ver | Proje 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 ver | Proje sahipleri, projesini kimin açtığının günlüğünü tutabilir. |
| Yorumlara izin ver | Paylaşı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 bildirimleri | Sunucunun oturum açma bağlantıları dışındaki e-postalarını herkes için durdurmak için kapatın. |
| E-postayla oturum açma | Kişiler, e-posta adreslerine gönderilen bir bağlantıyla oturum açabilir. Bu, sunucunun e-posta ayarlarını gerektirir. |