Herkese açık API başvurusu

VaultPilot’ın herkese açık entegrasyon istemcileri, onaylı sistemler için salt okunur kimliklerdir. Bu istemciler yalnızca şifreli kasa anlık görüntülerini ve işletimsel durum meta verisini alır. Herkese açık API düz metin parola, ana parola, şifresi çözülmüş kasa içeriği veya sunucunun gizli anahtar malzemesini döndürmez.

İstemcileri, yalnızca Sahip (Owner) rolüne açık Entegrasyonlar > API istemcileri ekranından oluşturun. İstemci kimliği pmc_, istemci sırrı pms_ ile başlar; sır yalnızca bir kez gösterilir ve sunucuda yalnızca özeti saklanır. Sırrı kaybederseniz yeni bir istemci oluşturun ve eskisini iptal edin.

v1 uç noktaları yalnızca GET isteğiyle okunur. İstek gövdesi göndermeyin. Gövde içeren istekleri sunucu, kimlik bilgilerine bakmadan reddeder.

Kimlik doğrulama yöntemleri

Yeni entegrasyonlarda HTTP Basic kimlik doğrulaması kullanın:

Authorization: Basic ${BASE64_CLIENT_CREDENTIALS}

Eski istemciler için uyumluluk üst bilgileri çalışır:

x-passman-client-id: <CLIENT_ID>
x-passman-client-secret: <CLIENT_SECRET>

Bu üst bilgilerin hiçbirini günlüğe yazmayın. Gerçek istemci kimliklerini, istemci sırlarını, şifreli içerikleri, kasa kimliklerini veya sır kimliklerini ekran görüntülerine, dokümanlara ya da destek yazışmalarına yapıştırmayın. Biçimi bozuk kimlik bilgileri hemen reddedilir.

Kapsamlar ve uç noktalar

SECRETS_READ için en az bir kasa atanmış olmalıdır. Yalnızca durum izleyen istemcileri kasa atamadan oluşturabilirsiniz.

PowerShell ile örnek istekler

Basic kimlik doğrulamalı PowerShell örneği:

$pair = "<CLIENT_ID>:<CLIENT_SECRET>"
$basic = [Convert]::ToBase64String([Text.Encoding]::UTF8.GetBytes($pair))
Invoke-RestMethod -Headers @{ Authorization = "Basic $basic" } -Uri "https://<SERVER_HOST>:1734/api/public/v1/server/status"

Uyumluluk üst bilgileriyle örnek:

Invoke-RestMethod `
  -Headers @{
    "x-passman-client-id" = "<CLIENT_ID>"
    "x-passman-client-secret" = "<CLIENT_SECRET>"
  } `
  -Uri "https://<SERVER_HOST>:1734/api/public/v1/secrets"

Paylaşacağınız örneklerde yer tutucu kullanın; gerçek değerler yalnızca API’yi kullanan sistemin onaylı sır deposunda durmalıdır. Gerçek $pair veya $basic değerleri içeren komutları yalnızca size ait, özel bir kabukta çalıştırın.

Şifreli anlık görüntü yanıtı

Sır anlık görüntüsü yanıtları şifresi çözülmüş kayıtlar içermez; şifreli içerik döner:

{
  "mode": "ENCRYPTED_SNAPSHOT",
  "vaults": [
    {
      "id": "<VAULT_ID>",
      "nameEncrypted": "<ENCRYPTED_VAULT_NAME>",
      "secrets": [
        {
          "id": "<SECRET_ID>",
          "type": "LOGIN",
          "payloadEncrypted": "<ENCRYPTED_PAYLOAD>",
          "updatedAt": "<ISO_TIMESTAMP>"
        }
      ]
    }
  ]
}

Durum uç noktaları yalnızca işletimsel meta veri döndürür ve kasa içeriğinin şifresini çözmez.

Yanıt kodları ve hata durumları

API yanıtları Cache-Control: no-store içerir; tarayıcılar ve aradaki sunucular anlık görüntüleri önbelleğe almaz. v1 uç noktaları her istekte güncel veriyi okur ve dakikada en fazla 120 istek kabul eder.

İlgili sayfalar

• Entegrasyon API istemcileri
• Güvenlik ve güven modeli
• API istemcisi 401, kapsam reddi veya boş veri alıyor

Dokümantasyon sayfasına dönün →