Autenticazione delle richieste in AMP per l'email

Per i contenuti delle email personalizzate dinamiche è spesso necessaria l'autenticazione dell'utente. Tuttavia, per proteggere i dati utente, tutte le richieste HTTP effettuate dall'interno delle email AMP all'interno di Gmail vengono inviati tramite proxy e rimossi dai cookie.

Per autenticare le richieste effettuate dalle email AMP, puoi utilizzare token di accesso.

Token di accesso

Puoi utilizzare i token di accesso per autenticare l'utente. I token di accesso sono forniti e controllati dal mittente dell'email. Il mittente utilizza i token per assicurarsi solo quelli con accesso all'email AMP possono effettuare le richieste contenute contenuti nell'email. I token di accesso devono essere crittograficamente sicuri, in termini di tempo limitato all'ambito. Sono inclusi nell'URL della richiesta.

Questo esempio mostra l'utilizzo di <amp-list> per visualizzare i dati autenticati:

<amp-list src="https://example.com/endpoint?token=REPLACE_WITH_YOUR_ACCESS_TOKEN"
  height="300">
  <template type="amp-mustache">
    ...
  </template>
</amp-list>

Allo stesso modo, quando utilizzi <amp-form>, inserisci il token di accesso nella sezione action-xhr URL.

<form action-xhr="https://example.com/endpoint?token=REPLACE_WITH_YOUR_ACCESS_TOKEN" method="post">
  <input type="text" name="data">
  <input type="submit" value="Send">
</form>

Esempio

L'esempio seguente considera un servizio ipotetico per l'aggiunta di note che consente utenti che hanno eseguito l'accesso per aggiungere note al proprio account e visualizzarle in un secondo momento. Il servizio vuole inviare a un utente, jane@example.com, un'email che include un elenco di appunti che ha preso in precedenza. L'elenco delle note dell'utente corrente è disponibile nell'endpoint https://example.com/personal-notes in formato JSON.

Prima di inviare l'email, il servizio genera una crittografia sicura token di accesso a utilizzo limitato per jane@example.com: A3a4roX9x. Il token di accesso è incluso nel nome del campo exampletoken all'interno della query dell'URL:

<amp-list src="https://example.com/personal-notes?exampletoken=A3a4roX9x" height="300">
  <template type="amp-mustache">
    <p>{{note}}</p>
  </template>
</amp-list>

L'endpoint https://example.com/personal-notes è responsabile della convalida il parametro exampletoken e di trovare l'utente associato al token.

Per ulteriori informazioni, vedi Token di accesso a utilizzo limitato.