Utilizzo di credenziali federate sul portale per gli sviluppatori

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

L'accesso federato è il processo in cui utilizzi le credenziali di un sistema di gestione delle identità, chiamato sistema di riferimento, per accedere a un altro sistema. Ad esempio, utilizzi le tue credenziali Google o Twitter per accedere al portale per sviluppatori Apigee. Il vantaggio dell'accesso federato è che il sistema a cui 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 sviluppatori.

Ciascuno dei fornitori di credenziali supportati richiede una procedura di configurazione diversa, come descritto di seguito.

Utilizzo delle 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 può quindi accedere al portale fornendo il nome utente e la password del portale come credenziali.

Con l'accesso federato sul portale, utilizzi le credenziali di terze parti per accedere a un account del portale esistente. In altre parole, devi avere un account sul portale prima di poter accedere con le credenziali di terze parti. Puoi utilizzare una delle credenziali federate supportate 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.

Accedere 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 di Twitter. La prima volta che accedi con le tue credenziali di Twitter, il portale ti chiede di associarle a un account del portale esistente. Esegui questa associazione una sola volta. Dopodiché, puoi accedere con le tue credenziali di 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 le credenziali federate, il portale per gli sviluppatori tenta di ottenere informazioni, in genere l'indirizzo email, dal sistema di riferimento. Ad esempio, utilizzi le tue credenziali Google per creare un nuovo account sviluppatore sul portale. Ti viene chiesto di approvare le informazioni trasmesse al portale da Google. Anche se il sistema di riferimento restituisce informazioni al portale, in genere le nuove registrazioni richiedono di inserire alcune informazioni, come l'accettazione dei termini e delle 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 nel portale per sviluppatori. Per impostazione predefinita, il pulsante seguente viene visualizzato sia nelle pagine di registrazione che in quelle di accesso del portale per gli sviluppatori:

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://laMiaAzienda.devportal.apigee.com. Se l'URL non termina con questo 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: la procedura di registrazione presuppone che il tuo portale sia configurato per consentire a chiunque di registrarsi senza l'approvazione dell'amministratore. Per ulteriori informazioni su come controllare chi può registrarsi, consulta la sezione Aggiungere e gestire gli account utente.

  1. Assicurati di avere già un account Apigee Edge.
  2. Seleziona il link Registrati nel 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 di Apigee Edge e seleziona Accedi.
  4. Se non sono richieste altre informazioni per la registrazione, potrai accedere al portale sviluppatori con il tuo nuovo account.
    Riceverai un'email all'indirizzo associato al tuo account Apigee con informazioni su come completare la procedura di registrazione, ad esempio l'impostazione della password.
  5. Se sono necessarie informazioni aggiuntive per completare la procedura di registrazione, ad esempio l'accettazione dei termini e delle condizioni, verrà visualizzato automaticamente un messaggio di reindirizzamento alla pagina Registrati con il nome utente e i dati email del tuo account Apigee Edge inseriti nei campi appropriati.
  6. Specifica eventuali altre informazioni di registrazione richieste per completare la procedura.
  7. Seleziona Crea nuovo account.
    Riceverai un'email all'indirizzo associato al tuo account Apigee con informazioni su come completare la procedura di registrazione, ad esempio l'impostazione della password.

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

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

Registrati o accedi utilizzando le credenziali di Google

La registrazione e l'accesso federati tramite le credenziali Google sono abilitati per impostazione predefinita nel portale per gli sviluppatori. Sia nella pagina di registrazione che in quella di accesso, vedrai 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 di Google al tuo account del portale memorizzando un OpenID di 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 sviluppatori e poi selezionando Gestisci i tuoi OpenID.

Per registrarti come nuovo sviluppatore utilizzando le tue credenziali Google:

Nota: la procedura di registrazione presuppone che il tuo portale sia configurato per consentire a chiunque di registrarsi senza l'approvazione dell'amministratore. Per ulteriori informazioni su come controllare chi può registrarsi, consulta la sezione Aggiungere e gestire gli account utente.

  1. Assicurati di avere un Account Google esistente, ad esempio un account Gmail.
  2. Seleziona il link Registrati nel portale per sviluppatori
  3. Seleziona il pulsante Autentica con Google nella pagina di registrazione.
    Verrà visualizzata una pagina di 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. Verrà visualizzata nuovamente la pagina di registrazione del portale per gli sviluppatori, con i campi di registrazione precompilati con le informazioni di Google.
  6. Specifica le informazioni obbligatorie mancanti per completare la procedura di registrazione.
  7. Seleziona Crea nuovo account.
    Riceverai un'email sul tuo account Gmail con le informazioni per completare la procedura di registrazione.

