Laravel için Dinamik Alan Düzeyi Güvenliği

Son güncelleme: 2 Şubat 2026 22:01

FieldGuard, Eloquent modellerinde alan düzeyinde güvenlik sağlarken kullanılabilecek hafif, müdahale etmeyen bir Laravel paketidir. Kullanıcıların belirli nitelikleri görüntüleme veya değiştirme yetkisini dinamik, veritabanı tabanlı kurallarla kontrol etmenizi sağlar.

<h2>Özellikler</h2>
<ul>
    <li><strong>Veritabanı Tabanlı Kurallar:</strong> Çalışma zamanı yapılandırması için veritabanında güvenlik kuralları oluşturun ve yönetin.</li>
    <li><strong>Müdahale Etmeyen:</strong> Modelleriniz için herhangi bir trait, temel sınıf veya nitelik gerektirmez.</li>
    <li><strong>Otomatik Uygulama:</strong> Hiçbir kod değişikliği olmadan model olayları (<code>retrieved</code>, <code>saving</code>) yoluyla güvenliği zorunlu hale getirebilirsiniz.</li>
    <li><strong>Okuma ve Yazma Koruması:</strong> Alanları görüntüleme ve güncelleme için ayrı kurallar oluşturun.</li>
    <li><strong>Veri Maskesi:</strong> Hassas alanları otomatik olarak maskeleyin (örneğin, <code> *- *- *</code>).</li>
    <li><strong>Middleware Entegrasyonu:</strong> Gelen taleplerden yetkisiz alanları otomatik olarak filtreleyin.</li>
    <li><strong>Önbellekleme:</strong> Veritabanı kuralları için Laravel önbellek desteği ile performans optimize edilmiştir.</li>
    <li><strong>Herkes İçin Kullanılabilir:</strong> Temel modellerinizi değiştirmeden merkezi bir kontrol sağlar.</li>
</ul>

<h2>Kurulum</h2>
<div class="highlight js-code-highlight">
    <pre class="highlight shell"><code>composer require sowailem/fieldguard

<p>Kuralları oluşturmak için göçleri çalıştırın:<br/></p>
<div class="highlight js-code-highlight">
    <pre class="highlight shell"><code>php artisan migrate

<h2>Kullanım</h2>

<h3>1. Güvenlik Kuralları Oluşturma</h3>
<p>Tüm alan düzeyindeki izinler <code>field_guard_rules</code> tablosu üzerinden yönetilmektedir. Kurallar oluşturmak için <code>FieldGuardRule</code> modelini kullanabilirsiniz.<br/></p>
<div class="highlight js-code-highlight">
    <pre class="highlight php"><code>use Sowailem\FieldGuard\Models\FieldGuardRule;

FieldGuardRule::create([
‘model_class’ => ‘App\Models\User’,
‘field_name’ => ‘salary’,
‘read_policy’ => [
‘roles’ => [‘admin’, ‘hr’],
‘allow_self’ => true
],
‘write_policy’ => [
‘roles’ => [‘admin’],
],
‘mask’ => ‘PROTECTED’,
‘is_active’ => true,
]);

<h4>Kural Yapısı</h4>
<ul>
    <li><code>model_class</code>: Eloquent modelinin tam nitelikli sınıf adı.</li>
    <li><code>field_name</code>: Güvence altına alınacak niteliğin adı.</li>
    <li><code>read_policy</code>: (Opsiyonel) Alanı görüntüleme izni. Bir dize veya JSON nesnesi olabilir.</li>
    <li><code>write_policy</code>: (Opsiyonel) Alanı oluşturma veya güncelleme izni. Bir dize veya JSON nesnesi olabilir.</li>
    <li><code>mask</code>: (Opsiyonel) <code>read</code> izni reddedildiğinde dönecek değer (alan kaldırılmadan)</li>
    <li><code>is_active</code>: Kuralı etkinleştirmek/devre dışı bırakmak için bir boolean (varsayılan true).</li>
</ul>

