As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Adicionando uma fonte personalizada no Security Lake
Depois de criar a função do IAM para invocar o AWS Glue rastreador, siga estas etapas para adicionar uma fonte personalizada no Security Lake.
------
#### [ Console ]
1. Abra o console do Security Lake em [https://console.aws.amazon.com/securitylake/](https://console.aws.amazon.com/securitylake/).
1. Usando o Região da AWS seletor no canto superior direito da página, selecione a região em que você deseja criar a fonte personalizada.
1. Escolha **Fontes personalizadas** no painel de navegação e **Criar fonte personalizada**.
1. Na seção **Detalhes da fonte personalizada**, insira um nome globalmente exclusivo para sua fonte personalizada. Em seguida, selecione uma classe de evento do OCSF que descreva o tipo de dados que a fonte personalizada enviará para o Security Lake.
1. Para **Conta da AWS com permissão para gravar dados**, insira o **ID da Conta da AWS ** e o **ID externo** da fonte personalizada que gravará logs e eventos no data lake.
1. Para o **Acesso ao serviço**, crie e use um novo perfil de serviço ou use um perfil de serviço existente que dê permissão ao Security Lake para invocar o AWS Glue.
1. Escolha **Criar**.
------
#### [ API ]
Para adicionar uma fonte personalizada programaticamente, use a [CreateCustomLogSource](https://docs.aws.amazon.com/security-lake/latest/APIReference/API_CreateCustomLogSource.html)operação da API Security Lake. Use a operação no Região da AWS local em que você deseja criar a fonte personalizada. Se você estiver usando o AWS Command Line Interface (AWS CLI), execute o [create-custom-log-source](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/securitylake/create-custom-log-source.html)comando.
Em sua solicitação, use os parâmetros compatíveis para especificar as configurações da fonte personalizada:
+ `sourceName`— Especifique um nome para a fonte. O nome deve ser um valor regionalmente exclusivo.
+ `eventClasses`— Especifique uma ou mais classes de eventos OCSF para descrever o tipo de dados que a fonte enviará ao Security Lake. Para obter uma lista das classes de eventos do OCSF suportadas como fonte no Security Lake, consulte [Open Cybersecurity Schema Framework](https://schema.ocsf.io/classes?extensions) (OCSF).
+ `sourceVersion`— Opcionalmente, especifique um valor para limitar a coleta de registros a uma versão específica dos dados de origem personalizados.
+ `crawlerConfiguration`— Especifique o Amazon Resource Name (ARN) da função do IAM que você criou para invocar o rastreador. AWS Glue Para ver as etapas detalhadas para criar uma função do IAM, consulte [Pré-requisitos para adicionar](https://docs.aws.amazon.com//security-lake/latest/userguide/custom-sources.html#iam-roles-glue-crawler) uma fonte personalizada
+ `providerIdentity`— especifique a AWS identidade e a ID externa que a fonte usará para gravar registros e eventos no data lake.
O exemplo a seguir adiciona uma fonte personalizada como fonte de registro na conta do provedor de registros designado nas regiões designadas. Este exemplo está formatado para Linux, macOS ou Unix e usa o caractere de continuação de linha “barra invertida (\$1)” para melhorar a legibilidade.
```
$ aws securitylake create-custom-log-source \
--source-name EXAMPLE_CUSTOM_SOURCE \
--event-classes '["DNS_ACTIVITY", "NETWORK_ACTIVITY"]' \
--configuration crawlerConfiguration={"roleArn=arn:aws:iam::XXX:role/service-role/RoleName"},providerIdentity={"externalId=ExternalId,principal=principal"} \
--region=[“ap-southeast-2”]
```
------
## Mantendo os dados de origem personalizados atualizados no AWS Glue
Depois de adicionar uma fonte personalizada no Security Lake, o Security Lake cria um AWS Glue rastreador. O crawler se conecta à sua fonte personalizada, determina as estruturas de dados e preenche o Catálogo de dados do AWS Glue com tabelas.
Recomendamos executar manualmente o crawler para manter seu esquema de fonte personalizado atualizado e manter a funcionalidade de consulta no Athena e em outros serviços de consulta. Especificamente, você deve executar o crawler se alguma das seguintes alterações ocorrer em seu conjunto de dados de entrada de uma fonte personalizada:
+ O conjunto de dados tem uma ou mais novas colunas de nível superior.
+ O conjunto de dados tem um ou mais campos novos em uma coluna com um tipo de dados `struct`.
*Para obter instruções sobre como executar um rastreador, consulte Como [programar um AWS Glue rastreador](https://docs.aws.amazon.com/glue/latest/dg/schedule-crawler.html) no Guia do desenvolvedor.AWS Glue *
O Security Lake não pode excluir nem atualizar os crawlers existentes na sua conta. Se você excluir uma fonte personalizada, recomendamos excluir o crawler associado se você planeja criar uma fonte personalizada com o mesmo nome no futuro.
## Classes de eventos do OCSF suportadas
As classes de eventos do Open Cybersecurity Schema Framework (OCSF) descrevem o tipo de dados que a fonte personalizada enviará ao Security Lake. A lista de classes de eventos suportadas é:
```
public enum OcsfEventClass {
ACCOUNT_CHANGE,
API_ACTIVITY,
APPLICATION_LIFECYCLE,
AUTHENTICATION,
AUTHORIZE_SESSION,
COMPLIANCE_FINDING,
DATASTORE_ACTIVITY,
DEVICE_CONFIG_STATE,
DEVICE_CONFIG_STATE_CHANGE,
DEVICE_INVENTORY_INFO,
DHCP_ACTIVITY,
DNS_ACTIVITY,
DETECTION_FINDING,
EMAIL_ACTIVITY,
EMAIL_FILE_ACTIVITY,
EMAIL_URL_ACTIVITY,
ENTITY_MANAGEMENT,
FILE_HOSTING_ACTIVITY,
FILE_SYSTEM_ACTIVITY,
FTP_ACTIVITY,
GROUP_MANAGEMENT,
HTTP_ACTIVITY,
INCIDENT_FINDING,
KERNEL_ACTIVITY,
KERNEL_EXTENSION,
MEMORY_ACTIVITY,
MODULE_ACTIVITY,
NETWORK_ACTIVITY,
NETWORK_FILE_ACTIVITY,
NTP_ACTIVITY,
PATCH_STATE,
PROCESS_ACTIVITY,
RDP_ACTIVITY,
REGISTRY_KEY_ACTIVITY,
REGISTRY_VALUE_ACTIVITY,
SCHEDULED_JOB_ACTIVITY,
SCAN_ACTIVITY,
SECURITY_FINDING,
SMB_ACTIVITY,
SSH_ACTIVITY,
USER_ACCESS,
USER_INVENTORY,
VULNERABILITY_FINDING,
WEB_RESOURCE_ACCESS_ACTIVITY,
WEB_RESOURCES_ACTIVITY,
WINDOWS_RESOURCE_ACTIVITY,
// 1.3 OCSF event classes
ADMIN_GROUP_QUERY,
DATA_SECURITY_FINDING,
EVENT_LOG_ACTIVITY,
FILE_QUERY,
FILE_REMEDIATION_ACTIVITY,
FOLDER_QUERY,
JOB_QUERY,
KERNEL_OBJECT_QUERY,
MODULE_QUERY,
NETWORK_CONNECTION_QUERY,
NETWORK_REMEDIATION_ACTIVITY,
NETWORKS_QUERY,
PERIPHERAL_DEVICE_QUERY,
PROCESS_QUERY,
PROCESS_REMEDIATION_ACTIVITY,
REMEDIATION_ACTIVITY,
SERVICE_QUERY,
SOFTWARE_INVENTORY_INFO,
TUNNEL_ACTIVITY,
USER_QUERY,
USER_SESSION_QUERY,
// 1.3 OCSF event classes (Win extension)
PREFETCH_QUERY,
REGISTRY_KEY_QUERY,
REGISTRY_VALUE_QUERY,
WINDOWS_SERVICE_ACTIVITY
}
```