# ID mapping workflow for one AWS account
An *ID mapping workflow for one AWS account* enables you to perform ID mapping between two datasets on your own AWS account.
Before you create an ID mapping workflow on your own AWS account, you must first complete the [prerequisites](id-mapping-workflow-prerequisite.md).
After you create and run an ID mapping workflow, you can view the output (the ID mapping table) and use it for analysis.
The following topics guide you through a set of steps to create an ID mapping workflow in the same AWS account.
**Topics**
+ [Prerequisites](id-mapping-workflow-prerequisite.md)
+ [Creating an ID mapping workflow (rule-based)](create-IDMW-rule-based-one-acct.md)
+ [Creating an ID mapping workflow (provider services)](create-IDMW-provider-services-one-acct.md)
# Prerequisites
Before you create an ID mapping workflow for one AWS account using either the **Rule-based** or the **Provider services** ID mapping method, you must first do the following:
+ Complete the tasks in [Setting up AWS Entity Resolution](https://docs.aws.amazon.com/entityresolution/latest/userguide/setting-up.html).
+ Complete the tasks in [Prepare input data tables](prepare-data-tables.md), depending on the type of input data you are using.
+ [Create a schema mapping](create-schema-mapping.md) or [Create a matching workflow](create-matching-workflow.md).
+ (**Provider services** ID mapping only) Before you create an ID mapping workflow with LiveRamp, you must choose an Amazon Simple Storage Service (Amazon S3) data staging bucket where you want to temporarily write the ID mapping workflow output.
If you are using the LiveRamp provider service to translate third-party data, add the following permissions policy, which allows you to access the data staging bucket.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"AWS": "arn:aws:iam::715724997226:root"
},
"Action": [
"s3:PutObject",
"s3:GetObject",
"s3:GetObjectVersion",
"s3:DeleteObject"
],
"Resource": [
"arn:aws:s3:::",
"arn:aws:s3:::/*"
]
},
{
"Effect": "Allow",
"Principal": {
"AWS": "arn:aws:iam::715724997226:root"
},
"Action": [
"s3:ListBucket",
"s3:GetBucketLocation",
"s3:GetBucketPolicy",
"s3:ListBucketVersions",
"s3:GetBucketAcl"
],
"Resource": [
"arn:aws:s3:::",
"arn:aws:s3:::/*"
]
}
]
}
```
------
In the preceding permissions policy, replace each ** with your own information.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/entityresolution/latest/userguide/id-mapping-workflow-prerequisite.html)
# Creating an ID mapping workflow (rule-based)
This topic describes the process of creating an ID mapping workflow for one AWS account that uses matching rules to translate first-party data from a source to a target.
**To create a rule-based ID mapping workflow for one AWS account**
1. Sign in to the AWS Management Console and open the AWS Entity Resolution console at [https://console.aws.amazon.com/entityresolution/](https://console.aws.amazon.com/entityresolution/).
1. In the left navigation pane, under **Workflows**, choose **ID mapping**.
1. On the **ID mapping workflows** page, in the upper right corner, choose **Create ID mapping workflow**.
1. For **Step 1: Specify ID mapping workflow details**, do the following.
1. Enter an **ID mapping workflow name** and an optional **Description**.
![\[The name and description fields on the Specify ID mapping workflow page\]](http://docs.aws.amazon.com/entityresolution/latest/userguide/images/specify-ID-mapping-details-name.png)
1. For the **ID mapping method**, choose **Rule-based**.
1. (Optional) To process only new, updated, or deleted records in the workflow, select **Enable incremental processing**.
![\[The ID mapping section of the Specify ID mapping workflow page with the Enable incremental process checkbox selected.\]](http://docs.aws.amazon.com/entityresolution/latest/userguide/images/id-mapping-method-enable-inc-proc.png)
AWS Entity Resolution processes only new, updated, or deleted records in either the Source or Target ID namespace, rather than recreating the entire ID mapping table.
When you choose incremental processing and your data table has a DELETE column, AWS Entity Resolution handles records differently based on the DELETE column value.
+ Records marked as `true` in the DELETE column are removed from the ID mapping table.
+ Records marked as `false` in the DELETE column are ingested into Amazon S3.
If you leave this option unselected, AWS Entity Resolution runs the default batch processing ID mapping workflow on the ID mapping table.
1. (Optional) To enable **Tags** for the resource, choose **Add new tag**, and then enter the **Key** and **Value** pair.
1. Choose **Next**.
1. For **Step 2: Specify source and target**, do the following.
1. For **Source**, choose the scenario that applies to you and then take the recommended action.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/entityresolution/latest/userguide/create-IDMW-rule-based-one-acct.html)
1. For **Target**, select an existing **Matching workflow** from the dropdown list.
1. For **Rule parameters**, do the following.
1. Specify the **Rule controls** by choosing one of the following options based on your source type.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/entityresolution/latest/userguide/create-IDMW-rule-based-one-acct.html)
1. For **Comparison and matching parameters**, the **Comparison type** is automatically set to **Multiple input fields**.
This is because both participants had selected this option previously.
1. Specify the **Record matching type** by choosing one of the following options based on your goal.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/entityresolution/latest/userguide/create-IDMW-rule-based-one-acct.html)
**Note**
You must specify compatible limitations for the source and target ID namespaces.
1. To specify the **Service access** permissions, choose an option and take the recommended action.
![\[The Service access options on the Specify source and target page\]](http://docs.aws.amazon.com/entityresolution/latest/userguide/images/specify-source-target-service-access.PNG)
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/entityresolution/latest/userguide/create-IDMW-rule-based-one-acct.html)
1. Choose **Next**.
1. For **Step 3: Specify data output location – *optional***, do the following.
1. For **Data output destination**, do the following:
1. Choose the **Amazon S3 location** for the data output.
1. For **Encryption**, if you choose to **Customize encryption settings**, then enter the **AWS KMS key** ARN or choose **Create an AWS KMS key**.
1. Choose **Next**.
1. For **Step 4: Review and create**, do the following.
1. Review the selections that you made for the previous steps and edit them if necessary.
1. Choose **Create**.
A message appears, indicating that the ID mapping workflow has been created.
After you create the ID mapping workflow, you're ready to [run an ID mapping workflow](run-id-mapping-workflow.md).
# Creating an ID mapping workflow (provider services)
This topic describes the process of creating an ID mapping workflow for one AWS account using a provider service called LiveRamp. LiveRamp translates a set of source RampIDs to another set using either maintained or derived RampIDs.
**To create a provider service-based ID mapping workflow for one AWS account**
1. Sign in to the AWS Management Console and open the AWS Entity Resolution console at [https://console.aws.amazon.com/entityresolution/](https://console.aws.amazon.com/entityresolution/).
1. In the left navigation pane, under **Workflows**, choose **ID mapping**.
1. On the **ID mapping workflows** page, in the upper right corner, choose **Create ID mapping workflow**.
1. For **Step 1: Specify ID mapping workflow details**, do the following.
1. Enter an **ID mapping workflow name** and an optional **Description**.
![\[The name and description fields on the Specify ID mapping workflow page\]](http://docs.aws.amazon.com/entityresolution/latest/userguide/images/specify-ID-mapping-details-name.png)
1. For the **ID mapping method**, choose **Provider services**.
AWS Entity Resolution currently offers the LiveRamp provider service as an ID mapping method. If you have a subscription to LiveRamp, then the status appears as **Subscribed**. For more information about how to subscribe to LiveRamp, see [Step 1: Subscribe to a provider service on AWS Data Exchange](prepare-third-party-input-data.md#subscribe-provider-service).
![\[The Subscribed status for the LiveRamp ID mapping method on the Specify ID mapping workflow page\]](http://docs.aws.amazon.com/entityresolution/latest/userguide/images/id-mapping-method.PNG)
**Note**
Ensure that your data input file format aligns with the provider service's guidelines. For more information about LiveRamp's input file formatting guidelines, see [Perform Translation Through ADX](https://docs.liveramp.com/identity/en/perform-transcoding-through-adx.html) on the LiveRamp documentation website.
1. For **LiveRamp configuration**, enter the following values that LiveRamp provides:
+ **Client ID manager ARN**
+ **Client secret manager ARN**
![\[The LiveRamp configuration fields on the Specify ID mapping workflow page\]](http://docs.aws.amazon.com/entityresolution/latest/userguide/images/liveramp-configuration.PNG)
1. (Optional) To enable **Tags** for the resource, choose **Add new tag**, and then enter the **Key** and **Value** pair.
1. Choose **Next**.
1. For **Step 2: Specify source and target**, do the following.
1. For **Source**, choose the scenario that applies to you and then take the recommended action.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/entityresolution/latest/userguide/create-IDMW-provider-services-one-acct.html)
1. For **Target**, take one of the following actions based on your chosen ID mapping method.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/entityresolution/latest/userguide/create-IDMW-provider-services-one-acct.html)
1. For **Data staging**, choose the **Amazon S3 location** where you want to temporarily write the ID mapping workflow output.
![\[The Data staging field on the Specify source and target page\]](http://docs.aws.amazon.com/entityresolution/latest/userguide/images/data-staging.PNG)
1. To specify the **Service access** permissions, choose an option and take the recommended action.
![\[The Service access options on the Specify source and target page\]](http://docs.aws.amazon.com/entityresolution/latest/userguide/images/specify-source-target-service-access.PNG)
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/entityresolution/latest/userguide/create-IDMW-provider-services-one-acct.html)
1. Choose **Next**.
1. For **Step 3: Specify data output location – *optional***, do the following.
1. For **Data output destination**, do the following:
1. Choose the **Amazon S3 location** for the data output.
1. For **Encryption**, if you choose to **Customize encryption settings**, then enter the **AWS KMS key** ARN or choose **Create an AWS KMS key**.
1. View the **LiveRamp generated output**.
1. Choose **Next**.
![\[The Data output destination fields on the Specify data output location page\]](http://docs.aws.amazon.com/entityresolution/latest/userguide/images/specify-data-ouput-IDM.PNG)
1. For **Step 4: Review and create**, do the following.
1. Review the selections that you made for the previous steps and edit them if necessary.
1. Choose **Create**.
A message appears, indicating that the ID mapping workflow has been created.
1. After you create the ID mapping workflow, you're ready to [run an ID mapping workflow](run-id-mapping-workflow.md).