Skema acara ID Suara

ID Suara menghasilkan peristiwa untuk setiap transaksi: pendaftaran, otentikasi, atau deteksi penipu dalam daftar pantauan. Acara dikirim ke bus acara EventBridge default.

Anda dapat membuat pipeline analitik untuk hasil autentikasi ID Suara dan deteksi penipu dalam daftar pantauan menggunakan EventBridge untuk memantau peristiwa ID Suara. Menggunakan skema yang tersedia dalam topik ini, Anda dapat mengonfigurasi EventBridge aturan untuk mendengarkan dan memfilter peristiwa ID Suara yang relevan, lalu memprosesnya melalui Amazon Data Firehose untuk disimpan di gudang data pilihan Anda.

Misalnya, Anda mungkin ingin melacak analisis ID Suara yang hampir real-time. Untuk melakukan itu, Anda dapat menarik semua Evaluate-Session acara, dan mendapatkan authenticationResult danfraudDetectionResult.

Peristiwa dipancarkan atas dasar upaya terbaik.

Bidang umum dalam acara tersebut

• version- Versi data acara.

• id- Pengidentifikasi unik dari peristiwa yang dihasilkan oleh EventBridge

• detail-type- Pengidentifikasi untuk detail acara.

• source- Sumber acara. Ini selaluaws.voiceid.

• account- ID AWS akun.

• timestamp- Tanggal dan waktu acara dipublikasikanUTC.

• region- AWS Wilayah tempat API panggilan dilakukan.

• resources- Sumber daya yang digunakan oleh API panggilan.

• detail- Detail tentang acara:

  • detail.sourceId- ID unik yang dihasilkan oleh ID Suara yang dapat Anda gunakan untuk de-duplikasi.

  • detail.action- Analog dengan yang API dipanggil.

  • detail.status- Menentukan status tindakan: sukses atau gagal.

  • detail.errorInfo- Diisi saat kesalahan tindakan yang ditentukan keluar di ID Suara.

Berikut ini adalah skema untuk acara yang dipancarkan.

Mulai Aksi Sesi

Memancarkan peristiwa saat streaming mulai (setelah penyiapan), streaming berakhir, dan pada kegagalan.

{...commonfields
    "detail-type": "VoiceId Start Session Action",
    "detail": {
        "sourceId": String,
        "action": "START_SESSION",
        "status": String,
        "domainId": String,
        "session": {
            "sessionId": String,
            "sessionName": String,
            "authenticationConfiguration": {
                "acceptanceThreshold":Integer
            },
            "fraudDetectionConfiguration": {
                "riskThreshold":Integer,
                "watchlistId": String
            },
            "streamingConfiguration": {
                "authenticationMinimumSpeechInSeconds": Integer
            },
            "enrollmentAudioProgress": {
                "audioAggregationStatus": String,
                "audioAggregationStartedAt": "Timestamp",
                "audioAggregationEndedAt": "Timestamp"
            },
            "authenticationAudioProgress": {
                "audioAggregationStartedAt": "Timestamp",
                "audioAggregationEndedAt": "Timestamp"
            },
            "fraudDetectionAudioProgress": {
                "audioAggregationStartedAt": "Timestamp",
                "audioAggregationEndedAt": "Timestamp"
            },
            "generatedSpeakerId": String
        },
        "errorInfo": {
            "errorMessage": String,
            "errorType": String,
            "errorCode": Integer
       }
    }
}

Perbarui Tindakan Sesi

Memancarkan peristiwa ketika pembaruan sesi internal berhasil atau gagal.

{...commonfields
"detail-type": "VoiceId Update Session Action",
"detail": {
    "sourceId": String,
    "action": "UPDATE_SESSION",
    "status": String,
    "domainId": String,
    "session": {
        "sessionId": String,
        "sessionName": String,
        "authenticationConfiguration": {
            "acceptanceThreshold": Integer
        },
        "fraudDetectionConfiguration": {
            "riskThreshold": Integer,
            "watchlistId": String
        },
        "streamingConfiguration": {
            "authenticationMinimumSpeechInSeconds": Integer
        },
        "generatedSpeakerId": String
    },
    "errorInfo": {
        "errorMessage": String,
        "errorType": String,
        "errorCode": Integer
    }
}
}   

Evaluasi Tindakan Sesi

Memancarkan peristiwa ketika evaluasi sesi berhasil atau gagal. Alasannya bisa KNOWN _ FRAUDSTER atau VOICE _SPOOFING.

