एन्क्रिप्टेड SQLite डेटाबेस का उपयोग कैसे करें

उद्देश्य. संवेदनशील डेटा को डिस्क पर एक सिफर किए गए डेटाबेस (SQLite3MC के माध्यम से) के साथ सुरक्षित करना। एन्क्रिप्शन opt-in है: कुंजी के बिना डेटाबेस एक सामान्य SQLite है, बिना किसी सिफर लागत के। कुंजी के साथ, CrossFly सिफर लागू करता है और कुंजी को खोलने पर मान्य करता है (जल्दी विफल होता है, पहली query पर नहीं)।

उपयोग की गई APIs

• SqliteDb.open(String filename, byte[] key) — डिफ़ॉल्ट सिफर Sqlite.Cipher.CHACHA20 (ChaCha20-Poly1305) के साथ सिफर किया हुआ खोलता/बनाता है।
• SqliteDb.open(String filename, byte[] key, Sqlite.Cipher cipher) — स्पष्ट सिफर के साथ खोलता है। विकल्प: CHACHA20, SQLCIPHER (AES-256-CBC + HMAC), AES128CBC, AES256CBC, RC4, ASCON128।
• SqliteDb.rekey(byte[] newKey) — sqlite3_rekey के माध्यम से कुंजी बदलता है। null या खाली array (new byte[0]) पास करना एन्क्रिप्शन को हटा देता है (“rekey to no key”)।
• SqliteException.code — त्रुटि का संख्यात्मक कोड। Sqlite के स्थिरांकों से तुलना करें। गलत कुंजी / फ़ाइल डेटाबेस नहीं है ⇒ code == Sqlite.NOTADB (26)। अन्य उपयोगी: Sqlite.BUSY (5), Sqlite.CONSTRAINT (19)।

गलत कुंजी कैसे दिखती है। कुंजी के साथ open में, CrossFly सिफर का चयन करता है, कुंजी लागू करता है और एक बलपूर्वक पठन (SELECT count(*) FROM sqlite_master) करता है ताकि गलत कुंजी के साथ तुरंत विफल हो सके, कनेक्शन बंद करते हुए। आप SqliteException को code == Sqlite.NOTADB के साथ पकड़ते हैं।

पुनः खोलते समय सिफर का ध्यान रखें। किसी मौजूदा डेटाबेस को पुनः खोलने के लिए, उसी सिफर का उपयोग करें जिसके साथ इसे बनाया गया था। CHACHA20 (डिफ़ॉल्ट) केवल CHACHA20 डेटाबेस को डिक्रिप्ट करता है; एक SQLCIPHER डेटाबेस को open(file, key, Sqlite.Cipher.SQLCIPHER) की आवश्यकता होती है।

पूर्ण उदाहरण (कॉपी करें, पेस्ट करें और चलाएँ)

package com.exemplo;

import java.nio.charset.StandardCharsets;

import dev.crossfly.ui.*;                     // Window
import dev.crossfly.ui.layout.*;             // VerticalLayout
import dev.crossfly.sqlite.*;                // SqliteDb, Sqlite, SqliteException

/** चलाने योग्य मुख्य स्क्रीन। launcher (classname) की ओर संकेत करें और चलाएँ: gradlew :lwjgl3:run */
public class MainWindow extends Window
{
   @Override
   public void onShow() throws Exception
   {
      super.onShow();
      setLayout(new VerticalLayout());

      byte[] key = "minha-senha-forte".getBytes(StandardCharsets.UTF_8);

      // एन्क्रिप्टेड खोलें/बनाएँ (डिफ़ॉल्ट cipher CHACHA20)
      try (SqliteDb db = SqliteDb.open("secure.db", key))
      {
         db.exec("CREATE TABLE IF NOT EXISTS secret(id INTEGER PRIMARY KEY, v TEXT)");
         db.execute("INSERT INTO secret(v) VALUES(?)", "dado sensível");

         // कुंजी बदलें
         byte[] novaKey = "senha-ainda-mais-forte".getBytes(StandardCharsets.UTF_8);
         db.rekey(novaKey);
         // db.rekey(new byte[0]);  // <- एन्क्रिप्शन हटा देगा
      }

      // स्पष्ट cipher (SQLCipher के साथ संगत)
      try (SqliteDb db = SqliteDb.open("sqlcipher.db", key, Sqlite.Cipher.SQLCIPHER))
      {
         db.exec("SELECT count(*) FROM sqlite_master");
      }

      // गलत कुंजी का पता लगाएँ
      try (SqliteDb db = SqliteDb.open("secure.db", "chave-errada".getBytes(StandardCharsets.UTF_8)))
      {
         // यहाँ नहीं पहुँचता: open में सत्यापन पहले ही विफल हो गया
      }
      catch (SqliteException e)
      {
         if (e.code == Sqlite.NOTADB)          // 26 = गलत कुंजी / डेटाबेस नहीं है
            System.out.println("Chave incorreta");
         else
            throw e;
      }
   }
}

नीचे दिया गया अंश केवल मुख्य भाग दिखाता है। इसे चलाने के लिए, इसे ऊपर दिए गए MainWindow ढाँचे में रखें।

न्यूनतम अंश

// स्रोत में सत्यापित: open(file,key), open(file,key,cipher), rekey, SqliteException.code == Sqlite.NOTADB
import dev.crossfly.sqlite.*;
import java.nio.charset.StandardCharsets;

byte[] key = "minha-senha-forte".getBytes(StandardCharsets.UTF_8);

// एन्क्रिप्टेड खोलें/बनाएँ (डिफ़ॉल्ट cipher CHACHA20)
try (SqliteDb db = SqliteDb.open("secure.db", key))
{
   db.exec("CREATE TABLE IF NOT EXISTS secret(id INTEGER PRIMARY KEY, v TEXT)");
   db.execute("INSERT INTO secret(v) VALUES(?)", "dado sensível");

   // कुंजी बदलें
   byte[] novaKey = "senha-ainda-mais-forte".getBytes(StandardCharsets.UTF_8);
   db.rekey(novaKey);
   // db.rekey(new byte[0]);  // <- एन्क्रिप्शन हटा देगा
}

// स्पष्ट cipher (SQLCipher के साथ संगत)
try (SqliteDb db = SqliteDb.open("sqlcipher.db", key, Sqlite.Cipher.SQLCIPHER))
{
   db.exec("SELECT count(*) FROM sqlite_master");
}

// गलत कुंजी का पता लगाएँ
try (SqliteDb db = SqliteDb.open("secure.db", "chave-errada".getBytes(StandardCharsets.UTF_8)))
{
   // यहाँ नहीं पहुँचता: open में सत्यापन पहले ही विफल हो गया
}
catch (SqliteException e)
{
   if (e.code == Sqlite.NOTADB)          // 26 = गलत कुंजी / डेटाबेस नहीं है
      System.out.println("Chave incorreta");
   else
      throw e;
}

और गहराई से जानें

• सुरक्षा की सर्वोत्तम प्रथाएँ · SQLite स्टोरेज गाइड
• सहयोगी रेसिपी: डेटाबेस खोलें/बनाएँ · पैरामीट्रिकृत CRUD