사기범 감시 목록 생성 및 편집

다음 API를 사용하여 사기범 감시 목록을 만들고 사기범을 등록하세요.

1. CreateWatchlistAPI를 사용하여 새 사기꾼 감시 목록을 만드세요.

2. StartFraudsterRegistrationJobAPI를 사용하여 일괄 등록하십시오. 새 감시 목록에 새 사기범을 등록하거나 Voice ID 도메인과 연결된 기본 감시 목록에 등록할 수 있습니다.

새 사기범을 등록할 때 Voice ID는 Voice ID 도메인에 등록된 모든 사기범과 보이스프린트를 비교하여 기존 사기범과 중복되는지 확인합니다.

지정된 사기범 감시 목록에 사기범을 추가하려면 다음 데이터를 API에 전달하세요.

1. 녹음을 연결할 도메인을 지정하는 데 사용할 도메인 ID

2. 사기범 목록이 포함된 입력 파일. 사기범 등록 작업의 입력 및 출력 파일 스키마 섹션을 참조하십시오.

3. 출력 파일의 위치

4. 출력을 작성할 때 사용할 KMS 키

5. Voice ID가 맡을 수 있는 역할. 오디오 파일이 저장된 S3 버킷에 액세스할 수 있어야 합니다. 이 역할은 파일을 암호화하는 데 사용되는 모든 KMS 키에 액세스할 수 있어야 합니다. 또한 지정된 출력 위치에 쓸 수 있어야 하며 출력 작성에 요청된 KMS 키를 사용할 수 있어야 합니다. 특히 다음 권한이 있어야 합니다.

   • 입력 버킷킷에 대한 s3:GetObject

   • 출력 버킷에 대한 s3:PutObject

   • 입력 버킷의 기본 암호화에 사용되는 KMS 키에 대한 kms:Decrypt

   • 입력에 제공되고 출력 버킷에 출력 파일을 쓰는 데 사용되는 KMS 키에 대한 kms:Decrypt 및 kms:GenerateDataKey

   호출하고 dataAccessRole을 제공할 때는 iam:PassRole 권한이 있어야 합니다. dataAccessRole에 혼동된 대리인 예방을 활성화하려면 Amazon Connect Voice ID 서비스 간 혼동되는 대리자 방지 섹션을 참조하세요.

6. 사기범을 등록할 watchlistId. watchlistId가 지정되지 않은 경우 사기범은 Voice ID 도메인의 기본 감시 목록에 등록됩니다.

7. 사기범의 중복 상태를 확인하기 위한 임계값

8. 사기범 중복을 무시하기 위한 플래그

Voice ID는 사기범을 성공적으로 추가하여 사기범 목록을 업데이트하고, 항목과 관련된 GeneratedFraudsterID를 동일한 S3 위치로 다시 반환합니다. 중복이 식별되면 Voice ID는 항목에 대해 '중복' 상태를 반환하고 일치율이 가장 높은 GeneratedFraudsterId를 제공합니다. 사기범이 성공적으로 등록되면 API를 사용하여 에서 식별한 이 사기범을 새 감시 목록에 연결할 수 있습니다. GeneratedFraudsterID AssociateFraudster

사기범 목록이 생성되기 전에는 Voice ID가 감시 목록에 있는 사기범을 탐지할 수 없습니다.

사기범 목록의 할당량은 Amazon Connect 서비스 할당량 섹션을 참조하세요.

참고

사기범 목록에 추가하면 요금이 부과됩니다. 자세한 내용은 Amazon Connect Voice ID 요금을 참조하세요.