Política de FlowCallout

Estás viendo la documentación de Apigee Edge.
Ve a la Documentación de Apigee X.
información

Usa la política de FlowCallout para llamar a un flujo compartido desde un proxy de API o algún otro flujo compartido.

En un flujo compartido, creas una secuencia de pasos que puedes volver a usar en el tiempo de ejecución desde varios lugares. Estos pasos se implementan como políticas, como en un proxy de API. La política Flow conformidad te permite invocar el flujo compartido desde proxies de API y otros flujos compartidos. Funciona como una llamada a función en un lenguaje de programación tradicional.

  • Por ejemplo, imagina que compilaste un flujo compartido con funciones de seguridad, Verificación de clave de API, validación de token de OAuth y protección de expresiones regulares. Este flujo compartido representa tu convención para verificar las solicitudes entrantes. Con las políticas Flow mejorado, puedes invocar ese flujo compartido desde varios proxies de API.
  • Puedes llamar a un flujo compartido desde otro mediante la implementación de una política de FlowCallout desde un flujo compartido.

Ejemplos

Verifica la clave de API en el flujo compartido

En este ejemplo, se usa un flujo compartido para realizar tareas comunes relacionadas con la seguridad. Aquí, el flujo compartido valida una clave de API. Los proxies de API y otros flujos compartidos política para realizar llamadas a este flujo compartido.

La siguiente definición de flujo compartido incluye una política de Verify-API-Key que se ejecuta cuando se llama al flujo compartido desde una política de FlowCallout en un proxy de API.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<SharedFlow name="default">
    <Step>
        <Name>Verify-API-Key</Name>
    </Step>
</SharedFlow>

La política VerifyAPIKey dentro del flujo compartido anterior recupera el valor de clave y lo verifica.

<VerifyAPIKey async="false" continueOnError="false" enabled="true" name="Verify-API-Key">
    <DisplayName>Verify API Key</DisplayName>
    <APIKey ref="request.queryparam.apikey"/>
</VerifyAPIKey>

La siguiente política Flow mejorado, que se usa en un proxy de API, llama al flujo compartido anterior para que verificar la clave de API. El paquete de flujo compartido verify-apikey-shared (no se muestra aquí) configura el flujo compartido de la misma forma en que un paquete de APIProxy configura un proxy.

<FlowCallout async="false" continueOnError="false" enabled="true" name="Auth-Flow-Callout">
    <DisplayName>Auth Flow Callout</DisplayName>
    <SharedFlowBundle>verify-apikey-shared</SharedFlowBundle>
</FlowCallout>

Cómo pasar parámetros a un flujo compartido

