Yönetim alanı

Yönetim alanı (/management) kurulum operatörünün kendi yüzeyidir. Girişi ürün hesaplarından ayrıdır - operatör hesabı ürün sayfalarını açamaz, tersi de geçerlidir.

Genel bakış

Açılış sayfası kurulumun ne olduğunu ve ne yaptığını gösterir: kullanıcı/çalışma alanı/proje sayıları, isteğe bağlı çalışma alanı filtresiyle modül durum kartları (ArchPilot, ArchScan, Kod Sağlığı), dağılım grafikleri, çalışma temposu göstergesi, son 28 günün etkinliği ve yapılandırıldıysa güncelleme kontrolü.

Çalışma alanları

Kurulumdaki her çalışma alanı, tenant başına bir detay sayfasıyla:

üyeler (LDAP ile giriş yapan hesaplar rozetlidir - parolaları dizinde yaşar),
projeler (kimlik bilgisi olmayan proje işaretlenir: hiç taranmayan depoyu açıklar),
bekleyen davetler, bitiş tarihleriyle,
davet aç/kapa anahtarı - kapatınca o çalışma alanının üyelerinde davet eylemi kaybolur ve Api çağrıyı kimden gelirse gelsin reddeder. Çalışma alanının kendi yöneticileri kaldıramaz.
Modül verisini sıfırla kartı: modülleri seçin (ArchScan, ArchPilot, ArchSecurity, Uyumluluk, Git Sağlığı, mühendislik analitiği, asistan geçmişi); bu çalışma alanındaki sonuçları (koşular, taramalar, bulgular, olgular) fiziksel olarak silinir. Kurallar, entegrasyonlar, kimlik bilgileri ve üyeler kalır; bir sonraki tarama veya eşitleme sıfırdan başlar. Geri alınamaz, bu yüzden önce sorar.

Çalışma alanı modül ekranlarındaki ArchScan koşuları ve ArchPilot incelemeleri aynı amaçla bir Sil düğmesi taşır: sayılmaması gereken bir deneme koşusu bulgularıyla birlikte kalıcı olarak kaldırılır.

Çalışma alanı detayına iki sayfa daha bağlıdır:

Yapılandırma - tenant’ın kurulumunun yalnızca kendi üyelerinin görebildiği yarısı: Git sağlayıcıya hangi kimlik bilgileriyle ulaştığı (çalışma alanına ait ve kurulumdan paylaşılanlar, her biri son dört karakteri ve kaç projede kullanıldığıyla), nelere bağlı olduğu (Jira, Trello, Sonar, Slack, Teams, JMeter, Argo CD, Kubernetes, Dynatrace, New Relic), tarama zamanlamaları, her birinin verdiği yetkilerle özel rolleri ve proje grupları. Salt okunur ve orada hiçbir sır okunamaz.
Proje detayı - proje adına tıklayın: varsayılan dal, grup, kimlik bilgisi ve bitiş tarihi, runner jetonunun son dört karakteri ve yaşı, webhook sırrının tanımlı olup olmadığı, tarama kapsamı dahil/hariç kalıpları, mimari yaklaşımlar, kural istisnaları, sürüm takibi ve projeyi kimin kaydettiği. Jeton ve webhook sırrı özetlenerek saklanır, okunamaz.

Silinen bir çalışma alanı listeden geri alınabilir. Satırlar hiç kaldırılmadığı için projeleri ve geçmişiyle geri gelir.

Modül ekranları

Her modülün kurulum geneli ekranı vardır ve çoğunda bir çalışma alanını kendi üyelerinin gördüğü haliyle açarsınız - aynı panolar, aynı bulgular, aynı raporlar; eylem tenant’a aitse (dışa aktarma, senkron düğmeleri, yorum kapatma) salt okunur.

ArchScan - kurulum panosu, çalışma alanına inip koşular ve tam raporlar; Kod Sağlığı ve Bağımlılıklar aynı sekme şeridinde, aynı isteğe bağlı çalışma alanı/proje filtresiyle.
ArchPilot - benimseme ve sonuç (geçti / dikkat / kaldı), en çok tetiklenen kurallar ve yorumlarının ne sıklıkla dikkate alındığı, çalışma alanı başına incelenen MR listeleri ve bulgu detayı.
ArchSecurity - şiddet dağılımı, çalışma alanı başına güvenlik panosu ve çerçeve raporları (OWASP, PCI DSS, DISA STIG, CASA ASVS), GitLab/SonarQube’dan aynalanan açık bulgular dahil - bizimkilerin yanında sayılır, asla birleştirilmez.
Uyumluluk, Git Sağlığı, Servis Kataloğu - tenant ekranlarının kurulum geneli karşılıkları; hepsi çalışma alanı ve projeyle daraltılabilir.

