VS Code eklentisi

Kurulum

vetkit eklentisini (yayıncı vetkit, kimlik vetkit.vetkit-vscode) Visual Studio Code Marketplace üzerinden kurun. VS Code 1.85 veya üzeri gerekir.

Oturum açma

Komut Paleti’nden vetkit: Sign In komutunu çalıştırın ya da Findings görünümünde Sign in to vetkit bağlantısına tıklayın.

1. Tarayıcınız vetkit uygulamasını /ide/connect adresinde açar ve tek kullanımlık bir kod gösterir. Kodun VS Code’da gösterilen kodla aynı olduğunu kontrol edin.
2. Kuruluşu seçin ve onaylayın. Üye veya daha yüksek bir rol gerekir; Görüntüleyiciler onaylayamaz.
3. Onay, “VS Code — cihaz adı” adlı, 90 gün sonra süresi dolan salt okunur bir API anahtarı (scope’lar repos:read, audits:read, findings:read, findings:ai-fix) oluşturur. Eklenti bunu VS Code Secret Storage içinde saklar.

Eklenti, anahtarın süresi dolmadan yaklaşık 7 gün önce sizi uyarır. Anahtarın süresi dolduğunda veya iptal edildiğinde yeniden oturum açmanızı ister.

Alternatif olarak vetkit: Set API Key komutunu çalıştırıp kendi oluşturduğunuz bir anahtarı yapıştırabilirsiniz.

Depo algılama

Eklenti, çalışma alanının .git/config dosyasındaki remote’ları okur (git çalıştırmaz), bunları host/owner/name biçimine normalleştirir ve oturum açtığınız kuruluşta arar. Tek bir eşleşme varsa otomatik seçilir.

Aksi halde vetkit: Select Repository bir seçici gösterir. Seçicide, depo önceden doldurulmuş olarak vetkit Repositories sayfasını açan Connect this repository in vetkit seçeneği bulunur.

Sonuçlar, kaydedilmemiş düzenleyici içeriğinden değil, sunucu tarafındaki en son başarılı denetimden gelir. Yerel HEAD denetlenen commit’ten farklıysa sonuçlar eski olarak işaretlenir.

Bağlantıyı kesme

• vetkit: Sign Out anahtarı sunucuda iptal eder ve cihazınızdan siler. Elle yapıştırılan bir anahtar yalnızca yerelde unutulur; iptal edilmez.
• Cihazı vetkit uygulamasında Settings → Security → Connected devices altından da iptal edebilirsiniz; kuruluş yöneticileri Settings → API keys altından iptal edebilir.
• Bir üyeyi kuruluştan çıkarmak veya rolünü Görüntüleyici olarak değiştirmek, o kuruluştaki VS Code anahtarlarını otomatik olarak iptal eder.

Gönderilen veriler

• Oturum açarken cihaz (host) adı; temizlenir ve API anahtarını adlandırmak için kullanılır.
• Depo aramasında kullanılan normalleştirilmiş git remote (host/owner/name).
• Depoları, denetimleri ve bulguları listelemek için kimliği doğrulanmış API istekleri.

Eklenti kaynak kodunu asla yüklemez.

Kendi sunucunuzda barındırılan kurulumlarda vetkit.apiUrl ayarını yapın (localhost dışında HTTPS gerekir). Anahtar yalnızca onu veren API’ye gönderilir.