Personalización de los flujos de trabajo con Amazon Cognito Events

Con Amazon Cognito Events, puede ejecutar una función de AWS Lambda como respuesta a eventos importantes de Amazon Cognito. Amazon Cognito lanza el evento desencadenador de sincronización cuando se sincroniza un conjunto de datos. Puede utilizar el evento disparador de la sincronización para actuar cuando un usuario actualiza los datos. La función puede evaluar y, de forma opcional, manipular los datos antes de que estos se almacenen en la nube y se sincronicen con los demás dispositivos del usuario. Es una función útil para validar los datos que vienen del dispositivo antes de que se sincronicen con los demás dispositivos del usuario o actualizar otros valores del conjunto de datos en función de los datos de entrada, como la emisión de un premio cuando un jugador logra un nivel nuevo.

Siga estos pasos para configurar una función de Lambda que se ejecuta cada vez que se sincroniza un conjunto de datos de Amazon Cognito.

Creación de una función en AWS Lambda

Para integrar Lambda en Amazon Cognito, primero debe crear una función en Lambda. Para ello:

Ahora que ya tiene una función adecuada escrita en Lambda, debe elegir esa función como controlador del evento desencadenador de Amazon Cognito Sync. Los pasos siguientes le guiarán por este proceso.

En la página de inicio de la consola:

Ahora su función de Lambda se ejecutará cada vez que se sincronice un conjunto de datos. En la sección siguiente se explica cómo puede leer y modificar los datos de su función mientras se están sincronizando.

Escritura de una función de Lambda para los desencadenadores de sincronización

Los desencadenadores de sincronización respetan el patrón de programación de la interfaz del proveedor de servicios. Amazon Cognito proporciona datos de entrada con el formato JSON siguiente a su función de Lambda.

{
  "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 espera que el valor de retorno de la función tenga el mismo formato que el de entrada.

Al escribir funciones para el evento Sync Trigger, observe lo siguiente:

Función de Lambda de ejemplo

En la siguiente función de Lambda de ejemplo se muestra cómo acceder, modificar y eliminar datos.

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);
};