Intlayer CLI Login Komutu

Açıklama

Intlayer CLI'nin login komutu, Intlayer CMS ile kimlik doğrulaması yapmanıza olanak tanır. Bu komut, kimlik doğrulama işlemini tamamlamak ve Intlayer hizmetlerini kullanmak için gerekli kimlik bilgilerini (Client ID ve Client Secret) almak üzere varsayılan tarayıcınızı otomatik olarak açar.

Kullanım

npx intlayer login [options]

veya

intlayer login [options]

Seçenekler

--cms-url <url>

Intlayer CMS ile kimlik doğrulaması için bağlanılacak URL'yi belirtin.

• Type: string
• Default: intlayer.config.* içinde yapılandırılmış değer veya https://intlayer.org
• Example:

npx intlayer login --cms-url https://intlayer.org

Yapılandırma Seçenekleri

Ayrıca ortak yapılandırma seçeneklerini de kullanabilirsiniz:

• --env-file <path>: Ortam dosyasının yolu
• -e, --env <env>: Çalışma ortamı
• --base-dir <dir>: Projenin temel dizini
• --verbose: Ayrıntılı çıktıyı etkinleştir (varsayılan: true)
• --prefix <prefix>: Loglar için ön ek

Nasıl Çalışır

1. Yerel Sunucu Başlatma: Komut, CMS'den kimlik bilgilerini almak için rastgele bir portta yerel bir HTTP sunucusu başlatır
2. Tarayıcı Açma: Komut varsayılan tarayıcınızı CMS giriş URL'siyle otomatik olarak açar
3. Kimlik Doğrulama: Tarayıcıda Intlayer hesabınızı kullanarak kimlik doğrulamayı tamamlayın
4. Kimlik Bilgilerinin Alınması: Yerel sunucu, CMS'den Client ID ve Client Secret'i alır
5. Talimatlar: Komut, projenizde kimlik bilgilerini yapılandırmak için talimatlar gösterir

Çıktı

Başarılı bir girişten sonra, komut şunları gösterecektir:

1. Alınan kimlik bilgileri (Client ID ve Client Secret)
2. .env dosyası için talimatlar:

INTLAYER_CLIENT_ID=your_client_id
INTLAYER_CLIENT_SECRET=your_client_secret

3. Intlayer yapılandırma dosyası için talimatlar:

{
  editor: {
    cmsURL: 'https://intlayer.org',
typescript
{
  editor: {
    cmsURL: 'https://intlayer.org',
    clientId: process.env.INTLAYER_CLIENT_ID,
    clientSecret: process.env.INTLAYER_CLIENT_SECRET,
  },
}

Erişim anahtarını güvende tutma

intlayer login bir erişim anahtarı yayınlar: her kimlik doğrulamalı komut (push, pull, fill, configuration push, live, …) tarafından kimlik doğrulaması için kullanılan bir clientId / clientSecret çiftidir.

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 sunucu tarafı kimlik bilgisidir. Proje kapsamlı tam API erişimi verir — sözlükleriniz, projeniz ve kuruluşunuzu okuyup yazabilir. Bunu .env dosyasında (git tarafından yok sayılan) veya CI gizli deposunda tutun ve asla yapılandırma dosyasında satır içine yazmayın.

Intlayer bunu yalnızca belgelemek yerine zorunlu kılar:

• clientSecret bundler tarafından satır içine alınan yapılandırmadan çıkarılır, bu nedenle hangi framework entegrasyonunu kullanırsanız kullanın bir tarayıcı bundle'ına ulaşamaz. Yalnızca sunucu tarafında çalışma zamanında ortamdan okunur.
• clientId farklıdır: bu genel proje anahtarıdır, göndermek için güvenlidir ve @intlayer/analytics tarafından kısa ömürlü, yalnızca alım tokeni elde etmek için kullanılır.

clientId yü açıklama satırına almak, ortam değişkenleri hala tanımlanmış olsa bile her kimlik doğrulamalı davranışı (uzak sözlük getirme, CMS erişimi, analitik) devre dışı bırakmak için yeterlidir.

CI pipeline'ları için, ci komutunu tercih edin; bu, kimlik bilgilerini saklamanız yerine tek bir çalıştırmanın süresi boyunca enjekte eder.

Manuel Yapılandırma

Tarayıcı otomatik olarak açılmıyorsa, terminalde gösterilen URL'yi kopyalayarak tarayıcınızda manuel olarak ziyaret edebilirsiniz.

Örnekler

Özel CMS URL'si ile Giriş

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

Belirli Bir Ortam Dosyası ile Giriş

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

Ayrıntılı Modda Giriş

npx intlayer login --verbose

Sorun Giderme

Tarayıcı Açılmıyor

Tarayıcı otomatik olarak açılmıyorsa, terminalde gösterilen URL'yi kopyalayın ve tarayıcınızda manuel olarak açın.

Bağlantı Sorunları

Bağlantı sorunlarıyla karşılaşırsanız, şunları doğrulayın:

1. CMS URL'sinin doğru olduğunu
2. İnternet bağlantınızın düzgün çalıştığını
3. Bağlantıyı engelleyen bir güvenlik duvarı olmadığını

Kimlik Bilgileri Alınmadı

Kimlik bilgileri alınmadıysa:

1. Tarayıcıda kimlik doğrulama sürecini tamamladığınızdan emin olun
2. Yerel portun engellenmediğini doğrulayın
3. Komutu tekrar deneyin

Sonraki Adımlar

Giriş işlemini tamamladıktan sonra:

1. Kimlik bilgilerini .env dosyanıza ekleyin
2. Kimlik bilgileri ile intlayer.config.* dosyanızı yapılandırın
3. Sözlüklerinizi yönetmek için CLI komutlarını kullanın:
   • npx intlayer push - Sözlükleri CMS'ye gönderir
   • npx intlayer pull - CMS'den sözlükleri çeker
   • npx intlayer fill - Eksik çevirileri doldur

Ayrıca Bakınız

• CLI Dokümantasyonu
• Intlayer Yapılandırması
• Intlayer CMS