Utilizzo di credenziali federate sul portale per gli sviluppatori

Stai visualizzando la documentazione di Apigee Edge.
Vai alla documentazione di Apigee X.
informazioni

L'accesso federato è il processo in cui utilizzi le credenziali di un sistema di gestione delle identità, chiamato sistema di registrazione, per accedere a un altro sistema. Ad esempio, utilizzi le tue credenziali Google o Twitter per accedere al portale per gli sviluppatori Apigee. Il vantaggio dell'accesso federato è che il sistema al quale accedi non vede mai la password associata alle tue credenziali. Ciò significa che le password non devono essere copiate su sistemi diversi.

Il portale Servizi per gli sviluppatori supporta l'accesso federato utilizzando le credenziali di diversi fornitori comuni, tra cui:

  • GitHub
  • Google
  • OpenID
  • Twitter

Inoltre, se hai già un account Apigee Edge, puoi utilizzare queste credenziali per accedere al portale per gli sviluppatori.

Ciascuno dei provider di credenziali supportati richiede un processo di configurazione diverso, come descritto di seguito.

Utilizzo di credenziali federate con il portale per gli sviluppatori

Per ottenere l'accesso al portale, uno sviluppatore registra un nuovo account sul portale e specifica un nome utente, un indirizzo email e una password. L'utente potrà quindi accedere al portale fornendo il nome utente e la password del portale come credenziali.

Con l'accesso federato al portale, utilizzi le credenziali di una terza parte per accedere a un account esistente del portale. Ciò significa che è necessario un account sul portale prima di poter accedere con credenziali di terze parti. Puoi utilizzare qualsiasi credenziale federata supportata da Apigee per accedere a un account del portale esistente. Inoltre, puoi utilizzare le credenziali di Google e Apigee per registrare un nuovo account sul portale.

Accesso a un account del portale esistente

Accedi a un account del portale esistente utilizzando una delle credenziali federate supportate. Ad esempio, accedi utilizzando le tue credenziali Twitter. La prima volta che accedi con le tue credenziali Twitter, il portale ti chiede di associare le tue credenziali Twitter a un account del portale esistente. Esegui questa associazione una sola volta. Successivamente, puoi accedere con le tue credenziali Twitter e il portale conserva le informazioni sull'associazione.

Registrazione di un nuovo account del portale

Registra un nuovo account sul portale utilizzando le tue credenziali Google o Apigee. Quando ti registri come nuovo sviluppatore sul portale utilizzando credenziali federate, il portale per gli sviluppatori tenta di ottenere informazioni dal sistema di registrazione. Ad esempio, utilizzi le tue credenziali Google per creare un nuovo account sviluppatore sul portale. Ti viene chiesto di approvare le informazioni restituite al portale da Google. Anche se il sistema di registrazione restituisce le informazioni al portale, in genere per le nuove registrazioni è necessario inserire alcune informazioni, ad esempio accettare i termini e condizioni.

Registrati o accedi utilizzando le credenziali Apigee

Se hai già un account Apigee Edge, puoi utilizzare queste credenziali per registrare un account o accedere a un account esistente sul portale per gli sviluppatori. Per impostazione predefinita, il seguente pulsante viene visualizzato sia nelle pagine di registrazione che di accesso del portale per gli sviluppatori:

Il pulsante viene visualizzato solo sui portali con un URL che termina con apigee.com, ovvero portali nel dominio Apigee. Ad esempio, un URL nel formato http://myCompany.devportal.apigee.com. Se l'URL non termina con quel dominio, non puoi utilizzare le tue credenziali Apigee Edge per accedere o registrarti al portale.

Per registrare un utente Apigee Edge esistente come nuovo sviluppatore del portale:

