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, puoi utilizzare 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 in altri sistemi.

Il portale Servizi per gli sviluppatori supporta l'accesso federato utilizzando credenziali di diversi provider 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 al portale e specifica un nome utente, un indirizzo email e una password. L'utente può quindi accedere al portale fornendo il nome utente e la password del portale come credenziali.

Con l'accesso federato sul portale, puoi utilizzare le credenziali di una terza parte per accedere a un account del portale esistente. Ciò significa che devi avere un account sul portale prima di poter accedere con credenziali di terze parti. Puoi utilizzare una qualsiasi delle credenziali federate supportate da Apigee per accedere a un account del portale esistente. Inoltre, puoi utilizzare le credenziali 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. Questa associazione viene eseguita una sola volta. Successivamente, puoi accedere con le tue credenziali Twitter e il portale conserverà le informazioni sull'associazione.

Registrazione di un nuovo account del portale in corso

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, in genere l'indirizzo email. Ad esempio, utilizzerai 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 informazioni al portale, le nuove registrazioni in genere richiedono l'inserimento di alcune informazioni, ad esempio l'accettazione dei 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, nelle pagine di registrazione e di accesso del portale per gli sviluppatori viene visualizzato il seguente pulsante:

Il pulsante viene visualizzato solo sui portali con un URL che termina con apigee.com, ovvero i 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 sul 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 sull'impostazione della password.

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

  1. Seleziona il link Login 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

La registrazione federata e l'accesso utilizzando le credenziali Google sono abilitate sul portale per gli sviluppatori per impostazione predefinita. Nelle pagine di registrazione e di accesso sarà presente 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 all'account del tuo portale, puoi vedere il codice 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 esistente, ad esempio un account Gmail.
  2. Seleziona il link Registrati sul portale per gli sviluppatori
  3. Nella pagina di registrazione, seleziona il pulsante Authenticate with Google (Autentica con Google).
    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 eventuali informazioni obbligatorie mancanti per completare il processo di registrazione.
  7. Seleziona Crea nuovo account.
    Riceverai un'email sul tuo account Gmail con le informazioni sul completamento della procedura di registrazione.

Per accedere come sviluppatore esistente:

  1. Seleziona il link Login sul portale per gli sviluppatori.
  2. Seleziona il pulsante Autenticazione con Google nella pagina di accesso.
    • Se hai già effettuato 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 devi associare il tuo Account Google a un account esistente sul portale per gli sviluppatori:

  4. Copia l'URL in Il tuo OpenID.
  5. Seleziona il link di accesso nella parte superiore della pagina e accedi utilizzando le tue credenziali esistenti per il 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 usando 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 con 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 prima creare un'app Twitter, che genera quindi la chiave e il segreto utente utilizzati dal portale per gli sviluppatori e da Twitter per comunicare.

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

Per abilitare il modulo Accedi con Twitter:

  1. Accedi al portale come utente con privilegi amministrativi.
  2. Seleziona Moduli nel menu di amministrazione di Drupal. Viene visualizzato l'elenco di tutti i moduli Drupal installati.
  3. Scorri la pagina verso il basso e seleziona la casella di controllo accanto al modulo Accesso a Twitter.
  4. Salva la configurazione.
    Quando attivi il modulo Accedi con Twitter, potresti ricevere una notifica che indica che devono essere abilitati anche altri moduli. Assicurati di abilitare questi moduli.
  5. Dopo aver attivato il modulo 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. Usa questo URL nel modulo:

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

    È necessario questo URL 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 di Twitter con le impostazioni OAuth, tra cui la chiave utente e il segreto utente. Sono necessari la chiave e il secret per configurare il modulo Drupal Twitter Signin.
  4. Nella scheda Impostazioni, imposta Accesso tipo di applicazione in Lettura e scrittura.
  5. Seleziona Aggiorna l'impostazione di questa applicazione Twitter.

Per configurare il modulo Accedi con Twitter:

  1. Accedi al portale come utente con privilegi amministrativi.
  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 utente dalla pagina di Twitter nel campo Chiave consumatore 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 Twitter, seleziona il pulsante Vai a Twitter per aggiungere un account autenticato.
  9. Seleziona la scheda Accedi.
  10. Seleziona No sotto Registra automaticamente nuovi utenti.
  11. Salva la configurazione.
    Gli utenti di Twitter ora possono registrarsi sul portale per gli sviluppatori e accedere utilizzando le loro credenziali di Twitter.

Per accedere come sviluppatore esistente utilizzando un account Twitter:

  1. Seleziona il link Login sul portale per gli sviluppatori.
  2. Seleziona il pulsante Authenticate with Twitter (Autentica con Twitter) nella pagina di accesso.
  3. Verrai reindirizzato a una pagina Twitter.
    • Se hai già eseguito l'accesso a Twitter, seleziona Autorizza app.
    • Se non hai ancora 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, verrai reindirizzato a una pagina sul portale in cui devi 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. Devi 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.

L'accesso federato utilizzando le credenziali GitHub richiede l'abilitazione del 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 prima creare un'app GitHub, che genera quindi la chiave e il segreto utente utilizzati dal portale per gli sviluppatori e da GitHub per comunicare.

Nel processo seguente, devi prima creare l'app GitHub. Dopo aver creato l'app, abilita il modulo 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, puoi scegliere 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:
    Client ID: dbe86111e411d031d8fb
    Client Secret: e6bd0f838a288113e8b4e531cb6a9487c27
  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 amministrativi.
  2. Seleziona Moduli nel menu di amministrazione di Drupal. Viene visualizzato l'elenco di tutti i moduli Drupal installati.
  3. Scorri la pagina verso il basso e seleziona la casella di controllo accanto al modulo 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 Login sul portale per gli sviluppatori.
  2. Seleziona il pulsante Login with GitHub (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, verrai reindirizzato a una pagina sul 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. Devi 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 consente di creare un unico nome utente e una singola 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 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 formato:

https://me.yahoo.com/a/UniqueID

dove UniqueID viene 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 necessarie 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 gli sviluppatori associa un OpenID all'account del portale memorizzando OpenID nel profilo del portale. Dopo aver associato un OpenID al tuo account del portale, puoi visualizzare 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 attivare il modulo OpenID:

  1. Accedi al portale come utente con privilegi amministrativi.
  2. Seleziona Moduli nel menu di amministrazione di Drupal. Viene visualizzato l'elenco di tutti i moduli Drupal installati.
  3. Scorri la pagina verso il basso 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 sistema OpenID:

  1. Accedi al portale per gli sviluppatori utilizzando le credenziali del portale per gli sviluppatori.
  2. Seleziona il tuo indirizzo email > Modifica profilo nel menu di primo livello della 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 Accedi.
  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 del portale per gli sviluppatori esistente usando il tuo OpenID. La prima volta che esegui questa operazione, ti verrà chiesto di accedere utilizzando le credenziali del portale per gli sviluppatori. Se effettui il primo accesso, il tuo OpenID verrà associato automaticamente all'account del portale per gli sviluppatori. Ora puoi accedere direttamente utilizzando il tuo OpenID.