Menutupi data sensitif dalam buku kerja Excel adalah kebutuhan umum bagi perusahaan yang berbagi laporan secara internal atau dengan mitra. GroupDocs.Merger Cloud SDK for Java memungkinkan pengembang menambahkan perlindungan kata sandi ke file XLSX melalui API REST sederhana. Dalam panduan ini Anda akan mempelajari cara mengimplementasikan password Protect Excel via REST in Java, melihat contoh Java lengkap, dan menjalankan perintah cURL setara untuk integrasi cloud.

Prasyarat dan Penyiapan

Sebelum Anda memulai, pastikan Anda memiliki hal berikut:

  • Java 8 atau lebih tinggi terpasang.
  • Maven atau Gradle untuk manajemen dependensi.
  • Akun GroupDocs Cloud dengan client ID dan client secret.
  • Akses ke penyimpanan cloud tempat file Excel akan berada.

Tambahkan dependensi Maven ke pom.xml Anda (atau potongan Gradle yang setara):

<dependency>
    <groupId>com.groupdocs</groupId>
    <artifactId>groupdocs-merger-cloud</artifactId>
    <version>25.11</version>
</dependency>

Anda dapat mengunduh JAR terbaru dari halaman unduhan. Setelah menambahkan dependensi, buat objek konfigurasi dengan kredensial Anda:

String clientId = "YOUR_CLIENT_ID";
String clientSecret = "YOUR_CLIENT_SECRET";

Configuration config = new Configuration(clientId, clientSecret);
MergerApi mergerApi = new MergerApi(config);

Dengan klien siap, Anda dapat melanjutkan ke alur kerja perlindungan kata sandi yang sebenarnya.

Melindungi Excel dengan Password melalui REST di Java: Panduan Langkah-demi-Langkah

Langkah 1: Muat Dokumen Sumber

Tentukan lokasi file XLSX sumber di dalam penyimpanan cloud Anda.

FileInfo inputFile = new FileInfo();
inputFile.setFilePath("input.xlsx");   // source Excel file

Langkah 2: Atur Jalur Tujuan

Tentukan di mana workbook yang dilindungi akan disimpan.

String outputPath = "output_protected.xlsx"; // destination file

Langkah 3: Konfigurasikan Opsi Perlindungan Kata Sandi

Buat objek ProtectOptions, lampirkan info file, jalur output, dan kata sandi yang diinginkan.

ProtectOptions protectOptions = new ProtectOptions();
protectOptions.setFileInfo(inputFile);
protectOptions.setOutputPath(outputPath);
protectOptions.setPassword("MySecretPassword"); // desired password

Langkah 4: Bangun Permintaan Lindungi Dokumen

Bungkus opsi dalam ProtectDocumentRequest.

ProtectDocumentRequest request = new ProtectDocumentRequest(protectOptions);

Langkah 5: Eksekusi Permintaan dan Tangani Respons

Panggil metode API dan proses setiap kesalahan.

try {
    mergerApi.protectDocument(request);
    System.out.println("Excel file has been password protected successfully.");
    System.out.println("Protected file stored at: " + outputPath);
} catch (ApiException e) {
    System.err.println("Error while protecting the Excel file:");
    System.err.println("Status Code: " + e.getCode());
    System.err.println("Message: " + e.getMessage());
}

Untuk detail lebih lanjut tentang setiap kelas, lihat referensi API.

Contoh Lengkap yang Berfungsi untuk Melindungi Excel dengan Kata Sandi via REST di Java

Kode berikut menunjukkan proses lengkap dari awal hingga akhir.

import com.groupdocs.merger.cloud.ApiException;
import com.groupdocs.merger.cloud.Configuration;
import com.groupdocs.merger.cloud.api.MergerApi;
import com.groupdocs.merger.cloud.model.FileInfo;
import com.groupdocs.merger.cloud.model.ProtectOptions;
import com.groupdocs.merger.cloud.model.requests.ProtectDocumentRequest;

