Aggiungi e gestisci gli account utente

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

Prima che gli utenti possano iniziare a utilizzare il tuo portale per i servizi per sviluppatori, devono essere aggiunti al sistema. Per impostazione predefinita, qualsiasi utente può registrarsi nel portale per sviluppatori selezionando il link Registrati nel menu del portale. L'account dell'utente viene quindi autenticato automaticamente e viene assegnato al ruolo utente autenticato.

Puoi personalizzare il tuo Developer Portal in modo che solo gli utenti con privilegio amministrativo possano aggiungere account utente. In questo caso, un amministratore deve aggiungere gli account utente manualmente. Un amministratore potrebbe anche dover aggiungere manualmente account utente per gli sviluppatori interni o aggiungere sviluppatori per conto di un cliente.

Dopo aver aggiunto un account utente, un amministratore può assegnare un ruolo all'account, che associa i privilegi per quel ruolo all'account. Inoltre, un amministratore può gestire un account utente esistente, inclusa la modifica del profilo utente dell'account, l'eliminazione dell'account, il blocco o lo sblocco dell'account o l'assegnazione di un nuovo ruolo all'account. Un amministratore può anche specificare cosa succede all'account utente e ai relativi contenuti associati (ad esempio, post del blog e del forum) quando l'account viene annullato.

Il portale per gli sviluppatori può inviare automaticamente email agli utenti quando si verificano eventi. Ad esempio, il portale può inviare un'email quando viene aggiunto un utente, un account viene bloccato o un account viene annullato. Nell'ambito della gestione degli utenti, puoi controllare i contenuti e il formato di queste email. Per saperne di più, consulta Configurare l'email.

Per scoprire come gestire i flussi di lavoro di registrazione, personalizzare le email di registrazione, bloccare la registrazione degli indirizzi IP e creare, gestire e bloccare gli account utente, guarda questo video.

Controllare chi può registrare account

Per impostazione predefinita, qualsiasi utente può creare un account dal portale per sviluppatori facendo clic sul link Registrati.

Per controllare chi può registrare account:

  1. Accedi al tuo portale come utente con privilegi amministrativi o di creazione di contenuti.
  2. Seleziona Configurazione > Persone > Impostazioni account nel menu di amministrazione di Drupal. Si apre la pagina Impostazioni account.
  3. Fai clic sull'opzione di registrazione appropriata in "Chi può registrare account" nella sezione Registrazione e annullamento. Le opzioni sono:
    • Solo per gli amministratori: solo gli amministratori possono registrare gli account degli utenti.
    • Visitatori: chiunque può registrarsi. Questa è l'impostazione predefinita.
    • Visitatori, ma è necessaria l'approvazione dell'amministratore: chiunque può registrarsi, ma un amministratore deve autorizzare l'account.
  4. Seleziona o deseleziona la casella di controllo Richiedi verifica email quando un visitatore crea un account. Se non è selezionata, lo sviluppatore accede immediatamente al portale dopo la registrazione. Se la casella è selezionata, l'utente riceve un'email che utilizza per convalidare il suo indirizzo email prima di poter accedere.
  5. Fai clic su Salva configurazione.

Aggiunta di un account utente

A seconda della configurazione del portale, gli amministratori devono aggiungere gli utenti manualmente oppure gli utenti possono registrarsi autonomamente selezionando il link Registrati nel portale per sviluppatori.

Aggiunta di un account utente manualmente

Per aggiungere un account utente manualmente:

  1. Accedi al tuo portale come utente con privilegi amministrativi o di creazione di contenuti.
  2. Seleziona Persone > Aggiungi utente nel menu di amministrazione di Drupal.
  3. Inserisci i contenuti per l'utente nei campi Nome, Cognome, Nome utente, Indirizzo email e Password e indica l'accettazione del contratto con l'utente.
  4. Se vuoi, imposta Stato e ruoli per l'utente.
  5. Seleziona Avvisa l'utente del nuovo account per generare un'email automatica inviata all'utente.
  6. Fai clic su Crea account.

Registrazione di un utente dal portale per sviluppatori

Per registrare un utente dal portale per sviluppatori:

  1. L'utente seleziona Registrati nella home page del portale per gli sviluppatori.
  2. Viene visualizzata la pagina di registrazione.
  3. L'utente inserisce le informazioni richieste e seleziona Crea nuovo account.
    In base alle impostazioni di registrazione del nuovo account, quando viene creato, all'utente viene inviata un'email di benvenuto automatica.

