Cómo utilizar el tipo de credencial definido por el usuario

Nota: Este artículo se aplica a la integración de acciones de datos de servicios web.

Cuando agrega la integración de acciones de datos de servicios web, puede seleccionar un tipo de credencial: Autenticación básica, definida por el usuario o definida por el usuario (OAuth). Para más información, ver Agregar una integración de acciones de datos y Tipos de credenciales.

Este artículo explica cómo utilizar el tipo de credencial definido por el usuario.

Cuando agregue la integración, configure las credenciales definidas por el usuario.
Agregue nombres de campo para la API que está utilizando y valores para esos nombres de campo.
Utilice los nombres de campo de sus credenciales en las solicitudes de todas las acciones personalizadas que cree.
El siguiente ejemplo es una solicitud de una acción personalizada denominada Obtener clima. cartas credenciales es una palabra clave estática, que puede utilizar con otras macros de Velocity. Clave API es el nombre de campo que agregó a la configuración de credenciales. Para más información, ver Macros de velocidad para acciones de datos.

Aunque la integración redacta los valores de los nombres de campo, los valores reales aparecen en su servicio web. Por ejemplo, si el valor de Clave API es 12345, luego, cuando se ejecuta la acción, la requestUrlTemplate que ve en su servicio web es “https://api.openweathermap.org/data/2.5/weather?q=London&APPID=12345”. Para más información, ver Crea una acción personalizada, Agregar configuración a acciones personalizadas, y Solicitar configuración.
Advertencia: Asegúrese de evitar cualquier uso de variables de entrada o salida dentro de requestTemplate, SuccessTemplate, o requestUrlTemplate. Si no escapa correctamente las variables con caracteres especiales, sus acciones de datos fallarán en la ejecución.
- Usar esc.jsonString para escapar de las cadenas dentro de los cuerpos JSON.
  Para obtener más información, consulte la sección esc.jsonString en Macros de velocidad para acciones de datos.
- Usar esc.url () o urlTool.optionalQueryParam () para escapar correctamente de la ruta o los parámetros de consulta para un requestUrlTemplate o requestTemplate si usa x-www.form-urlencoded valores.
  Para obtener más información, consulte la sección de la biblioteca de escape de cadenas en Macros de velocidad para acciones de datos.
Debido a que el escape es específico del contexto JSON, el siguiente ejemplo no muestra el escape intencionalmente.
```
{
  "requestUrlTemplate": "https://api.openweathermap.org/data/2.5/weather?q=London&APPID=${credentials.API_Key}",
  "requestType": "GET",
  "headers": {},
  "requestTemplate": "${input.rawRequest}"
}
```
Nota: Cuando prueba una acción personalizada, la integración oculta cualquier información de autorización. Para más información, ver Prueba una acción personalizada.

Para obtener más información sobre la integración, consulte Acerca de la integración de acciones de datos de servicios web.