Apple

Prasyarat

Sebelum Anda memulai, pastikan Anda memiliki hal-hal berikut:

• Akun Pengembang Apple: Jika Anda belum memilikinya, daftar di sini.

Membuat App ID Baru

1. Masuk ke Apple Developer Console

• Tindakan:
• Kunjungi Apple Developer dan masuk dengan Apple ID Anda.

2. Navigasi ke Identifiers

• Buka Certificates, Identifiers & Profiles.
• Klik Identifiers di bilah sisi.

3. Buat App ID Baru

1. Klik tombol "+" untuk menambahkan pengenal baru.
2. Pilih App IDs dan klik Continue.
3. Pilih App dan klik Continue.
4. Masukkan Deskripsi untuk App ID Anda (contoh: LibreChat App ID).
5. Atur Bundle ID (contoh: com.yourdomain.librechat).
6. Klik Continue lalu Register.

• Referensi Gambar:

• Gambar 1: Membuat App ID Baru

• Gambar 2: Memilih Pengidentifikasi Aplikasi

4. Aktifkan "Sign in with Apple"

1. Setelah membuat App ID, klik pada ID tersebut untuk mengeditnya.
2. Di bawah Capabilities, temukan dan centang Sign in with Apple.
3. Klik Save.

• Referensi Gambar:
• Gambar 3: Mengaktifkan "Sign in with Apple"

Membuat Services ID

1. Navigasi ke Identifiers

• Di bagian Certificates, Identifiers & Profiles, klik pada Identifiers.

2. Buat ID Layanan Baru

1. Klik tombol "+".
2. Pilih Services IDs dan klik Continue.
3. Masukkan Deskripsi (contoh: LibreChat Services ID).
4. Masukkan Identifier (contoh: com.yourdomain.librechat.services).
5. Klik Continue lalu Register.

• Referensi Gambar:

• Gambar 4: Memilih ID Layanan

• Gambar 5: Membuat Services ID

3. Konfigurasi "Sign in with Apple"

1. Klik pada Services ID yang baru dibuat.
2. Di bawah Capabilities, klik Configure di sebelah Sign in with Apple.
3. Masukkan Domains Anda (contoh: your-domain.com) dan Return URLs (contoh: https://your-domain.com/oauth/apple/callback).
4. Klik Next lalu Register.

• Referensi Gambar:

• Gambar 6: Mengonfigurasi "Sign in with Apple" untuk Services ID

• Gambar 7: Konfigurasi Autentikasi Web

• Gambar 8: Simpan konfigurasi Services ID edit

Membuat Kunci

1. Navigasi ke Keys

• Di bagian Certificates, Identifiers & Profiles, klik pada Keys.

2. Buat Kunci Baru

1. Klik tombol "+" untuk menambahkan kunci baru.
2. Masukkan Key Name (contoh: LibreChatSignInWithApple).
3. Pilih Sign in with Apple di bawah Capabilities.
4. Klik Configure dan pilih App ID yang telah dibuat (contoh: com.yourdomain.librechat), lalu klik Save.
5. Klik Continue lalu Register.

• Referensi Gambar:

• Gambar 8: Membuat Kunci Baru

• Gambar 9: Mengonfigurasi Key dengan App ID

• Gambar 10: Mendaftarkan Kunci

3. Unduh Private Key

1. Setelah membuat kunci tersebut, klik Download.
2. Penting: Simpan file .p8 dengan aman. Anda tidak akan dapat mengunduhnya lagi.
3. Catat Key ID tersebut; Anda akan membutuhkannya untuk file .env.

• Referensi Gambar:
• Gambar 11: Mengunduh Kunci Pribadi

Mengonfigurasi LibreChat

1. Perbarui Konfigurasi .env

Tambahkan konfigurasi Apple OAuth2 berikut ke file .env Anda:

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

Catatan:

• Ganti com.yourdomain.librechat.services dengan ID Layanan Anda yang sebenarnya.
• Ganti YOUR_TEAM_ID dan YOUR_KEY_ID dengan nilai masing-masing dari akun Apple Developer Anda.
• Jika menggunakan Docker, pastikan file .p8 dapat diakses di dalam container Docker Anda dan perbarui APPLE_PRIVATE_KEY_PATH sebagaimana mestinya.

2. Restart LibreChat

Setelah memperbarui file .env, mulai ulang LibreChat untuk menerapkan perubahan tersebut.

• Jika menggunakan Docker:

docker compose up -d

Pemecahan Masalah

Jika Anda mengalami masalah selama pengaturan, pertimbangkan solusi berikut:

• URI Pengalihan Tidak Valid:

  • Pastikan URI pengalihan di Apple Developer Console Anda (https://your-domain.com/oauth/apple/callback) sama persis dengan yang ditentukan dalam file .env Anda (APPLE_CALLBACK_URL).

• Masalah Private Key:

  • Pastikan jalur ke file .p8 Anda (APPLE_PRIVATE_KEY_PATH) sudah benar.
  • Pastikan LibreChat memiliki izin baca untuk file .p8.

• Kesalahan Team ID dan Key ID:

  • Periksa kembali apakah APPLE_TEAM_ID dan APPLE_KEY_ID di dalam file .env Anda sudah sesuai dengan yang ada di Akun Pengembang Apple Anda.

• Verifikasi Domain Gagal:

  • Pastikan file verifikasi telah diunggah dengan benar ke root domain Anda.
  • Pastikan tidak ada kesalahan pengetikan pada nama domain yang dimasukkan selama konfigurasi.

• Masalah Konfigurasi Docker:

  • Jika menggunakan Docker, pastikan file .p8 telah di-mount dengan benar dan path di dalam APPLE_PRIVATE_KEY_PATH dapat diakses di dalam container.

• Periksa Log:

  • Periksa log LibreChat untuk melihat pesan kesalahan apa pun yang terkait dengan autentikasi Apple. Hal ini dapat memberikan wawasan spesifik mengenai apa yang mungkin menjadi masalah.