Configurar secretos en el reenvío de eventos
En el reenvío de eventos, un secreto es un recurso que representa una credencial de autenticación para otro sistema, lo que permite el intercambio seguro de datos. Los secretos solo se pueden crear dentro de las propiedades del reenvío de eventos.
Actualmente se admiten los siguientes tipos de secretos:
Esta guía proporciona información general de alto nivel sobre cómo configurar secretos para una propiedad de reenvío de eventos (Edge) en la interfaz de usuario de Experience Platform o de recopilación de datos.
Requisitos previos
En esta guía se da por hecho que ya está familiarizado con la administración de recursos para etiquetas y reenvío de eventos en la interfaz de usuario, incluido cómo crear un elemento de datos y una regla de reenvío de eventos. Consulte la guía sobre administración de recursos si necesita una introducción.
También debe tener una comprensión práctica del flujo de publicación para etiquetas y reenvío de eventos, incluido cómo añadir recursos a una biblioteca e instalar una compilación en el sitio web para probarlos. Consulte información general de publicación para obtener más detalles.
Crear un secreto create
Para crear un secreto, seleccione Event Forwarding en el panel de navegación izquierdo y, a continuación, abra la propiedad de reenvío de eventos en la que desee agregar el secreto. A continuación, seleccione Secrets en el panel de navegación izquierdo, seguido de Create New Secret.
La siguiente pantalla le permite configurar los detalles del secreto. Para que el reenvío de eventos pueda utilizar un secreto, este debe asignarse a un entorno existente. Si no ha creado ningún entorno para su propiedad de reenvío de eventos, consulte la guía de entornos para obtener instrucciones sobre cómo configurarlos antes de continuar.
En Target Environment, utilice el menú desplegable para seleccionar el entorno al que desea asignar el secreto. En Secret Name, proporcione un nombre para el secreto en el contexto del entorno. Este nombre debe ser único en todos los secretos de la propiedad de reenvío de eventos.
Un secreto solo se puede asignar a un entorno a la vez, pero puede asignar las mismas credenciales a varios secretos en entornos diferentes si lo desea. Seleccione Add Environment para agregar otra fila a la lista.
Para cada entorno que agregue, debe proporcionar otro nombre único para el secreto asociado. Si se agotan todos los entornos disponibles, el botón Add Environment no estará disponible.
A partir de aquí, los pasos para crear el secreto difieren según el tipo de secreto que esté creando. Consulte las subsecciones siguientes para obtener más información:
Token token
Para crear un secreto de token, seleccione Token de la lista desplegable Type. En el campo Token que aparece, proporcione la cadena de credencial reconocida por el sistema en el que se está autenticando. Seleccione Create Secret para guardar el secreto.
HTTP http
Para crear un secreto HTTP, seleccione Simple HTTP de la lista desplegable Type. En los campos que aparecen a continuación, proporcione un nombre de usuario y una contraseña para la credencial antes de seleccionar Create Secret para guardar el secreto.
OAuth 2 oauth2
Para crear un secreto de OAuth 2, seleccione OAuth 2 de la lista desplegable Type. En los campos que aparecen a continuación, proporcione sus Client ID y Client Secret, así como su Token URL para la integración de OAuth. El campo Token URL de la interfaz de usuario es una concatenación entre el host del servidor de autorización y la ruta del token.
En Credential Options, puede proporcionar otras opciones de credenciales como scope y audience en forma de pares clave-valor. Para agregar más pares clave-valor, seleccione Add another.
Finalmente, puede configurar el valor Refresh Offset del secreto. Representa el número de segundos antes de la caducidad del token que el sistema realizará una actualización automática. El tiempo equivalente en horas y minutos se muestra a la derecha del campo y se actualiza automáticamente a medida que escribe.
Por ejemplo, si el desplazamiento de actualización está establecido en el valor predeterminado de 14400 (cuatro horas) y el token de acceso tiene un valor de expires_in de 86400 (24 horas), el sistema actualizará automáticamente el secreto en 20 horas.
28800 (ocho horas) y el token de acceso tiene un expires_in de 36000 (diez horas), el intercambio fallaría debido a que la diferencia resultante es de menos de cuatro horas.Cuando termine, seleccione Create Secret para guardar el secreto.
OAuth 2 JWT oauth2jwt
Para crear un secreto JWT de OAuth 2, seleccione OAuth 2 JWT de la lista desplegable Type.
En los campos que aparecen a continuación, proporcione los campos Issuer, Subject, Audience, Custom Claims, TTL y, a continuación, seleccione Algorithm de la lista desplegable. A continuación, ingrese Private Key Id, así como Token URL para la integración con OAuth. El campo Token URL no es un campo obligatorio. Si se proporciona un valor, el JWT se intercambia con un token de acceso. El secreto se actualizará según el atributo expires_in de la respuesta y el valor Refresh Offset. Si no se proporciona un valor, el secreto insertado en el perímetro es el JWT. El JWT se actualizará según los valores TTL y Refresh Offset.
En Credential Options, puede proporcionar otras opciones de credenciales como jwt_param en forma de pares clave-valor. Para agregar más pares clave-valor, seleccione Add another.
Finalmente, puede configurar el valor Refresh Offset del secreto. Representa el número de segundos antes de la caducidad del token que el sistema realizará una actualización automática. El tiempo equivalente en horas y minutos se muestra a la derecha del campo y se actualiza automáticamente a medida que escribe.
Por ejemplo, si el desplazamiento de actualización está establecido en el valor predeterminado de 1800 (30 minutos) y el token de acceso tiene un valor de expires_in de 3600 (una hora), el sistema actualizará automáticamente el secreto en una hora.
1800 (30 minutos) y el token de acceso tiene un expires_in de 2700 (45 minutos), el intercambio fallaría debido a que la diferencia resultante es inferior a 30 minutos.Cuando termine, seleccione Create Secret para guardar el secreto.
Google OAuth 2 google-oauth2
Para crear un secreto de Google OAuth 2, seleccione Google OAuth 2 en la lista desplegable Type. En Scopes, seleccione las API de Google a las que desee conceder acceso con este secreto. Actualmente se admiten los siguientes productos:
Cuando termine, seleccione Create Secret.
Aparece una ventana emergente que le informa de que el secreto debe autorizarse manualmente a través de Google. Seleccione Create & Authorize para continuar.
Aparece un cuadro de diálogo que le permite introducir las credenciales de su cuenta de Google. Siga las indicaciones para conceder acceso de reenvío de eventos a los datos en el ámbito seleccionado. Una vez completado el proceso de autorización, se crea el secreto.
LinkedIn OAuth 2 linkedin-oauth2
Para crear un secreto de OAuth 2 de LinkedIn, seleccione LinkedIn OAuth 2 en la lista desplegable Type. A continuación, seleccione Create Secret.
Aparece una ventana emergente que le informa de que el secreto debe autorizarse manualmente a través de LinkedIn. Seleccione Create & Authorize secret with LinkedIn para continuar.
Aparecerá un cuadro de diálogo pidiéndole que escriba sus credenciales de LinkedIn. Siga las indicaciones para conceder acceso al reenvío de eventos a sus datos.
Una vez completado el proceso de autorización, volverá a la ficha Secrets, donde podrá ver el secreto recién creado. Aquí puede ver el estado del secreto y la fecha de caducidad.
Volver a autorizar un secreto LinkedIn OAuth 2
IMPORTANTE
Debe volver a autorizar con sus credenciales de LinkedIn cada 365 días. Si no vuelve a autorizar a su debido tiempo, el secreto no se actualizará y las LinkedIn solicitudes de conversión fallarán.
Tres meses antes del secreto que requiere reautorización, una ventana emergente comenzará a mostrarse cuando navegue por cualquier página de la propiedad. Seleccione Click here to go to your secrets.
Se le redirigirá a la ficha Secrets. Los secretos enumerados en esta página se filtran para mostrar solo los secretos que deben volver a autorizarse. Seleccione Auth Needed para el secreto que necesita volver a autorizar.
Aparecerá un cuadro de diálogo que le pedirá que escriba sus credenciales de LinkedIn. Siga las indicaciones para volver a autorizar su secreto.
Amazon OAuth 2 amazon-oauth2
Para crear un secreto de OAuth 2 de Amazon, seleccione Amazon OAuth 2 en la lista desplegable Type. A continuación, seleccione Create Secret.
Aparece una ventana emergente que le informa de que el secreto debe autorizarse manualmente a través de Amazon. Seleccione Create & Authorize secret with Amazon para continuar.
Aparecerá un cuadro de diálogo pidiéndole que escriba sus credenciales de Amazon. Siga las indicaciones para conceder acceso al reenvío de eventos a sus datos.
Una vez completado el proceso de autorización, volverá a la ficha Secrets, donde podrá ver el secreto recién creado. Aquí puede ver el estado del secreto y la fecha de caducidad.
Editar un secreto
Después de crear secretos para una propiedad, puede encontrarlos en el área de trabajo Secrets. Para editar los detalles de un secreto existente, seleccione su nombre en la lista.
La siguiente pantalla le permite cambiar el nombre y las credenciales del secreto.
Reintentar un intercambio secreto
Puede volver a intentar o actualizar un intercambio secreto desde la pantalla de edición. Este proceso varía según el tipo de secreto que se esté editando:
Eliminar un secreto
Para eliminar un secreto existente en el área de trabajo Secrets, active la casilla de verificación situada junto a su nombre antes de seleccionar Delete.
Uso de secretos en el reenvío de eventos
Para utilizar un secreto en el reenvío de eventos, primero debe crear un elemento de datos que haga referencia al secreto en sí. Después de guardar el elemento de datos, puede incluirlo en las reglas del reenvío de eventos y agregar esas reglas a una biblioteca, que a su vez se puede implementar en los servidores de Adobe como una compilación.
Al crear el elemento de datos, seleccione la extensión Core y luego seleccione Secret para el tipo de elemento de datos. El panel derecho actualiza y proporciona controles desplegables para asignar hasta tres secretos al elemento de datos: uno para Development, Staging y Production, respectivamente.
Al asignar varios secretos a un único elemento de datos e incluirlo en una regla, puede hacer que el valor del elemento de datos cambie según la ubicación de la biblioteca contenedora en el flujo de publicación.
Próximos pasos
En esta guía se explica cómo administrar secretos en la interfaz de usuario. Para obtener información sobre cómo interactuar con secretos mediante la API de Reactor, consulte la guía de extremo de secretos.