Amazon Cognito Events

Amazon Cognito Events ti consente di eseguire una funzione AWS Lambda in risposta a eventi importanti di Amazon Cognito. Amazon Cognito lancia l'evento trigger di sincronizzazione quando viene sincronizzato un set di dati. Puoi utilizzare l'evento del trigger di sincronizzazione per eseguire un'azione quando un utente aggiorna i dati. La funzione è in grado di valutare e, facoltativamente, modificare i dati prima che siano archiviati nel cloud e sincronizzati negli altri dispositivi dell'utente. Questa funzione è utile per convalidare i dati provenienti dal dispositivo prima che siano sincronizzati negli altri dispositivi dell'utente o per aggiornare altri valori nel set di dati in base ai dati in entrata, come l'attribuzione di un riconoscimento quando un giocatore raggiunge un nuovo livello.

Le fasi di seguito ti guideranno attraverso la configurazione di una funzione Lambda che viene eseguita ogni volta che il set di dati di Amazon Cognito viene sincronizzato.

Creazione di una funzione in AWS Lambda

Per integrare Lambda con Amazon Cognito, per prima cosa hai bisogno di creare una funzione in Lambda. A tale scopo:

Ora che disponi di una funzione appropriata scritta in Lambda, devi scegliere quella funzione come gestore dell'evento del trigger di Amazon Cognito Sync. La seguente procedura ti guiderà attraverso il processo.

Dalla home page della console:

Ora, la tua funzione Lambda verrà eseguita ogni volta che un set di dati è sincronizzato. La sezione seguente spiega in che modo puoi leggere e modificare i dati nella tua funzione durante la loro fase di sincronizzazione.

Scrittura di una funzione Lambda per trigger di sincronizzazione

I trigger di sincronizzazione seguono il modello di programmazione usato dall'interfaccia del fornitore di servizi. Amazon Cognito fornisce l'input alla tua funzione Lambda nel formato JSON seguente.

{
  "version": 2,
  "eventType": "SyncTrigger",
  "region": "us-east-1",
  "identityPoolId": "identityPoolId",
  "identityId": "identityId",
  "datasetName": "datasetName",
  "datasetRecords": {
    "SampleKey1": {
      "oldValue": "oldValue1",
      "newValue": "newValue1",
      "op": "replace"
    },
    "SampleKey2": {
      "oldValue": "oldValue2",
      "newValue": "newValue2",
      "op": "replace"
    },..
  }
}

Amazon Cognito richiede il valore restituito della funzione nello stesso formato dell'input.

Quando scrivete funzioni per l'evento Sync Trigger, osserva quanto segue:

Funzione Lambda di esempio

Ecco un esempio di funzione Lambda che mostra come accedere, modificare e rimuovere i dati.

console.log('Loading function');

exports.handler = function(event, context) {
    console.log(JSON.stringify(event, null, 2));

    //Check for the event type
    if (event.eventType === 'SyncTrigger') {

        //Modify value for a key
        if('SampleKey1' in event.datasetRecords){
            event.datasetRecords.SampleKey1.newValue = 'ModifyValue1';
            event.datasetRecords.SampleKey1.op = 'replace';
        }

        //Remove a key
        if('SampleKey2' in event.datasetRecords){
            event.datasetRecords.SampleKey2.op = 'remove';
        }

        //Add a key
        if(!('SampleKey3' in event.datasetRecords)){
            event.datasetRecords.SampleKey3={'newValue':'ModifyValue3', 'op' : 'replace'};
        }

    }
    context.done(null, event);
};