vault plugin secrets qdrant

Mesin Rahasia Hashicorp Vault - Plugin Qdrant

vault-plugin-secrets-qdrant adalah plugin Hashicorp Vault yang memperluas lemari besi dengan mesin rahasia untuk Qdrant untuk Auth JWT.

Ini mampu menghasilkan Token Qdrant Credentials/JWT yang ditandatangani dengan kontrol akses granular.

Peran disimpan dalam lemari besi dan dapat dicabut kapan saja.

Token JWT yang dihasilkan bersifat sesaat dan tanpa kewarganegaraan; Mereka tidak disimpan dalam lemari besi tetapi dapat terikat pada peran dan tidak valid ketika peran dihapus.

Plugin ini juga dapat membuat/memperbarui/menghapus data peran ke server qdrant

Fitur

• Dukung konfigurasi multi-instansi
• Izinkan manajemen token TTL per instance dan/atau peran
• Perubahan Peran Push (Buat/Perbarui/Hapus) ke server Qdrant
• Menghasilkan dan menandatangani token JWT berdasarkan instance dan parameter peran
• Izinkan penyediaan klaim khusus (akses dan filter) untuk peran
• Dukung TLS dan CA khusus untuk terhubung ke server Qdrant

Memulai

Mesin Rahasia Qdrant menghasilkan kredensial JWT secara dinamis.

Plugin mendukung beberapa sumber daya, termasuk: Config, Role dan JWT.

Harap baca dokumentasi Qdrant resmi untuk memahami konsep token dan akses serta proses otentikasi.

Tangan yang penuh dengan sumber daya dapat didefinisikan dalam plugin Vault:

Konfigurasi

Sumber Daya config Tipe Mewakili Konfigurasi Instance Database untuk Rahasia.

Jalur entitas	Keterangan	Operasi
qdrant/config	Daftar instance	daftar
qdrant/config/	Kelola Config Config	Tulis, baca, hapus

Peran

Sumber daya role tipe mewakili konfigurasi peran database untuk rahasia.

Jalur entitas	Keterangan	Operasi
qdrant/peran/	Daftar peran untuk	daftar
Qdrant/Role //	Kelola Konfigurasi Peran Contoh	Tulis, baca, hapus

Jwt

Sumber daya Type jwt mewakili Token JWT Database.

Jalur entitas	Keterangan	Operasi
qdrant/jwt //	Menghasilkan token untuk peran	membaca

Konfigurasi

Ada argumen yang dapat diteruskan ke jalur untuk config/ (instance database), role/ .

Konfigurasi

Kunci	Jenis	Diperlukan	Contoh	Keterangan
url	bool	BENAR	Qdrant: 6334	Alamat URL instance Qdrant (Protokol GRPC)
sig_key	rangkaian	BENAR	Key Secret	Kunci rahasia untuk menandatangani dan memverifikasi (API-Key Server) token.
sig_alg	rangkaian	BENAR	HS256	Algoritma untuk memecahkan kode token.
jwt_ttl	rangkaian	BENAR	300 -an	TTL default misalnya token (dapat ditimpa dalam peran)
tls	bool	PALSU	BENAR	Jika diatur ke True - Vault akan membuka koneksi TLS GRPC ke Qdrant
ca	rangkaian	PALSU	eyjhbgc ...	BASE64 Ditkodekan CA CA CERT UNTUK TLS

Catatan: Saat Anda menghapus konfigurasi instan, semua peran terkait akan secara otomatis dihapus dari instance Qdrant.

Peran

Kunci	Jenis	Diperlukan	Contoh	Keterangan
jwt_ttl	rangkaian	PALSU	300 -an	TTL misalnya token
klaim	json	BENAR		Atribut Akses dan Filter (lihat Qdrant Doc)

Catatan: Sinkronisasi Peran Vault dengan Koleksi Instance Qdrant sys_roles secara otomatis

Contoh claims

{
    "claims":{
        "value_exists": {
            "collection": "sys_roles",
            "matches": [
            { "key": "role", "value": "write2" }
            ]
        },
        "access": [
            {
            "collection": "my_collection",
            "access": "r"
            }
        ]
    }
}

Instalasi dan Pengaturan

Untuk menggunakan plugin ini, Anda perlu mendaftarkannya dengan Vault. Konfigurasikan server Vault Anda untuk memiliki konfigurasi plugins_directory yang valid.

Catatan: Anda mungkin ingin mengatur api_addr ke alamat mendengarkan Anda dan disable_mlock ke true dalam konfigurasi vault untuk dapat menggunakan plugin.

Instal dari rilis

Unduh rilis stabil terbaru dari halaman rilis dan masukkan ke plugins_directory dari server Vault Anda.

Untuk menggunakan plugin Vault, Anda memerlukan jumlah SHA256 plugin.

Contoh Cara Mendaftarkan Plugin:

 SHA256SUM=$(sha256sum vault-plugin-secrets-qdrant | cut -d' ' -f1)
vault plugin register -sha256 ${SHA256SUM} secret vault-plugin-secrets-qdrant
vault secrets enable -path=qdrant vault-plugin-secrets-qdrant

Catatan: Anda dapat menggunakan bendera -tls-skip-verify jika Anda menggunakan sertifikat yang ditandatangani sendiri.

Perkembangan

Bangun secara lokal

$ make 

Pengaturan Enviroment (Docker Compose)

$ make setup-env

Jalankan tes unit

$ make tests

Jalankan tes ujung ke ujung

$ make e2e

Teardown Enviroment (Docker Compose)

$ make teardown-env

Membersihkan

$ make clean

?? Berkontribusi

Kontribusi kode sangat disambut .

1. Garpu proyek
2. Buat Cabang Anda ( git checkout -b AmazingFeature )
3. Komitmen Anda (`git commit -m 'Tambahkan beberapa fitur luar biasa")
4. Dorong ke cabang ( git push origin AmazingFeature )
5. Buka permintaan tarik yang menargetkan cabang main .