API Attack Surface Discovery ¶

Wallarm'ın API Attack Surface Management çözümünün bir bileşeni olan API Attack Surface Discovery (AASD), seçtiğiniz alan adlarını tarayarak tüm harici host'larını ve bunların API'lerini keşfeder, Web ve API tabanlı saldırılara karşı korumalarını değerlendirir ve eksik WAF/WAAP çözümlerini belirler. Wallarm içinde abone olarak çalışır - herhangi bir şey dağıtmanız gerekmez. Bu makale bileşene genel bir bakış sunar.

Ele alınan konular¶

Sağlanan yetenekler¶

Kuruluşunuzun harici API'lerinin tam listesini bilmek, izlenmeyen veya belgelenmemiş API'lerin kötü amaçlı saldırılar için potansiyel giriş noktaları haline gelebileceği güvenlik risklerini azaltmanın ilk adımıdır.

Wallarm'ın API Attack Surface Discovery bileşeni aşağıdakileri sağlayarak bu sorunları çözmeye yardımcı olur:

Seçili alan adlarınız için harici host'ların otomatik tespiti.
Bulunan host'ların açık portlarının otomatik tespiti.
Bulunan host'ların API'lerinin otomatik tespiti.

Tespit edilebilecek API türleri (protokoller): JSON-API, GraphQL, XML-RPC, JSON-RPC, OData, gRPC, WebSocket, SOAP, WebDav, HTML WEB.

HTML WEB — tarayıcılarla insan erişimine yönelik tasarlanmış bir HTML Web sayfası. Statik bir HTML Web sayfası olabilir ya da API'lere erişebilen bir uygulamanın tek bir HTML sayfası olabilir.
Bulunan host'lar için otomatik security posture değerlendirmesi.
Tüm API yüzeyinin genel WAAP skoru.
Güvenlik satıcısı, veri merkezi ve konuma göre varlık özetleri.

Bir host'un birden fazla IP adresi olabileceğinden, varlık istatistikleri veri merkezleri ve coğrafi konum bazında host bazında değil IP adresi bazında değerlendirilir. CDN'lerin kullanımı nedeniyle varlıkların konumu temsil niteliği taşımayabilir.
Bulunan host'lar için güvenlik sorunlarının otomatik tespiti.

Tüm bunlara Wallarm içinde bileşene abone olarak sahip olursunuz - herhangi bir dağıtım yapmanız gerekmez ve analiz edilmiş verilere anında erişirsiniz.

Eski Scanner'ın değiştirilmesi¶

API Attach Surface Discovery (AASD) yetenekleri, eski Wallarm Scanner'ın tüm işlevselliğini kapsadığından ve - Security Issues ile birlikte - çok daha fazlasını sunduğundan, 7 Mayıs 2025 itibarıyla Scanner devre dışı bırakılmıştır.

Eski Scanner'ın devre dışı bırakılması şunları içerir:

Eski Scanner'ı kullanan tüm müşterilere AASD erişimi sağlanması
Eski Scanner'daki tüm konfigürasyonun Wallarm destek tarafından AASD'ye taşınması
AASD tarafından host ve API'lerin otomatik olarak yeniden keşfedilmesi ve bunlara ilişkin genişletilmiş verilerin sunulması
Host ve API'ler için otomatik güvenlik sorunu tespiti
7 Mayıs 2025'ten önce eski Scanner tarafından bulunan zafiyetler, data retention policy uyarınca Vulnerabilities bölümünde gösterilmeye devam eder

Bulunan host'lara ilişkin veriler¶

Alan adlarınız için host'lar bulunduğunda, Wallarm Console içinde API Attack Surface bölümüne gidin. Listeden host'a tıklayarak şunları görün:

Host için bulunan açık portlar
Host için bulunan API'ler
Host'un değerlendirilen WAAP skoruna ilişkin ayrıntılar

Security posture¶

Wallarm, harici ağ çevrenizin security posture durumunu otomatik olarak değerlendirir ve durumunu 0 (en kötü) ile 100 (en iyi) koruma arasında Total score olarak yansıtır.

