İddia Türleri

Sağlanan bir test VM’sinde yürütülen iddialar için kurallı referans. Belirtilmediği sürece hedef primary’dir. Her iddia aynı zamanda bir insan gerektirir okunabilir description.

Kararlı konuk iddiaları

Tür	Gerekli `params`	İsteğe bağlı davranış
`user_exists`	`username`	Çalıştırılıyor `id`
`user_password`	`username`	Kilitlenmemiş bir şifre karmasının mevcut olduğunu doğrular; etkileşimli oturum açma girişiminde bulunmuyor
`user_in_group`	`username`, `group`	`sudo`/`admin` kontrol edilirken Vyatta idari eşdeğerlerini kabul eder
`file_exists`	`path`	Bir dosya veya dizini kabul eder
`file_contains`	`path`, `pattern` veya `content`	`grep` kullanır; değer bir grep modelidir, yalnızca gerçek bir karşılaştırma değildir
`file_permissions`	`path`, `mode`	`stat`
`service_running`	`service`	Sistemin aktif durumunu kontrol eder; küçük bir çapraz dağıtım takma ad kümesini biliyor
`service_enabled`	`service`	Systemd etkinleştirmesini kontrol eder
`package_installed`	`package`	Konuğun desteklenen paket yöneticisi veritabanını kontrol eder
`port_listening`	`port`	`protocol` `tcp` veya `udp` olabilir; varsayılan TCP’dir
`command_succeeds`	`command`	Çıkış kodu sıfır olmalıdır; `timeout_seconds`/`timeout` 1–1.800 saniyeye sabitlenir
`command_output`	`command` artı `expected_pattern`, `pattern`, `expected`’de bir normal ifade veya `expected` iddia düzeyi	Standart ifadeyi Python düzenli ifade semantiğiyle eşleştirir
`network_reachable`	`host`	`count` varsayılan olarak 3’tür; ICMP ping’i kullanır
`http_responds`	`url`	`status` varsayılan olarak 200’dür

Örnek:


{
  "type": "command_output",
  "description": "Application reports the expected release",
  "params": {
    "command": "/opt/acme/bin/acme --version",
    "expected_pattern": "^acme 2\\.4\\.[0-9]+$"
  }
}

Komut ve yakalanan çıktı, test kanıtı haline gelebilir. Sırları gömmeyin.

GUI iddiaları

GUI kontrolleri, çalışan bir görüntüleme oturumuna ve koşucunun ekran görüntüsüne veya giriş yardımcıları. Konuk komut kontrollerine göre çevreye daha duyarlıdırlar.

Tür	Ana parametreler	Neyi kontrol ediyor
`gui_application_opens`	`application` (kanonik); işleyici ayrıca başlatmaya özel seçenekleri de kabul eder	Bir uygulamayı başlatır ve bir pencere arar
`gui_window_visible`	işleyici tarafından kullanılan pencere başlığı veya eşleşen parametreler	Mevcut bir pencereyi arar
`gui_execute_command`	`command`	Bir masaüstü komutunu yürütür; ekran görüntüsü yakalayabilir
`gui_application_process`	`process_name`	Süreci başsız bir geri dönüş olarak arar
`gui_screenshot_matches`	`reference_id`; isteğe bağlı `threshold`, kırpma/maske bölgeleri	Geçerli ekran görüntüsünü kayıtlı bir referansla karşılaştırır
`gui_wallpaper_matches`	`wallpaper_path`; isteğe bağlı eşikler ve bölgeler	Yapılandırılmış duvar kağıdı yolunu ve görsel sonucu kontrol eder
`desktop_wallpaper_matches`	`wallpaper_path`	Daha katı masaüstü duvar kağıdı kaynağı/yapılandırma/görsel kontrolünü çalıştırır
`gui_click_element`	`x`, `y`	Koordinat tabanlı işaretçi girişi gönderir
`gui_form_fill`	`fields`	Koordinat tanımlı form girişlerini doldurur
`gui_text_visible`	`text`, `contains` veya `ocr_contains`	Ekranda veya seçilen bölgede OCR’yi kullanır

Yürütücü ayrıca bazı OCR ve duvar kağıdı için uyumluluk takma adlarını da kabul eder türleri. Yeni tariflerde yukarıdaki kanonik isimleri tercih edin. Koordinat testleri çözünürlüğe duyarlı; Mümkün olduğunda OCR veya sonuç kontrollerini kullanın.

Karşılaştırma kontrolleri ayrı bir formattır

Tarifin tarihsel iddia sözlüğünde cis_benchmark yer alıyor, ancak sıradan iddia göndericinin cis_benchmark işleyicisi yoktur. BDT ve diğer kıyaslama kontrolleri audit_script ile karşılaştırma kayıtları olarak sağlanır ve kıyaslama koşucusu aracılığıyla yürütün. Şunu kullanın: CIS karşılaştırma iş akışı, özel bir iddia değil type: "cis_benchmark".

Sonuçların yorumlanması

Gerekli verilerin eksik olması error sonucunu verir, aksi takdirde planlamacı iddiayı reddedebilir idam edilmeden önce bir uyarı ile.
Kullanılamayan bir on_vm hedefi skipped sonucunu verir.
Eşleşmeyen bir sonuç failed sonucunu verir.
Sadece passed bu iddiayı doğrulayan delildir.

Yazma kılavuzu için Özel iddialar’e bakın.