Per accedere come sviluppatore esistente:

  1. Seleziona il link Accedi nel portale per sviluppatori.
  2. Seleziona il pulsante 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 di 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 in corrispondenza di Il tuo OpenID.
  5. Seleziona il link di accesso nella parte superiore della pagina e accedi utilizzando le tue credenziali del portale sviluppatori esistenti.
  6. Seleziona il tuo indirizzo email > Modifica profilo dal menu di primo livello nel portale 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.

Accedere utilizzando le credenziali di Twitter

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

Per accedere con l'autenticazione federata utilizzando le credenziali di Twitter, devi attivare il modulo Drupal Twitter Signin (Accesso con Twitter di Drupal) nel portale per gli sviluppatori. Dopo aver attivato il modulo, nella pagina di accesso viene visualizzato il seguente pulsante:

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

Nella procedura riportata di seguito, devi prima attivare il modulo di accesso di Twitter nel portale per sviluppatori, poi creare l'app Twitter. Dopo aver creato l'app, torna al modulo di accesso di Twitter e aggiungi le informazioni di configurazione richieste dall'app Twitter.

Per attivare il modulo di accesso con Twitter:

  1. Accedi al tuo 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 verso il basso nella pagina e seleziona la casella di controllo accanto al modulo di accesso di Twitter.
  4. Salva la configurazione.
    Quando attivi il modulo di accesso di Twitter, potresti ricevere una notifica che ti informa che devono essere attivati anche altri moduli. Assicurati di attivare questi moduli.
  5. Dopo aver attivato il modulo di accesso con Twitter, seleziona Configurazione > Servizi web > Twitter nel menu di Drupal.
    Viene visualizzata la schermata di configurazione di Twitter.
  6. Seleziona la scheda Impostazioni .
  7. Copia l'URL di callback. Si tratta di un URL nel seguente formato:

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

    Per creare l'app Twitter, hai bisogno di questo URL.

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 Callback dalla schermata di configurazione del modulo di accesso di Twitter.
  3. Accetta i termini e le condizioni.
    Verrà visualizzata una pagina di Twitter con le impostazioni OAuth, tra cui la chiave utente e il segreto utente. Per configurare il modulo di accesso con Twitter di Drupal, hai bisogno della chiave e del secret.
  4. Nella scheda Impostazioni, modifica il tipo di accesso all'applicazione in Lettura e scrittura.
  5. Seleziona Aggiorna l'impostazione di questa applicazione Twitter.

Per configurare il modulo di accesso di Twitter:

  1. Accedi al tuo portale come utente con privilegi amministrativi.
  2. Seleziona Configurazione > Servizi web > Twitter nel menu di 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 utente OAuth.
  5. Copia il secret utente dalla pagina di Twitter nel campo Secret utente OAuth.
  6. Seleziona Salva configurazione.
  7. Seleziona la scheda Twitter.
  8. Dopo aver eseguito 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 Accesso.
  10. Seleziona No in Registra automaticamente i nuovi utenti.
  11. Salva la configurazione.
    Ora gli utenti di Twitter possono registrarsi al portale per sviluppatori e accedere utilizzando le proprie credenziali di Twitter.

Per accedere come sviluppatore esistente utilizzando un account Twitter:

  1. Seleziona il link Accedi nel portale per sviluppatori.
  2. Seleziona il pulsante Autentica con Twitter nella pagina di accesso.
  3. Verrà visualizzata una pagina di 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 di Twitter e seleziona Autorizza app.
  4. Se è la prima volta che accedi utilizzando le credenziali di Twitter, verrà visualizzato un messaggio che ti reindirizzerà a una pagina del portale in cui dovrai associare il tuo account Twitter a un account esistente nel 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.
    Al successivo accesso con le tue credenziali di Twitter, accederai direttamente al portale.

Accedere utilizzando le credenziali di GitHub

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

