Voice ID-Ereignisschema

Voice ID generiert Ereignisse für jede Transaktion: Registrierung, Authentifizierung oder Erkennung von Betrügern auf einer Beobachtungsliste. Ereignisse werden an den Standard-Event-Bus gesendet. EventBridge

Sie können eine Analysepipeline für die Ergebnisse der Voice ID-Authentifizierung und die Erkennung von Betrügern in einer Beobachtungsliste einrichten, indem Sie sie EventBridge zur Überwachung von Voice ID-Ereignissen verwenden. Mithilfe des in diesem Thema verfügbaren Schemas können Sie EventBridge Regeln konfigurieren, um relevante Voice ID-Ereignisse abzuhören und zu filtern und sie dann über Amazon Kinesis Data Firehose zu verarbeiten, um sie in einem Data Warehouse Ihrer Wahl zu speichern.

Möglicherweise möchten Sie beispielsweise die Voice ID-Analyse nahezu in Echtzeit verfolgen. Dazu können Sie alle Evaluate-Session Ereignisse abrufen und das authenticationResult und abrufenfraudDetectionResult.

Ereignisse werden nach bestem Wissen und Gewissen ausgegeben.

Allgemeine Felder in der Veranstaltung

• version- Die Version der Ereignisdaten.

• id- Eine eindeutige Kennung des Ereignisses, generiert von EventBridge

• detail-type- Eine Kennung für die Details des Ereignisses.

• source- Die Quelle des Ereignisses. Dies ist immer aws.voiceid.

• account- AWS Konto-ID.

• timestamp- Datum und Uhrzeit der Veröffentlichung des Ereignisses in UTC.

• region- Die AWS Region, in der der API-Aufruf getätigt wurde.

• resources- Vom API-Aufruf verwendete Ressourcen.

• detail- Einzelheiten zur Veranstaltung:

  • detail.sourceId- Eine von Voice ID generierte eindeutige ID, die Sie für die Deduplizierung verwenden können.

  • detail.action- Analog zur aufgerufenen API.

  • detail.status- Gibt den Status der Aktion an: Erfolg oder Fehlschlag.

  • detail.errorInfo- Wird aufgefüllt, wenn bei der angegebenen Aktion bei Voice ID ein Fehler auftritt.

Im Folgenden sind die Schemas für die ausgegebenen Ereignisse aufgeführt.

Sitzungsaktion starten

Gibt Ereignisse beim Start des Streams (nach der Einrichtung), beim Stream-Ende und bei Fehlern aus.

{...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
       }
    }
}

Aktion „Sitzung aktualisieren“

Gibt Ereignisse aus, wenn das interne Sitzungsupdate erfolgreich ist oder fehlschlägt.

{...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
    }
}
}   

Sitzungsaktion auswerten

Gibt Ereignisse aus, wenn die Sitzungsauswertung erfolgreich ist oder fehlschlägt. Die Gründe können KNOWN_FRAUDSTER oder VOICE_SPOOFING sein.

{...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
    }
}
}  

Aktion des Lautsprechers

Gibt Ereignisse aus, wenn ein Sprecher erfolgreich abbestellt, gelöscht oder angemeldet wurde.

{...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
     }
}
}   

Aktion eines Betrügers

Gibt Ereignisse aus, wenn ein Betrüger erfolgreich registriert oder gelöscht wurde.

Es werden keine Ereignisse gesendet, wenn ein Betrüger mit einer Beobachtungsliste verknüpft oder deren Verknüpfung aufgehoben wird.

{...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

Löst dieses Ereignis aus, wenn eine Registrierungsanfrage eingereicht wird. Ein Speaker Ereignis wird ausgelöst, wenn die tatsächliche Registrierung erfolgreich ist oder fehlschlägt.

{...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

Dieses Ereignis wird ausgelöst, wenn eine Batch-Registrierungsanfrage eingereicht wird, erfolgreich ist oder fehlschlägt. Für jeden einzelnen Redner wird ein Speaker Ereignis ausgelöst, das angibt, ob die entsprechende Registrierung erfolgreich war oder nicht.

{...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

Dieses Ereignis wird ausgelöst, wenn eine Batch-Registrierungsanfrage eingereicht wurde, erfolgreich ist oder fehlschlägt. Für jeden einzelnen Betrüger wird ein Fraudster Ereignis ausgelöst, das anzeigt, ob die entsprechende Registrierung erfolgreich war oder fehlschlägt.

{...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
    }
}
}