<h4>Politika Türleri</h4>
<p>Politikalar şunlar olabilir:</p>
<ul>
    <li><code>Gate Name</code>: Bir Laravel Gate adı (örneğin, <code>'view-salary'</code>).</li>
    <li><code>'self'</code>: Kullanıcının ID'si modelin birincil anahtarıyla eşleşiyorsa erişim sağlar.</li>
    <li><code>'role:name'</code>: Kullanıcının belirli bir role sahip olmasını gerektirir (Kullanıcı modelinde <code>hasRole($role)</code> methodunu bekler).</li>
    <li><code>'true'</code> / <code>'false'</code>: Her zaman izin ver veya her zaman reddet.</li>
    <li><code>JSON Array</code>: Karmaşık mantık için (örneğin, <code>['roles' => ['admin'], 'allow_self' => true, 'gate' => 'extra-check']</code>).</li>
</ul>

<h3>2. Güvenliği Uygulama</h3>

<h4>Otomatik Uygulama (Küresel)</h4>
<p>Tüm modeller için otomatik uygulamayı etkinleştirmek için <code>config/fieldguard.php</code> dosyanızda <code>automatic_enforcement</code> değerini <code>true</code> olarak ayarlayın. Bu, alanları otomatik olarak filtrelemek için Eloquent olaylarını kullanır.<br/></p>
<div class="highlight js-code-highlight">
    <pre class="highlight php"><code>'automatic_enforcement' => true,

<ul>
    <li><strong>Okuma:</strong> Model veritabanından alındığında alanları otomatik olarak gizler veya maskeler.</li>
    <li><strong>Yazma:</strong> Yetkisiz alanların kaydedilmesini otomatik olarak engeller (orijinal değerlere geri döner).</li>
</ul>

<h4>Manuel Uygulama (Okuma)</h4>
<p>Modül niteliklerini filtrelemek için <code>FieldGuard</code> facade'ini kullanabilirsiniz. Bu, kontrolcüler veya API kaynaklarında faydalıdır.<br/></p>
<div class="highlight js-code-highlight">
    <pre class="highlight php"><code>use Sowailem\FieldGuard\Facades\FieldGuard;

public function view(User $user)
{
// Güvenlik kurallarına göre filtrelenmiş model niteliklerini bir dizi olarak döndürür
return FieldGuard::apply($user, auth()->user());
}

<h4>API Kaynağı Entegrasyonu</h4>
<div class="highlight js-code-highlight">
    <pre class="highlight php"><code>public function toArray($request)

{
return FieldGuard::apply($this->resource, $request->user());
}

<h4>Otomatik Uygulama (Middleware - Yazma)</h4>
<p>Middleware'i <code>bootstrap/app.php</code> (Laravel 11+) veya <code>app/Http/Kernel.php</code> dosyanıza kaydedin:<br/></p>
<div class="highlight js-code-highlight">
    <pre class="highlight php"><code>// Laravel 11+ örneği bootstrap/app.php içinde

->withMiddleware(function (Middleware $middleware) {
$middleware->alias([
‘fieldguard’ => \Sowailem\FieldGuard\Middleware\EnforceFieldSecurityMiddleware::class,
]);
})

<p>Middleware'i rotalara uygulayarak talep verilerini kontrolcülerinize ulaşmadan önce filtreleyin:<br/></p>
<div class="highlight js-code-highlight">
    <pre class="highlight php"><code>Route::put('/users/{user}', [UserController::class, 'update'])
->middleware('fieldguard:App\Models\User');

<p>Middleware, yetkisiz alanları <code>$request->all()</code>'den otomatik olarak kaldıracaktır.</p> <h3>3. Önbellekleme</h3> <p>Veritabanı kuralları performans için önbelleğe alınır. Varsayılan olarak, <code>fieldguard:rules</code> etiketi ile önbelleğe alınır (bu <code>config/fieldguard.php</code> dosyasında yapılandırılabilir). <code>FieldGuardRuleRepository</code> aracılığıyla kuralları güncellediğinizde, önbellek otomatik olarak temizlenir.</p> <p>Önbelleği manuel olarak temizlemek için:<br/></p> <div class="highlight js-code-highlight"> <pre class="highlight shell"><code>php artisan fieldguard:clear-cache