Her yerde hiç taranmamış, bilinmiyor olarak raporlanır - sağlıklı olarak da sıfır olarak da değil.

Uyumluluk ve Git Sağlığı ekranlarında operatör, bir proje için çalışma alanı adına tarama da kuyruğa alabilir. Koşu operator tarafından tetiklenmiş olarak kaydedilir ve hiçbir tenant kullanıcısına atfedilmez; böylece bir destek işlemi müşterinin yaptığı bir şey gibi görünmez.

Ayarlar

Tek sekmeli ekran: Lisans (lisansın tanıdığı limitlerle), E-posta (SMTP/Postmark, test gönderimiyle), Rapor e-postaları, Yapay zeka asistanı (bkz. Archito, asistan), Kayıt & davetler - kayıt anahtarı, davet edilebilir e-posta alan adları ve kurulum geneli iki adımlı doğrulama anahtarı -, Pano, Modüller (modülü kapatmak zamanlı job’larını da durdurur), LDAP, Turnstile, Diller ve Analitik. Lisansın süresi dolduğunda kurulum 14 günlük ek süre boyunca çalışmaya devam eder; ek süre bitince kurulum, yeni lisans yüklenene dek durur - bunun ne anlama geldiği ve kurulumu başka nelerin durdurabileceği için Lisansı geçerli tutmak bölümüne bakın.

Lisans sekmesi kurulum kodunu da gösterir. Bir lisans yalnızca bir kurulumda çalışır: lisansı çevrimiçi ilk alan kurulum onu kendine bağlar, aynı lisansı isteyen başka bir kurulum reddedilir. İnternete kapalı bir kurulum bu kodu AppArch’a gönderir ve yalnızca bu kurulumda çalışan bir .lic dosyası alır. Aynı veritabanını paylaşan birden fazla pod tek kurulum sayılır. Yeni bir sunucuya geçmek için AppArch’tan lisansı serbest bırakmasını isteyin, ardından lisansı yeni sunucudan tekrar alın - bkz. Bir lisans, bir kurulum.

Tehlikeli bölge - fabrika sıfırlaması

Ayarlar > Tehlikeli bölge kurulumu ilk çalıştırma haline döndürür: tüm çalışma alanları, üyeler, davetler, kullanıcı hesapları, Git kimlik bilgileri (paylaşılanlar dahil), projeler, entegrasyonlar, taramalar, bulgular ve raporlar silinir; kimlik sayaçları baştan başlar. Yönetici hesapları, lisans, kurulum kimlik bilgileri, ayarlar, çeviriler ve kural katalogları kalır; bu yüzden kurulum sihirbazı yeniden açılmaz, uygulamada yalnızca kullanıcı ve çalışma alanı kalmaz. Geri alma yoktur; önce veritabanı yedeği alın (docker compose exec postgres pg_dump ...).

Sıfırlama bilerek yavaş tetiklenir:

Parola - yalnızca tüm izinlere sahip bir yönetici başlatabilir ve parolasını yeniden girmelidir.
E-posta kodu - o yöneticinin kendi adresine altı haneli bir kod gider (15 dakika geçerli, beş deneme). Giden e-posta ayarlı olmalıdır; başka bir onay yolu yoktur.
Yazılı onay - lisanslı müşteri adı, gösterildiği gibi.
On dakikalık pencere - silme planlanır, tüm etkin yöneticilere bağlantılı bir e-posta gider ve pencere kapanana kadar herhangi biri iptal edebilir. Sonrasında iş otuz saniye içinde başlar ve durdurulamaz.

Her istek, kimin hangi adresten başlattığı ve tablo başına silinen satır sayısıyla birlikte yönetim veritabanında tutulur. Yöneticilere toplamları içeren son bir e-posta gider. İsteğe bağlı bir anahtar lisansı da siler; yalnızca kurulumu başka bir müşteriye devrederken kullanılır.