Nota: il processo di registrazione presuppone che il portale sia configurato in modo da consentire a chiunque di registrarsi senza l'approvazione dell'amministratore. Consulta Aggiungere e gestire account utente per ulteriori informazioni su come controllare chi può registrarsi.

  1. Assicurati di disporre di un account Apigee Edge esistente.
  2. Seleziona il link Registrati sul portale per gli sviluppatori.
  3. Seleziona il pulsante Autentica con Apigee nella pagina di registrazione.
    • Se non hai eseguito l'accesso ad Apigee Edge, inserisci le tue credenziali Apigee Edge e seleziona Accedi.
  4. Se non sono necessarie altre informazioni per la registrazione, accederai al portale per gli sviluppatori con il tuo nuovo account.
    Riceverai un'email all'indirizzo email associato al tuo account Apigee con informazioni sul completamento del processo di registrazione, ad esempio sull'impostazione della password.
  5. Se sono necessarie informazioni aggiuntive per completare il processo di registrazione, ad esempio l'accettazione di termini e condizioni, il sistema ti reindirizzerà automaticamente alla pagina di registrazione, con il nome utente e le informazioni email del tuo account Apigee Edge inseriti nei campi appropriati.
  6. Specifica eventuali altre informazioni di registrazione richieste per completare il processo di registrazione.
  7. Seleziona Crea nuovo account.
    Riceverai un'email all'indirizzo email associato al tuo account Apigee con informazioni sul completamento del processo di registrazione, ad esempio l'impostazione della password.

Per accedere come sviluppatore del portale esistente utilizzando un account Apigee:

  1. Seleziona il link Accedi sul portale per gli sviluppatori.
  2. Seleziona il pulsante Autentica con Apigee nella pagina di accesso.
    • Se hai già eseguito l'accesso ad Apigee Edge, accederai automaticamente al portale per gli sviluppatori.
    • Se non hai eseguito l'accesso ad Apigee Edge, inserisci le tue credenziali Apigee Edge e seleziona Accedi.

Registrati o accedi utilizzando le credenziali Google

Per impostazione predefinita, la registrazione federata e l'accesso utilizzando le credenziali Google sono attive sul portale per gli sviluppatori. Sia nella pagina di registrazione che in quella di accesso troverai il seguente pulsante:

Puoi registrarti come nuovo sviluppatore o accedere come sviluppatore esistente utilizzando le tue credenziali Google. Ad esempio, se hai un account Gmail, puoi accedere utilizzando le tue credenziali di Gmail.

Il portale per gli sviluppatori associa le credenziali Google al tuo account del portale memorizzando un OpenID Google nel tuo profilo del portale. Dopo aver associato le credenziali Google al tuo account del portale, puoi visualizzare l'OpenID selezionando il tuo indirizzo email > Modifica profilo dal menu di primo livello nel portale per gli sviluppatori, quindi selezionando Gestisci i tuoi OpenID.

Per registrarti come nuovo sviluppatore utilizzando le tue credenziali Google:

Nota: il processo di registrazione presuppone che il portale sia configurato in modo da consentire a chiunque di registrarsi senza l'approvazione dell'amministratore. Consulta Aggiungere e gestire account utente per ulteriori informazioni su come controllare chi può registrarsi.

  1. Assicurati di disporre di un Account Google, ad esempio un account Gmail.
  2. Seleziona il link Registrati sul portale per gli sviluppatori.
  3. Seleziona il pulsante Authenticate with Google (Autentica con Google) nella pagina di registrazione.
    Si aprirà una pagina Google in cui ti verrà chiesto di accettare che il portale per gli sviluppatori possa accedere al tuo indirizzo email Google e alle tue informazioni di base.
  4. Seleziona Accetta per approvare.
  5. Verrai reindirizzato alla pagina di registrazione del portale per gli sviluppatori, con le informazioni di Google che precompilano i campi di registrazione.
  6. Specifica le informazioni richieste mancanti per completare la procedura di registrazione.
  7. Seleziona Crea nuovo account.
    Riceverai un'email nel tuo account Gmail con informazioni sul completamento della procedura di registrazione.

Per accedere come sviluppatore esistente:

  1. Seleziona il link Accedi sul portale per gli sviluppatori.
  2. Seleziona il pulsante Authenticate with Google (Autentica con Google) nella pagina di accesso.
    • Se hai già eseguito l'accesso a Google, accederai al portale.
    • Se non hai eseguito l'accesso a Google, inserisci le tue credenziali Google per accedere al portale.
  3. Se è la prima volta che accedi utilizzando le credenziali Google, verrà visualizzata una pagina del portale in cui dovrai associare il tuo Account Google a un account esistente sul portale per gli sviluppatori:

  4. Copia l'URL sotto Il tuo OpenID.
  5. Seleziona il link di accesso nella parte superiore della pagina e accedi con le tue credenziali esistenti del portale per gli sviluppatori.
  6. Seleziona il tuo indirizzo email > Modifica profilo nel menu di primo livello nel portale per gli sviluppatori.
  7. Nella pagina del tuo profilo, seleziona Gestisci i tuoi OpenID.
  8. Inserisci l'URL OpenID e seleziona Aggiungi OpenID.
    Ora puoi accedere utilizzando le tue credenziali Google.

