# 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ı

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](#sign-in-by-email-link), 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

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

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:

   ```ini
   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.com | `https://gitlab.com` |
| Kendi yönettiğiniz GitLab | GitLab adresiniz, örneğin `https://gitlab.example.edu` |
| Google | `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

İ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

Ü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:

```sh
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:

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

## 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:

```ini
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.

### 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

[Yönetici konsolunda](#admin-console) **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

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

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](#email) 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

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ı

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.

### 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](/docs/collaboration/server-operations/#limits-per-account) 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

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](/docs/collaboration/sharing/#roles), 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

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

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

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

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

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

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](/docs/collaboration/browser/) 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](/docs/collaboration/server-operations/#behind-a-reverse-proxy) 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](/docs/collaboration/server-operations/#compiled-pdfs) 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

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ı](#server-settings). |
| **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ı

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](/docs/notes/projects-and-sharing/#publish-a-read-only-copy) 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. |
