Hub per gli strumenti
Punto di accesso per chi vuole integrare Login with myZenkai: meno attrito tra documentazione, test e configurazione dei client.
Docs
v1 · alpha
Benvenuto nella documentazione developer
Guida introduttiva al Developer Portal di Zenkaiverse: cos’è, cosa puoi usare oggi e come si inserisce Login with myZenkai nel tuo percorso di integrazione.
Cos’è questo portal
Un’unica area da cui partire per integrare e testare l’accesso con myZenkai, senza rincorrere URL sparsi o checklist solo mentali.
Pensato per essere chiaro
L’obiettivo è spiegare con calma cosa succede quando un’app usa myZenkai per identificare un utente, senza diluvi di jargon.
Cosa puoi fare ora
Tre blocchi funzionali che puoi usare subito nel portal in ambiente alpha.
Entrare con myZenkai
Flusso di login reale: l’utente entra con il proprio account e il portal lo riconosce come autenticato.
Gestire i client
Visualizza e aggiorna i tuoi client OAuth: nome, redirect URI, scope, stato attivo e PKCE.
Provare il flow
Playground per authorize URL, code verifier, code challenge e verifica rapida del percorso OAuth.
Come funziona, in sintesi
Quattro passaggi che collegano richiesta dell’app, login utente, codice temporaneo e scambio con token.
-
L’app chiede myZenkai
Un’app o uno strumento esterno avvia il flow e chiede il permesso di identificare l’utente.
-
Accesso utente
L’utente entra con il proprio account myZenkai. Con client configurato correttamente, il percorso resta coerente.
-
Codice temporaneo
Dopo il login l’app riceve un codice temporaneo: da solo non basta per accedere ai dati protetti.
-
Scambio con token
L’app scambia il codice (con PKCE dove richiesto) e ottiene il token per completare il login in modo sicuro.
Su cos’è concentrato l’alpha
Cosa è già in pista e cosa non è ancora il focus del prodotto.
Già disponibile
- Login with myZenkai nel portal
- Gestione base dei client OAuth del proprietario
- PKCE per test e integrazioni moderne
- Playground per costruire e verificare il flow
- Pagina callback per il ritorno OAuth
Non è il focus ora
- Billing e piani commerciali
- Analytics avanzate per app
- Configurazioni enterprise complesse
- Portale pubblico enorme multi-sezione
- Documentazione esaustiva di ogni edge case
Termini ricorrenti
Definizioni brevi per orientarti nella UI e nelle guide.
Client
Profilo tecnico di un’app che usa myZenkai per il login: nome, identificatore e indirizzi autorizzati.
Redirect URI
Indirizzo a cui il browser torna dopo il login. Deve essere autorizzato in anticipo o il flow viene bloccato.
Scope
Tipo di accesso richiesto (es. identità di base, profilo pubblico, email).
PKCE
Protezione aggiuntiva per app pubbliche, CLI e client senza segreto server-side.
06 · Prossimi passi
Da qui in poi
Base pronta per guide operative: creare un client, configurare le redirect URI, capire gli scope e completare il code exchange con esempi mirati.