Pemicu Lambda pra pendaftaran - Amazon Cognito
ParameterContoh: konfirmasi otomatis domain emailContoh: konfirmasi otomatis dan verifikasi semuaContoh: memvalidasi panjang nama pengguna

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Pemicu Lambda pra pendaftaran

Anda mungkin ingin menyesuaikan proses pendaftaran di kumpulan pengguna yang memiliki opsi pendaftaran swalayan. Beberapa penggunaan umum dari pemicu pra pendaftaran adalah untuk melakukan analisis kustom dan pencatatan pengguna baru, menerapkan standar keamanan dan tata kelola, atau menautkan pengguna dari iDP pihak ketiga ke profil pengguna terkonsolidasi. Anda mungkin juga memiliki pengguna tepercaya yang tidak diharuskan menjalani verifikasi dan konfirmasi.

Segera sebelum Amazon Cognito menyelesaikan pembuatan pengguna lokal atau federasi baru, ini mengaktifkan fungsi Lambda pra pendaftaran. Objek permintaan yang dikirim ke fungsi ini berisi atribut yang telah disediakan oleh pendaftaran pengguna lokal atau yang telah berhasil dipetakan dari atribut penyedia untuk pengguna federasi. userAttributes Kumpulan pengguna Anda memanggil pemicu ini saat mendaftar layanan mandiri dengan SignUpatau masuk pertama kali dengan penyedia identitas tepercaya, dan pada pembuatan pengguna dengan. AdminCreateUser Sebagai bagian dari proses pendaftaran, Anda dapat menggunakan fungsi ini untuk menganalisis peristiwa masuk dengan logika khusus, dan memodifikasi atau menolak pengguna baru.

Parameter pemicu Lambda pra-pendaftaran

Permintaan yang diteruskan Amazon Cognito ke fungsi Lambda ini adalah kombinasi dari parameter di bawah ini dan parameter umum yang ditambahkan Amazon Cognito ke semua permintaan.

JSON
{
    "request": {
        "userAttributes": {
            "string": "string",
            . . .
        },
        "validationData": {
            "string": "string",
            . . .
         },
        "clientMetadata": {
            "string": "string",
            . . .
         }
    },

    "response": {
        "autoConfirmUser": "boolean",
        "autoVerifyPhone": "boolean",
        "autoVerifyEmail": "boolean"
    }
}

Parameter permintaan pra-pendaftaran

userAttributes

Satu atau lebih pasangan nilai-nama yang mewakili atribut pengguna. Nama atribut adalah kuncinya.

validationData

Satu atau beberapa pasangan nilai kunci dengan data atribut pengguna yang diteruskan aplikasi Anda ke Amazon Cognito dalam permintaan untuk membuat pengguna baru. Kirim informasi ini ke fungsi Lambda Anda dalam ValidationData parameter permintaan Anda AdminCreateUseratau SignUpAPI.

Amazon Cognito tidak menyetel ValidationData data Anda sebagai atribut pengguna yang Anda buat. ValidationData adalah informasi pengguna sementara yang Anda berikan untuk tujuan pemicu Lambda pra pendaftaran Anda.

clientMetadata

Satu atau lebih pasangan nilai-kunci yang dapat Anda berikan sebagai masukan kustom ke fungsi Lambda yang Anda tentukan untuk pemicu pra pendaftaran. Anda dapat meneruskan data ini ke fungsi Lambda dengan menggunakan ClientMetadata parameter dalam tindakan API berikut: AdminCreateUser,, AdminRespondToAuthChallengeForgotPassword, dan. SignUp

Parameter respons pra pendaftaran

Dalam respons, Anda dapat mengatur autoConfirmUser ke true jika Anda ingin mengonfirmasi pengguna secara otomatis. Anda dapat mengatur autoVerifyEmail ke true untuk memverifikasi secara otomatis email pengguna. Anda dapat mengatur autoVerifyPhone ke true untuk memverifikasi secara otomatis nomor telepon pengguna.

catatan