Operasyon

Güncellemeler - kurulu sürümün satıcı sürüm kaydıyla bileşen başına karşılaştırması ve şimdi-kontrol-et düğmesi. Denetim satıcı gateway’i üzerinden kurulum kimlik bilgileriyle yapılır; hava boşluklu kurulumlar UpdateCheck:Enabled=false ile kapatır.
Güvenlik tavsiyeleri - taranan her bağımlılığın eşleştirildiği güvenlik açığı verisi, kayıt kaynağı bazında, ve bunu tazeleyen OSV içe alma. Aşağıya bakın.
Bulgular - kurulumun kendisi hakkında fark ettikleri: patlayan bir job, eşitlemesi sürekli düşen bir proje, denemeleri biten bir posta, veritabanının reddettiği bir satır. Sorun başına tek satır; kaç kez tekrarladığı ve son hata görünür, konusu yeniden başarılı olunca kendini kapatır. Görüldü işaretleyin, elle kapatın ya da bir tipi yalnızca kendiniz için susturun. Açık bulgular kenar çubuğunda rozet ve giriş sayfasında şerit olarak görünür.
Job’lar - her zamanlı iş, şimdi-çalıştır düğmesiyle.
Kapasite (System altında kendi sayfası) - ölçülen job yükü (her job’ın ortalama süresinin aralığına oranı, toplanmış) ile tek Api pod’unun iş parçacıklarının karşılaştırması, Quartz küme tablosundaki canlı pod’lar gerçek CPU ve bellekleriyle, modül grubuna göre yük, kategori filtresi ve kolon sıralamasıyla en ağır job’lar ve pod önerisi: yükü tek pod taşıyor ama kesintisiz yeniden başlatma için iki pod, ya da iki katına çıkarılan yük tek pod’u aşıyorsa N pod. Yedi günlük geçmişten sonra görünür.
Sistem sağlığı - canlı PostgreSQL ve Redis probları (asla önbelleklenmez) ve zamanlayıcı durumu. Orkestratör probları için kimlik doğrulamasız /health/live ve /health/ready uçlarını kullanın - bkz. on-prem kurulum.
Entegrasyonlar - kurulumun konuştuğu her şeyin envanteri, çalışma alanı başına, sır göstermeden.
Kullanıcılar, davetler, yöneticiler - iki düzlemin hesap yönetimi.

Güvenlik tavsiyeleri

Her ArchScan koşusu deponun bildirdiği bağımlılıkları raporlar. Api bu listeyi kurulumun kendi tavsiye kataloğuyla eşleştirir ve kurulu sürümü yayımlanmış bir açık aralığına düşen her paket için bulgu açar (CWE-1104; OWASP A06 ile PCI, STIG ve CASA denetimlerine eşlenir). Eşleştirme runner’da değil burada yapılır: müşteri ağındaki bir CI işi CVE servisine erişemez ve bir yıl önce sabitlenmiş bir collector imajı bir yıllık veriyle gelir.

Ürün, collector’ların okuduğu sekiz kayıt kaynağı için derlenmiş bir temel küme ile gelir: NuGet, npm, PyPI, Maven (Java ve Kotlin), Go, RubyGems, Packagist ve SwiftPM. Güvenlik açığı verisi haftalar içinde eskir; bu yüzden Yönetim → Güvenlik tavsiyeleri ekranından tazeleyin: internete çıkan bir makinede osv.dev üzerinden ihtiyacınız olan kaynağın dışa aktarımını indirin (osv-vulnerabilities/<kaynak>/all.zip), kayıtları tek bir JSON dizisinde birleştirin ve dosyayı yükleyin. Sonraki tarama bununla eşleştirir - imaj yeniden üretilmez, kurulumdan dışarı çağrı yapılmaz.

İçe alma satır ekler ve günceller; hiçbir satırı silmez ve operatörün yanlış uyarı sonrası kapattığı bir tavsiyeyi yeniden açmaz. Ekran ayrıca hiç tavsiyesi olmayan kaynakları da gösterir, çünkü bu, bağımlılıkları denetlenmeyen bir dil demektir.

Yönetici girişi ve kilit

