

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á.

# Configurar Salesforce para AppFabric
<a name="salesforce"></a>

Salesforcefabrica software baseado em nuvem projetado para ajudar as empresas a encontrar mais clientes potenciais, fechar mais negócios e impressionar os clientes com um serviço incrível. Salesforce’s O Customer 360 oferece um conjunto completo de produtos, une equipes de vendas, serviços, marketing, comércio e TI com uma visão única e compartilhada das informações do cliente, ajudando as organizações a desenvolver relacionamentos tanto com clientes quanto com funcionários.

Você pode usar AWS AppFabric para receber registros de auditoria e dados do usuárioSalesforce, normalizar os dados no formato Open Cybersecurity Schema Framework (OCSF) e enviar os dados para um bucket do Amazon Simple Storage Service (Amazon S3) ou para um stream do Amazon Data Firehose.

**Topics**
+ [AppFabric suporte para Salesforce](#salesforce-appfabric-support)
+ [Conectando-se AppFabric à sua Salesforce conta](#salesforce-appfabric-connecting)

## AppFabric suporte para Salesforce
<a name="salesforce-appfabric-support"></a>

AppFabric suporta o recebimento de informações do usuário e registros de auditoria doSalesforce.

### Pré-requisitos
<a name="salesforce-prerequisites"></a>

Para usar AppFabric para transferir registros de auditoria Salesforce de destinos compatíveis, você deve atender aos seguintes requisitos:
+ Você deve ter uma [edição Performance, Enterprise ou Unlimited](https://help.salesforce.com/s/articleView?id=sf.overview_edition.htm&type=5) doSalesforce. Entre em contato Salesforce para fazer o upgrade para uma dessas edições.
+ Se você deseja AppFabric transferir arquivos de registro de eventos por hora com um [conjunto completo de eventos de registro de](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_eventlogfile_supportedeventtypes.htm)Salesforce, você deve se inscrever no Event Monitoring como parte do [Shield Features](https://www.salesforce.com/editions-pricing/platform/shield/) ofSalesforce. Caso contrário, AppFabric transferirá eventos limitados (ou seja, login, logout InsecureExternalAssets, uso total da API, violação de CORS e eventos HostnameRedirects ELF) do arquivo de log diário Salesforce’s padrão. Você pode verificar se sua Salesforce conta já está inscrita no Shield Features acessando **Configuração** > **Gerenciador de eventos**. Se você ver 19 ou mais eventos listados, sua conta está inscrita no Monitoramento de Eventos. Se você não tem monitoramento de eventos, pode comprar uma assinatura desse complemento entrando Salesforce em contato com.
+ Você precisa [optar pela geração do Arquivo de Registro de Eventos](https://help.salesforce.com/s/articleView?id=release-notes.rn_security_em_generate_event_log_files.htm&release=244&type=5) nas Salesforce configurações.
+ Você deve usar o Perfil do Administrador do Sistema para criar um OAuth aplicativo e fazer login com as mesmas credenciais do. AppFabric

**nota**  
O uso total da API, o registro de violação do CORS, os redirecionamentos de nome de host, os ativos externos inseguros, os eventos de login e logout estão disponíveis sem custo adicional nas edições suportadas do. Salesforce Entre em contato Salesforce para comprar os demais tipos de eventos. Para obter mais informações sobre os tipos de Salesforce eventos, consulte [Tipos de eventos EventLogFile compatíveis](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_eventlogfile_supportedeventtypes.htm) no Salesforce site.  
AppFabric pode suportar até 100.000 eventos por tipo de evento por instância do arquivo de log (diariamente ou de hora em hora, dependendo da assinatura do complemento Event Monitoring). Um arquivo de log que exceda o limite pode fazer com que todo o arquivo de log seja excluído da ingestão.

### Considerações sobre limites de taxa
<a name="salesforce-rate-limits"></a>

O Salesforce impõe limites de taxa na API do Salesforce. Para obter mais informações sobre os limites de taxa da Salesforce API, consulte [Limites e alocações de solicitações de API](https://developer.salesforce.com/docs/atlas.en-us.salesforce_app_limits_cheatsheet.meta/salesforce_app_limits_cheatsheet/salesforce_app_limits_platform_api.htm) no Salesforce site. Se a combinação de seus aplicativos de Salesforce API existentes AppFabric e seus aplicativos de API excederem Salesforce’s os limites, os registros de auditoria que aparecem AppFabric podem ser adiados.

### Considerações sobre o atraso de dados
<a name="salesforce-data-delay"></a>

Você pode ver um atraso de até 6 horas no arquivo de registro diário ou até 29 horas de atraso no arquivo de log de hora em hora para que um evento de auditoria seja entregue ao seu destino. Isso se deve ao atraso nos eventos de auditoria disponibilizados pelo aplicativo, bem como às precauções tomadas para reduzir a perda de dados. No entanto, isso pode ser personalizado ao nível da conta. Para obter ajuda, entre em contato com [Suporte](https://aws.amazon.com/contact-us/).

## Conectando-se AppFabric à sua Salesforce conta
<a name="salesforce-appfabric-connecting"></a>

Depois de criar seu pacote de aplicativos dentro do AppFabric serviço, você deve autorizar AppFabric com. Salesforce Para encontrar as informações necessárias para autorizar Salesforce AppFabric, use as etapas a seguir.

### Crie um OAuth aplicativo
<a name="salesforce-create-oauth"></a>

AppFabric se integra com o Salesforce uso OAuth. Para criar um OAuth aplicativo emSalesforce, use as seguintes etapas:

1. [Faça login na sua Salesforce conta.](https://login.salesforce.com)

1. Acesse a **página de configuração** conforme descrito na [Salesforcedocumentação](https://help.salesforce.com/s/articleView?id=sf.basics_nav_setup.htm&type=5).

1. Pesquise **o App Manager** na busca rápida.

1. Escolha **Novo aplicativo conectado**.

1. Insira as informações necessárias nos campos do formulário.

1. Escolha **Ativar OAuth configurações**.

1. Certifique-se de **desativar** as seguintes opções:
   + Exigir chave de prova para extensão de troca de código (PKCE) para fluxos de autorização compatíveis
   + Exigir segredo para o fluxo do servidor Web
   + Exigir segredo para Refresh Token Flow
   + Ativar a rotação do token de atualização

1. Insira uma URL com o seguinte formato na caixa de texto **URL de retorno** de chamada e escolha **Salvar** alterações.

   ```
   https://{{<region>}}.console.aws.amazon.com/appfabric/oauth2
   ```

   Nesse URL, {{<region>}} está o código Região da AWS no qual você configurou seu pacote de AppFabric aplicativos. Por exemplo, o código para a região Leste dos EUA (Norte da Virgínia) é `us-east-1`. Para essa região, o URL de redirecionamento é `https://{{us-east-1}}.console.aws.amazon.com/appfabric/oauth2`.

1. Preencha os escopos conforme necessário (descrito na [Escopos necessários](#salesforce-required-scopes) seção a seguir). Todos os outros campos podem ser deixados com seus valores padrão.

1. Escolha **Salvar**.

1. Conclua as etapas a seguir para verificar a política de token de atualização para o novo OAuth aplicativo:

   1. Na **página Configuração**, insira **Aplicativos conectados** na caixa de texto Busca rápida e escolha **Gerenciar aplicativos conectados**.

   1. Escolha **Editar** ao lado do aplicativo recém-criado.

   1. Certifique-se de que o **token de atualização seja válido até que a opção revogada** seja selecionada.

   1. Salve as alterações.

1. Conclua as etapas a seguir para verificar se os registros de auditoria estão sendo gerados:

   1. Na **página Configuração**, insira **Arquivo de registro de eventos** na caixa de texto Busca rápida e escolha **Navegador de arquivos de registro de eventos**.

   1. Confirme se os registros de eventos estão listados no **Navegador de arquivos de registro de eventos**.

1. Navegue até o aplicativo criado e escolha **Exibir** no menu suspenso.

1. Escolha **Gerenciar detalhes do consumidor**.

   Você será redirecionado para uma nova guia na qual precisará verificar sua identidade. Nessa guia, anote os valores da **Chave do Consumidor** e do **Segredo do Consumidor**. Você precisará deles mais tarde para fazer login.

### Escopos necessários
<a name="salesforce-required-scopes"></a>

Você deve adicionar os seguintes escopos ao seu Salesforce OAuth aplicativo:
+ Gerencie os dados do usuário via APIs (`API`).
+ Execute a solicitação a qualquer momento (`refresh_token`e`offline_access`).

### Autorizações do aplicativo
<a name="salesforce-app-authorizations"></a>

#### ID de locatário
<a name="salesforce-tenant-id"></a>

AppFabric solicitará seu ID de inquilino. O ID do inquilino em AppFabric é o subdomínio do seu Salesforce **Meu** domínio. Você pode encontrar seu **subdomínio Meu** domínio na barra de endereço do seu navegador entre `https://` e. `.my.salesforce.com`

Para encontrar seu Salesforce **Meu domínio**, use as instruções a seguir na tela Salesforce inicial.

1. Acesse a **página de configuração** conforme descrito na [Salesforcedocumentação](https://help.salesforce.com/s/articleView?id=sf.basics_nav_setup.htm&type=5).

1. Pesquise **Configurações da empresa** na busca rápida e escolha **Meu domínio** nos resultados.

#### Nome do locatário
<a name="salesforce-tenant-name"></a>

Insira um nome que identifique essa Salesforce organização exclusiva. AppFabric usa o nome do inquilino para rotular as autorizações do aplicativo e todas as ingestões criadas a partir da autorização do aplicativo.

#### ID de cliente
<a name="salesforce-client-id"></a>

AppFabric solicitará um ID de cliente. Para encontrar sua ID de cliente no Salesforce, siga as etapas abaixo:

1. Navegue até a página **de configuração**.

1. Escolha **Configuração** e, em seguida, selecione **Gerenciador de aplicativos**.

1. Escolha o aplicativo criado e escolha **Exibir** no menu suspenso.

1. Escolha **Gerenciar detalhes do consumidor**. Você será redirecionado para uma nova guia.

1. Verifique sua identidade e, em seguida, procure o valor da **Chave do Consumidor**.

1. Insira a **Chave do Consumidor** no campo ID do cliente em AppFabric.

#### Segredo do cliente
<a name="salesforce-client-secret"></a>

AppFabric solicitará o segredo do seu cliente. O **segredo do cliente** AppFabric é o **segredo do consumidor** emSalesforce. Para descobrir seu segredoSalesforce, use as seguintes etapas:

1. Navegue até a página **de configuração**.

1. Escolha **Configuração** e, em seguida, selecione **Gerenciador de aplicativos**.

1. Escolha o aplicativo criado e escolha **Exibir** no menu suspenso.

1. Escolha **Gerenciar detalhes do consumidor**. Você será redirecionado para uma nova guia.

1. Verifique sua identidade e, em seguida, procure o valor do **Segredo do Consumidor**.

1. Insira o **Segredo do Consumidor** no campo segredo do cliente em AppFabric.

#### Aprovar autorização
<a name="salesforce-approve-authorization"></a>

 Depois de criar a autorização do aplicativo em AppFabric, você receberá uma janela pop-up Salesforce para aprovar a autorização. Na página de aprovação, certifique-se de usar a função de administrador do Salesforce sistema ou um Salesforce usuário que tenha permissões de usuário para visualizar arquivos de registro de eventos e API habilitadas para API ao autorizar. Escolha **Permitir** para aprovar a AppFabric autorização.