Configurar segredos no encaminhamento de eventos

No encaminhamento de eventos, um segredo é um recurso que representa uma credencial de autenticação para outro sistema, permitindo a troca segura de dados. Segredos só podem ser criados nas propriedades de encaminhamento de eventos.

No momento, há três tipos secretos compatíveis:

Este guia fornece uma visão geral de alto nível de como configurar segredos para um encaminhamento de evento (Edge) na interface do usuário da coleta de dados.

Pré-requisitos

Este guia pressupõe que você já esteja familiarizado com o gerenciamento de recursos para tags e encaminhamento de eventos na interface do usuário da coleta de dados, incluindo como criar um elemento de dados e uma regra de encaminhamento de eventos. Consulte o guia sobre gerenciamento de recursos se você precisar de uma introdução.

Você também deve ter uma compreensão funcional do fluxo de publicação para tags e encaminhamento de eventos, incluindo como adicionar recursos a uma biblioteca e instalar uma build em seu site para testes. Consulte a visão geral da publicação para obter mais detalhes.

Criar um segredo

Para criar um segredo, faça logon na interface do usuário da Coleta de dados e abra a propriedade de encaminhamento de eventos em que deseja adicionar o segredo. Em seguida, selecione Segredos no painel de navegação esquerdo, seguido de Criar novo segredo.

A próxima tela permite configurar os detalhes do segredo. Para que um segredo possa ser usado pelo encaminhamento de eventos, ele deve ser atribuído a um ambiente existente. Se você não tiver nenhum ambiente criado para sua propriedade de encaminhamento de evento, consulte o guia em ambientes para obter orientação sobre como configurá-los antes de continuar.

Em Ambiente do Target, use o menu suspenso para selecionar o ambiente ao qual deseja atribuir o segredo. Em Nome secreto, forneça um nome para o segredo no contexto do ambiente. Esse nome deve ser exclusivo em todos os segredos na propriedade de encaminhamento de eventos.

Um segredo só pode ser atribuído a um ambiente por vez, mas você pode atribuir as mesmas credenciais a vários segredos em ambientes diferentes, se desejar. Selecionar Adicionar ambiente para adicionar outra linha à lista.

Para cada ambiente adicionado, você deve fornecer outro nome exclusivo para o segredo associado. Se você esgotar todos os ambientes disponíveis, a variável Adicionar ambiente não estará disponível.

A partir daqui, as etapas para criar o segredo diferem dependendo do tipo de segredo que você está criando. Consulte as subseções abaixo para obter detalhes:

• Token
• HTTP
• OAuth2

Token

Para criar um segredo de token, selecione Token do Tipo lista suspensa. No Token , forneça a cadeia de caracteres de credencial reconhecida pelo sistema ao qual você está autenticando. Selecionar Criar segredo para salvar o segredo.

HTTP

Para criar um segredo HTTP, selecione HTTP simples do Tipo lista suspensa. Nos campos que aparecem abaixo, forneça um nome de usuário e senha para a credencial antes de selecionar Criar segredo para salvar o segredo.

OAuth2

Para criar um segredo OAuth2, selecione OAuth2 do Tipo lista suspensa. Nos campos que aparecem abaixo, forneça seu ID do cliente e Segredo do cliente, bem como seu URL de autorização para sua integração com o OAuth. O URL de autorização na interface do usuário da coleta de dados é uma concatenação entre o host do servidor de autorização e o caminho do token.

Em Opções de Credencial, você pode fornecer outras opções de credencial, como scope e audience na forma de pares de valores-chave. Para adicionar mais pares de valores chave, selecione Adicionar outro.

Por fim, você pode configurar a variável Atualizar Deslocamento para o segredo. Representa o número de segundos antes da expiração do token em que o sistema executará uma atualização automática. O tempo equivalente em horas e minutos é exibido à direita do campo e é atualizado automaticamente à medida que você digita.

Por exemplo, se o deslocamento de atualização estiver definido como o valor padrão de 14400 (quatro horas) e o token de acesso tem um expires_in valor de 86400 (24 horas), o sistema atualizará automaticamente o segredo em 20 horas.

Quando terminar, selecione Criar segredo para salvar o segredo.

Editar um segredo

Depois de criar segredos para uma propriedade, você pode encontrá-los listados na Segredos espaço de trabalho. Para editar os detalhes de um segredo existente, selecione seu nome na lista.

A próxima tela permite alterar o nome e as credenciais do segredo.

Repetir uma troca secreta

Você pode tentar novamente ou atualizar uma troca secreta na tela de edição. Esse processo varia dependendo do tipo de segredo que está sendo editado:

Excluir um segredo

Para excluir um segredo existente no Segredos na área de trabalho, marque a caixa de seleção ao lado do nome antes de selecionar Excluir.

Uso de segredos no encaminhamento de eventos

Para usar um segredo no encaminhamento de eventos, primeiro crie um elemento de dados que faz referência ao próprio segredo. Depois de salvar o elemento de dados, você pode incluí-lo no encaminhamento do evento regras e adicionar essas regras a um biblioteca, que, por sua vez, pode ser implantado em servidores do Adobe como um build.

Ao criar o elemento de dados, selecione o Núcleo e selecione Segredo para o tipo de elemento de dados. O painel direito atualiza e fornece controles suspensos para atribuir até três segredos ao elemento de dados: um para Desenvolvimento, Estágiose Produção respectivamente.

Ao atribuir vários segredos a um único elemento de dados e incluí-lo em uma regra, você pode ter o valor do elemento de dados alterado, dependendo de onde a biblioteca que contém está no fluxo de publicação.

Próximas etapas

Este guia cobriu como gerenciar segredos na interface do usuário da coleta de dados. Para obter informações sobre como interagir com segredos usando a API do Reator, consulte o guia do endpoint de segredos.

Recursos de Business.Adobe.com