# Yapılandırma

<p class="callout info">Not: Wazuh sunucu API'sini nasıl koruyacağınız hakkında daha fazla bilgi için lütfen [<span class="doc">Wazuh sunucu API'sini güvence altına alma</span>](https://acikkaynak.lastguard.com.tr/books/kullanim-kilavuzu/page/wazuh-sunucu-apisini-guvence-altina-alma) bölümünü inceleyin.</p>

<section id="bkmrk-wazuh-sunucu-api-yap"><span id="bkmrk-"></span>### Wazuh Sunucu API Yapılandırma Dosyası

`<span class="pre">/var/ossec/api/configuration/api.yaml</span>`Wazuh sunucusu API yapılandırması Wazuh sunucusundaki dosyada bulunur . Varsayılan olarak, tüm ayarlar yorum satırına alınır. Farklı bir yapılandırma uygulamak için, yorum satırını kaldırın ve istediğiniz satırı düzenleyin.

Yapılandırma dosyası için tüm kullanılabilir ayarlar şunlardır `<span class="pre">/var/ossec/api/configuration/api.yaml</span>`. Her bir ayar hakkında daha fazla bilgi için <span class="std std-ref">yapılandırma seçeneklerini</span> kontrol edin:

<section id="bkmrk-host%3A-%5B%270.0.0.0%27%2C-%27%3A">```
host: ['0.0.0.0', '::']
port: 55000

drop_privileges: yes
experimental_features: no
max_upload_size: 10485760

intervals:
   request_timeout: 10

https:
   enabled: yes
   key: "server.key"
   cert: "server.crt"
   use_ca: False
   ca: "ca.crt"
   ssl_protocol: "auto"
   ssl_ciphers: ""

logs:
   level: "info"
   format: "plain"
   max_size:
    enabled: false

cors:
   enabled: no
   source_route: "*"
   expose_headers: "*"
   allow_headers: "*"
   allow_credentials: no

access:
   max_login_attempts: 50
   block_time: 300
   max_request_per_minute: 300

upload_configuration:
   remote_commands:
      localfile:
         allow: yes
         exceptions: []
      wodle_command:
         allow: yes
         exceptions: []
   limits:
      eps:
         allow: yes
    agents:
      allow_higher_versions:
         allow: yes
    indexer:
      allow: yes
    integrations:
      virustotal:
         public_key:
            allow: yes
            minimum_quota: 240
```

<p class="callout warning">Uyarı: Bir Wazuh sunucu kümesi çalıştırıldığında, ana düğüm yerel Wazuh sunucu API yapılandırma dosyasını otomatik olarak çalışan düğümlere göndermez. Her düğüm kendi Wazuh sunucu API yapılandırmasını korur. Bu nedenle, ana düğümdeki yapılandırma dosyasında herhangi bir değişiklik yapılırsa, tutarlılığı sağlamak için her çalışan düğümünde yapılandırmayı manuel olarak güncellemelisiniz. Her çalışanın yerel yapılandırmasında IP adresinin ve bağlantı noktasının üzerine yazılmadığından emin olun.</p>

Yapılandırma dosyasını düzenledikten sonra Wazuh yönetici servisini kullanarak Wazuh sunucu API'sini yeniden başlattığınızdan emin olun:  
  
**Systemd**

```
systemctl restart wazuh-manager
```

  
**SysV Başlatma**

```
service wazuh-manager restart
```

### API Yapılandırma Seçenekleri

</section><section id="bkmrk-home-%C4%B0zin-verilen-de"><section id="bkmrk-home-%C4%B0zin-verilen-de-1">#### home

<table class="docutils align-default" style="width: 100%;"><thead><tr class="row-odd"><th class="head" style="width: 31.7721%;">İzin verilen değerler

</th><th class="head" style="width: 16.1959%;">Varsayılan değer

</th><th class="head" style="width: 52.0478%;">Tanım

</th></tr></thead><tbody><tr class="row-even"><td style="width: 31.7721%;">Geçerli IP adresleri veya ana bilgisayar adlarının listesi

</td><td style="width: 16.1959%;">\['0.0.0.0', '::'\]

</td><td style="width: 52.0478%;">Wazuh sunucu API'sinin çalıştığı Wazuh yöneticisinin IP adresleri veya ana bilgisayar adları.

</td></tr></tbody></table>

</section><section id="bkmrk-port-%C4%B0zin-verilen-de">#### port

<table class="docutils align-default" style="width: 99.6296%;"><thead><tr class="row-odd"><th class="head" style="width: 32.2638%;">İzin verilen değerler

</th><th class="head" style="width: 15.882%;">Varsayılan değer

</th><th class="head" style="width: 51.8684%;">Tanım

</th></tr></thead><tbody><tr class="row-even"><td style="width: 32.2638%;">1 ile 65535 arasındaki herhangi bir değer

</td><td style="width: 15.882%;">55000

</td><td style="width: 51.8684%;">Wazuh sunucu API'sinin dinleyeceği port.

</td></tr></tbody></table>

</section><section id="bkmrk-use_only_authd-4.3.0">#### use\_only\_authd

  
<p class="callout danger"><span class="versionmodified deprecated">4.3.0 sürümünden itibaren kullanımdan kaldırılmıştır.</span></p>

<table class="docutils align-default" style="width: 99.6296%;"><thead><tr class="row-odd"><th class="head" style="width: 32.0145%;">İzin verilen değerler

</th><th class="head" style="width: 16.1361%;">Varsayılan değer

</th><th class="head" style="width: 51.8636%;">Tanım

</th></tr></thead><tbody><tr class="row-even"><td style="width: 32.0145%;">evet, doğru, hayır, yanlış

</td><td style="width: 16.1361%;">YANLIŞ

</td><td style="width: 51.8636%;">Ajanları kaydederken ve kaldırırken wazuh-authd kullanımını zorunlu kılın.

</td></tr></tbody></table>

</section><section id="bkmrk-drop_privileges-%C4%B0zin">#### drop\_privileges

  
<table class="docutils align-default" style="width: 100.494%; height: 70.9376px;"><thead><tr class="row-odd" style="height: 35.4688px;"><th class="head" style="width: 31.772%; height: 35.4688px;">İzin verilen değerler

</th><th class="head" style="width: 16.3161%; height: 35.4688px;">Varsayılan değer

</th><th class="head" style="width: 51.9256%; height: 35.4688px;">Tanım

</th></tr></thead><tbody><tr class="row-even" style="height: 35.4688px;"><td style="width: 31.772%; height: 35.4688px;">evet, doğru, hayır, yanlış

</td><td style="width: 16.3161%; height: 35.4688px;">doğru

</td><td style="width: 51.9256%; height: 35.4688px;">Wazuh-api işlemini kullanıcı olarak çalıştırın `<span class="pre">wazuh</span>`.

</td></tr></tbody></table>

</section><section id="bkmrk-experimental_feature">#### experimental\_features

  
<table class="docutils align-default" style="width: 99.5062%;"><thead><tr class="row-odd"><th class="head" style="width: 31.5586%;">İzin verilen değerler

</th><th class="head" style="width: 16.2747%;">Varsayılan değer

</th><th class="head" style="width: 52.1818%;">Tanım

</th></tr></thead><tbody><tr class="row-even"><td style="width: 31.5586%;">evet, doğru, hayır, yanlış

</td><td style="width: 16.2747%;">YANLIŞ

</td><td style="width: 52.1818%;">Geliştirme aşamasındaki özellikleri etkinleştirin

</td></tr></tbody></table>

</section>#### max\_upload\_size

  
<table class="docutils align-default" style="width: 100%;"><thead><tr class="row-odd"><th class="head" style="width: 31.6349%;">İzin verilen değerler

</th><th class="head" style="width: 15.8386%;">Varsayılan değer

</th><th class="head" style="width: 52.5423%;">Tanım

</th></tr></thead><tbody><tr class="row-even"><td style="width: 31.6349%;">Herhangi bir pozitif tam sayı

</td><td style="width: 15.8386%;">10485760

</td><td style="width: 52.5423%;">API'nin kabul edebileceği maksimum gövde boyutunu bayt cinsinden ayarlayın (0 -&gt; sınırsız)

</td></tr></tbody></table>

<section id="bkmrk-intervals-%28aral%C4%B1klar">#### intervals (aralıklar)

<table class="docutils align-default" style="width: 100%;"><thead><tr class="row-odd"><th class="head" style="width: 17.3081%;">Alt alanlar

</th><th class="head" style="width: 20.7697%;">İzin verilen değerler

</th><th class="head" style="width: 17.6789%;">Varsayılan değer

</th><th class="head" style="width: 44.2592%;">Tanım

</th></tr></thead><tbody><tr class="row-even"><td style="width: 17.3081%;">request\_timeout

</td><td style="width: 20.7697%;"> </td><td style="width: 17.6789%;">10

</td><td style="width: 44.2592%;">Her API isteği için maksimum yanıt süresini (saniye cinsinden) ayarlayın

</td></tr></tbody></table>

</section><section id="bkmrk-https-alt-alanlar-%C4%B0z">#### https

<table class="docutils align-default" style="width: 100%;"><thead><tr class="row-odd"><th class="head" style="width: 16.8135%;">Alt alanlar

</th><th class="head" style="width: 21.1406%;">İzin verilen değerler

</th><th class="head" style="width: 17.916%;">Varsayılan değer

</th><th class="head" style="width: 44.0221%;">Tanım

</th></tr></thead><tbody><tr class="row-even"><td style="width: 16.8135%;">enabled

</td><td style="width: 21.1406%;">evet, doğru, hayır, yanlış

</td><td style="width: 17.916%;">doğru

</td><td style="width: 44.0221%;">Wazuh sunucu API'sinde SSL'yi (https) etkinleştirin veya devre dışı bırakın.

</td></tr><tr class="row-odd"><td style="width: 16.8135%;">key

</td><td style="width: 21.1406%;">Herhangi bir metin dizesi

</td><td style="width: 17.916%;">sunucu.anahtar

</td><td style="width: 44.0221%;">Özel anahtarın adı. İçinde saklanır `<span class="pre">/var/ossec/api/configuration/ssl</span>`.

</td></tr><tr class="row-even"><td style="width: 16.8135%;">sertifika

</td><td style="width: 21.1406%;">Herhangi bir metin dizesi

</td><td style="width: 17.916%;">sunucu.crt

</td><td style="width: 44.0221%;">Sertifikanın adı. Şurada saklanır `<span class="pre">/var/ossec/api/configuration/ssl</span>`: .

</td></tr><tr class="row-odd"><td style="width: 16.8135%;">use\_ca

</td><td style="width: 21.1406%;">evet, doğru, hayır, yanlış

</td><td style="width: 17.916%;">YANLIŞ

</td><td style="width: 44.0221%;">Bir Sertifika Yetkilisinden alınan sertifikanın kullanılıp kullanılmayacağı.

</td></tr><tr class="row-even"><td style="width: 16.8135%;">ca

</td><td style="width: 21.1406%;">Herhangi bir metin dizesi

</td><td style="width: 17.916%;">yaklaşık.krt

</td><td style="width: 44.0221%;">Sertifika Yetkilisinin (CA) sertifikasının adı. İçinde saklanır `<span class="pre">/var/ossec/api/configuration/ssl</span>`.

</td></tr><tr class="row-odd"><td style="width: 16.8135%;">ssl\_protocol

</td><td style="width: 21.1406%;">TLS, TLSv1, TLSv1.1, TLSv1.2, otomatik

</td><td style="width: 17.916%;"><span class="versionmodified added">4.8.0 sürümündeki yenilikler.</span>

otomatik

</td><td style="width: 44.0221%;">SSL protokolüne izin vermek için. Değeri büyük/küçük harfe duyarlı değildir.

</td></tr><tr class="row-even"><td style="width: 16.8135%;">ssl\_ciphers

</td><td style="width: 21.1406%;">Herhangi bir metin dizesi

</td><td style="width: 17.916%;">Hiçbiri

</td><td style="width: 44.0221%;">SSL şifrelerine izin verilir. Değeri büyük/küçük harfe duyarlı değildir.

</td></tr></tbody></table>

</section><section id="bkmrk-logs-alt-alanlar-%C4%B0zi">#### logs

<table class="docutils align-default" style="width: 100%;"><thead><tr class="row-odd"><th class="head" style="width: 16.6899%;">Alt alanlar

</th><th class="head" style="width: 21.1406%;">İzin verilen değerler

</th><th class="head" style="width: 18.2971%;">Varsayılan değer

</th><th class="head" style="width: 43.8883%;">Tanım

</th></tr></thead><tbody><tr class="row-even"><td style="width: 16.6899%;">level

</td><td style="width: 21.1406%;">devre dışı, bilgi, uyarı, hata, hata ayıklama, debug2 (her seviye bir önceki seviyeyi içerir)

</td><td style="width: 18.2971%;">bilgi

</td><td style="width: 43.8883%;">Wazuh sunucusu API günlüklerinin ayrıntı düzeyini ayarlayın.

</td></tr><tr class="row-odd"><td style="width: 16.6899%;">path

</td><td style="width: 21.1406%;">Herhangi bir metin dizesi.

</td><td style="width: 18.2971%;">günlükler/api.log

</td><td style="width: 43.8883%;"><span class="versionmodified deprecated">4.3.0 sürümünden itibaren kullanımdan kaldırılmıştır.</span>

Wazuh sunucusu API kayıtlarının kaydedileceği yol.

</td></tr><tr class="row-even"><td style="width: 16.6899%;">format

</td><td style="width: 21.1406%;"> </td><td style="width: 18.2971%;">ova

</td><td style="width: 43.8883%;"><span class="versionmodified added">4.4.0 sürümündeki yenilikler.</span>

Wazuh sunucusu API günlüklerinin biçimini ayarlayın.

</td></tr></tbody></table>

</section></section></section><section id="bkmrk-alt-alanlar-%C4%B0zin-ver"><section id="bkmrk-g%C3%BCnl%C3%BCklerbu-ba%C5%9Fl%C4%B1%C4%9Fa-"></section><section id="bkmrk-maksimum_boyutbu-ba%C5%9F">#### max\_size

  
<p class="callout danger"><span class="versionmodified added">4.6.0 sürümündeki yenilikler.</span></p>

<table class="docutils align-default" style="width: 100%;"><thead><tr class="row-odd"><th class="head" style="width: 16.4427%;">Alt alanlar

</th><th class="head" style="width: 21.1354%;">İzin verilen değerler

</th><th class="head" style="width: 18.9204%;">Varsayılan değer

</th><th class="head" style="width: 43.5174%;">Tanım

</th></tr></thead><tbody><tr class="row-even"><td style="width: 16.4427%;">enabled

</td><td style="width: 21.1354%;">evet, doğru, hayır, yanlış

</td><td style="width: 18.9204%;">YANLIŞ

</td><td style="width: 43.5174%;">Zaman tabanlı ve boyut tabanlı Wazuh API günlük döndürme arasında geçiş yapın. Bu seçeneği etkinleştirmek zaman tabanlı döndürmeyi devre dışı bırakır ve bunun yerine dosya boyutuna dayalı döndürmeyi etkinleştirir.

</td></tr><tr class="row-odd"><td style="width: 16.4427%;">size

</td><td style="width: 21.1354%;">Geçerli bir birimden sonra gelen herhangi bir pozitif sayı. Kilobayt için K/k, megabayt için M/m.

</td><td style="width: 18.9204%;">1M

</td><td style="width: 43.5174%;">Boyut tabanlı günlük döndürmeyi tetiklemeyecek şekilde maksimum dosya boyutunu ayarlayın. 1 M'den düşük değerler 1 M olarak kabul edilir.

</td></tr></tbody></table>

</section><section id="bkmrk-korsbu-ba%C5%9Fl%C4%B1%C4%9Fa-kal%C4%B1c">#### cors

<table class="docutils align-default" style="width: 100%;"><thead><tr class="row-odd"><th class="head" style="width: 16.4427%;">Alt alanlar

</th><th class="head" style="width: 21.6351%;">İzin verilen değerler

</th><th class="head" style="width: 18.9003%;">Varsayılan değer

</th><th class="head" style="width: 43.0379%;">Tanım

</th></tr></thead><tbody><tr class="row-even"><td style="width: 16.4427%;">enabled

</td><td style="width: 21.6351%;"> </td><td style="width: 18.9003%;">YANLIŞ

</td><td style="width: 43.0379%;">Wazuh sunucu API'sinde CORS kullanımını etkinleştirin veya devre dışı bırakın.

</td></tr><tr class="row-odd"><td style="width: 16.4427%;">source\_route

</td><td style="width: 21.6351%;">Herhangi bir metin dizesi

</td><td style="width: 18.9003%;">`<span class="pre">*</span>`

</td><td style="width: 43.0379%;">Kaynakların mevcut olacağı kaynaklar. Örneğin `<span class="pre">http://client.example.org</span>`.

</td></tr><tr class="row-even"><td style="width: 16.4427%;">expose\_headers

</td><td style="width: 21.6351%;">Herhangi bir metin dizesi

</td><td style="width: 18.9003%;">`<span class="pre">*</span>`

</td><td style="width: 43.0379%;">Hangi başlıkların yanıtın bir parçası olarak açığa çıkarılabileceği.

</td></tr><tr class="row-odd"><td style="width: 16.4427%;">allow\_headers

</td><td style="width: 21.6351%;"> </td><td style="width: 18.9003%;">`<span class="pre">*</span>`

</td><td style="width: 43.0379%;">Gerçek istek sırasında hangi HTTP başlıklarının kullanılabileceği.

</td></tr><tr class="row-even"><td style="width: 16.4427%;">allow\_credentials

</td><td style="width: 21.6351%;">evet, doğru, hayır, yanlış

</td><td style="width: 18.9003%;">YANLIŞ

</td><td style="width: 43.0379%;">Tarayıcılara yanıtın ön uç JavaScript'e açılıp açılmayacağını söyleyin.

</td></tr></tbody></table>

</section><section id="bkmrk-eri%C5%9Fimbu-ba%C5%9Fl%C4%B1%C4%9Fa-kal"><span id="bkmrk--3"></span>### access (erişim)

<table class="docutils align-default" style="width: 100%;"><thead><tr class="row-odd"><th class="head" style="width: 16.0609%;">Alt alanlar

</th><th class="head" style="width: 22.5113%;">İzin verilen değerler

</th><th class="head" style="width: 18.7916%;">Varsayılan değer

</th><th class="head" style="width: 42.652%;">Tanım

</th></tr></thead><tbody><tr class="row-even"><td style="width: 16.0609%;">max\_login\_attempts

</td><td style="width: 22.5113%;">Herhangi bir pozitif tam sayı

</td><td style="width: 18.7916%;">50

</td><td style="width: 42.652%;">Belirtilen saniye sayısı içerisinde yapılabilecek maksimum oturum açma girişimi sayısını ayarlayın `<span class="pre">block_time</span>`.

</td></tr><tr class="row-odd"><td style="width: 16.0609%;">block\_time

</td><td style="width: 22.5113%;"> </td><td style="width: 18.7916%;">300

</td><td style="width: 42.652%;">Oturum açma isteklerini denemek için belirlenen zaman aralığı (saniye cinsinden). Belirlenen istek sayısı ( `<span class="pre">max_login_attempts</span>`) bu zaman sınırı içinde aşılırsa, IP adresi blok zaman aralığının sonuna kadar engellenir.

</td></tr><tr class="row-even"><td style="width: 16.0609%;">max\_request\_per\_minute

</td><td style="width: 22.5113%;">Herhangi bir pozitif tam sayı

</td><td style="width: 18.7916%;">300

</td><td style="width: 42.652%;">Dakikada izin verilen maksimum istek sayısı. Kimlik doğrulama istekleri hariç tüm Wazuh sunucu API uç noktaları için geçerlidir. Bu sınıra bir dakikadan kısa sürede ulaşılması, kalan süre boyunca herhangi bir kullanıcıdan gelen tüm istekleri engeller. Bir değeri `<span class="pre">0</span>`bu özelliği devre dışı bırakır. İstekler için, etkili değer 30'dan büyük değerler içindir.`<span class="pre">POST</span> <span class="pre">/events</span>``<span class="pre">30</span>`

</td></tr></tbody></table>

</section><section id="bkmrk-y%C3%BCkleme_yap%C4%B1land%C4%B1rma">#### upload\_configuration

  
<p class="callout danger"><span class="versionmodified added">4.4.0 sürümündeki yenilikler.</span></p>

</section>##### remote\_commands (yerel\_dosya ve wodle "komut")  
  


<section></section><section><section id="bkmrk-uzak_komutlar-%28yerel"><table class="docutils align-default" style="width: 100%;"><thead><tr class="row-odd"><th class="head" style="width: 16.1811%;">Alt alanlar

</th><th class="head" style="width: 22.762%;">İzin verilen değerler

</th><th class="head" style="width: 19.2861%;">Varsayılan değer

</th><th class="head" style="width: 41.7866%;">Tanım

</th></tr></thead><tbody><tr class="row-even"><td style="width: 16.1811%;">allow

</td><td style="width: 22.762%;">evet, doğru, hayır, yanlış

</td><td style="width: 19.2861%;">doğru

</td><td style="width: 41.7866%;">Wazuh sunucu API'si aracılığıyla uzaktan komutlarla yapılandırmaların yüklenmesine izin verin. Bu seçeneğin ayarlanması, <span class="std std-ref">wodle "command" seçeneğini</span> veya <span class="std std-ref">localfile etiketi</span> içindeki seçeneği içeren dosyaların `<span class="pre">false</span>`yüklenmesini engeller .`<span class="pre">ossec.conf</span>``<span class="pre"><command></span>`

</td></tr><tr class="row-odd"><td style="width: 16.1811%;">exceptions

</td><td style="width: 22.762%;">komut listesi

</td><td style="width: 19.2861%;">\[ \]

</td><td style="width: 41.7866%;">API aracılığıyla yüklenmesine izin verilen komutların bir listesini ayarlayın. Bu istisnalar yapılandırmadan bağımsız olarak her zaman yüklenebilir `<span class="pre">allow</span>`.

</td></tr></tbody></table>

</section><section id="bkmrk-s%C4%B1n%C4%B1rlarbu-ba%C5%9Fl%C4%B1%C4%9Fa-k">##### sınırlar

eps

<p class="callout danger"><span class="versionmodified added">4.4.0 sürümündeki yenilikler.</span></p>

<table class="docutils align-default" style="width: 100%;"><thead><tr class="row-odd"><th class="head" style="width: 15.8114%;">Alt alanlar

</th><th class="head" style="width: 22.8845%;">İzin verilen değerler

</th><th class="head" style="width: 19.2861%;">Varsayılan değer

</th><th class="head" style="width: 42.0339%;">Tanım

</th></tr></thead><tbody><tr class="row-even"><td style="width: 15.8114%;">allow

</td><td style="width: 22.8845%;">evet, doğru, hayır, yanlış

</td><td style="width: 19.2861%;">doğru

</td><td style="width: 42.0339%;">Wazuh sunucu API'si aracılığıyla değiştirilmiş EPS limitleriyle yapılandırmaların yüklenmesine izin verin. Bu seçeneğin ayarlanması, <span class="std std-ref">genel etiketin</span> içindeki bölüm değiştiyse dosyaların `<span class="pre">false</span>` yüklenmesini engeller. `<span class="pre">ossec.conf</span>``<span class="pre"><limits><eps></span>`

</td></tr></tbody></table>

</section><section id="bkmrk-ajanlarbu-ba%C5%9Fl%C4%B1%C4%9Fa-ka">##### agents

**allow\_higher\_versions**

<p class="callout danger"><span class="versionmodified added">4.6.0 sürümündeki yenilikler.</span></p>

<table class="docutils align-default" style="width: 100%;"><thead><tr class="row-odd"><th class="head" style="width: 14.8233%;">Alt alanlar

</th><th class="head" style="width: 23.0072%;">İzin verilen değerler

</th><th class="head" style="width: 20.646%;">Varsayılan değer

</th><th class="head" style="width: 41.5394%;">Tanım

</th></tr></thead><tbody><tr class="row-even"><td style="width: 14.8233%;">allow

</td><td style="width: 23.0072%;">evet, doğru, hayır, yanlış

</td><td style="width: 20.646%;">doğru

</td><td style="width: 41.5394%;">Wazuh sunucu API'si aracılığıyla daha yüksek aracı sürümlerini kabul eden yapılandırmaların yüklenmesine izin verin. Bu seçeneğin ayarlanması, <span class="std std-ref">auth</span> veya <span class="std std-ref">remote</span> etiketleri içindeki değere sahip bölümü içeren dosyaların `<span class="pre">false</span>`yüklenmesini engeller .`<span class="pre">ossec.conf</span>``<span class="pre"><allow_higher_versions></span>``<span class="pre">yes</span>`

</td></tr></tbody></table>

</section><section id="bkmrk-dizinleyicibu-ba%C5%9Fl%C4%B1%C4%9F">##### indexer

<p class="callout danger"><span class="versionmodified added">4.8.0 sürümündeki yenilikler.</span></p>

<table class="docutils align-default" style="width: 100%;"><thead><tr class="row-odd"><th class="head" style="width: 13.9709%;">Alt alanlar

</th><th class="head" style="width: 23.2414%;">İzin verilen değerler

</th><th class="head" style="width: 21.0169%;">Varsayılan değer

</th><th class="head" style="width: 41.7866%;">Tanım

</th></tr></thead><tbody><tr class="row-even"><td style="width: 13.9709%;">allow

</td><td style="width: 23.2414%;">evet, doğru, hayır, yanlış

</td><td style="width: 21.0169%;">doğru

</td><td style="width: 41.7866%;">Wazuh sunucu API'si aracılığıyla güncellenmiş bir <span class="doc">dizinleyici yapılandırma bölümünün</span> yüklenmesine izin verir . Bu seçeneğin ayarlanması `<span class="pre">false</span>`, yükleme sırasında dizinleyici yapılandırmasının güncellenmesini önler `<span class="pre">ossec.conf</span>`.

</td></tr></tbody></table>

</section><section id="bkmrk-entegrasyonlarbu-ba%C5%9F">##### entegrasyonlar

<p class="callout danger"><span class="versionmodified added">4.8.0 sürümündeki yenilikler.</span></p>

virüstotal (public\_key)

<table class="docutils align-default" style="width: 100%;"><thead><tr class="row-odd"><th class="head" style="width: 14.5875%;">Alt alanlar

</th><th class="head" style="width: 21.5121%;">İzin verilen değerler

</th><th class="head" style="width: 22.5005%;">Varsayılan değer

</th><th class="head" style="width: 41.4157%;">Tanım

</th></tr></thead><tbody><tr class="row-even"><td style="width: 14.5875%;">allow

</td><td style="width: 21.5121%;">evet, doğru, hayır, yanlış

</td><td style="width: 22.5005%;">doğru

</td><td style="width: 41.4157%;">Wazuh sunucu API'si aracılığıyla genel bir API anahtarı kullanılarak güncellenmiş bir <span class="doc">Virus Total entegrasyon yapılandırma bölümünün</span> yüklenmesine izin verir . Bu seçeneğin ayarlanması `<span class="pre">false</span>`, yükleme sırasında entegrasyonların Virus Total yapılandırmasının güncellenmesini önler `<span class="pre">ossec.conf</span>`.

</td></tr><tr class="row-odd"><td style="width: 14.5875%;">minimum\_quota

</td><td style="width: 21.5121%;">Herhangi bir pozitif tam sayı

</td><td style="width: 22.5005%;">240

</td><td style="width: 41.4157%;">Virus Total genel API anahtarı için minimum kota değeri.

</td></tr></tbody></table>

</section></section></section><section id="bkmrk-wazuh-sunucu-api-g%C3%BCv">### Wazuh Sunucu API Güvenlik Yapılandırması

`<span class="pre">auth_token_exp_timeout</span>`Güvenlik yapılandırmasını ve `<span class="pre">rbac_mode</span>`ayarlarını yalnızca Wazuh sunucu API uç noktaları aracılığıyla sorgulayabilir ve değiştirebilirsiniz : [GET /security/config](https://documentation.wazuh.com/current/user-manual/api/reference.html#operation/api.controllers.security_controller.get_security_config) , [PUT /security/config](https://documentation.wazuh.com/current/user-manual/api/reference.html#operation/api.controllers.security_controller.put_security_config) ve [DELETE /security/config](https://documentation.wazuh.com/current/user-manual/api/reference.html#operation/api.controllers.security_controller.delete_security_config) . `<span class="pre">auth_token_exp_timeout</span>`Bir kimlik doğrulama belirtecinin süresi dolmadan ve yenilenmesi gerekmeden önceki saniye cinsinden süreyi tanımlar. `<span class="pre">rbac_mode</span>`Kullanıcı rollerine ve izinlerine göre kaynaklara ve uç noktalara erişimi genel olarak izin vermek veya kısıtlamak üzere yapılandırılabilen Rol Tabanlı Erişim Kontrol sisteminin genel davranışını belirler. Daha fazla ayrıntı için [<span class="doc">Rol Tabanlı Erişim Kontrol</span>](https://acikkaynak.lastguard.com.tr/books/kullanim-kilavuzu/page/rol-tabanli-erisim-kontrolu) belgelerine bakın. Yapılandırma, geçerliyse bir kümedeki her Wazuh sunucu API'sine uygulanır.

Her bir ayar hakkında daha fazla bilgi için lütfen [<span class="std std-ref">güvenlik yapılandırma seçeneklerini</span>](https://acikkaynak.lastguard.com.tr/books/kullanim-kilavuzu/page/yapilandirma) kontrol edin .

```
auth_token_exp_timeout: 900
rbac_mode: white
```

<p class="callout warning">Uyarı: Güvenlik nedenleriyle, güvenlik yapılandırmasını değiştirmek tüm JWT'leri iptal eder. Değişiklikten sonra oturum açmanız ve yeni bir token edinmeniz gerekecektir.</p>

<section id="bkmrk-g%C3%BCvenlik-yap%C4%B1land%C4%B1rm"><span id="bkmrk--4"></span>#### Güvenlik Yapılandırma Seçenekleri

<section id="bkmrk-auth_token_exp_timeo">##### auth\_token\_exp\_timeout

  
<table class="docutils align-default" style="width: 93.8272%;"><thead><tr class="row-odd"><th class="head" style="width: 25.1684%;">İzin verilen değerler

</th><th class="head" style="width: 18.1814%;">Varsayılan değer

</th><th class="head" style="width: 56.6649%;">Tanım

</th></tr></thead><tbody><tr class="row-even"><td style="width: 25.1684%;">Herhangi bir pozitif tam sayı

</td><td style="width: 18.1814%;">900

</td><td style="width: 56.6649%;">JWT token'larının süresinin dolmasının kaç saniye süreceğini ayarlayın.

</td></tr></tbody></table>

</section><section id="bkmrk-rbac_modubu-ba%C5%9Fl%C4%B1%C4%9Fa-">##### rbac\_mode

  
<table class="docutils align-default" style="width: 100%;"><thead><tr class="row-odd"><th class="head" style="width: 23.5911%;">İzin verilen değerler

</th><th class="head" style="width: 17.5774%;">Varsayılan değer

</th><th class="head" style="width: 58.8474%;">Tanım

</th></tr></thead><tbody><tr class="row-even"><td style="width: 23.5911%;">siyah, beyaz

</td><td style="width: 17.5774%;">beyaz

</td><td style="width: 58.8474%;">RBAC davranışını ayarlayın. Varsayılan olarak, siyah modda her şeye izin verilirken beyaz modda her şey reddedilir. İstenen RBAC altyapısına daha uygun olan rbac\_mode'u seçin. Siyah modda, sadece bazı politikalarla birkaç belirli eylem-kaynak çiftini reddetmek çok kolaydır, beyaz mod ise daha güvenlidir ve sıfırdan oluşturulmasını gerektirir.

</td></tr></tbody></table>

</section></section></section><section id="bkmrk-yap%C4%B1land%C4%B1rma-u%C3%A7-nokt">### Yapılandırma Endpoints

Wazuh sunucu API'sinin geçerli yapılandırmasını sorgulamaya izin veren birkaç uç noktası vardır. Genel API yapılandırmasını değiştirmek için dosyayı [<span class="std std-ref">Wazuh sunucu API yapılandırma dosyası </span>](https://acikkaynak.lastguard.com.tr/books/kullanim-kilavuzu/page/yapilandirma)`<span class="pre">/var/ossec/api/configuration/api.yaml</span>` bölümünde ayrıntılı olarak açıklandığı şekilde düzenleyin .

<section id="bkmrk-yap%C4%B1land%C4%B1rmay%C4%B1-albu-">#### Yapılandırmayı Al

- [GET /manager/api/config](https://documentation.wazuh.com/current/user-manual/api/reference.html#operation/api.controllers.manager_controller.get_api_config) : Yerel Wazuh sunucusunun API yapılandırmasının tamamını alın.
- [GET /cluster/api/config](https://documentation.wazuh.com/current/user-manual/api/reference.html#operation/api.controllers.cluster_controller.get_api_config) : Tüm küme düğümlerinin (veya bir listesinin) Wazuh sunucusu API yapılandırmasının tamamını alın.
- [GET /security/config](https://documentation.wazuh.com/current/user-manual/api/reference.html#operation/api.controllers.security_controller.get_security_config) : Mevcut güvenlik yapılandırmasını alın.

</section><section id="bkmrk-yap%C4%B1land%C4%B1rmay%C4%B1-de%C4%9Fi%C5%9F">#### Yapılandırmayı Değiştir

- [PUT /security/config](https://documentation.wazuh.com/current/user-manual/api/reference.html#operation/api.controllers.security_controller.put_security_config) : Güvenlik yapılandırmasını değiştirin.

</section><section id="bkmrk-yap%C4%B1land%C4%B1rmay%C4%B1-geri-">#### Yapılandırmayı Geri Yükle

- [DELETE /security/config](https://documentation.wazuh.com/current/user-manual/api/reference.html#operation/api.controllers.security_controller.delete_security_config) : Varsayılan güvenlik yapılandırmasını geri yükler.

</section></section><section id="bkmrk-ssl-sertifikas%C4%B1bu-ba">### SSL sertifikası

<p class="callout info">Not: Bu işlem Wazuh sunucu API'si ilk kez çalıştırıldığında otomatik olarak gerçekleştirilir.</p>

SSL sertifikası, Wazuh sunucu API'si ile istemcileri arasında güvenli iletişimi sağlar. Sertifika dosyaları dizinde saklanır `<span class="pre">/var/ossec/api/configuration/ssl/</span>`.

Wazuh sunucu API'si için yeni sertifikalar oluşturmak üzere aşağıdaki adımları izleyin:

1. Anahtar ve sertifika isteğini oluşturun ( `<span class="pre">openssl</span>`paket gereklidir):
    
    ```
    cd /var/ossec/api/configuration/ssl
    openssl req -newkey rsa:2048 -new -nodes -x509 -days 365 -keyout server.key -out server.crt
    ```
    
    Varsayılan olarak, anahtarın parolası sunucu her çalıştırıldığında girilmelidir. Anahtar Wazuh sunucu API'si veya yukarıdaki komut tarafından üretilmişse, parolası olmazdı.
2. (İsteğe bağlı) Anahtarı bir parola ile güvenceye alın:
    
    ```
    ssh-keygen -p -f server.key
    ```
    
    Yeni şifreyi girmeniz ve onaylamanız istenecektir.

</section>