BotreamDokümanlar Web sitesi English v0.1.1

Kullanıcılar ve roller

Botream'de oturum açan her kişinin bir veya daha fazla role sahip bir kullanıcı hesabı vardır. Rol bir yetkiler kümesidir; kullanıcı, rollerinden herhangi birinin izin verdiği her şeyi yapabilir. Kişinin hangi sayfaları göreceğini ve sunucunun ona neler yapma izni vereceğini yetkiler belirler.

Roller

Botream dört rolle başlar. Yöneticiler bunları değiştirebilir ve Administration → Roles altında kendi rollerini ekleyebilir.

Rol Tipik kullanıcı Yetkiler
Admin Platform yöneticisi Her zaman tüm yetkiler (sonraki sürümlerde eklenenler de).
Developer RPA geliştiricisi Edit tasks, Debug tasks, Run tasks, See all runs, Manage schedules, Manage triggers, Manage queues, Manage global values, Use every vault.
Runner Operatör Run tasks.
User İş kullanıcısı Yok: yalnızca gösterge paneli ve kendi Inbox'ı.

Admin yerleşik bir roldür: yeniden adlandırılamaz, değiştirilemez ve silinemez; en az bir etkin kullanıcı her zaman bu role sahip olur. Developer, Runner ve User sıradan rollerdir: adlarını ve yetkilerini değiştirebilir, artık kimsede yoklarsa silebilirsiniz.

Yetkiler

Bir rolün sahip olabileceği yetkiler şunlardır. Sunucu bunları her istekte denetler ve bir değişiklik hemen geçerli olur: kişilerin yeniden oturum açması gerekmez. Menüleri, Botream sekmesine döndüklerinde (ya da birkaç dakika içinde) güncellenir.

Grup Yetki İzin verdiği
Tasks Edit tasks Görev ve klasör oluşturma, düzenleme ve silme; öğe yakalama, kaydetme, AI üreticisini ve iyileştirme önerilerini kullanma.
Tasks Debug tasks Görevlerde hata ayıklama, yerel kopyaları ve seçili blokları düzenleyiciden çalıştırma.
Tasks Run tasks Run iletişim kutusundan veya API üzerinden çalıştırma başlatma, duraklatma ve durdurma; kendi çalıştırmalarını, kuyrukları ve kendisine erişim izni verilen kasaları görme.
Tasks Release task locks Başka bir kullanıcının çektiği görevdeki kilidi kaldırma (yerel değişiklikleri atılır).
Runs and automation See all runs Yalnızca kendi başlattıklarını değil, tüm çalıştırmaları ve canlı günlüklerini görme.
Runs and automation Manage schedules Zamanlamaları oluşturma, değiştirme, silme ve çalıştırma.
Runs and automation Manage triggers Olay tetikleyicilerini oluşturma, değiştirme ve silme.
Runs and automation Manage queues İş kuyruklarını oluşturma, değiştirme ve silme; öğe ekleme, yeniden deneme ve silme.
Runs and automation Manage global values Görevlerin kullandığı genel değerleri ($Global.Name$) görme ve değiştirme.
Credentials Use every vault Erişim izni olmadan tüm kasaları okuma ve kimlik bilgilerini kullanma.
Credentials Manage vaults Kasaları, kimlik bilgilerini ve bunları kimin kullanabileceğini oluşturma, değiştirme ve silme.
Administration Manage users and roles Kullanıcıları, rollerini ve rollerin kendisini oluşturma ve değiştirme.
Administration Manage agents Ajanları ve ajan gruplarını, kayıt belirtecini, yükleyicileri ve güncellemeleri onaylama ve değiştirme.
Administration Manage settings Sistem ayarlarını ve dizin ile oturum açmayı değiştirme.
Administration See the audit log Denetim kaydında arama.
Administration See system health SQL Server, zamanlayıcı ve süreç sağlığı ayrıntılarını görme.
Administration See performance Performans raporunu görme ve dışa aktarma, iş birimlerini yönetme.

Oturum açan herkes, rolleri ne olursa olsun gösterge panelini ve kendi Inbox'ını görür.

Sayfalar ve yetkiler

Menü yalnızca kullanıcının yetkilerinin açtığı sayfaları gösterir:

Sayfa Yetki (herhangi biri)
Dashboard, Inbox Herkes (Run tasks veya See all runs olmadan gösterge paneli, çalıştırma rakamları olmayan bir karşılama sayfasıdır)
Tasks, Selector health Edit tasks
Executions Run tasks, See all runs
Schedules Manage schedules
Queues Run tasks, Manage queues
Vaults Run tasks, Use every vault, Manage vaults
Administration → Users, Roles Manage users and roles
Administration → Agents Manage agents
Administration → Settings Manage settings
Administration → Performance See performance
Administration → Audit log See the audit log
Administration → System health See system health

Rolleri yönetme

Administration → Roles'u açın. Liste her rolü açıklamasıyla, kaç yetkisi olduğuyla (Admin: All permissions), dizin gruplarıyla ve kaç etkin kullanıcının bu role sahip olduğuyla gösterir.

  • New role rol formunu açar: Name (benzersiz, en fazla 50 karakter), Description, yukarıdaki tablodaki gibi gruplanmış Permissions (bir grubun tümünü işaretlemek için grubun kutusunu işaretleyin; her yetki neye izin verdiğini söyler) ve Directory groups (bkz. Dizin ile oturum açma).
  • Edit, aynı formu role sahip kullanıcılarla birlikte açar. Admin için yalnızca açıklama ve dizin grupları değiştirilebilir.
  • Delete, kimsenin sahip olmadığı bir rolü kaldırır (devre dışı kullanıcılar da sayılır). Role verilen kasa erişimi de onunla birlikte sona erer. Admin silinemez.

İpucu: Rolleri kişilerin yaptığı işe göre oluşturun; örneğin Run tasks yetkisiyle Finans operatörü rolü oluşturup bir kasayı bu role verin. Görev de geliştiren biri ikinci rol olarak Developer alır.

Kullanıcıları yönetme

Administration → Users'ı açın. Liste her kullanıcının adını, kullanıcı adını ve e-postasını, Roles, Status (Active veya Inactive) ve Last login değerlerini gösterir. Ada, kullanıcı adına veya e-postaya göre arama yapın.

Kullanıcı ekleme

Add user'a tıklayın ve New user iletişim kutusunu doldurun:

Alan Kurallar
Username En az 3 karakter: harfler, rakamlar, ., _ ve -. Daha sonra değiştirilemez.
Email Geçerli bir adres; her adres yalnızca bir kullanıcıya ait olabilir.
First name, Last name İsteğe bağlı.
Password Aşağıdaki parola ilkesine bakın.
Roles Bir veya daha fazla rol. Kullanıcı, bunlardan herhangi birinin izin verdiği her şeyi yapabilir.
Active Kullanıcının oturum açıp açamayacağı.

Kullanıcıyı düzenleme

Satırın menüsünde Edit'i seçin veya satıra çift tıklayın. Geçerli parolayı korumak için New password alanını boş bırakın.

Rol değişikliği kullanıcının bir sonraki tıklamasında geçerli olur; oturumu açık kalır. Bir kullanıcının parolasını değiştirmek ya da onu devre dışı bırakmak, kullanıcının tüm cihazlardaki oturumunu anında kapatır.

Not: Admin rolünü kendinizden kaldıramaz veya kendi hesabınızı devre dışı bırakamazsınız; ayrıca en az bir etkin kullanıcı her zaman Admin rolüne sahip olmalıdır.

Kullanıcıyı devre dışı bırakma

Satırın menüsünde Deactivate'i seçin. Kullanıcının oturumu hemen kapatılır ve artık oturum açamaz. Kullanıcılar hiçbir zaman silinmez: başlattıkları çalıştırmalar ve denetim kayıtları gibi geçmişleri olduğu gibi kalır. Yeniden giriş yapabilmelerini sağlamak için kullanıcıyı düzenleyin ve Active'i açın.

Dizin ile oturum açma (Active Directory / LDAP)

Kullanıcılar, Botream'in tuttuğu bir parola yerine Active Directory (veya başka bir LDAP dizini) kullanıcı adı ve parolalarıyla oturum açabilir. Bunu Administration → Settings → Directory (LDAP) altında ayarlayın:

Ayar Örnek Notlar
Sign in with directory accounts açık Yerel hesaplar çalışmaya devam eder.
Directory server ldaps://dc01.company.local:636 ldaps:// (şifreli) önerilir. Boşlukla ayrılmış birden fazla sunucu: biri çalışmazsa sonraki denenir.
Search base DC=company,DC=local Kullanıcıların arandığı yer.
Sign-in domain company.local Active Directory: ali, ali@company.local olarak oturum açar.
Lookup account ve parolası CN=svc-botream,OU=Service,DC=company,DC=local Active Directory'de isteğe bağlı; diğer dizinler için gereklidir.
User name attribute sAMAccountName Diğer dizinlerin çoğunda uid.

Dizin kullanıcılarının hangi rolleri alacağı rollerin üzerinde belirlenir: Administration → Roles altında bir rolü açın ve Directory groups alanına grup adlarını (örneğin Botream Admins) veya tam DN'leri girin. *, rolü her dizin kullanıcısına verir.

  • Kullanıcılar ali, COMPANY\ali veya ali@company.local olarak oturum açar. Parolayı dizin denetler; Botream onu asla saklamaz.
  • İlk oturum açma Botream hesabını oluşturur (ad ve e-posta dizinden gelir). Her oturum açmada roller gruplardan yeniden belirlenir: kişi, dizin grupları kendi gruplarından birini içeren her rolü alır (Active Directory'de iç içe gruplar dahil). Hiç rol almayan biri oturum açamaz.
  • Users sayfasında dizin hesapları Directory etiketi taşır. Parolaları ve rolleri Botream'de değiştirilemez; Deactivate onları dışarıda tutar.
  • Yerel bir hesap, aynı adlı bir dizin hesabı tarafından asla ele geçirilmez.
  • Ayar kartındaki Test sign-in, kayıtlı ayarlarla bir hesabı dener ve hiçbir şey oluşturmadan gruplarını ve alacağı rolleri gösterir.

Not: Rollerin dizin grupları olmadan önce gruplar dört ayardı (Admin, Developer, Runner ve User groups). Yükseltme bunları bu dört rolün dizin gruplarına taşır.

İpucu: Dizine ulaşılamadığında da oturum açabilmek için bir yerel Admin hesabı tutun.

Parola ilkesi

Parolalar:

  • 8 ile 128 karakter uzunluğunda olmalı,
  • en az bir harf içermeli,
  • en az bir rakam içermelidir.

Parolalar yalnızca bcrypt özetleri olarak saklanır; yöneticiler dahil hiç kimse bunları okuyamaz.

Oturum açma ve oturumlar

  • Kullanıcı adınız ve parolanızla oturum açın. Başarısız bir oturum açma denemesi, kullanıcı adının var olup olmadığını belirtmez.
  • Oturum açma denemeleri dakika başına sınırlandırılır (varsayılan olarak 10); böylece parolalar hızlıca tahmin edilemez.
  • Oturum açtıktan sonra tarayıcı kısa ömürlü bir erişim belirteci (varsayılan olarak 15 dakika) ve bunu arka planda yenileyen bir yenileme çerezi (varsayılan olarak 7 gün) tutar. Botream'i kullandığınız sürece, sekmeler arasında da oturumunuz açık kalır.
  • Kullanıcı menüsündeki (sağ üst) Sign out oturumu sonlandırır.
  • Daha önce kullanılmış bir yenileme belirteci yeniden sunulursa Botream onu çalınmış kabul eder: o kullanıcının tüm oturumlarını sonlandırır ve olayı denetim kaydına işler.

Belirteç ömürleri ve oturum açma hız sınırı, sunucunun yapılandırma dosyasının bir parçasıdır; bkz. Sunucuyu kurma.

Denetim

Oturum açmalar (başarılı ve başarısız), oturum kapatmalar, yenileme belirtecinin yeniden kullanımı, kullanıcı oluşturma, değiştirme (önceki ve sonraki rollerle) ve devre dışı bırakma ile oluşturulan, değiştirilen ve silinen roller denetim kaydına işlenir. Başarısız oturum açmalar nedeni içerir; örneğin bilinmeyen bir kullanıcı, yanlış bir parola, hiç rol almayan bir dizin hesabı veya ulaşılamayan bir dizin. Ayarlar sayfasındaki Test sign-in de kaydedilir.

Botream 0.1.1 · Oluşturulma 2026-10-14