Apple

Prerequisiti

Prima di iniziare, assicurati di avere quanto segue:

• Account Apple Developer: Se non ne possiedi uno, iscriviti qui.

Creazione di un nuovo App ID

1. Accedi alla Apple Developer Console

• Azione:
• Visita Apple Developer ed effettua l'accesso con il tuo Apple ID.

2. Passa a Identifiers

• Vai su Certificates, Identifiers & Profiles.
• Fai clic su Identifiers nella barra laterale.

3. Crea un nuovo App ID

1. Fai clic sul pulsante "+" per aggiungere un nuovo identificatore.
2. Seleziona App IDs e fai clic su Continue.
3. Scegli App e fai clic su Continue.
4. Inserisci una Description per il tuo App ID (ad esempio, LibreChat App ID).
5. Imposta il Bundle ID (ad esempio, com.yourdomain.librechat).
6. Fai clic su Continue e poi su Register.

• Riferimenti alle immagini:

• Figura 1: Creazione di un nuovo App ID

• Figura 2: Selezione dell'identificatore dell'app

4. Abilitare "Sign in with Apple"

1. Dopo aver creato l'App ID, fai clic su di esso per modificarlo.
2. Sotto Capabilities, trova e seleziona Sign in with Apple.
3. Fai clic su Save.

• Riferimento immagine:
• Figura 3: Abilitazione di "Accedi con Apple"

Creazione di un Services ID

1. Passare a Identifiers

• Nella sezione Certificates, Identifiers & Profiles, fai clic su Identifiers.

2. Crea un nuovo ID servizi

1. Fai clic sul pulsante "+".
2. Seleziona Services IDs e fai clic su Continue.
3. Inserisci una Description (ad esempio, LibreChat Services ID).
4. Inserisci un Identifier (es. com.yourdomain.librechat.services).
5. Fai clic su Continue e poi su Register.

• Riferimenti alle immagini:

• Figura 4: Selezione dell'ID dei servizi

• Figura 5: Creazione dell'ID Servizi

3. Configura "Accedi con Apple"

1. Fai clic sul Services ID appena creato.
2. Sotto Capabilities, fai clic su Configure accanto a Sign in with Apple.
3. Inserisci i tuoi Domains (es. your-domain.com) e i Return URLs (es. https://your-domain.com/oauth/apple/callback).
4. Fai clic su Next e poi su Register.

• Riferimento immagine:

• Figura 6: Configurazione di "Sign in with Apple" per Services ID

• Figura 7: Configurazione dell'autenticazione web

• Figura 8: Salva la configurazione dell'ID dei servizi

Creazione di una Key

1. Passa alle Keys

• Nella sezione Certificates, Identifiers & Profiles, fai clic su Keys.

2. Crea una nuova chiave

1. Fai clic sul pulsante "+" per aggiungere una nuova chiave.
2. Inserisci un Nome Chiave (ad esempio, LibreChatSignInWithApple).
3. Seleziona Sign in with Apple sotto Capabilities.
4. Fai clic su Configure e seleziona l'App ID creato (ad esempio, com.yourdomain.librechat), quindi fai clic su Save.
5. Fai clic su Continue e poi su Register.

• Riferimenti alle immagini:

• Figura 8: Creazione di una nuova chiave

• Figura 9: Configurazione della chiave con App ID

• Figura 10: Registrazione della chiave

3. Scarica la chiave privata

1. Dopo aver creato la chiave, fai clic su Download.
2. Importante: Salva il file .p8 in modo sicuro. Non sarà possibile scaricarlo di nuovo.
3. Annota il Key ID; ti servirà per il file .env.

• Riferimento immagine:
• Figura 11: Download della chiave privata

Configurazione di LibreChat

1. Aggiorna la configurazione di .env

Aggiungi la seguente configurazione Apple OAuth2 al tuo file .env:

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

Nota:

• Sostituisci com.yourdomain.librechat.services con il tuo effettivo Services ID.
• Sostituisci YOUR_TEAM_ID e YOUR_KEY_ID con i rispettivi valori dal tuo account Apple Developer.
• Se utilizzi Docker, assicurati che il file .p8 sia accessibile all'interno del tuo container Docker e aggiorna APPLE_PRIVATE_KEY_PATH di conseguenza.

2. Riavviare LibreChat

Dopo aver aggiornato il file .env, riavvia LibreChat per applicare le modifiche.

• Se utilizzi Docker:

docker compose up -d

Risoluzione dei problemi

Se riscontri problemi durante la configurazione, prendi in considerazione le seguenti soluzioni:

• URI di reindirizzamento non valido:

  • Assicurati che l'URI di reindirizzamento nella tua Apple Developer Console (https://your-domain.com/oauth/apple/callback) corrisponda esattamente a quello specificato nel tuo file .env (APPLE_CALLBACK_URL).

• Problemi con la chiave privata:

  • Verifica che il percorso del tuo file .p8 (APPLE_PRIVATE_KEY_PATH) sia corretto.
  • Assicurati che LibreChat abbia i permessi di lettura per il file .p8.

• Errori di Team ID e Key ID:

  • Controlla due volte che APPLE_TEAM_ID e APPLE_KEY_ID nel tuo file .env corrispondano a quelli nel tuo Apple Developer Account.

• Verifica del dominio non riuscita:

  • Assicurati che il file di verifica sia caricato correttamente nella root del tuo dominio.
  • Verifica che non ci siano errori di battitura nel nome di dominio inserito durante la configurazione.

• Problemi di configurazione Docker:

  • Se utilizzi Docker, conferma che il file .p8 sia montato correttamente e che il percorso in APPLE_PRIVATE_KEY_PATH sia accessibile all'interno del container.

• Controlla i log:

  • Controlla i log di LibreChat per eventuali messaggi di errore relativi all'autenticazione Apple. Questo può fornire informazioni specifiche su cosa potrebbe non funzionare.