Configurare Feishu SSO per Verdent Team
Collega Feishu a Verdent Team per un accesso aziendale centralizzato
Verdent Team supporta il single sign-on (SSO) di Feishu. Dopo la configurazione, i membri con un dominio email aziendale approvato possono verificare la propria identità con l'account Feishu dell'azienda.
Feishu SSO consente al team di usare il sistema di identità esistente, riduce le credenziali separate e offre al Team Owner un unico punto per gestire gli accessi.
Questa guida è rivolta ai Team Owner di Verdent Team. Solo un Team Owner può accedere alle impostazioni del Team e gestire l'SSO.
Come funziona Feishu SSO
Il Team Owner crea un'app aziendale personalizzata nella Feishu Open Platform, quindi aggiunge le credenziali dell'app e i domini email aziendali a Verdent Team.
Quando un membro inserisce un'email aziendale corrispondente nella pagina di accesso di Verdent, viene reindirizzato a Feishu per l'autorizzazione. Verdent verifica l'email restituita da Feishu.
I membri devono avere un'email aziendale nella directory di Feishu. Senza di essa non possono accedere tramite Feishu SSO.
Prima di iniziare
Sono necessari:
- Un account amministratore aziendale Feishu autorizzato a creare app personalizzate
- Accesso Owner al Verdent Team
- Il dominio email aziendale del team, ad esempio
yourcompany.com
La configurazione richiede in genere circa 5 minuti.
Aprire le impostazioni SSO
- Accedi a Verdent e passa al Team da configurare.
- Apri Settings nella console del Team.
- Seleziona SSO.
- Fai clic su Connect SSO.
Tieni aperti Verdent e Feishu Open Platform durante la configurazione.
Configurare l'app Feishu
Creare un'app aziendale personalizzata
Apri Feishu Open Platform, entra nella Developer Console e fai clic su Create custom enterprise app. Inserisci un nome, carica un'icona e crea l'app.
Ottenere le credenziali dell'app
Apri Credentials & Basic Info e individua App ID e App Secret:
| Credenziale Feishu | Campo SSO Verdent |
|---|---|
| App ID | Client ID |
| App Secret | Client Secret |
Client Secret in Verdent.Aggiungere l'URL di reindirizzamento
Apri Development Configuration → Security Settings e aggiungi questo Redirect URL:
https://login.verdent.ai/passport/sso/callbackhttps, non aggiungere / alla fine e rimuovi gli spazi. Un valore errato causa l'errore Feishu 20029.Concedere le autorizzazioni
Apri Development Configuration → Permissions e concedi:
| Autorizzazione | Ambito |
|---|---|
| Leggere le informazioni di base dell'utente | contact:user.base:readonly |
| Leggere le informazioni email dell'utente | contact:user.email:readonly |
Verdent usa queste autorizzazioni per identificare i membri tramite nome ed email aziendale.
Pubblicare l'app
Apri Version Management & Release, crea una versione e inviala per la pubblicazione. I membri possono usare l'app solo dopo la pubblicazione.
Completare la connessione in Verdent
Torna alla configurazione Feishu SSO in Verdent e inserisci:
| Campo Verdent | Valore |
|---|---|
Client ID | App ID Feishu |
Client Secret | App Secret Feishu |
Email domain | Dominio email aziendale |
Puoi aggiungere fino a 5 domini aziendali. I domini pubblici come Gmail non sono supportati.
Salva la configurazione e verifica che Feishu SSO sia attivo nella relativa scheda. Puoi disattivarlo temporaneamente senza eliminare la connessione.
Esperienza di accesso dei membri
Dopo l'attivazione, i membri inseriscono un'email di un dominio configurato, confermano l'uso dell'SSO, autorizzano l'accesso in Feishu e tornano a Verdent. Se l'email inserita è diversa da quella restituita da Feishu, Verdent chiede conferma e usa l'email Feishu per l'autenticazione.
Testare e gestire la configurazione
Prima di estendere l'SSO a tutti, esegui un test con un membro normale il cui account Feishu abbia un'email aziendale. Esci, accedi con quell'email, completa l'autorizzazione e verifica l'accesso al Verdent Team.
Da Team → Settings → SSO, il Team Owner può visualizzare domini e stato, attivare o disattivare l'SSO, aggiornare le credenziali, riconfigurare una connessione non riuscita o eliminarla.
Risoluzione dei problemi
Errore Feishu 20029: URL di reindirizzamento non valido
In Feishu, apri Development Configuration → Security Settings e verifica che
https://login.verdent.ai/passport/sso/callback sia stato aggiunto esattamente.
Verdent segnala che Client ID o Client Secret non sono validi
Copia nuovamente App ID e App Secret da Credentials & Basic Info. Se il segreto è stato reimpostato, usa il valore più recente.
L'app non è disponibile durante l'accesso
Verifica di aver creato e pubblicato una versione in Version Management & Release.
L'email è vuota dopo l'accesso
Aggiungi un'email aziendale al profilo del membro nella directory Feishu e riprova.
Il membro non viene reindirizzato a Feishu SSO
Verifica che l'email corrisponda a un dominio configurato e che Feishu SSO sia attivo in Verdent.