Amazon Voice ID Update: Amazon Connect Voice ID now detects voice spoofing. When a prospective fraudster tries to spoof caller audio using audio playback or synthesized speech, Voice ID will return a risk score and outcome to indicate the how likely it is that the voice is spoofed.

AWS · AWS · commit 80d97b6a9e7b · 2022-08-29T19:06:25.000Z
diff --git a/.changes/next-release/feature-AmazonVoiceID-db670b8.json b/.changes/next-release/feature-AmazonVoiceID-db670b8.json
@@ -0,0 +1,6 @@
+{
+    "type": "feature",
+    "category": "Amazon Voice ID",
+    "contributor": "",
+    "description": "Amazon Connect Voice ID now detects voice spoofing. When a prospective fraudster tries to spoof caller audio using audio playback or synthesized speech, Voice ID will return a risk score and outcome to indicate the how likely it is that the voice is spoofed."
+}
diff --git a/services/voiceid/src/main/resources/codegen-resources/service-2.json b/services/voiceid/src/main/resources/codegen-resources/service-2.json
@@ -48,7 +48,8 @@
         {"shape":"ThrottlingException"},
         {"shape":"AccessDeniedException"}
       ],
-      "documentation":"<p>Deletes the specified domain from Voice ID.</p>"
+      "documentation":"<p>Deletes the specified domain from Voice ID.</p>",
+      "idempotent":true
     },
     "DeleteFraudster":{
       "name":"DeleteFraudster",
@@ -280,6 +281,7 @@
       "input":{"shape":"OptOutSpeakerRequest"},
       "output":{"shape":"OptOutSpeakerResponse"},
       "errors":[
+        {"shape":"ServiceQuotaExceededException"},
         {"shape":"ResourceNotFoundException"},
         {"shape":"ValidationException"},
         {"shape":"ConflictException"},
@@ -509,7 +511,7 @@
         },
         "Description":{
           "shape":"Description",
-          "documentation":"<p>A brief description of this domain.</p>"
+          "documentation":"<p>A brief description of the domain.</p>"
         },
         "Name":{
           "shape":"DomainName",
@@ -815,7 +817,7 @@
         },
         "ServerSideEncryptionUpdateDetails":{
           "shape":"ServerSideEncryptionUpdateDetails",
-          "documentation":"<p>Details about the most recent server-side encryption configuration update. When the server-side encryption configuration is changed, dependency on the old KMS key is removed through an asynchronous process. When this update is complete, the domain’s data can only be accessed using the new KMS key.</p>"
+          "documentation":"<p>Details about the most recent server-side encryption configuration update. When the server-side encryption configuration is changed, dependency on the old KMS key is removed through an asynchronous process. When this update is complete, the domain's data can only be accessed using the new KMS key.</p>"
         },
         "UpdatedAt":{
           "shape":"Timestamp",
@@ -954,7 +956,10 @@
     },
     "FraudDetectionReason":{
       "type":"string",
-      "enum":["KNOWN_FRAUDSTER"]
+      "enum":[
+        "KNOWN_FRAUDSTER",
+        "VOICE_SPOOFING"
+      ]
     },
     "FraudDetectionReasons":{
       "type":"list",
@@ -987,22 +992,29 @@
         },
         "Reasons":{
           "shape":"FraudDetectionReasons",
-          "documentation":"<p>The reason speaker was flagged by the fraud detection system. This is only be populated if fraud detection Decision is <code>HIGH_RISK</code>, and only has one possible value: <code>KNOWN_FRAUDSTER</code>.</p>"
+          "documentation":"<p>The reason speaker was flagged by the fraud detection system. This is only be populated if fraud detection Decision is <code>HIGH_RISK</code>, and the following possible values: <code>KNOWN_FRAUDSTER</code> and <code>VOICE_SPOOFING</code>.</p>"
         },
         "RiskDetails":{
           "shape":"FraudRiskDetails",
-          "documentation":"<p>Details about each risk analyzed for this speaker.</p>"
+          "documentation":"<p>Details about each risk analyzed for this speaker. Currently, this contains KnownFraudsterRisk and VoiceSpoofingRisk details.</p>"
         }
       },
       "documentation":"<p>The fraud detection result produced by Voice ID, processed against the current session state and streamed audio of the speaker.</p>"
     },
     "FraudRiskDetails":{
       "type":"structure",
-      "required":["KnownFraudsterRisk"],
+      "required":[
+        "KnownFraudsterRisk",
+        "VoiceSpoofingRisk"
+      ],
       "members":{
         "KnownFraudsterRisk":{
           "shape":"KnownFraudsterRisk",
           "documentation":"<p>The details resulting from 'Known Fraudster Risk' analysis of the speaker.</p>"
+        },
+        "VoiceSpoofingRisk":{
+          "shape":"VoiceSpoofingRisk",
+          "documentation":"<p>The details resulting from 'Voice Spoofing Risk' analysis of the speaker.</p>"
         }
       },
       "documentation":"<p>Details regarding various fraud risk analyses performed against the current session state and streamed audio of the speaker.</p>"
@@ -1077,7 +1089,7 @@
         },
         "OutputDataConfig":{
           "shape":"OutputDataConfig",
-          "documentation":"<p>The output data config containing the S3 location where you want Voice ID to write your job output file; you must also include a KMS key iD in order to encrypt the file.</p>"
+          "documentation":"<p>The output data config containing the S3 location where you want Voice ID to write your job output file; you must also include a KMS key ID in order to encrypt the file.</p>"
         },
         "RegistrationConfig":{
           "shape":"RegistrationConfig",
@@ -1125,7 +1137,7 @@
         },
         "JobName":{
           "shape":"JobName",
-          "documentation":"<p>The client-provied name for the fraudster registration job.</p>"
+          "documentation":"<p>The client-provided name for the fraudster registration job.</p>"
         },
         "JobProgress":{
           "shape":"JobProgress",
@@ -1228,7 +1240,7 @@
       "members":{
         "MaxResults":{
           "shape":"MaxResultsForListDomainFe",
-          "documentation":"<p>The maximum number of results that are returned per call. You can use <code>NextToken</code> to obtain further pages of results. The default is 100; the maximum allowed page size is also 100. </p>"
+          "documentation":"<p>The maximum number of domains to list per API call.</p>"
         },
         "NextToken":{
           "shape":"NextToken",
@@ -1419,7 +1431,7 @@
       "members":{
         "KmsKeyId":{
           "shape":"KmsKeyId",
-          "documentation":"<p>the identifier of the KMS key you want Voice ID to use to encrypt the output file of the fraudster registration job.</p>"
+          "documentation":"<p>The identifier of the KMS key you want Voice ID to use to encrypt the output file of a speaker enrollment job/fraudster registration job. </p>"
         },
         "S3Uri":{
           "shape":"S3Uri",
@@ -1483,7 +1495,7 @@
       "members":{
         "KmsKeyId":{
           "shape":"KmsKeyId",
-          "documentation":"<p>The identifier of the KMS key you want Voice ID to use to encrypt your data.</p>"
+          "documentation":"<p>The identifier of the KMS key to use to encrypt data stored by Voice ID. Voice ID doesn't support asymmetric customer managed keys. </p>"
         }
       },
       "documentation":"<p>The configuration containing information about the customer managed key used for encrypting customer data.</p>"
@@ -1770,7 +1782,7 @@
         },
         "RegistrationConfig":{
           "shape":"RegistrationConfig",
-          "documentation":"<p>The registration config containing details such as the action to take when a duplicate fraudster is detected, and the similarity threshold to use for detecting a duplicate fraudster.</p>"
+          "documentation":"<p>The registration config containing details such as the action to take when a duplicate fraudster is detected, and the similarity threshold to use for detecting a duplicate fraudster. </p>"
         }
       }
     },
@@ -1799,7 +1811,7 @@
         },
         "DataAccessRoleArn":{
           "shape":"IamRoleArn",
-          "documentation":"<p>The IAM role Amazon Resource Name (ARN) that grants Voice ID permissions to access customer's buckets to read the input manifest file and write the job output file. Refer to <a href=\"https://docs.aws.amazon.com/connect/latest/adminguide/voiceid-batch-enrollment.html\">Batch enrollment using audio data from prior calls</a> documentation for the permissions needed in this role.</p>"
+          "documentation":"<p>The IAM role Amazon Resource Name (ARN) that grants Voice ID permissions to access customer's buckets to read the input manifest file and write the job output file. Refer to <a href=\"https://docs.aws.amazon.com/connect/latest/adminguide/voiceid-batch-enrollment.html\">Batch enrollment using audio data from prior calls</a> for the permissions needed in this role.</p>"
         },
         "DomainId":{
           "shape":"DomainId",
@@ -1853,14 +1865,14 @@
       "members":{
         "Key":{
           "shape":"TagKey",
-          "documentation":"<p>The first part of a key:value pair that forms a tag associated with a given resource. For example, in the tag ‘Department’:’Sales’, the key is 'Department'. </p>"
+          "documentation":"<p>The first part of a key:value pair that forms a tag associated with a given resource. For example, in the tag 'Department':'Sales', the key is 'Department'. </p>"
         },
         "Value":{
           "shape":"TagValue",
-          "documentation":"<p>The second part of a key:value pair that forms a tag associated with a given resource. For example, in the tag ‘Department’:’Sales’, the value is 'Sales'. </p>"
+          "documentation":"<p>The second part of a key:value pair that forms a tag associated with a given resource. For example, in the tag 'Department':'Sales', the value is 'Sales'. </p>"
         }
       },
-      "documentation":"<p>A tag that can be assigned to a Voice ID resource.</p>"
+      "documentation":"<p>The tags used to organize, track, or control access for this resource. For example, { \"tags\": {\"key1\":\"value1\", \"key2\":\"value2\"} }.</p>"
     },
     "TagKey":{
       "type":"string",
@@ -1957,7 +1969,7 @@
       "members":{
         "Description":{
           "shape":"Description",
-          "documentation":"<p>A brief description about this domain.</p>"
+          "documentation":"<p>A brief description of the domain.</p>"
         },
         "DomainId":{
           "shape":"DomainId",
@@ -1969,7 +1981,7 @@
         },
         "ServerSideEncryptionConfiguration":{
           "shape":"ServerSideEncryptionConfiguration",
-          "documentation":"<p>The configuration, containing the KMS key identifier, to be used by Voice ID for the server-side encryption of your data. Note that all the existing data in the domain are still encrypted using the existing key, only the data added to domain after updating the key is encrypted using the new key. </p>"
+          "documentation":"<p>The configuration, containing the KMS key identifier, to be used by Voice ID for the server-side encryption of your data. Changing the domain's associated KMS key immediately triggers an asynchronous process to remove dependency on the old KMS key, such that the domain's data can only be accessed using the new KMS key. The domain's <code>ServerSideEncryptionUpdateDetails</code> contains the details for this process.</p>"
         }
       }
     },
@@ -1989,6 +2001,17 @@
       },
       "documentation":"<p>The request failed one or more validations; check the error message for more details.</p>",
       "exception":true
+    },
+    "VoiceSpoofingRisk":{
+      "type":"structure",
+      "required":["RiskScore"],
+      "members":{
+        "RiskScore":{
+          "shape":"Score",
+          "documentation":"<p>The score indicating the likelihood of speaker’s voice being spoofed.</p>"
+        }
+      },
+      "documentation":"<p>The details resulting from 'Voice Spoofing Risk' analysis of the speaker.</p>"
     }
   },
   "documentation":"<p>Amazon Connect Voice ID provides real-time caller authentication and fraud screening. This guide describes the APIs used for this service. </p>"