Toplam skor, aşağıdakileri içeren karmaşık, tescilli bir formülle hesaplanır:

WAAP kapsam skoru, harici web ve API servislerinin WAF/WAAP çözümleriyle kapsanmasını yansıtır. Skor, WAF/WAAP güvenliğiyle korunan HTTP/HTTPS portlarının payı olarak hesaplanır.
Ortalama WAAP skoru, harici host'ların web ve API saldırılarına karşı dayanıklılığını temsil eder. Skor, AASM'nin engelleme modunda aktif WAAP çözümleri belirlediği ve WAAP skorunun hatasız değerlendirildiği tüm host'lar arasında ortalama skor olarak hesaplanır.

Belirli bir uç noktanın WAAP skoru, Wallarm tarafından test edilmesinin sonucudur ve şu şekilde hesaplanır:
```
((AppSec + FalsePositive) / 2 + APISec) / 2
```
- AppSec - SQL injection, XSS ve komut enjeksiyonu gibi web saldırılarına karşı dayanıklılık.
- APISec - GraphQL, SOAP ve gRPC protokollerini hedefleyenler dahil API saldırılarına karşı dayanıklılık.
- FalsePositive - meşru istekleri yanlışlıkla tehdit olarak algılamadan doğru şekilde izin verme yeteneği.
Her host için, ayrıntılı WAAP skoru değerlendirme raporunu PDF formatında indirebilirsiniz.
Ek metrikler olarak TLS kapsamı, güvenlik sorunlarının varlığı ve tespit edilen güvenlik sorunları.

API saldırı yüzeyi raporları¶

Alan adlarınız için keşfedilen harici host'lar ve onların API'leri hakkında ayrıntılı bir DOCX raporu alabilirsiniz. Bu rapor ayrıca bu API'ler için tespit edilen güvenlik sorunları ile ilgili seçeceğiniz bilgileri de içerecektir.

Bunun yanı sıra, API yüzeyiniz hakkında tablo görünümünde (CSV) bilgi alabilirsiniz; şu şekilde düzenlenmiş:

Host'lar (her host için bir satır)
Portlar (her port için bir satır)
API'ler (her API için bir satır)

Bir diğer seçenek de, makine tarafından okunabilir formatta API yüzeyi hakkında bilgiler içeren JSON rapordur.

Güvenlik sorunları hakkında ayrı bir rapor da alabilirsiniz.

Bildirimler¶

Email¶

You automatically receive notifications to your personal email (the one you use to log in) about discovered hosts and security issues, including:

Daily critical security issues (new only) - all critical security issues opened for the day, sent once a day with a detailed description of each issue and instructions on how to mitigate it.
Daily security issues (new only) - statistics for security issues opened for the day, sent once a day with information on how many issues of every risk level were found and general action items for mitigation.
Weekly AASM statistics - information about hosts, APIs, and statistics for security issues discovered for your configured domains within last week.

The notifications are enabled by default. You can unsubscribe at any moment and configure any additional emails to get all or some of these notifications in Wallarm Console → Configuration → Integrations → Email and messengers → Personal email (you email) or Email report (extra emails) as described here.

Instant notification¶

You can configure instant notification for the new and re-opened security issues. Select all or only some risk levels that should trigger notification. Separate message will be sent for each security issue.

Example:

[Wallarm System] New security issue detected
Notification type: security_issue
New security issue was detected in your system.
ID: 106279
Title: Vulnerable version of Nginx: 1.14.2
Host: <HOST_WITH_ISSUE>
Path:
Port: 443
URL: <URL_WITH_ISSUE>
Method:
Discovered by: AASM
Parameter:
Type: Vulnerable component
Risk: Medium
More details: 
Client: <YOUR_COMPANY_NAME>
Cloud: US

You can configure instant notification for the security issues in Wallarm Console → Configuration → Integrations → YOUR_INTEGRATION as described in your integration documentation.