Parameter responsautoVerifyPhone, autoVerifyEmail dan autoConfirmUser diabaikan oleh Amazon Cognito saat fungsi Lambda pra-pendaftaran dipicu oleh API. AdminCreateUser

autoConfirmUser

Atur ke true untuk mengonfirmasi otomatis pengguna, atau false untuk sebaliknya.

autoVerifyEmail

Setel true untuk menetapkan alamat email pengguna yang mendaftar sebagai terverifikasi, atau false sebaliknya. Jika autoVerifyEmail diatur ke true, atribut email harus memiliki nilai yang valid dan bukan nol. Jika tidak, kesalahan akan terjadi dan pengguna tidak akan bisa menyelesaikan pendaftaran.

Jika email atribut dipilih sebagai alias, alias akan dibuat untuk alamat email pengguna saat autoVerifyEmail disetel. Jika alias dengan alamat email tersebut sudah ada, alias akan dipindahkan ke pengguna baru dan alamat email pengguna sebelumnya akan ditandai sebagai tidak diverifikasi. Untuk informasi selengkapnya, lihat Menyesuaikan atribut masuk.

autoVerifyPhone

Atur ke true untuk mengatur sebagai terverifikasi nomor telepon dari pengguna yang mendaftar, atau false untuk sebaliknya. Jika autoVerifyPhone diatur ke true, atribut phone_number harus memiliki nilai yang valid dan bukan nol. Jika tidak, kesalahan akan terjadi dan pengguna tidak akan bisa menyelesaikan pendaftaran.

Jika atribut phone_number dipilih sebagai alias, alias akan dibuat untuk nomor telepon pengguna ketika autoVerifyPhone diatur. Jika alias dengan nomor telepon tersebut sudah ada, alias akan dipindahkan ke pengguna baru dan nomor telepon pengguna sebelumnya akan ditandai sebagai tidak terverifikasi. Untuk informasi selengkapnya, lihat Menyesuaikan atribut masuk.

Contoh pra pendaftaran: Konfirmasi otomatis pengguna dari domain terdaftar

Ini adalah contoh kode pemicu Lambda. Pemicu pra pendaftaran dipanggil segera sebelum Amazon Cognito memproses permintaan pendaftaran. Ini menggunakan atribut kustom custom:domain untuk mengonfirmasi pengguna baru secara otomatis dari domain email tertentu. Setiap pengguna baru yang tidak berada dalam domain kustom akan ditambahkan ke kolam pengguna, tetapi tidak dikonfirmasi secara otomatis.

Node.js
export const handler = async (event, context, callback) => {
  // Set the user pool autoConfirmUser flag after validating the email domain
  event.response.autoConfirmUser = false;

  // Split the email address so we can compare domains
  var address = event.request.userAttributes.email.split("@");

  // This example uses a custom attribute "custom:domain"
  if (event.request.userAttributes.hasOwnProperty("custom:domain")) {
    if (event.request.userAttributes["custom:domain"] === address[1]) {
      event.response.autoConfirmUser = true;
    }
  }

  // Return to Amazon Cognito
  callback(null, event);
};
Python
def lambda_handler(event, context):
    # It sets the user pool autoConfirmUser flag after validating the email domain
    event['response']['autoConfirmUser'] = False

    # Split the email address so we can compare domains
    address = event['request']['userAttributes']['email'].split('@')

    # This example uses a custom attribute 'custom:domain'
    if 'custom:domain' in event['request']['userAttributes']:
        if event['request']['userAttributes']['custom:domain'] == address[1]:
            event['response']['autoConfirmUser'] = True

    # Return to Amazon Cognito
    return event

Amazon Cognito meneruskan informasi peristiwa ke fungsi Lambda Anda. Fungsi kemudian mengembalikan objek acara yang sama ke Amazon Cognito, dengan perubahan apa pun dalam respons. Di konsol Lambda, Anda dapat mengatur peristiwa pengujian dengan data yang relevan dengan pemicu Lambda Anda. Berikut ini adalah peristiwa pengujian untuk sampel kode ini:

JSON
{
    "request": {
        "userAttributes": {
            "email": "testuser@example.com",
            "custom:domain": "example.com"
        }
    },
    "response": {}
}

Contoh pra pendaftaran: Konfirmasi otomatis dan verifikasi otomatis semua pengguna

Contoh ini mengonfirmasi semua pengguna dan mengatur atribut email dan phone_number pengguna menjadi terverifikasi jika atribut tersebut ada. Juga, jika aliasing diaktifkan, alias akan dibuat untuk phone_number dan email saat verifikasi otomatis diatur.

catatan

Jika alias dengan nomor telepon yang sama sudah ada, alias akan dipindahkan ke pengguna baru, dan phone_number pengguna sebelumnya akan ditandai sebagai belum diverifikasi. Hal yang sama berlaku untuk alamat email. Untuk mencegah hal ini terjadi, Anda dapat menggunakan ListUsers API kumpulan pengguna untuk melihat apakah ada pengguna yang sudah menggunakan nomor telepon atau alamat email pengguna baru sebagai alias.

Node.js
exports.handler = (event, context, callback) => {
  // Confirm the user
  event.response.autoConfirmUser = true;

  // Set the email as verified if it is in the request
  if (event.request.userAttributes.hasOwnProperty("email")) {
    event.response.autoVerifyEmail = true;
  }

  // Set the phone number as verified if it is in the request
  if (event.request.userAttributes.hasOwnProperty("phone_number")) {
    event.response.autoVerifyPhone = true;
  }

  // Return to Amazon Cognito
  callback(null, event);
};
Python
def lambda_handler(event, context):
    # Confirm the user
    event['response']['autoConfirmUser'] = True

    # Set the email as verified if it is in the request
    if 'email' in event['request']['userAttributes']:
        event['response']['autoVerifyEmail'] = True

    # Set the phone number as verified if it is in the request
    if 'phone_number' in event['request']['userAttributes']:
        event['response']['autoVerifyPhone'] = True

    # Return to Amazon Cognito
    return event

Amazon Cognito meneruskan informasi peristiwa ke fungsi Lambda Anda. Fungsi kemudian mengembalikan objek acara yang sama ke Amazon Cognito, dengan perubahan apa pun dalam respons. Di konsol Lambda, Anda dapat mengatur peristiwa pengujian dengan data yang relevan dengan pemicu Lambda Anda. Berikut ini adalah peristiwa pengujian untuk sampel kode ini:

JSON
{
  "request": {
    "userAttributes": {
      "email": "user@example.com",
      "phone_number": "+12065550100"
    }
  },
  "response": {}
}

Contoh pra-pendaftaran: Tolak pendaftaran jika nama pengguna memiliki kurang dari lima karakter

Contoh ini memeriksa panjang nama pengguna dalam permintaan pendaftaran. Contoh mengembalikan kesalahan jika pengguna telah memasukkan nama yang panjangnya kurang dari lima karakter.

Node.js
export const handler = (event, context, callback) => {
    // Impose a condition that the minimum length of the username is 5 is imposed on all user pools.
    if (event.userName.length < 5) {
        var error = new Error("Cannot register users with username less than the minimum length of 5");
        // Return error to Amazon Cognito
        callback(error, event);
    }
    // Return to Amazon Cognito
    callback(null, event);
};
Python
def lambda_handler(event, context):
    if len(event['userName']) < 5:
        raise Exception("Cannot register users with username less than the minimum length of 5")
    # Return to Amazon Cognito
    return event

Amazon Cognito meneruskan informasi peristiwa ke fungsi Lambda Anda. Fungsi kemudian mengembalikan objek acara yang sama ke Amazon Cognito, dengan perubahan apa pun dalam respons. Di konsol Lambda, Anda dapat mengatur peristiwa pengujian dengan data yang relevan dengan pemicu Lambda Anda. Berikut ini adalah peristiwa pengujian untuk sampel kode ini:

JSON
{
  "userName": "rroe",
  "response": {}
}