Apple

LibreChat'i kullanıcı kimlik doğrulaması için Apple kullanacak şekilde nasıl yapılandıracağınızı öğrenin.

Ön Koşullar

Başlamadan önce, aşağıdakilere sahip olduğunuzdan emin olun:

Apple Developer Account: Eğer bir hesabınız yoksa, buradan kaydolun.

Yeni Bir App ID Oluşturma

1. Apple Developer Console'da oturum açın

Eylem:
Apple Developer adresini ziyaret edin ve Apple ID'niz ile giriş yapın.

2. Tanımlayıcılara (Identifiers) Gidin

Certificates, Identifiers & Profiles kısmına gidin.
Kenar çubuğundaki Identifiers öğesine tıklayın.

3. Yeni bir App ID Oluşturun

Yeni bir tanımlayıcı eklemek için "+" düğmesine tıklayın.
App IDs öğesini seçin ve Continue düğmesine tıklayın.
App öğesini seçin ve Continue düğmesine tıklayın.
Uygulama Kimliğiniz (App ID) için bir Açıklama girin (örneğin, LibreChat App ID).
Bundle ID değerini ayarlayın (örneğin, com.yourdomain.librechat).
Continue (Devam) düğmesine ve ardından Register (Kaydol) düğmesine tıklayın.

Görsel Referansları:
Şekil 1: Yeni Bir App ID Oluşturma
Şekil 2: Uygulama Tanımlayıcısını Seçme

App ID'yi oluşturduktan sonra, düzenlemek için üzerine tıklayın.
Capabilities altında, Sign in with Apple seçeneğini bulun ve işaretleyin.
Kaydet'e tıklayın.

Görsel Referansı:
Şekil 3: "Sign in with Apple" özelliğini etkinleştirme

Bir Services ID Oluşturma

1. Tanımlayıcılara (Identifiers) gidin

Certificates, Identifiers & Profiles bölümünde, Identifiers öğesine tıklayın.

2. Yeni bir Services ID Oluşturun

"+" düğmesine tıklayın.
Services IDs öğesini seçin ve Continue düğmesine tıklayın.
Bir Açıklama (örneğin, LibreChat Services ID) girin.
Bir Tanımlayıcı (örneğin, com.yourdomain.librechat.services) girin.
Continue (Devam) düğmesine ve ardından Register (Kaydol) düğmesine tıklayın.

Görsel Referansları:
Şekil 4: Hizmet Kimliğini (Services ID) seçme
Şekil 5: Services ID oluşturma