{...commonfields
"detail-type": "VoiceId Evaluate Session Action",
"detail": {
    "sourceId": String,
    "action": "EVALUATE_SESSION",
    "status": String,
    "domainId": String,
    "session": {
        "sessionId": String,
        "sessionName": String,
        "generatedSpeakerId": String,
        "streamingStatus": String,
        "authenticationResult": {
            "authenticationResultId": String,
            "decision": String,
            "score": Integer,
            "audioAggregationStartedAt": "Timestamp",
            "audioAggregationEndedAt": "Timestamp",
            "configuration": {
                "acceptanceThreshold": Integer
            }
        },
        "fraudDetectionResult": {
            "fraudDetectionResultId": String,
            "decision": String,
            "reasons": [String],
            "audioAggregationStartedAt": "Timestamp",
            "audioAggregationEndedAt": "Timestamp",
            "configuration": {
                   "riskThreshold": Integer
            },
            "riskDetails": {
                 "knownFraudsterRisk": {
                         "generatedFraudsterId": String,
                         "riskScore": Integer,
                         "watchlistId": String
                  },
                  "voiceSpoofingRisk": {
                        "riskScore": Integer
                  } 
            }
         }
     },
     "errorInfo": {
        "errorMessage": String,
        "errorType": String,
        "errorCode": Integer
    }
}
}  

Aksi Pembicara

Memancarkan peristiwa tentang keberhasilan atau kegagalan untuk memilih keluar dari pembicara, menghapus pembicara, atau mendaftarkan pembicara.

{...commonfields
"detail-type": "VoiceId Speaker Action",
"detail": {
    "sourceId": String,
    "domainID": String,
    "action": String,
    "status": String,
    "generatedSpeakerId": String,
    "data": {
        "enrollmentSource": String,
        "enrollmentSourceId": String,
        "enrollmentStatus": String
        },
    "errorInfo": {
        "errorMessage": String,
        "errorType": String,
        "errorCode": Integer
     }
}
}   

Tindakan Penipu

Memancarkan peristiwa ketika penipu berhasil didaftarkan atau dihapus.

Acara tidak dikirim ketika penipu dikaitkan atau dipisahkan dengan daftar pantauan.

{...commonfields
"detail-type": "VoiceId Fraudster Action",
"detail": {
    "sourceId": String,
    "domainID": String,
    "action": String,
    "status": String,
    "generatedFraudsterId": String,
    "watchlistIds": [String],
    "data": {
        "registrationSource": String,
        "registrationSourceId": String,
        "registrationStatus": String
    },
    "errorInfo": {
        "errorMessage": String,
        "errorType": String,
        "errorCode": Integer
    }
}
}       

EnrollBySession

Memancarkan acara ini ketika permintaan pendaftaran diajukan. Sebuah Speaker peristiwa dipancarkan ketika pendaftaran aktual berhasil atau gagal.

{...commonfields
"detail-type": "VoiceId Session Speaker Enrollment Action",
"detail": {
    "sourceId": String,
    "domainId": String,
    "action": "SESSION_ENROLLMENT_REQUEST",
    "status": String,
    "sessionId": String,
    "sessionName": String,
    "errorInfo": {
        "errorMessage": String,
        "errorType": String,
        "errorCode": Integer
    }
}
}  

StartSpeakerEnrollmentJob

Memancarkan acara ini ketika permintaan pendaftaran batch dikirimkan, berhasil, atau gagal. Sebuah Speaker acara dipancarkan untuk masing-masing pembicara individu untuk menunjukkan apakah pendaftaran yang sesuai berhasil atau gagal.

{...commonfields
"detail-type": "VoiceID Batch Speaker Enrollment Action",
"detail": {
    "sourceId": String,
    "domainId": String,
    "action": "BATCH_ENROLLMENT_REQUEST",
    "status": String,
    "batchJobId": String,
    "data": {
        "dataAccessRoleArn": String,
        "enrollmentConfig": {
            "existingEnrollmentAction": String,
            "fraudDetectionConfig": {
            "fraudDetectionAction": String,
            "riskThreshold": Integer,
            "watchlistIds": [String],
            }
        },
        "inputDataConfig": {
            "s3Uri": String
         },
        "outputDataConfig": {
            "s3Uri": String,
            "kmsKeyId": String
        }
    },
    "errorInfo": {
        "errorMessage": String,
        "errorType": String,
        "errorCode": Integer
    }
}
}     

StartFraudsterRegistrationJob

Memancarkan acara ini ketika permintaan pendaftaran batch dikirimkan, berhasil, atau gagal. Suatu Fraudster peristiwa dipancarkan untuk masing-masing penipu individu untuk menunjukkan apakah pendaftaran yang sesuai berhasil atau gagal.

{...commonfields
"detail-type": "VoiceId Batch Fraudster Registration Action",
"detail": {
    "sourceId": String,
    "domainId": String,
    "action": "BATCH_REGISTRATION_REQUEST",
    "status": String,
    "batchJobId": String,
    "data": {
        "dataAccessRoleArn": String,
        "registrationConfig": {
            "duplicateRegistrationAction": String,
            "fraudsterSimilarityThreshold": Integer,
            "watchlistIds": [String],
        }
        "inputDataConfig": {
            "s3Uri": String
        },
        "outputDataConfig": {
            "s3Uri": String,
            "kmsKeyId": String
        }
    },                                                      
    "errorInfo": {
        "errorMessage": String,
        "errorType": String,
        "errorCode": Integer
    }
}
}