<h3>4. Özel Politika Çözümleyicileri</h3> <p>Veritabanı politikalarını yorumlamak için özel bir mantığa ihtiyaç duyuyorsanız (örneğin, belirli bir RBAC sistemiyle entegrasyon), <code>PolicyResolver</code> arayüzünü uygulayın ve <code>config/fieldguard.php</code> dosyasında kaydedin.<br/></p> <div class="highlight js-code-highlight"> <pre class="highlight php"><code>namespace App\Security;

<h3>5. İlk Kuralların Oluşturulması</h3> <p>Paket, kuralları başlatmanıza yardımcı olmak için bir seeder örneği içerir. Seeder'ı yayınlayabilir ve çalıştırabilir veya sağlanan örneği kullanabilirsiniz:<br/></p> <div class="highlight js-code-highlight"> <pre class="highlight shell"><code>php artisan db:seed --class="Sowailem\FieldGuard\Database\Seeders\FieldGuardRuleSeeder"

<h3>6. İdari API</h3> <p>FieldGuard, güvenlik kurallarını yönetmek için yerleşik RESTful API uç noktaları ile birlikte gelir.</p> <ul> <li><code>GET /field-guard/rules</code> – Tüm kuralları listeleyin (sayfalandırma ve filtreleme destekler)</li> <li><code>POST /field-guard/rules</code> – Yeni bir kural oluşturun</li> <li><code>GET /field-guard/rules/{id}</code> – Belirli bir kuralı görüntüleyin</li> <li><code>PUT/PATCH /field-guard/rules/{id}</code> – Mevcut bir kuralı güncelleyin</li> <li><code>DELETE /field-guard/rules/{id}</code> – Bir kuralı silin</li> </ul> <h4>Yapılandırma</h4> <p>API ön ekini ve middleware'i <code>config/fieldguard.php</code> dosyasında özelleştirebilirsiniz:<br/></p> <div class="highlight js-code-highlight"> <pre class="highlight php"><code>'api' => [ 'enabled' => true, 'prefix' => 'field-guard', 'middleware' => ['api', 'auth:sanctum'],

<h4>Yetkilendirme</h4> <p>API, istekleri yetkilendirmek için <code>manage-field-guard</code> adında bir kapı kullanır. Bu kapıyı <code>AuthServiceProvider</code> veya <code>AppServiceProvider</code> dosyanızda tanımladığınızdan emin olun:<br/></p> <div class="highlight js-code-highlight"> <pre class="highlight php"><code>use Illuminate\Support\Facades\Gate;

<h4>Rotaları Yayınlama</h4> <p>Rotaları özelleştirmek istiyorsanız, bunları yayınlayabilirsiniz:<br/></p> <div class="highlight js-code-highlight"> <pre class="highlight shell"><code>php artisan vendor:publish --tag="fieldguard-routes"

Laravel için Dinamik Alan Düzeyi Güvenliği

Sanal Medya

Son Eklenenler

Mira Murati Yeniden Sahneye Çıkıyor

HP, RTX 5080 oyun PC’sinde 2.600 $ indirim yaptı!

$559 Nvidia RTX 5070 GPU, en uygun fiyatla 1440p oyun sunuyor

Laravel’de Carbon (MultiCarbon) ile Jalali ve Hijri Tarihleri

DDR4 bellek ve anakart üretimi yeniden başlıyor, DDR5’siz geleceğe hazırlık

AI token maliyetleri büyük bir sorun haline geliyor, OpenAI çözümler arıyor

Siber güvenlik, yapay zeka ve savunma sanayiinden; finans ve sinema dünyasına uzanan geniş bir yelpaze. Teknomers; teknoloji, strateji ve yazılım dünyasını sade bir dille sizlerle buluşturuyor.

Kurumsal

Kategoriler

Populer