Her yönetim girişi denemesi kaydedilir - kim, hangi adresten, hangi tarayıcıyla ve neden başarısız olduğu (yanlış parola, bilinmeyen e-posta, pasif hesap, kilitli hesap). Kayıt Denetim > Girişler altındadır.

Beş başarısız denemeden sonra hesap on beş dakika kilitlenir. Kilit adres bazlı değil, hesap bazlıdır: her giriş API’ye UI pod’u üzerinden ulaştığı için adres bazlı bir kilit tek makineyi sayardı. Kilitli hesap yönetici listesinde rozetlenir ve Yöneticiler yetkisi olan herhangi bir yönetici beklemeden kilidi açabilir.

Artık her operatör jetonu bir oturuma aittir ve yöneticiler ekranındaki Oturumlarım hepsini listeler: cihaz, adres, ne zaman başladığı ve en son ne zaman kullanıldığı; baktığınız oturum işaretlidir. Bir oturumu sonlandırmak o tarayıcıyı bir sonraki isteğinde çıkarır ve sonrasında yenilenemez de - yani “şu dizüstünü çıkar” gerçekten bunu yapar, jetonun süresi dolana kadar sürmez. Diğer tüm oturumları sonlandır gerisini tek işlemde temizler.

Yöneticiler yetkisi olan bir yönetici, listeden bir meslektaşını hesabına dokunmadan her yerden çıkarabilir. Öncesinde bunun tek yolu hesabı devre dışı bırakmaktı ve bu, biri yeniden açmayı hatırlayana kadar erişimini elinden alır.

Yönetici kaldırma

Listedeki Yöneticiyi sil hesabı kaldırır: listeden çıkar, giriş yapamaz, açık oturumları anında sonlanır ve e-posta adresi yerine gelecek kişi için serbest kalır.

Veritabanı satırı kalır, bu bilinçlidir. Denetim kaydı, giriş geçmişi ve her “değiştiren” atfı, aktörü o hesabın kimliğiyle adlandırır ve arkasında yabancı anahtar yoktur. Satırı düşürmek bunların hepsini “birisi” der hâle getirirdi - kayıt hesaptan uzun yaşar ama içindekini unuturdu. Bu yüzden hesap silinmek yerine boşaltılır ve hâlâ kullanılabileceği her yerden gizlenir.

Kendi hesabınızı silemezsiniz: kendi kimlik bilgilerini yolun yarısında yok eden bir istek, “çıkış yap”ı anlatmanın kafa karıştırıcı bir yoludur ve yanlış bir tıklama sizi panelden kilitler. Kendi hesabınızı kapatmak için bir meslektaşınızın yapması gerekir.

Hangi yetki neyi kapatır

Bir yöneticinin yetkileri yalnızca ne göreceğini değil ne yapabileceğini belirler - API her hâlükârda çağrıyı reddeder:

Lisans - lisansı kurmak ve değiştirmek.
Kullanıcılar - hesapları askıya almak, yeniden etkinleştirmek, silmek, parola sıfırlamak.
Yöneticiler - yönetici oluşturmak, yetki değiştirmek, kilit açmak.
Ayarlar - tüm ayar sekmeleri, entegrasyon ayarları ve paylaşılan kimlik bilgileri.
Çalışma alanları - yaşam döngüsü işlemleri: sahiplik, üyelik, davet anahtarları, silme ve geri alma.
Veri - fiziksel silme: çalışma alanı temizliği, bir koşunun veya incelemenin silinmesi.
Operasyon - job’ları duraklatmak ve sürdürmek, dışa aktarımlar, posta göndermek.

Yetkisi olmayan bir yönetici o yetkinin ait olduğu menü grubunu görmez ve ilgili uç noktalar 403 döner.

Kullanıcı silme

Kullanıcı sayfası, kişinin bulunduğu çalışma alanlarını ve hiçbirinin sahibi değilse bir Kullanıcıyı sil işlemini taşır. Tüm üyelikleri, dış girişleri, iki adımlı doğrulama kaydını ve kurtarma kodlarını kaldırır, oturumlarını iptal eder ve kimliği temizler - giriş geçmişi ve denetim kaydı kalır, çünkü olanların kaydı onlardır. Hâlâ bir çalışma alanının sahibi olan kişi silinemez: önce sahipliği devredin, bu çalışma alanı sayfasında tek işlemdir.