Automatizzare la notifica all'amministratore quando si registra un nuovo utente

Per impostazione predefinita, quando un nuovo utente si registra sul portale, riceve un'email. Per saperne di più, consulta Configurare l'email.

Tuttavia, per impostazione predefinita, gli amministratori del portale non ricevono una notifica quando un nuovo utente si registra. Ad esempio, se configuri il portale in modo che i nuovi utenti debbano disporre dell'approvazione amministrativa per attivare il loro account, devi assicurarti che gli amministratori ricevano una notifica quando viene creato il nuovo account. In caso contrario, l'account utente rimane inattivo.

Per inviare una notifica agli amministratori quando un nuovo utente registra un account:

  1. Accedi al tuo portale come utente con privilegi amministrativi o di creazione di contenuti.
  2. Seleziona Configurazione > Persone > Notifica amministratore nel menu di amministrazione di Drupal.
  3. In Avvisi utente, specifica chi riceve l'email. Puoi indirizzarlo a:
    • Invia a un indirizzo email personalizzato
    • Invia a un ruolo specifico. Se scegli questa opzione, ti consigliamo di creare un nuovo ruolo. In caso contrario, se scegli un ruolo come Amministratore, tutti gli amministratori riceveranno l'email, che potrebbe non essere applicabile a tutti.
    • Entrambi
  4. Modifica l'oggetto e il corpo del messaggio.
  5. Seleziona l'invio dell'email quando:
    • Ricevi email al momento della creazione dell'utente.
    • Ricevere un'email al momento della creazione e dell'aggiornamento dell'utente.
  6. Fai clic su Salva configurazione.

Gestire un account utente

Gli amministratori possono gestire gli account utente per impostare le informazioni utente, reimpostare le password, attivare gli account, annullare o sospendere gli account ed eseguire altre attività.

Per modificare il profilo utente di un account utente:

  1. Accedi al tuo portale come utente con privilegi amministrativi o di creazione di contenuti.
  2. Seleziona Persone nel menu di amministrazione di Drupal.
  3. Utilizza l'area dei filtri nella parte superiore della pagina per filtrare la visualizzazione degli utenti in base a un nome utente, un indirizzo email, uno stato o un'autorizzazione specifici. Per impostazione predefinita, per questi filtri è selezionato "Qualsiasi". In questo caso, tutti gli utenti sono elencati nella pagina.

  4. Fai clic su Modifica nella riga Nome utente dell'account utente. Si apre una visualizzazione modificabile del profilo dell'utente.
  5. Modifica i dati del profilo dell'utente in base alle esigenze.
  6. Fai clic su Salva.

Aggiunta di CAPTCHA

Puoi aggiungere un test CAPTCHA alla pagina di accesso e ad altre pagine attivando i moduli Drupal CAPTCHA e reCAPTCHA. Il modulo reCAPTCHA aggiunge il supporto per il servizio senza costi reCAPTCHA di Google.

Drupal supporta altri moduli CAPTCHA, come i CAPTCHA di immagini, che puoi utilizzare anche sul portale.

Video: guarda un breve video sull'abilitazione del CAPTCHA nel portale per gli sviluppatori.

Per attivare reCAPTCHA:

  1. Accedi al tuo portale come utente con privilegi amministrativi o di creazione di contenuti.
  2. Seleziona Moduli dal menu di Drupal.
  3. Attiva sia i moduli CAPTCHA che reCAPTCHA.
  4. Registrati per le chiavi reCAPTCHA di Google all'indirizzo https://www.google.com/recaptcha/intro/index.html.
  5. Seleziona Configurazione > Persone > CAPTCHA > reCAPTCHA nel menu di Drupal.
  6. Inserisci la chiave pubblica (chiave del sito Google) e la chiave privata (chiave segreta Google). Puoi lasciare le altre impostazioni con i valori predefiniti.
  7. Seleziona Configurazione > Persone > CAPTCHA per impostare il punto in cui vuoi che venga visualizzato il modulo reCAPTCHA. Per impostazione predefinita, viene visualizzato nei moduli di accesso e registrazione degli utenti.
  8. Da questa pagina, imposta il Tipo di sfida per ogni modulo.
  9. Salva le modifiche.