public class ProtectExcelExample {
    public static void main(String[] args) {
        // Replace with your actual client credentials
        String clientId = "YOUR_CLIENT_ID";
        String clientSecret = "YOUR_CLIENT_SECRET";

// Initialize the API configuration
        Configuration config = new Configuration(clientId, clientSecret);
        MergerApi mergerApi = new MergerApi(config);

// Define input and output file locations (relative to the storage root)
        FileInfo inputFile = new FileInfo();
        inputFile.setFilePath("input.xlsx");          // source Excel file
        String outputPath = "output_protected.xlsx";  // destination file

// Set password protection options
        ProtectOptions protectOptions = new ProtectOptions();
        protectOptions.setFileInfo(inputFile);
        protectOptions.setOutputPath(outputPath);
        protectOptions.setPassword("MySecretPassword"); // desired password

// Build the request
        ProtectDocumentRequest request = new ProtectDocumentRequest(protectOptions);

try {
            // Execute the password protection operation
            mergerApi.protectDocument(request);
            System.out.println("Excel file has been password protected successfully.");
            System.out.println("Protected file stored at: " + outputPath);
        } catch (ApiException e) {
            System.err.println("Error while protecting the Excel file:");
            System.err.println("Status Code: " + e.getCode());
            System.err.println("Message: " + e.getMessage());
        }
    }
}

Catatan: Contoh kode ini menunjukkan fungsi inti. Sebelum menggunakannya dalam proyek Anda, pastikan untuk memperbarui jalur file (input.xlsx, output_protected.xlsx) agar sesuai dengan lokasi file Anda yang sebenarnya, verifikasi bahwa semua dependensi yang diperlukan telah terpasang dengan benar, dan uji secara menyeluruh di lingkungan pengembangan Anda. Jika Anda mengalami masalah, silakan merujuk ke dokumentasi resmi atau hubungi tim dukungan untuk bantuan.

Lindungi Excel Workbook melalui REST API menggunakan cURL

Berikut adalah sekumpulan perintah cURL yang melakukan operasi perlindungan kata sandi yang sama secara langsung terhadap endpoint REST.

1. Autentikasi dan dapatkan token akses

curl -X POST "https://api.groupdocs.cloud/v2.0/auth/token" \
     -H "Content-Type: application/json" \
     -d '{
           "client_id": "YOUR_CLIENT_ID",
           "client_secret": "YOUR_CLIENT_SECRET"
         }'

Respons berisi access_token yang akan Anda gunakan dalam panggilan berikutnya.

2. Unggah file XLSX sumber

curl -X PUT "https://api.groupdocs.cloud/v2.0/storage/file/input.xlsx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/octet-stream" \
     --data-binary @input.xlsx

3. Permintaan perlindungan kata sandi

curl -X POST "https://api.groupdocs.cloud/v2.0/merger/protect" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "fileInfo": { "filePath": "input.xlsx" },
           "outputPath": "output_protected.xlsx",
           "password": "MySecretPassword"
         }'

4. Unduh workbook yang dilindungi

curl -X GET "https://api.groupdocs.cloud/v2.0/storage/file/output_protected.xlsx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o output_protected.xlsx

Perintah ini memungkinkan Anda mengintegrasikan alur kerja perlindungan ke dalam skrip atau pipeline CI. Untuk detail lebih lanjut, lihat dokumentasi API resmi.

Kesimpulan

Implementasi Password Protect Excel via REST di Java sangat mudah dengan GroupDocs.Merger Cloud SDK for Java. Dengan mengikuti langkah‑langkah di atas, Anda dapat mengamankan workbook Excel, mengotomatisasi proses dalam aplikasi sisi‑server, dan menjaga data sensitif tetap aman. Ingatlah untuk memperoleh lisensi yang tepat untuk penggunaan produksi; informasi harga tersedia di halaman produk dan Anda dapat memulai dengan lisensi sementara untuk mengevaluasi pustaka ini. Selamat coding!

FAQs

  • Bagaimana perlindungan Excel dengan kata sandi melalui REST di Java berbeda dari enkripsi lokal?
    API cloud melakukan enkripsi di server, sehingga Anda tidak perlu mengelola perpustakaan kriptografi secara lokal. SDK menangani konstruksi permintaan dan parsing respons, menyederhanakan integrasi.

  • Apakah memungkinkan untuk mengatur opsi perlindungan tambahan, seperti mode baca‑saja?
    Kelas ProtectOptions saat ini berfokus pada perlindungan dengan kata sandi. Untuk fitur keamanan yang lebih canggih, konsultasikan referensi API untuk parameter yang lebih baru.

  • Format file apa yang didukung untuk perlindungan kata sandi?
    Merger API saat ini mendukung XLSX, DOCX, PPTX, dan PDF untuk enkripsi. Lihat dokumentasi resmi untuk daftar lengkap.

  • Apakah saya memerlukan lisensi untuk menjalankan contoh di lingkungan pengembangan?
    Pengembangan dan pengujian dapat dilakukan dengan lisensi sementara. Penyebaran produksi memerlukan lisensi berbayar, yang dapat Anda beli melalui halaman produk.

Baca Selengkapnya