Penulis:
    Aymeric PINEAU
    Dibuat:2025-12-16Terakhir diperbarui:2025-12-16

    Perintah Login CLI Intlayer

    Deskripsi

    Perintah login dari Intlayer CLI memungkinkan Anda untuk mengautentikasi dengan Intlayer CMS. Perintah ini secara otomatis membuka browser default Anda untuk menyelesaikan proses autentikasi dan menerima kredensial yang diperlukan (Client ID dan Client Secret) untuk menggunakan layanan Intlayer.

    Penggunaan

    bash
    npx intlayer login [options]

    atau

    bash
    intlayer login [options]

    Opsi

    --cms-url <url>

    Tentukan URL Intlayer CMS yang akan digunakan untuk autentikasi.

    • Tipe: string
    • Default: Nilai yang dikonfigurasi di intlayer.config.* atau https://intlayer.org
    • Contoh:
    bash
    npx intlayer login --cms-url https://intlayer.org

    Opsi Konfigurasi

    Anda juga dapat menggunakan opsi konfigurasi umum:

    • --env-file <path>: Path ke file environment
    • -e, --env <env>: Lingkungan eksekusi
    • --base-dir <dir>: Direktori dasar proyek
    • --verbose: Aktifkan output rinci (default: true)
    • --prefix <prefix>: Prefix untuk log

    Cara Kerjanya

    1. Mulai Server Lokal: Perintah memulai server HTTP lokal pada port acak untuk menerima kredensial dari CMS
    2. Membuka Browser: Perintah otomatis membuka browser default Anda ke URL login CMS
    3. Autentikasi: Selesaikan autentikasi di browser menggunakan akun Intlayer Anda
    4. Penerimaan Kredensial: Server lokal menerima Client ID dan Client Secret dari CMS
    5. Instruksi: Perintah menampilkan instruksi untuk mengonfigurasi kredensial di proyek Anda

    Keluaran

    Setelah login berhasil, perintah akan menampilkan:

    1. Kredensial yang diterima (Client ID dan Client Secret)
    2. Instruksi untuk file .env:
    bash
    INTLAYER_CLIENT_ID=your_client_id
INTLAYER_CLIENT_SECRET=your_client_secret
    1. Instruksi untuk file konfigurasi Intlayer:
    typescript
    {
  editor: {
    cmsURL: 'https://intlayer.org',
    clientId: process.env.INTLAYER_CLIENT_ID,
    clientSecret: process.env.INTLAYER_CLIENT_SECRET,
  },
}

    Menjaga akses key tetap aman

    intlayer login mengeluarkan access key: pasangan clientId / clientSecret yang digunakan oleh setiap perintah terautentikasi (push, pull, fill, configuration push, live, …) untuk autentikasi.

    intlayer.config.ts
    import type { IntlayerConfig } from "intlayer";

const config: IntlayerConfig = {
  editor: {
    clientId: process.env.INTLAYER_CLIENT_ID,
    clientSecret: process.env.INTLAYER_CLIENT_SECRET,
  },
};

export default config;
    clientSecret adalah kredensial sisi server. Ini memberikan akses API penuh yang dibatasi proyek — membaca dan menulis kamus Anda, proyek, dan organisasi Anda. Simpan di .env (git-ignored) atau penyimpanan rahasia CI Anda, dan jangan pernah inline-kan di file konfigurasi.

    Intlayer memberlakukan ini daripada hanya mendokumentasikannya:

    • clientSecret adalah dihapus dari konfigurasi yang bundler Anda inline, sehingga tidak dapat mencapai bundle browser apa pun integrasi framework yang Anda gunakan. Ini hanya pernah dibaca sisi server, saat runtime, dari lingkungan.
    • clientId berbeda: ini adalah kunci proyek publik, aman untuk dikirim, dan digunakan oleh @intlayer/analytics untuk mendapatkan token berumur pendek dan ingest-only.

    Mengomentari clientId sudah cukup untuk menonaktifkan setiap perilaku terautentikasi — pengambilan kamus jarak jauh, akses CMS, analytics — bahkan ketika variabel lingkungan masih didefinisikan.

    Untuk pipeline CI, lebih suka ci command, yang menyuntikkan kredensial untuk durasi satu run alih-alih mempertahankannya.

    Konfigurasi Manual

    Jika browser tidak terbuka secara otomatis, Anda dapat mengunjungi URL yang ditampilkan di terminal secara manual.

    Contoh

    Login dengan URL CMS Kustom

    bash
    npx intlayer login --cms-url https://custom-cms.example.com

    Login dengan File Environment Tertentu

    bash
    npx intlayer login --env-file .env.production

    Login dalam Mode Verbose

    bash
    npx intlayer login --verbose

    Pemecahan Masalah

    Browser Tidak Terbuka

    Jika browser tidak terbuka secara otomatis, salin URL yang ditampilkan di terminal dan buka secara manual di browser Anda.

    Masalah Koneksi

    Jika Anda mengalami masalah koneksi, verifikasi:

    1. Bahwa URL CMS sudah benar
    2. Bahwa koneksi internet Anda berfungsi dengan baik
    3. Bahwa tidak ada firewall yang memblokir koneksi

    Kredensial Tidak Diterima

    Jika kredensial tidak diterima:

    1. Pastikan Anda telah menyelesaikan proses autentikasi di browser
    2. Verifikasi bahwa port lokal tidak diblokir
    3. Coba jalankan perintah lagi

    Langkah Selanjutnya

    Setelah menyelesaikan login:

    1. Tambahkan kredensial ke file .env Anda
    2. Konfigurasikan file intlayer.config.* Anda dengan kredensial tersebut
    3. Gunakan perintah CLI untuk mengelola kamus Anda:

    Lihat Juga

    ExtractPush