Aggiunta di una pagina Termini e condizioni

Puoi aggiungere al portale per sviluppatori una pagina Termini e condizioni che gli utenti devono accettare al momento dell'accesso prima di poter accedere al portale. Se in un secondo momento modifichi la pagina Termini e condizioni, gli utenti dovranno accettare i termini e condizioni aggiornati al successivo accesso.

L'implementazione della pagina Termini e condizioni utilizza il modulo Legale di Drupal. Questo modulo offre un modo flessibile per creare una pagina Termini e condizioni, monitorare la cronologia delle revisioni dei termini e condizioni e monitorare gli utenti che hanno accettato i termini e condizioni.

Una volta creata, la pagina Termini e condizioni avrà l'URL <siteURL>/legal.

Per attivare il modulo Legale:

  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 informazioni legali.
  4. Fai clic su Salva configurazione.

Per creare una pagina Termini e condizioni:

  1. Accedi al tuo portale come utente con privilegi amministrativi.
  2. Seleziona Configurazione > Persone > Legale nel menu di amministrazione di Drupal.
    Questo elemento del menu viene visualizzato solo quando il modulo Legale è attivo. La casella in alto nella pagina, in corrispondenza di La versione/revisione più recente, mostra i termini e le condizioni attuali. Se non hai definito i termini e le condizioni, questa area è vuota. Puoi creare una nuova versione nell'area Termini e condizioni in Crea nuova versione/traduzione.
  3. Inserisci i tuoi Termini di servizio nell'area Termini e condizioni.
  4. Scegli come visualizzare i Termini e condizioni nella pagina: riquadro scorrevole, riquadro scorrevole (CSS), testo HTML o link alla pagina.
  5. Se vuoi, aggiungi altre caselle di controllo e un'area di testo che descriva le ultime modifiche.
  6. Seleziona Anteprima per visualizzare l'anteprima dei termini e condizioni nell'area Termini e condizioni d'uso in Versione/revisione più recente oppure Salva per salvarli.

Per monitorare le modifiche e l'accettazione dei Termini e condizioni:

  1. Accedi al tuo portale come utente con privilegi amministrativi.
  2. Seleziona Configurazione > Persone > Legale nel menu di amministrazione di Drupal.
  3. Seleziona la scheda Cronologia TdC per visualizzare la cronologia delle revisioni dei termini e condizioni.
  4. Seleziona la scheda Accettati per visualizzare l'elenco degli utenti che hanno accettato ogni versione dei termini e delle condizioni.

Reindirizzare un utente al momento dell'accesso

Per impostazione predefinita, quando un utente accede al portale, viene indirizzato a una pagina che mostra le sue informazioni, ad esempio nome e cognome. In alternativa, puoi utilizzare il modulo Regole di Drupal per aggiungere una regola che reindirizzi automaticamente l'utente a una pagina diversa. Ad esempio, puoi reindirizzare l'utente alla pagina che elenca tutte le sue app o alla home page del portale.

Prima di poter creare una regola di reindirizzamento, devi assicurarti che tutti i moduli Drupal necessari siano abilitati.

