Personnalisation des flux de travail avec Amazon Cognito Events

Amazon Cognito Events vous permet d'exécuter une AWS Lambda fonction en réponse à des événements importants dans Amazon Cognito. Amazon Cognito déclenche l'événement Sync Trigger lors de la synchronisation d'un jeu de données. Vous pouvez utiliser cet événement pour effectuer une action lorsqu'un utilisateur met à jour des données. Cette fonction peut évaluer et éventuellement manipuler les données avant d'être stockées dans le cloud et synchronisées avec les autres dispositifs de l'utilisateur. Elle est particulièrement utile pour valider des données provenant d'un dispositif avant qu'elles ne soient synchronisées avec les autres appareils de l'utilisateur, ou pour mettre à jour d'autres valeurs dans l'ensemble de données en fonction des données entrantes (comme l'attribution d'un prix quand un joueur atteint un nouveau niveau).

Les étapes ci-dessous illustrent comment configurer une fonction Lambda qui s'exécute chaque fois qu'un jeu de données Amazon Cognito est synchronisé.

Création d'une fonction dans AWS Lambda

Pour intégrer Lambda avec Amazon Cognito, vous devez commencer par créer une fonction dans Lambda. Pour ce faire :

Maintenant qu'une fonction appropriée est écrite dans Lambda, vous devez choisir cette fonction en tant que gestionnaire de l'événement Sync Trigger d'Amazon Cognito. Les étapes indiquées ci-dessous vous guident tout au long de ce processus.

A partir de la page d'accueil de la console :

Désormais, la fonction Lambda sera exécutée à chaque synchronisation d'un jeu de données. La section suivante explique comment lire et modifier les données dans votre fonction lorsqu'elles sont en cours de synchronisation.

Écriture d'une fonction Lambda pour des déclencheurs de synchronisation

Les déclencheurs de synchronisation suivent le modèle de programmation suivi par les interfaces du fournisseur de services. Amazon Cognito fournit des entrées à votre fonction Lambda au format suivant. JSON

{
  "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 attend la valeur de retour de la fonction au même format que l'entrée.

Lorsque vous écrivez des fonctions pour l'événement de déclencheur de synchronisation, observez les points suivants :

Exemple de fonction Lambda

L'exemple de fonction Lambda suivant montre comment accéder aux données, les modifier et les supprimer.

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