Yeni oluşturulan Services ID'ye tıklayın.
Capabilities altında, Sign in with Apple seçeneğinin yanındaki Configure öğesine tıklayın.
Domain (Alan Adı) bilgilerinizi (örneğin, your-domain.com) ve Return URL (Dönüş URL'si) bilgilerinizi (örneğin, https://your-domain.com/oauth/apple/callback) girin.
İleri'ye ve ardından Kaydol'a tıklayın.

Görsel Referansı:
Şekil 6: Services ID için "Sign in with Apple" yapılandırması
Şekil 7: Web Authentication Configuration
Şekil 8: Hizmet Kimliği Yapılandırmasını düzenlemeyi kaydet

Bir Anahtar Oluşturma

1. Keys kısmına gidin

Certificates, Identifiers & Profiles bölümünde, Keys seçeneğine tıklayın.

2. Yeni Bir Anahtar Oluşturun

Yeni bir anahtar eklemek için "+" düğmesine tıklayın.
Bir Anahtar Adı girin (örneğin, LibreChatSignInWithApple).
Capabilities altında Sign in with Apple seçeneğini seçin.
Configure öğesine tıklayın ve oluşturulan App ID'yi (örneğin, com.yourdomain.librechat) seçin, ardından Save öğesine tıklayın.
Continue (Devam) düğmesine ve ardından Register (Kaydol) düğmesine tıklayın.

Görsel Referansları:
Şekil 8: Yeni Bir Anahtar Oluşturma
Şekil 9: Anahtarın Uygulama Kimliği (App ID) ile yapılandırılması
Şekil 10: Anahtarı Kaydetme

3. Özel Anahtarı İndirin

Anahtarı oluşturduktan sonra Download düğmesine tıklayın.
Önemli: .p8 dosyasını güvenli bir şekilde saklayın. Dosyayı tekrar indirmeniz mümkün olmayacaktır.
Key ID değerini not edin; .env dosyası için buna ihtiyacınız olacak.

Görsel Referansı:
Şekil 11: Özel Anahtarı İndirme

LibreChat'i Yapılandırma

1. `.env` Yapılandırmasını Güncelleyin

Aşağıdaki Apple OAuth2 yapılandırmasını .env dosyanıza ekleyin:

DOMAIN_CLIENT=https://your-domain.com # use http://localhost:3080 if not using a custom domain
DOMAIN_SERVER=https://your-domain.com # use http://localhost:3080 if not using a custom domain

# Apple
APPLE_CLIENT_ID=com.yourdomain.librechat.services
APPLE_TEAM_ID=YOUR_TEAM_ID
APPLE_KEY_ID=YOUR_KEY_ID
APPLE_PRIVATE_KEY_PATH=/path/to/AuthKey.p8 # Absolute path to your downloaded .p8 file
APPLE_CALLBACK_URL=/oauth/apple/callback

Not:

com.yourdomain.librechat.services ifadesini kendi gerçek Services ID'niz ile değiştirin.

YOUR_TEAM_ID ve YOUR_KEY_ID değerlerini Apple Developer hesabınızdaki ilgili değerlerle değiştirin.

Docker kullanıyorsanız, .p8 dosyasının Docker konteyneriniz içinde erişilebilir olduğundan emin olun ve APPLE_PRIVATE_KEY_PATH değerini buna göre güncelleyin.

2. LibreChat'i yeniden başlatın

.env dosyasını güncelledikten sonra, değişiklikleri uygulamak için LibreChat'i yeniden başlatın.

Docker kullanıyorsanız:

docker compose up -d

Sorun Giderme

Kurulum sırasında sorunlarla karşılaşırsanız, aşağıdaki çözümleri değerlendirin:

Geçersiz Yönlendirme URI'si:
- Apple Developer Console içindeki yönlendirme URI'sinin (https://your-domain.com/oauth/apple/callback), .env dosyanızda (APPLE_CALLBACK_URL) belirtilen ile tam olarak eşleştiğinden emin olun.
Özel Anahtar Sorunları:
- .p8 dosyanızın yolunun (APPLE_PRIVATE_KEY_PATH) doğru olduğunu doğrulayın.
- LibreChat'in .p8 dosyası için okuma izinlerine sahip olduğundan emin olun.
Team ID ve Key ID Hataları:
- .env dosyanızdaki APPLE_TEAM_ID ve APPLE_KEY_ID değerlerinin Apple Geliştirici Hesabınızdakilerle eşleştiğini tekrar kontrol edin.
Etki Alanı Doğrulaması Başarısız:
- Doğrulama dosyasının alan adınızın kök dizinine doğru bir şekilde yüklendiğinden emin olun.
- Yapılandırma sırasında girilen alan adında herhangi bir yazım hatası olmadığını doğrulayın.
Docker Yapılandırma Sorunları:
- Docker kullanıyorsanız, .p8 dosyasının düzgün bir şekilde bağlandığından ve APPLE_PRIVATE_KEY_PATH içindeki yolun konteyner içinde erişilebilir olduğundan emin olun.
Günlükleri Kontrol Et:
- Apple kimlik doğrulamasıyla ilgili herhangi bir hata mesajı olup olmadığını görmek için LibreChat günlüklerini inceleyin. Bu, neyin yanlış gidiyor olabileceğine dair özel bilgiler sağlayabilir.

Apple

Bu sayfada