En este ejemplo, se ilustra cómo pasar parámetros de una política FlowTexto a una flujo compartido. En este caso, una política Flow mejorado llama a un flujo compartido diseñado para realizar acciones las funciones de manejo de cadenas. El flujo compartido incluye JavaScript que concatena su entrada, escribe su entrada en minúsculas o ambas. La política Flow mejorado define los parámetros que especifican la entrada de cadena, la salida y qué hacer con la entrada.

  1. La política Flow conformidad String-Handler llama al flujo compartido, parámetros que especifican la variable para almacenar la salida del flujo compartido, operación y qué entrada usar (aquí, un literal de cadena, pero también podría ser de flujo). Los elementos Parameter especifican los nombres y valores de las variables para crear un entorno de ejecución. El flujo compartido puede recuperar estas variables para usarlas en su propio código.

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <FlowCallout async="false" continueOnError="false" enabled="true" name="String-Handler">
      <DisplayName>String Handler</DisplayName>
      <Parameters>
        <Parameter name="input">Gladys Kravitz</Parameter>
        <Parameter name="operations">concatenate tolowercase</Parameter>
        <Parameter name="outputVariable">string.handler.output</Parameter>
      </Parameters>
      <SharedFlowBundle>StringHandler</SharedFlowBundle>
    </FlowCallout>
    
  2. El siguiente flujo compartido default incluye una política de JavaScript SharedStringFunctions que se ejecuta cuando se llama al flujo compartido desde una política de FlowCallout.

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <SharedFlow name="default">
      <Step>
        <Name>SharedStringFunctions</Name>
      </Step>
    </SharedFlow>
  3. En el flujo compartido, la siguiente política de JavaScript SharedStringFunctions especifica el archivo de JavaScript SharedStringFunctions.js con el código que se ejecutará.

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <Javascript async="false" continueOnError="false" enabled="true" timeLimit="200" name="SharedStringFunctions">
      <DisplayName>SharedStringFunctions</DisplayName> <Properties/>
      <ResourceURL>jsc://SharedStringFunctions.js</ResourceURL>
    </Javascript>
  4. El siguiente JavaScript, SharedStringFunctions.js, se ejecuta desde el Política de JavaScript de SharedStringFunctions. Esta secuencia de comandos recupera valores de Variables creadas a partir de los elementos Parameter de la política Flow conformidad.

    // Input value from the calling API proxy.
    var handledString = context.getVariable("input");
    // Variable to use for output from this script.
    var outputVariable = context.getVariable("outputVariable");
    // A space-separated list of things to do to the input string.
    // Convert to lower case to handle unintentional capitals in configuration.
    var operation = context.getVariable("operations").toLowerCase();
    
    // If "lowercase" was given as an operation, convert the input to lowercase.
    if (operation.includes("tolowercase")) {
        handledString = handledString.toLowerCase();
    }
    
    // If "concatenate" was given as an operation, concatenate the input.
    if (operation.includes("concatenate")) {
        handledString = handledString.replace(/\s+/g, '');
    }
    // Assign the resulting string to the output variable specified by
    // the calling API proxy.
    context.setVariable(outputVariable, handledString);
  5. La ejecución fluye de la política de JavaScript al flujo compartido y, luego, a la política de FlowCallout en el proxy de API de origen.

Referencia del elemento

A continuación, se describen los elementos y los atributos que puedes configurar en esta política:

<FlowCallout async="false" continueOnError="false" enabled="true" name="Flow-Callout-1">
    <DisplayName>Custom label used in UI</DisplayName>
    <SharedFlowBundle>thereferencedsharedflowbundle</SharedFlowBundle>
</FlowCallout>

Atributos <FlowCallout>

<FlowCallout async="false" continueOnError="false" enabled="true" name="Flow-Callout-1">

En la siguiente tabla, se describen los atributos que son comunes a todos los elementos principales de las políticas:

Atributo Descripción Predeterminado Presencia
name

El nombre interno de la política. El valor del atributo name puede contener letras, números, espacios, guiones, guiones bajos y puntos. Este valor no puede superar los 255 caracteres.

De forma opcional, usa el elemento <DisplayName> para etiquetar la política en el editor de proxy de la IU de administración con un nombre de lenguaje natural diferente.

N/A Obligatorio
continueOnError

Configúralo como false para mostrar un error cuando una política falla. Este es el comportamiento previsto para la mayoría de las políticas.

Configúralo como true para continuar con la ejecución del flujo incluso después de que una política falle.

falso Opcional
enabled

Configúralo como true para aplicar la política.

Configúralo como false para desactivar la política. La política no se aplicará incluso si permanece adjunta a un flujo.

true Opcional
async

Este atributo dejó de estar disponible.

falso Obsoleta

Elemento <DisplayName>

Se usan además del atributo name para etiquetar la política en el editor de proxy de la IU de administración con un nombre de lenguaje natural diferente.

<DisplayName>Policy Display Name</DisplayName>
Predeterminada

N/A

Si omites este elemento, se usa el valor del atributo name de la política.

Presencia Opcional
Tipo String

Elemento <SharedFlowBundle>

Especifica el nombre del flujo compartido que se va a llamar. El valor de este elemento debe ser el mismo que el de del atributo de nombre del elemento SharedFlowBundle de destino.

<SharedFlowBundle/>

En el ejemplo más simple, se asigna el nombre del flujo compartido al que se llama como un valor para esta . Es decir, el valor de este elemento debe ser el mismo que el name del flujo compartido. valor del atributo.

<SharedFlowBundle>Shared-Flow-Name</SharedFlowBundle>
 
Predeterminada N/A
Presencia

Obligatorio

Tipo N/A

Atributos

Ninguno

Elemento <Parameter>