Per accedere in modo federato utilizzando le credenziali GitHub, devi attivare il modulo Drupal GitHub Connect nel portale sviluppatori. Dopo aver attivato il modulo, nella pagina di accesso viene 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 sviluppatori con le credenziali di GitHub, devi prima creare un'app GitHub. L'app genera quindi la chiave consumer e il secret consumer utilizzati dal portale per sviluppatori e da GitHub per comunicare.

Nella procedura riportata di seguito, crea prima l'app GitHub. Dopo aver creato l'app, attiva il modulo Connessione GitHub e aggiungi l'ID cliente e il segreto cliente 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 dell'applicazione: ad esempio MyApigeePortal
    Descrizione: ad esempio My Apigee Portal
    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 cliente e il segreto cliente necessari per configurare il modulo di connessione GitHub nel portale per gli sviluppatori nel seguente formato:
    ID cliente: dbe86111e411d031d8fb
    Segreto cliente: e6bd0f838a288113e8b4e531cb6a9487c27f2d79
  5. Copia questi valori da utilizzare durante la configurazione del modulo di connessione GitHub.

Per attivare il modulo Connessione GitHub:

  1. Accedi al tuo 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 verso il basso nella pagina e seleziona la casella di controllo accanto al modulo Connessione GitHub.
  4. Salva la configurazione.
    Quando attivi il modulo Connessione GitHub, potresti ricevere una notifica che ti informa che è necessario attivare anche altri moduli. Dovrebbero essere attivate automaticamente.
  5. Dopo aver attivato il modulo Connessione GitHub, seleziona Configurazione > Persone > GitHub nel menu di 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 dove vuoi che venga visualizzato.
  8. Salva la configurazione.

Per accedere come sviluppatore esistente utilizzando un account GitHub:

  1. Seleziona il link Accedi nel portale per sviluppatori.
  2. Seleziona il pulsante Accedi con GitHub nella pagina di accesso.
  3. Verrà aperta una pagina di GitHub.
    • Se hai già eseguito l'accesso a GitHub, seleziona Consenti accesso.
    • Se non hai ancora eseguito l'accesso a GitHub, inserisci le tue credenziali di GitHub e seleziona Autorizza app.
  4. Se è la prima volta che accedi utilizzando le credenziali di GitHub, verrà eseguito il reindirizzamento a una pagina del portale in cui dovrai associare il tuo account GitHub a un account esistente nel 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 volta successiva che accederai con le tue credenziali GitHub, accederai direttamente al portale.

Accedi utilizzando le credenziali OpenID

OpenID ti consente di creare un unico nome utente e una password che puoi utilizzare per accedere a qualsiasi sito che supporta OpenID. Con OpenID, la tua password non viene condivisa, ma è conservata solo dal fornitore OpenID. Spetta al provider OpenID verificare la tua identità su un altro sito web. Per maggiori 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 con un indirizzo email Yahoo ha un OpenID nel seguente formato:

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

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

Per supportare OpenID con il portale per sviluppatori, devi attivare il modulo Drupal OpenID. Non è necessaria alcuna altra configurazione sul portale per gli sviluppatori. Dopo aver attivato il modulo OpenID, i seguenti link vengono aggiunti automaticamente alla pagina di accesso del portale per sviluppatori:

Il portale per gli sviluppatori associa un OpenID al tuo account del portale memorizzandolo nel tuo 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 sviluppatori, quindi selezionando Gestisci i tuoi OpenID.

Per attivare il modulo OpenID:

  1. Accedi al tuo 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 verso il basso nella pagina e seleziona la casella di controllo accanto al modulo OpenID.
  4. Salva la configurazione.
    Non è richiesta alcuna altra configurazione nel portale per gli sviluppatori.

Per accedere come sviluppatore esistente utilizzando un OpenID:

  1. Accedi al portale per sviluppatori utilizzando le tue credenziali del portale per sviluppatori.
  2. Seleziona il tuo indirizzo email > Modifica profilo dal 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 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 sviluppatori esistente utilizzando il tuo OpenID. La prima volta ti verrà chiesto di accedere utilizzando le credenziali del tuo Developer Portal. L'accesso per la prima volta associa automaticamente il tuo OpenID all'account del portale per gli sviluppatori. Ora puoi accedere direttamente utilizzando il tuo OpenID.