Accedi utilizzando le credenziali di Twitter

Puoi accedere come sviluppatore esistente utilizzando le tue credenziali di Twitter, ma non puoi registrarti come nuovo utente.

L'accesso federato utilizzando le credenziali di Twitter richiede l'attivazione del modulo Drupal Twitter Signin sul portale per gli sviluppatori. Dopo aver abilitato il modulo, nella pagina di accesso verrà visualizzato il seguente pulsante:

La connessione tra il portale per gli sviluppatori e Twitter utilizza OAuth per l'autenticazione. Pertanto, prima di poter accedere al portale per gli sviluppatori con le credenziali di Twitter, devi creare un'app Twitter, che genera quindi la chiave e il consumer secret utilizzati dal portale per gli sviluppatori e da Twitter per la comunicazione.

Nel processo seguente, devi innanzitutto attivare il modulo Twitter Signin sul portale per gli sviluppatori, quindi creare l'app Twitter. Dopo aver creato l'app, torna al modulo Twitter Signin e aggiungi le informazioni di configurazione richieste dall'app Twitter.

Per attivare il modulo Twitter Signin:

  1. Accedi al portale come utente con privilegi di amministratore.
  2. Seleziona Moduli nel menu di amministrazione di Drupal. Viene visualizzato l'elenco di tutti i moduli Drupal installati.
  3. Scorri verso il basso nella pagina e seleziona la casella di controllo accanto al modulo Twitter Signin (Accesso a Twitter).
  4. Salva la configurazione.
    Quando abiliti il modulo Twitter Signin, è possibile che ti venga comunicato che devono essere abilitati anche altri moduli. Assicurati di abilitare questi moduli.
  5. Dopo aver abilitato il modulo di accesso a Twitter, seleziona Configurazione > Servizi web > Twitter nel menu Drupal.
    Viene visualizzata la schermata di configurazione di Twitter.
  6. Seleziona la scheda Impostazioni.
  7. Copia l'URL di callback. Ecco un URL nel modulo:

    http://{env}-{org-name}.devportal.apigee.com/twitter/oauth

    Questo URL è necessario per creare l'app Twitter.

Crea l'app Twitter:

  1. Vai a questa pagina in un browser: https://dev.twitter.com/apps/new e accedi al tuo account Twitter.
  2. Inserisci le seguenti informazioni sul tuo portale:
    Nome: ad esempio MyApigeePortal
    Descrizione: ad esempio Il mio portale Apigee
    Sito web: ad esempio http://{env}-{org-name}.devportal.apigee.com/
    CallbackURL: copia l'URL di callback dalla schermata di configurazione del modulo Twitter Signin.
  3. Accetta i termini/condizioni.
    Si aprirà una pagina Twitter con le impostazioni OAuth, tra cui la chiave e il consumer secret. Sono necessari la chiave e il secret per configurare il modulo di accesso tramite Twitter di Drupal.
  4. Nella scheda Impostazioni, imposta Accesso al tipo di applicazione in Lettura e scrittura.
  5. Seleziona Aggiorna l'impostazione di questa applicazione Twitter.

Per configurare il modulo Twitter Signin:

  1. Accedi al portale come utente con privilegi di amministratore.
  2. Seleziona Configurazione > Servizi web > Twitter nel menu Drupal.
    Viene visualizzata la schermata di configurazione di Twitter.
  3. Seleziona la scheda Impostazioni.
  4. Copia la chiave consumer dalla pagina di Twitter nel campo Chiave consumer OAUTH.
  5. Copia il consumer Secret dalla pagina di Twitter nel campo Consumer Secret OAUTH.
  6. Seleziona Salva configurazione.
  7. Seleziona la scheda Twitter.
  8. Dopo aver effettuato l'accesso a Twitter con l'account che ha creato l'app, seleziona il pulsante Vai a Twitter per aggiungere un account autenticato.
  9. Seleziona la scheda Accedi.
  10. Seleziona No in Registra automaticamente nuovi utenti.
  11. Salva la configurazione.
    Gli utenti di Twitter possono ora registrarsi sul portale per gli sviluppatori e accedere utilizzando le proprie credenziali Twitter.

