{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-guides/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["partial"]},"type":"markdown"},"seo":{"title":"Amazon Security Lake Sink Provider Configuration Guide","siteUrl":"https://docs.synqly.com","lang":"en-US"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"introduction","__idx":0},"children":["Introduction"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Amazon Security Lake is a fully managed AWS Service that centralizes security data from multiple sources and stores them in a data lake. This guide walks you through the steps to gather the necessary information and configure your service for the purpose of creating a new Amazon Security Lake Sink integration."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"prerequisites","__idx":1},"children":["Prerequisites"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Before you begin, ensure that you have:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Activated Amazon Security Lake"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Access to an AWS account with the ability to create IAM policies, IAM roles, IAM users, and Amazon Security Lake Custom Sources."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Access to an AWS account with AWS Lake Formation data lake administrator permissions for the table associated with your Amazon Security Lake Data Lake"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Knowledge of the OCSF Event classes that the integration will send, and the AWS Account ID that will send them"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"required-permissions","__idx":2},"children":["Required Permissions"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Action"},"children":["Action"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Purpose"},"children":["Purpose"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["securitylake:ListDataLakes"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["securitylake:ListLogSources"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Find the Amazon Security Lake Data Lake in the Region, and the location of each Custom Source"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["s3:PutObject"]}," on the Amazon Security Lake bucket"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Write events to your Custom Sources"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["glue:GetTable"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["glue:BatchCreatePartition"]}," on the Custom Source tables"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Add the partition for a new day of events to the table of a Custom Source, so that the events can be queried straight away"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the following policy document and replace these values:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["<region>"]},": the AWS Region that the integration will use. Example: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["us-east-1"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["<region_underscored>"]},": the same AWS Region with underscores. Example: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["us_east_1"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["<account-id>"]},": your AWS account ID. Example: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["123456789012"]}]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"Version\": \"2012-10-17\",\n  \"Statement\": [\n    {\n      \"Sid\": \"SecurityLakeRead\",\n      \"Effect\": \"Allow\",\n      \"Action\": [\"securitylake:ListLogSources\", \"securitylake:ListDataLakes\"],\n      \"Resource\": \"*\"\n    },\n    {\n      \"Sid\": \"SecurityLakeCustomSourceWrite\",\n      \"Effect\": \"Allow\",\n      \"Action\": \"s3:PutObject\",\n      \"Resource\": \"arn:aws:s3:::aws-security-data-lake-<region>-*/ext/*\"\n    },\n    {\n      \"Sid\": \"SecurityLakeCustomSourcePartitions\",\n      \"Effect\": \"Allow\",\n      \"Action\": [\"glue:GetTable\", \"glue:BatchCreatePartition\"],\n      \"Resource\": [\n        \"arn:aws:glue:<region>:<account-id>:catalog\",\n        \"arn:aws:glue:<region>:<account-id>:database/amazon_security_lake_glue_db_<region_underscored>\",\n        \"arn:aws:glue:<region>:<account-id>:table/amazon_security_lake_glue_db_<region_underscored>/amazon_security_lake_table_<region_underscored>_ext_*\"\n      ]\n    }\n  ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The integration also needs these Lake Formation permissions:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Resource"},"children":["Resource"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Lake Formation Permission"},"children":["Lake Formation Permission"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Purpose"},"children":["Purpose"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The table of each Custom Source, named ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["amazon_security_lake_table_<region_underscored>_ext_<custom_source_name>"]},", with the hyphens in the Custom Source name changed to underscores"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Alter"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Add the partition for a new day of events"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"aws-credentials-configuration","__idx":3},"children":["AWS Credentials Configuration"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Synqly supports two methods for authenticating with AWS: static credentials (IAM user access keys)"," ","and role-based access (IAM role assumption). Role-based access is recommended for production"," ","environments because it uses short-lived credentials and provides better auditability through"," ","CloudTrail."]},{"$$mdtype":"Tag","name":"Tabs","attributes":{"size":"medium"},"children":[{"$$mdtype":"Tag","name":"TabItemFragment","attributes":{"label":"Role-Based Access","disable":false},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"role-based-access","__idx":4},"children":["Role-Based Access"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Role-Based access is recommended and is considered an ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html#bp-workloads-use-roles"},"children":["AWS best"," ","practice"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Role-based access uses AWS IAM roles to grant Synqly temporary credentials to access resources in"," ","your AWS account. This eliminates long-lived credentials and provides better security through the"," ","principle of least privilege."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"1-create-an-iam-role","__idx":5},"children":["1. Create an IAM Role"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Create a role in your AWS account with a name that starts with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SynqlyAccess"]}," (for example,"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SynqlyAccessS3Reader"]},"). This naming convention is required."]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In the AWS IAM console, go to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Roles"]}," and choose ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create role"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["For trusted entity type, choose ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Custom trust policy"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Enter the following trust policy:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"Version\": \"2012-10-17\",\n  \"Statement\": [\n    {\n      \"Effect\": \"Allow\",\n      \"Principal\": {\n        \"AWS\": \"arn:aws:iam::733459310821:role/SynqlyIntegrationAccess\"\n      },\n      \"Action\": \"sts:AssumeRole\",\n      \"Condition\": {\n        \"StringEquals\": {\n          \"sts:ExternalId\": \"YOUR_EXTERNAL_ID\"\n        }\n      }\n    }\n  ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Replace ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["YOUR_EXTERNAL_ID"]}," with a unique identifier you generate (for example, a UUID). You will"," ","provide this External ID when configuring the integration."]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":4},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Name the role with a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SynqlyAccess"]}," prefix (for example, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SynqlyAccessMyIntegration"]},")."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Attach the appropriate permissions policy for your use case."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Create the role and note its ARN."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For more details, see:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_common-scenarios_third-party.html"},"children":["Access to AWS accounts owned by third"," ","parties"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-custom.html"},"children":["Create a role using custom trust"," ","policies"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"external-id-requirements","__idx":6},"children":["External ID Requirements"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The External ID is a security mechanism that prevents the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://docs.aws.amazon.com/IAM/latest/UserGuide/confused-deputy.html"},"children":["confused deputy"," ","problem"]},". It ensures that"," ","only authorized requests from Synqly can assume your role."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The External ID must contain only the following characters:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Alphanumeric characters (a-z, A-Z, 0-9)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Special characters: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["+ = , . @ : / -"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Must be between 2 and 1224 characters in length"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"configuring-the-integration-credentials","__idx":7},"children":["Configuring the Integration Credentials"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When creating an AWS integration in Synqly, provide the following configuration values based on your"," ","chosen authentication method."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Credential Parameter"},"children":["Credential Parameter"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Role ARN"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The ARN of the IAM role you created, for example ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["arn:aws:iam::123456789012:role/SynqlyAccessMyIntegration"]},". The role name must start with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SynqlyAccess"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["External ID"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The External ID you specified in the role's trust policy. This value must match exactly"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Role Session Name"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["OPTIONAL:"]}," A name for the role session. If not specified, Synqly generates a default session name"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Duration"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["OPTIONAL:"]}," The duration of the role session in seconds. The value can range from 900 seconds (15 minutes) up to the maximum session duration configured on your role (default is 1 hour)"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"TabItemFragment","attributes":{"label":"Static Credentials (IAM User)","disable":false},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"static-credentials-iam-user","__idx":8},"children":["Static Credentials (IAM User)"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["AWS static credentials are ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["NOT RECOMMENDED"]}," for production systems. See the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html#bp-workloads-use-roles"},"children":["AWS best"," ","practices"]}," ","for more details."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Static credentials consist of an Access Key ID and Secret Access Key associated with an IAM user."," ","Use this method for simpler setups."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"1-create-an-iam-user","__idx":9},"children":["1. Create an IAM User"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In the AWS IAM console, go to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Users"]}," and choose ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create user"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Enter a user name (for example, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SynqlyIntegration"]},")."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Do not enable console access; this user only needs programmatic access."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Under permissions, choose ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Attach policies directly"]}," and attach the appropriate policy for your"," ","use case."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Create the user."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"2-create-an-access-key","__idx":10},"children":["2. Create an Access Key"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Open the newly created user and choose ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create access key"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["For the use case, choose ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Third-party service"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Create the key and securely copy the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Access Key ID"]}," and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Secret Access Key"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For more details, see:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html"},"children":["Managing access keys for IAM"," ","users"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://docs.aws.amazon.com/IAM/latest/UserGuide/access-keys-admin-managed.html"},"children":["How an IAM administrator can manage IAM user access"," ","keys"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"configuring-the-integration-credentials-1","__idx":11},"children":["Configuring the Integration Credentials"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When creating an AWS integration in Synqly, provide the following configuration values based on your"," ","chosen authentication method."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Credential Parameter"},"children":["Credential Parameter"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Access Key ID"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The Access Key ID from your IAM user's access key pair"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Secret Access Key"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The Secret Access Key from your IAM user's access key pair"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Session Token"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["OPTIONAL:"]}," A temporary session token. Only required if you are using temporary credentials from AWS STS."]}]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"creating-amazon-security-lake-custom-sources","__idx":12},"children":["Creating Amazon Security Lake Custom Sources"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Open the Amazon Security Lake Console with an AWS account that has permission to create Amazon Security Lake Custom Sources"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Custom sources"]}," from the sidebar on the left"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create custom source"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In the section titled ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Custom source details"]},", enter a name for the custom source",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Example: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["detection-findings"]}]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select the OCSF Event class that this custom source will be used for"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In the section titled ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["AWS account with permission to write data"]},", fill in the following fields:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["AWS account ID"]},": the ID of the AWS account that owns the IAM role or user from the section titled ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#aws-credentials-configuration"},"children":["AWS Credentials Configuration"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["External ID"]},": enter any value"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In the section titled ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Service Access"]},", create a new service role or select an existing one"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Take note of the custom source name and the OCSF event class"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Repeat steps 3 to 9 for each OCSF event class that the integration will write"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"granting-lake-formation-permissions","__idx":13},"children":["Granting Lake Formation Permissions"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Open the AWS Lake Formation Console with an AWS account that has administrator permissions for the table associated with your Amazon Security Lake Data Lake"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Permissions > Data permissions"]}," from the sidebar on the left"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Grant"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["IAM users and roles"]},", then select the IAM role or user from the section titled ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#aws-credentials-configuration"},"children":["AWS Credentials Configuration"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In the section titled ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["LF-Tags or catalog resources"]},", select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Named data catalog resources"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select the database ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["amazon_security_lake_glue_db_<region_underscored>"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select the tables named in the ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Resource"]}," column."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In the section titled ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Table permissions"]},", select the permissions named in the ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Lake Formation Permission"]}," column"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Grant"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Repeat steps 3 to 9 for each row of the table"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"configuring-the-integration","__idx":14},"children":["Configuring the Integration"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Integration Parameter"},"children":["Integration Parameter"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Region"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["This is the AWS Region where you activated Amazon Security Lake and created the Custom Sources. Example: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["us-east-1"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Custom Log Sources > Account ID"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["This is the AWS Account ID that you entered in the ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["AWS account ID"]}," field when you created the Custom Sources. Example: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["123456789012"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Custom Log Sources > Mappings"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["This is the mapping of each Custom Source name to its OCSF Event class that was created in the section titled the section titled ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#creating-amazon-security-lake-custom-sources"},"children":["Creating Amazon Security Lake Custom Sources"]},"."]}]}]}]}]}]},"headings":[{"value":"Introduction","id":"introduction","depth":2},{"value":"Prerequisites","id":"prerequisites","depth":2},{"value":"Required Permissions","id":"required-permissions","depth":2},{"value":"AWS Credentials Configuration","id":"aws-credentials-configuration","depth":2},{"value":"Role-Based Access","id":"role-based-access","depth":3},{"value":"1. Create an IAM Role","id":"1-create-an-iam-role","depth":4},{"value":"External ID Requirements","id":"external-id-requirements","depth":3},{"value":"Configuring the Integration Credentials","id":"configuring-the-integration-credentials","depth":3},{"value":"Static Credentials (IAM User)","id":"static-credentials-iam-user","depth":3},{"value":"1. Create an IAM User","id":"1-create-an-iam-user","depth":4},{"value":"2. Create an Access Key","id":"2-create-an-access-key","depth":4},{"value":"Configuring the Integration Credentials","id":"configuring-the-integration-credentials-1","depth":3},{"value":"Creating Amazon Security Lake Custom Sources","id":"creating-amazon-security-lake-custom-sources","depth":2},{"value":"Granting Lake Formation Permissions","id":"granting-lake-formation-permissions","depth":2},{"value":"Configuring the Integration","id":"configuring-the-integration","depth":2}],"frontmatter":{"slug":"guides/provider-configuration/amazonsecuritylake-sink-setup","seo":{"title":"Amazon Security Lake Sink Provider Configuration Guide"}},"lastModified":"2026-11-13T23:24:33.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/provider-configuration/amazonsecuritylake-sink-setup","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}