{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-guides/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["partial"]},"type":"markdown"},"seo":{"title":"Amazon Security Lake SIEM 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 SIEM 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":["An ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://docs.aws.amazon.com/athena/latest/ug/workgroups-create-manage.html"},"children":["Amazon Athena workgroup"]}," in the same Region, with a query result location set"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To enable this integration to write events as well as read them, you also need ensure that you have:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$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:ListLogSources"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["List the log sources in the data lake"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["glue:GetDatabase"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["glue:GetTable"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["glue:GetTables"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["glue:GetPartitions"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Find the Security Lake tables and read their structure"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["athena:StartQueryExecution"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["athena:GetQueryExecution"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["athena:GetQueryResults"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Run queries and read the results"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["lakeformation:GetDataAccess"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read the Security Lake tables"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["s3:GetBucketLocation"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["s3:ListBucket"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["s3:GetObject"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["s3:PutObject"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["s3:AbortMultipartUpload"]}," on the Athena query result bucket"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Write and read query results. Only needed if the workgroup stores query results in your own S3 bucket"]}]}]}]}]},{"$$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":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["<workgroup-name>"]},": the name of the Athena workgroup. Example: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["primary"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["<athena-results-bucket>"]},": the bucket of the workgroup's query result location. Example: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["my-athena-results"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If the workgroup uses Athena managed query results, remove the statement with the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Sid"]}," value ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AthenaQueryResults"]},"."]},{"$$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\",\n      \"Resource\": \"*\"\n    },\n    {\n      \"Sid\": \"GlueCatalogRead\",\n      \"Effect\": \"Allow\",\n      \"Action\": [\n        \"glue:GetDatabase\",\n        \"glue:GetTable\",\n        \"glue:GetTables\",\n        \"glue:GetPartitions\"\n      ],\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>/*\"\n      ]\n    },\n    {\n      \"Sid\": \"AthenaQuery\",\n      \"Effect\": \"Allow\",\n      \"Action\": [\n        \"athena:StartQueryExecution\",\n        \"athena:GetQueryExecution\",\n        \"athena:GetQueryResults\"\n      ],\n      \"Resource\": \"arn:aws:athena:<region>:<account-id>:workgroup/<workgroup-name>\"\n    },\n    {\n      \"Sid\": \"LakeFormationDataAccess\",\n      \"Effect\": \"Allow\",\n      \"Action\": \"lakeformation:GetDataAccess\",\n      \"Resource\": \"*\"\n    },\n    {\n      \"Sid\": \"AthenaQueryResults\",\n      \"Effect\": \"Allow\",\n      \"Action\": [\n        \"s3:GetBucketLocation\",\n        \"s3:ListBucket\",\n        \"s3:GetObject\",\n        \"s3:PutObject\",\n        \"s3:AbortMultipartUpload\"\n      ],\n      \"Resource\": [\n        \"arn:aws:s3:::<athena-results-bucket>\",\n        \"arn:aws:s3:::<athena-results-bucket>/*\"\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":["All tables in the database ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["amazon_security_lake_glue_db_<region_underscored>"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Select"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Describe"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Query events from the Security Lake tables"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Only to write events:"]}," 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":3,"id":"writing-events-optional","__idx":3},"children":["Writing Events (Optional)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To write events, also attach this policy."]},{"$$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 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 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 a custom source's table, 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 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 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":"Heading","attributes":{"level":2,"id":"aws-credentials-configuration","__idx":4},"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":5},"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":6},"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":7},"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":8},"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":9},"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":10},"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":11},"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":12},"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":13},"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":14},"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":15},"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. Example: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["us-east-1"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Workgroup Name"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["This is the name of the Athena workgroup from the prerequisites. Example: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["primary"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"optional-fields","__idx":16},"children":["Optional fields"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Fill in these fields only if the integration will write events."]},{"$$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":["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":"Writing Events (Optional)","id":"writing-events-optional","depth":3},{"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},{"value":"Optional fields","id":"optional-fields","depth":3}],"frontmatter":{"slug":"guides/provider-configuration/amazonsecuritylake-siem-setup","seo":{"title":"Amazon Security Lake SIEM Provider Configuration Guide"}},"lastModified":"2026-11-13T23:24:33.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/provider-configuration/amazonsecuritylake-siem-setup","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}