vaultPHP

PHP Hashicorp Vault Client

Perpustakaan Klien PHP untuk Layanan Hashicorp Vault. Klien ini mengikuti data permintaan dan respons yang sama dengan dokumentasi klien Hashicorp Vault.

• Otentikasi https://www.vaultproject.io/api-docs/auth
• Mesin rahasia https://www.vaultproject.io/api-docs/secret

Jangan ragu untuk membuka permintaan tarik untuk menambah perbaikan atau fungsi yang hilang.

Instalasi

Komposer

composer require mittwald/vault-php

Fungsionalitas yang diimplementasikan:

• Auth
  • Pengguna/Kata Sandi
  • Token
  • Kubernetes
  • Persetujuan
• Mesin rahasia
  • Mesin transit
    • Mengenkripsi/dekripsi
    • Perbarui Kunci Kunci
    • Buat kunci
    • Hapus kunci
    • Daftar kunci
    • Menandatangani data

Penggunaan dasar

 // setting up independent http client 
$ httpClient = new Client ();

// setting up vault auth provider
$ auth = new Token ( ' foo ' );

// creating the vault request client
$ client = new VaultClient (
    $ httpClient ,
    $ auth ,
    ' http://127.0.0.1:8200 '
);

// selecting the desired secret engine
// e.g. Transit Secret Engine
$ api = new Transit ( $ client );

// calling specific endpoint
$ response = $ api -> listKeys ();

//reading results
var_dump ( $ response -> getKeys ());
//...
//...
//Profit... 

VaultClient

 public function __construct(
    HttpClient $ httpClient ,
    AuthenticationProviderInterface $ authProvider ,
    string $ apiHost
)

HttpClient mengambil setiap adaptor klien http psr-18 yang sesuai seperti "php-http/curl-client": "^1.7"

AuthenticationProviderInterface Authentication Provider dari /authentication/provider/*

$apiHost hashicorp vault endpoint URL titik akhir

Permintaan curah

Menggunakan permintaan curah juga mengharuskan untuk mengulangi respons dan memanggil hasErrors dalam MetaData dari setiap item curah untuk memastikan itu diproses dengan sukses.

Pengecualian

Metode Perpustakaan Memanggil akan melempar pengecualian, menunjukkan di mana data yang tidak valid disediakan atau kesalahan HTTP terjadi atau melingkarkan kesalahan titik akhir generik ditemui.

---

VaultException

Pengecualian akar generik di mana setiap pengecualian di perpustakaan ini meluas dari.

---

VaultHttpException

Pengecualian akan dilemparkan ketika sesuatu di dalam penanganan HTTP akan menyebabkan kesalahan.

---

VaultAuthenticationException

Akan dilemparkan ketika otentikasi titik akhir API gagal.

---

VaultResponseException

Akan dilemparkan pada kesalahan kode status 5xx.

---

InvalidRouteException

Memanggil titik akhir API Vault API yang tidak valid/tidak ada/dinonaktifkan akan melempar pengecualian ini.

---

InvalidDataException

Pengecualian menunjukkan validasi muatan server yang gagal.

---

KeyNameNotFoundException

Akan dilemparkan ketika mencoba meminta titik akhir API di mana nama kunci - yang ditunjukkan dalam URL - tidak akan ada.