Per accedere come sviluppatore esistente utilizzando un account Twitter:

  1. Seleziona il link Accedi sul portale per gli sviluppatori.
  2. Seleziona il pulsante Authenticate with Twitter (Autentica con Twitter) nella pagina di accesso.
  3. Il sistema ti reindirizzerà a una pagina di Twitter.
    • Se hai già eseguito l'accesso a Twitter, seleziona Autorizza app.
    • Se non hai già eseguito l'accesso a Twitter, inserisci le tue credenziali Twitter e seleziona Autorizza app.
  4. Se è la prima volta che accedi utilizzando le credenziali di Twitter, verrà visualizzata una pagina del portale in cui dovrai associare il tuo account Twitter a un account esistente sul portale per gli sviluppatori.
  5. Inserisci il nome utente e la password dell'account che vuoi associare al tuo account Twitter. Dovrai eseguire questa operazione una sola volta.
    La prossima volta che accederai con le tue credenziali Twitter, accederai direttamente al portale.

Accedi utilizzando le credenziali GitHub

Puoi accedere come sviluppatore esistente utilizzando le tue credenziali GitHub, ma non puoi registrarti come nuovo utente.

Per accedere federato utilizzando le credenziali GitHub è necessario abilitare il modulo Drupal GitHub Connect sul portale per gli sviluppatori. Dopo aver abilitato il modulo, nella pagina di accesso verrà visualizzato il seguente pulsante:

La connessione tra il portale per gli sviluppatori e GitHub utilizza OAuth per l'autenticazione. Pertanto, prima di poter accedere al portale per gli sviluppatori con le credenziali GitHub, devi creare un'app GitHub, che genera quindi la chiave utente e il segreto utente utilizzati dal portale per sviluppatori e da GitHub per la comunicazione.

Nel processo seguente, devi prima creare l'app GitHub. Dopo aver creato l'app, abilita il modulo di connessione GitHub e aggiungi l'ID client e il client secret dall'app GitHub.

Crea l'app GitHub:

  1. Vai a questa pagina in un browser: https://github.com/settings/applications/new e, se necessario, accedi al tuo account GitHub.
  2. Inserisci le seguenti informazioni sul tuo portale:
    Nome applicazione: ad esempio MyApigeePortal
    Descrizione: ad esempio Il mio portale Apigee
    Sito web: ad esempio http://{env}-{org-name}.devportal.apigee.com/
    CallbackURL: l'URL della home page del tuo portale, con l'estensione /github/register/create. Ad esempio:

    http://{env}-{org-name}.devportal.apigee.com/github/register/create
  3. Se vuoi, scegli un'immagine.
  4. Seleziona Registra applicazione. Il sito GitHub mostra l'ID client e il client secret necessari per configurare il modulo di connessione GitHub sul portale per gli sviluppatori nel seguente formato:
    ID client: dbe86111e411d031d8fb
    Client Secret: e6bd0f838a288113e8b4e531cb6a9487c97f
  5. Copia questi valori da utilizzare durante la configurazione del modulo di connessione GitHub.

Per abilitare il modulo di connessione GitHub:

  1. Accedi al portale come utente con privilegi di amministratore.
  2. Seleziona Moduli nel menu di amministrazione di Drupal. Viene visualizzato l'elenco di tutti i moduli Drupal installati.
  3. Scorri verso il basso nella pagina e seleziona la casella di controllo accanto al modulo di connessione GitHub.
  4. Salva la configurazione.
    Quando abiliti il modulo di connessione GitHub, è possibile che ti venga comunicato che devono essere abilitati anche altri moduli. Dovrebbero essere attivate automaticamente.
  5. Dopo aver abilitato il modulo di connessione GitHub, seleziona Configurazione > Persone > GitHub nel menu Drupal.
    Viene visualizzata la schermata di configurazione di GitHub.
  6. Inserisci l'ID client e il client secret della tua applicazione GitHub.
  7. Posiziona il blocco GitHub Connect nel punto in cui vuoi che venga visualizzato.
  8. Salva la configurazione.