Especifica un parámetro y un valor (o una fuente de valor) para pasar como una variable al flujo compartido que llama esta política.

Cuando usas un parámetro, puedes especificar un valor (o una variable que contenga un valor) que se debe pasar al flujo compartido al que llama la política. Esto es conceptualmente similar a especificar un parámetro en una llamada a función. Al igual que ocurre con un parámetro de función, varían según el contexto de la llamada de flujo compartido.

Los parámetros de FlowCallout son visibles solo durante la ejecución del flujo compartido.

Sintaxis

Puedes usar este elemento con cualquiera de las siguientes formas de sintaxis. Ten en cuenta que, cuando usas un valor literal, el formato del valor que especifiques dependerá del código que lo consume.

<!- A literal value in an attribute. --/>
<Parameter name="parameter-name" value='parameter-value' />
<!- A reference to a variable in an attribute. --/>
<Parameter name="parameter-name" ref='source-variable-name' />
<!- A literal value in the element content. --/>
<Parameter name="parameter-name">parameter-value</Parameter>
<!- An reference to an attribute in the element content. --/>
<Parameter name="parameter-name">{source-variable-name}</Parameter>

Ejemplo

Esta política FlowTexto de String-Handler pasa parámetros que especifican dónde para almacenar la salida del flujo compartido y qué entrada usar. Los elementos Parameter especificar los nombres y valores de las variables para crear un entorno de ejecución. El flujo compartido puede recuperar estas variables para usarlas en su propio código.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<FlowCallout async="false" continueOnError="false" enabled="true" name="String-Handler">
  <DisplayName>String Handler</DisplayName>
  <Parameters>
    <Parameter name="input">Gladys Kravitz</Parameter>
    <Parameter name="outputVariable">string.handler.output</Parameter>
  </Parameters>
  <SharedFlowBundle>StringHandler</SharedFlowBundle>
</FlowCallout>
Predeterminada N/A
Presencia

Obligatorio

Tipo N/A

Atributos

Atributo Descripción Predeterminado Presencia Tipo
name El nombre de la variable de entorno de ejecución que se debe crear con este parámetro. Ninguno Obligatorio String
ref

La variable contiene el valor que se usará en el entorno de ejecución. Omite este atributo si especificas un valor literal que usarás.

Ninguno Opcional. String
valor El valor que se usará en la variable de entorno de ejecución creada con este parámetro. Omite este atributo si especificas el nombre de una variable que debe ser la fuente del valor. Ninguno Opcional. String

Elemento <Parameters>

Especifica el conjunto de elementos &lt;Parameter&gt; para pasar como variables al flujo compartido que llama este .

Sintaxis

<Parameters>
  <Parameter name="parameter-name" value='parameter-value' />
</Parameters>
Predeterminada N/A
Presencia

Opcional.

Tipo N/A

Atributos

Ninguno

Esquemas

Variables de flujo

Las variables de flujo habilitan el comportamiento dinámico de políticas y flujos en el entorno de ejecución, basado en HTTP encabezados, contenido de mensajes o contexto de flujo. Para obtener más información sobre las variables de flujo, consulta Referencia de variables.

Variable Descripción

apigee.edge.sharedflow.name

Alcance: Durante la ejecución del flujo compartido
Tipo: String
Permiso: Lectura

Valor del atributo de nombre del flujo compartido.

apigee.edge.flowhook.name

Alcance: Durante la ejecución del flujo compartido adjunto el hook de flujo.
Tipo: String
Permiso: Lectura

El nombre del hook de flujo.

Referencia de errores

En esta sección, se describen los códigos y mensajes de error que se muestran, así como las variables de fallas que establece Edge cuando esta política activa un error. Esta información es importante para saber si estás desarrollando reglas de fallas con el propósito de manejar fallas. Para obtener más información, consulta Lo que necesitas saber sobre errores de políticas y Controla fallas.

Errores de entorno de ejecución

Estos errores pueden producirse cuando se ejecuta la política.

Código de falla Estado de HTTP Causa Corregir
flow.SharedFlowNotFound 500 El flujo compartido no existe o existe, pero no se ha implementado.

Errores en la implementación

No disponible

Temas relacionados