Attiva i moduli Drupal necessari:

  1. Accedi al tuo portale come utente con privilegi amministrativi.
  2. Seleziona Moduli nel menu di amministrazione di Drupal.
  3. Attiva i seguenti moduli, se non sono già attivi:
    • Alias "me" (viene visualizzato nella parte superiore dell'elenco dei moduli, non nella posizione alfabetica come tutti gli altri moduli)
    • LoginToboggan
    • Regole
    • Interfaccia utente delle regole
  4. Fai clic su Salva configurazione.
    Potresti notare che altri moduli richiesti vengono attivati automaticamente.

Crea una regola di reindirizzamento all'accesso:

  1. Accedi al tuo portale come utente con privilegi amministrativi.
  2. Seleziona Configurazione > Flusso di lavoro > Regole nel menu di amministrazione di Drupal.
  3. Seleziona + Aggiungi nuova regola nella pagina Regole.
  4. Specifica il nome della regola: Reindirizzamento all'accesso.
  5. Facoltativamente, specifica un tag come accesso.
  6. Nella casella del menu a discesa Reagisci all'evento, seleziona Utente > L'utente ha eseguito l'accesso.
  7. Seleziona Salva
    Viene visualizzata la pagina Modifica regola di reazione. Hai già impostato l'evento nel passaggio precedente, quindi in Evento dovrebbe essere visualizzato il messaggio "Utente ha eseguito l'accesso". Lascia vuoto il campo Condizioni per questa regola.
  8. In Azioni, seleziona + Aggiungi azione.
  9. Seleziona Sistema > Redirect di pagina nel menu a discesa.
    Il layout della pagina Aggiungi una nuova azione cambia per consentirti di specificare l'URL di reindirizzamento.
  10. In Valore, specifica user/[account:uid]/apps.
    [account:uid] è un pattern di sostituzione che corrisponde all'ID portale dell'utente. Per visualizzare l'elenco completo dei pattern di sostituzione, seleziona Pattern di sostituzione nella casella di immissione del valore.
  11. Fai clic su Salva per tornare alla pagina Modifica regola di reazione. La pagina dovrebbe essere visualizzata come mostrato di seguito:
  12. Fai clic su Salva modifiche.
    Per modificare la regola in un secondo momento, seleziona Regole dalla pagina Configurazione e poi seleziona Reindirizzamento accesso dall'elenco delle regole.

Ora, quando un utente accede, viene reindirizzato alla pagina che elenca tutte le sue app. Se invece vuoi reindirizzarli alla home page del portale, modifica il valore impostato sopra nel passaggio 11 per specificare l'URL della home page del tuo portale. Ad esempio, http://dev-myCompany.devportal.apigee.io/.

Impostare i ruoli e le autorizzazioni utente

Un ruolo definisce un insieme specifico di autorizzazioni che consentono a un utente di svolgere determinate attività. Puoi concedere privilegi a un utente o a un gruppo di utenti assegnando l'utente a un ruolo con le autorizzazioni necessarie. Gli amministratori gestiscono i ruoli, inclusa l'impostazione delle autorizzazioni per i ruoli, sul portale per gli sviluppatori.

Per impostazione predefinita, Drupal crea due ruoli:

  • utente anonimo: il ruolo di qualsiasi utente che non ha eseguito l'accesso. Gli utenti anonimi non possono eseguire la maggior parte delle azioni.
  • utente autenticato: il ruolo predefinito assegnato a tutti gli utenti. Puoi assegnare a un utente altri ruoli, ma questi vengono sempre assegnati a questo ruolo.

Inoltre, Apigee ha aggiunto il ruolo di amministratore. Assegna agli utenti il ruolo di amministratore per concedergli i diritti di amministrazione del portale.

In genere, aggiungi i ruoli al tuo portale per differenziare le autorizzazioni in base ai diversi tipi di utenti. Un utente può avere un solo ruolo o più ruoli. A tutti gli utenti viene assegnato il ruolo utente autenticato, ma se vuoi assegnare un utente a ruoli aggiuntivi, devi aggiungere logica al tuo portale o eseguire l'assegnazione del ruolo manualmente.

Per visualizzare tutti i ruoli e le autorizzazioni:

  1. Accedi al tuo portale come utente con privilegi amministrativi o di creazione di contenuti.
  2. Seleziona Persone > Autorizzazioni > Ruoli nel menu di amministrazione di Drupal.

Per aggiungere un nuovo ruolo:

  1. Seleziona Persone > Autorizzazioni > Ruoli.
  2. Inserisci un nuovo nome del ruolo nella casella di testo sopra il pulsante Aggiungi ruolo nella pagina Persone.
  3. Fai clic su Aggiungi ruolo.

Per modificare un ruolo:

  1. Seleziona Persone > Autorizzazioni > Ruoli.
  2. Fai clic su modifica ruolo nella riga del ruolo pertinente nella pagina Persone.
  3. Modifica il nome del ruolo, se opportuno.
  4. Fai clic su Salva.

Per eliminare un ruolo:

  1. Seleziona Persone > Autorizzazioni > Ruoli.
  2. Fai clic su modifica ruolo nella riga del ruolo pertinente nella pagina Persone.
  3. Fai clic su Elimina ruolo.

Per aggiungere un utente a un ruolo:

  1. Accedi al tuo portale come utente con privilegi amministrativi o di creazione di contenuti.
  2. Seleziona Persone nel menu di amministrazione di Drupal.
  3. Fai clic su Modifica nella riga Nome utente dell'account utente. Si apre una visualizzazione modificabile del profilo dell'utente.
  4. Seleziona tutti i ruoli per l'utente, se opportuno.
  5. Fai clic su Salva.

Per modificare le autorizzazioni di un ruolo:

  1. Seleziona Persone > Autorizzazioni > Ruoli.
  2. Fai clic sulla scheda Autorizzazione nella pagina Persone.
    Viene visualizzata una tabella di ruoli e autorizzazioni. I segni di spunta nella tabella indicano quali autorizzazioni sono assegnate a quali ruoli.

  3. Seleziona o deseleziona una casella di controllo per concedere o revocare l'autorizzazione associata al ruolo.
    Ad esempio, per impedire agli utenti autenticati di creare o eliminare app, scorri verso il basso fino alla sezione App per sviluppatori DevConnet della tabella delle autorizzazioni e deseleziona le caselle Crea app per sviluppatori ed Elimina app per sviluppatori in Utenti autenticati.
  4. Fai clic su Salva autorizzazioni.

Personalizzare i campi del modulo utilizzati per registrare un utente

Quando l'utente registra un account sul portale, viene visualizzata la pagina di registrazione predefinita con i campi per Nome, Cognome, Nome utente, Indirizzo email e Password. In qualità di fornitore di API, ti consigliamo di modificare questo modulo per chiedere all'utente di fornire informazioni aggiuntive, come il nome dell'azienda, l'indirizzo postale o altre informazioni. Il portale ti consente di aggiungere nuovi campi a questo modulo. Questi campi possono essere:

  • Obbligatorio o facoltativo
  • Visualizzati da diversi elementi HTML, come caselle di testo, pulsanti di opzione, caselle di controllo e altro ancora
  • Può essere impostato per essere visualizzato in qualsiasi punto del modulo

Per scoprire come personalizzare il modulo di registrazione utente disponibile nel portale per gli sviluppatori, guarda questo video.

Ad esempio, puoi aggiungere un campo obbligatorio per il nome dell'azienda o un campo facoltativo per il numero di telefono. In alternativa, puoi aggiungere diversi campi, sia facoltativi che obbligatori.

L'immagine seguente mostra un campo obbligatorio per il nome dell'azienda aggiunto al modulo:

In qualità di amministratore del portale, puoi visualizzare e modificare le informazioni dell'utente, inclusi eventuali campi personalizzati, nel seguente modo:

  1. Seleziona Persone nel menu di amministrazione di Drupal sul portale.
  2. Seleziona Modifica nella riga corrispondente al nome dell'utente.

Questo è il modo principale in cui, in qualità di amministratore, accedi alle informazioni degli utenti.

Per impostazione predefinita, quando aggiungi nuovi campi al modulo, i valori dei campi non vengono caricati in Edge. Tuttavia, puoi configurare il portale in modo che carichi questi valori quando l'utente invia il modulo. Ciò significa che puoi visualizzare questi campi su Edge o utilizzare l'API di gestione di Edge per accedervi da uno script.

Ad esempio, per visualizzare i nuovi campi del modulo nell'interfaccia utente di gestione di Edge,vai a Pubblica > Sviluppatori e seleziona il nome utente. I nuovi valori di campo vengono visualizzati nella area Attributi personalizzati della pagina con un nome che corrisponde al nome interno del campo:

Per aggiungere un campo al modulo di registrazione utente:

  1. Accedi al tuo portale come utente con privilegi amministrativi o di creazione di contenuti.
  2. Seleziona Configurazione > Persone > Impostazioni account nel menu di amministrazione di Drupal.
  3. Seleziona il pulsante Gestisci campi nella parte superiore della pagina.
  4. Scorri la pagina verso il basso fino all'area Aggiungi nuovo campo:
  5. Configura il campo. Ad esempio, per il campo Nome dell'azienda mostrato sopra, utilizza le seguenti impostazioni:
  6. Seleziona Salva.
  7. Poiché si tratta di un campo di testo, ti viene chiesto di specificare la lunghezza massima del campo.
  8. Inserisci la lunghezza massima e seleziona Salva impostazioni campo.
  9. Viene visualizzata una nuova pagina che ti consente di specificare informazioni aggiuntive per il campo, tra cui:
    • Una casella di controllo per impostare il campo come obbligatorio.
    • Una casella di controllo per specificare la visualizzazione del campo.
    • Testo di aiuto facoltativo che viene visualizzato in un popup nel modulo.
    • Altre impostazioni.
  10. Assicurati di selezionare la casella di controllo per rendere obbligatorio questo campo.
  11. Se apporti modifiche in questa pagina, salva le impostazioni.
    Potresti dover svuotare la cache del browser prima che il nuovo campo venga visualizzato nel modulo.

Per riordinare gli attributi nel modulo:

Per impostazione predefinita, i nuovi campi obbligatori vengono visualizzati nel modulo dopo il campo Cognome. I campi facoltativi vengono visualizzati nella parte inferiore del modulo, dopo i campi della password.

  1. Accedi al tuo portale come utente con privilegi amministrativi o di creazione di contenuti.
  2. Seleziona Configurazione > Persone > Impostazioni account nel menu di amministrazione di Drupal.
  3. Seleziona il pulsante Gestisci campi nella parte superiore della pagina.
  4. Seleziona il simbolo Più + nella colonna Etichetta e trascina il campo nella posizione in cui vuoi visualizzarlo nel modulo.
  5. Salva le modifiche.

Salvare i valori dei campi del modulo come attributi sviluppatore personalizzati in Edge

Puoi salvare i valori dei campi del modulo negli attributi sviluppatore personalizzati in Edge. Puoi visualizzare e gestire gli attributi personalizzati per uno sviluppatore come descritto in Gestire gli sviluppatori di app.

Dopo aver salvato gli attributi sviluppatore personalizzati, puoi utilizzare la norma relativa alle entità di accesso, ad esempio, per attivare un comportamento dinamico in base ai valori degli attributi personalizzati.

Per scoprire come salvare i valori dei campi del modulo come attributi sviluppatore personalizzati, guarda questo video.

Per salvare i valori di campo come attributi sviluppatore personalizzati in Edge:

  1. Accedi al tuo portale come utente con privilegi amministrativi o di creazione di contenuti.
  2. Seleziona Configurazione > Dev Portal > Attributi sviluppatore nel menu di amministrazione di Drupal.
    Viene visualizzato un elenco dei campi disponibili.
  3. Seleziona il campo che vuoi conservare come attributo in Edge, ad esempio Nome azienda.
  4. Imposta la casella di controllo Mantieni questo campo come attributo in Edge.
  5. Specifica il nome dell'attributo bordo. È il nome visualizzato nella colonna Nome della tabella Attributi personalizzati per l'utente.
  6. Specifica il comportamento per un campo vuoto/
  7. Seleziona la stringa Converti valore in true|false se vuoi eseguire il casting del valore come booleano e convertirlo in una stringa true o false prima di inviarlo a Edge.
  8. Fai clic su Salva configurazione.
    Ora l'attributo personalizzato verrà caricato in Edge quando l'utente invia il modulo. Se, in qualità di amministratore, vuoi modificare il valore di un campo personalizzato, esegui l'operazione dal portale, non da Edge.

Creazione di un'app predefinita quando un utente registra un nuovo account

Puoi creare automaticamente un'app predefinita quando un utente registra un nuovo account del portale. Quando l'utente accede per la prima volta, l'app viene visualizzata nella pagina Le mie app. A seconda delle autorizzazioni assegnate al ruolo dell'utente, puoi consentire all'utente di aggiungere altre app oppure questa può essere l'unica app disponibile per l'utente.

Hai il controllo completo sulle proprietà dell'app predefinita, tra cui:

  • I prodotti API inclusi dall'app
  • Lo stato dell'app: in attesa o approvata
  • L'URL di callback, se necessario
  • Parametri personalizzati applicati all'app

Per controllare la creazione di un'app predefinita, devi creare una regola utilizzando il modulo Regole di Drupal. Una regola consente di definire un'azione che si verifica in risposta a un evento sul portale. In questo scenario, l'evento è la registrazione di un utente a un account sul portale. L'azione consiste nel creare un'app predefinita per l'utente.

La sezione Personalizzazione dei campi del modulo utilizzati per registrare un'app descrive come aggiungere attributi personalizzati utilizzati per configurare un'app. Questi attributi possono essere facoltativi o obbligatori, a seconda di come li definisci. Se hai creato attributi personalizzati per le app, puoi impostarli quando definisci un'app predefinita.

Attiva i moduli delle regole di Drupal:

  1. Accedi al tuo portale come utente con privilegi amministrativi.
  2. Seleziona Moduli nel menu di amministrazione di Drupal
  3. Se non sono già attivi, attiva i seguenti moduli:
    • Alias "me" (viene visualizzato nella parte superiore dell'elenco dei moduli, non nella posizione alfabetica come tutti gli altri moduli)
    • LoginToboggan
    • Regole
    • Interfaccia utente delle regole
  4. Fai clic su Salva configurazione.
    Potresti notare che altri moduli richiesti vengono attivati automaticamente.

Creare una regola per aggiungere un'app predefinita:

  1. Accedi al tuo portale come utente con privilegi amministrativi.
  2. Seleziona Configurazione > Flusso di lavoro > Regole nel menu di amministrazione di Drupal.
  3. Seleziona il pulsante +Aggiungi nuova regola.
  4. Specifica il nome della regola.
  5. Se vuoi, specifica l'accesso nel campo Tag o qualsiasi altro tag da utilizzare per classificare la regola.
  6. Nella casella del menu a discesa Reagire a un evento, seleziona Utente > Dopo aver salvato un nuovo account utente.
  7. Seleziona Salva.
    Viene visualizzata la pagina di modifica della regola. Hai già impostato l'evento nel passaggio precedente, quindi in Evento dovrebbe essere visualizzato "Dopo aver salvato un nuovo account utente".
  8. Lascia vuoto il campo Condizioni per questa regola.
  9. In Azioni, seleziona + Aggiungi azione.
  10. Seleziona Devconnect > Crea un'applicazione per sviluppatori nel menu a discesa.
    La pagina Aggiungi una nuova azione cambia il layout per consentirti di configurare l'app.
  11. In Nome API, specifica il nome dell'app predefinita. Ad esempio, utilizza [account:field_last_name] Applicazione.
    Il valore [account:field_last_name] è un pattern di sostituzione che corrisponde al cognome dell'utente. Per visualizzare l'elenco completo dei pattern di sostituzione, seleziona Pattern di sostituzione nella casella di immissione Valore.
  12. Imposta UID sviluppatore su [account:uid]. Questo valore è obbligatorio per associare l'utente all'app.
  13. Imposta lo stato dell'app su in attesa o approvata. Impostalo su In attesa se un amministratore deve ancora approvare l'app prima che l'utente possa utilizzarla per accedere alle tue API.
  14. Se necessario, imposta l'URL di callback per l'app. Questo campo viene visualizzato solo se hai configurato le app in modo che richiedano un URL di callback. Per ulteriori informazioni sulla configurazione degli URL di callback, consulta Configurare la gestione degli URL di callback.
  15. Se hai definito attributi app personalizzati, facoltativi o obbligatori, impostali. Per maggiori informazioni, consulta Personalizzare i campi del modulo utilizzati per registrare un'app.
  16. Specifica i prodotti API inclusi nell'app.
    La casella di testo Valore deve elencare ogni prodotto API su una riga separata, senza virgole o altri delimitatori. L'elenco dei prodotti API disponibili è mostrato sopra l'area di testo Valore.
  17. Fai clic su Salva per tornare alla pagina Regola di modifica.
  18. Fai clic su Salva modifiche.
  19. Per modificare la regola in un secondo momento, seleziona Configurazione > Flusso di lavoro > Regole nel menu di amministrazione di Drupal, quindi seleziona la regola dall'elenco delle regole.

Quando un nuovo utente accede al portale per la prima volta e seleziona il link Le mie app nel menu, ora vede un'app denominata Application lastName, dove lastName è l'ultimo nome utilizzato quando l'utente ha registrato l'account.

Amministrare le app utente

In qualità di amministratore del portale, puoi utilizzare il report App per sviluppatori per gestire le app utente direttamente dal portale. Da questo report, un amministratore può visualizzare le informazioni sull'app di un utente, modificarla o eliminarla. Ad esempio, un amministratore del portale può modificare l'app per aggiungere o rimuovere prodotti API, modificare l'URL di callback o apportare altre modifiche.

Per amministrare un'app utente:

  1. Accedi al tuo portale come utente con privilegi amministrativi.
  2. Seleziona Report > App sviluppatore nel menu di amministrazione di Drupal. Viene visualizzato un elenco ordinatile delle app dell'utente.
  3. Per qualsiasi app nell'elenco:
    • Seleziona il link Modifica per modificare le proprietà dell'app.
    • Seleziona il link Elimina per eliminare l'app.

Annullamento di un account utente

Un amministratore del portale può annullare un account utente. L'amministratore può annullare un singolo account o più account contemporaneamente.

Per annullare un account utente singolo:

  1. Accedi al tuo portale come utente con privilegi amministrativi.
  2. Seleziona Persone nel menu di amministrazione di Drupal.
  3. Nella colonna Operazioni della tabella degli utenti, seleziona Annulla account.
  4. Fai clic sull'opzione di annullamento appropriata in "Quando annulli un account utente". Le opzioni disponibili sono:
    • Disattivare l'account e conservarne i contenuti: (impostazione predefinita) l'account utente e i relativi contenuti vengono conservati. Tuttavia, l'account utente non può accedere alle risorse dell'API. Questa è l'impostazione predefinita. Un amministratore può successivamente sbloccare l'account dell'utente.
    • Disattivare l'account e annullarne la pubblicazione: l'account utente viene conservato. Tuttavia, i contenuti associati all'account utente vengono rimossi. L'accesso alle risorse dell'API è bloccato per l'account utente. Un amministratore può successivamente sbloccare l'account dell'utente.
    • Elimina l'account, ma fai in modo che i relativi contenuti appartengano all'utente anonimo: L'account utente viene eliminato. I contenuti associati all'account utente vengono conservati, ma sono associati all'account utente "Anonimo", ovvero un account non autenticato. L'account utente non può essere riattivato. L'utente deve registrarsi di nuovo e il suo account deve essere autenticato prima di accedere alle risorse dell'API.
    • Elimina l'account e i relativi contenuti: l'account utente e i relativi contenuti correlati vengono eliminati. L'account utente non può essere riattivato. L'utente deve registrarsi di nuovo e il suo account deve essere autenticato prima di accedere alle risorse dell'API.
  5. Se vuoi che l'utente riceva un'email con la richiesta di conferma dell'annullamento, seleziona "Richiedi conferma via email per annullare l'account".
    Se selezioni questa opzione, l'account dell'utente deve disporre delle autorizzazioni corrette per consentire l'annullamento. Seleziona Persone > Autorizzazioni e assicurati che al ruolo "Utente autenticato" sia impostata l'autorizzazione "Annullamento del proprio account utente".
  6. Fai clic su Cancella account.

Per annullare più account utente:

  1. Accedi al tuo portale come utente con privilegi amministrativi.
  2. Seleziona Persone nel menu di amministrazione di Drupal.
  3. In Operazioni, seleziona Annullamento account utente nel menu a discesa.
  4. Seleziona la casella di controllo accanto a ogni utente di cui vuoi annullare l'account.
  5. Seleziona il pulsante Esegui.
  6. Fai clic sull'opzione di annullamento appropriata in "Quando annulli un account utente". Le opzioni disponibili sono:
    • Disattivare l'account e conservarne i contenuti.
    • Disattivare l'account e annullare la pubblicazione dei relativi contenuti.
    • Eliminare l'account, ma fare in modo che i relativi contenuti appartengano all'utente anonimo.
    • Eliminare l'account e i relativi contenuti.
  7. Fai clic su Avanti.
  8. Fai clic su Conferma.

Impostare l'azione predefinita quando un account viene chiuso

Gli amministratori del portale per gli sviluppatori possono impostare l'azione predefinita del portale quando un account utente viene annullato.

Per impostare l'azione predefinita quando un account viene annullato:

  1. Accedi al tuo portale come utente con privilegi amministrativi o di creazione di contenuti.
  2. Seleziona Configurazione nel menu di amministrazione di Drupal.
  3. Seleziona Impostazioni account.
  4. Fai clic sull'opzione di annullamento appropriata in "Quando annulli un account utente" nella sezione Registrazione e annullamento. Le opzioni sono:
    • Disattivare l'account e conservarne i contenuti.
    • Disattivare l'account e annullare la pubblicazione dei relativi contenuti.
    • Eliminare l'account, ma fare in modo che i relativi contenuti appartengano all'utente anonimo.
    • Eliminare l'account e i relativi contenuti.
  5. Fai clic su Salva configurazione.