Per accedere come sviluppatore esistente utilizzando un account GitHub:

  1. Seleziona il link Accedi sul portale per gli sviluppatori.
  2. Seleziona il pulsante Accedi con GitHub nella pagina di accesso.
  3. Verrai reindirizzato a una pagina GitHub.
    • Se hai già eseguito l'accesso a GitHub, seleziona Consenti accesso.
    • Se non hai già eseguito l'accesso a GitHub, inserisci le tue credenziali GitHub e seleziona Autorizza app.
  4. Se è la prima volta che accedi utilizzando le credenziali GitHub, verrà visualizzata una pagina del portale in cui devi associare il tuo account GitHub a un account esistente sul portale per gli sviluppatori.
  5. Inserisci il nome utente e la password dell'account che vuoi associare al tuo account GitHub. Dovrai eseguire questa operazione una sola volta.
    La prossima volta che accederai con le tue credenziali GitHub, accederai direttamente al portale.

Accedi utilizzando le credenziali OpenID

OpenID ti consente di creare un singolo nome utente e una password che potrai utilizzare per accedere a qualsiasi sito che supporti OpenID. Con OpenID, la tua password non viene condivisa, ma risiede solo con il provider OpenID. Spetta al provider OpenID verificare la tua identità su un altro sito web. Per ulteriori informazioni su OpenID, visita il sito http://openid.net/.

Se hai un account su alcuni dei siti web più popolari, come Google o Yahoo, hai già un OpenID. Ad esempio, un utente email Yahoo ha un OpenID nel modulo:

https://me.yahoo.com/a/ID univoco

dove UniqueID è generato da Yahoo. Puoi utilizzare questo OpenID per accedere al portale per gli sviluppatori.

Per supportare OpenID con il portale per gli sviluppatori, devi attivare il modulo Drupal OpenID. Non sono richieste altre configurazioni sul portale per gli sviluppatori. Dopo aver abilitato il modulo OpenID, i seguenti link vengono aggiunti automaticamente alla pagina di accesso del portale per gli sviluppatori:

Il portale per sviluppatori associa un OpenID all'account del portale memorizzandolo nel profilo del portale. Dopo aver associato un OpenID al tuo account del portale, puoi visualizzarlo selezionando il tuo indirizzo email > Modifica profilo dal menu di primo livello nel portale per gli sviluppatori, quindi selezionando Gestisci i tuoi OpenID.

Per attivare il modulo OpenID:

  1. Accedi al portale come utente con privilegi di amministratore.
  2. Seleziona Moduli nel menu di amministrazione di Drupal. Viene visualizzato l'elenco di tutti i moduli Drupal installati.
  3. Scorri verso il basso nella pagina e seleziona la casella di controllo accanto al modulo OpenID.
  4. Salva la configurazione.
    Non sono richieste altre configurazioni sul portale per gli sviluppatori.

Per accedere come sviluppatore esistente utilizzando un OpenID:

  1. Accedi al portale per gli sviluppatori utilizzando le tue credenziali del portale sviluppatori.
  2. Seleziona il tuo indirizzo email > Modifica profilo nel menu di primo livello nella barra dei menu.
  3. Nella pagina del tuo profilo, seleziona Gestisci i tuoi OpenID.
  4. Inserisci il tuo OpenID e seleziona Aggiungi un OpenID.
    Ora puoi accedere utilizzando il tuo OpenID.
  5. Esci dal portale per gli sviluppatori.
  6. Seleziona Login.
  7. Nella pagina di accesso, seleziona Accedi utilizzando OpenID.
  8. Inserisci il tuo OpenID.
  9. Seleziona Accedi.

In alternativa, puoi accedere direttamente a un account esistente del portale per sviluppatori utilizzando il tuo OpenID. La prima volta che esegui questa operazione, ti verrà chiesto di accedere con le credenziali del tuo portale per gli sviluppatori. Se accedi per la prima volta, il tuo OpenID viene associato automaticamente all'account del portale per gli sviluppatori. Ora puoi accedere direttamente utilizzando il tuo OpenID.