Политика FlowCallout

Подтвердите ключ API в общем процессе.

В этом примере общий поток используется для выполнения стандартных задач, связанных с безопасностью. Здесь общий поток проверяет ключ API. API-прокси и другие общие потоки могут использовать политику FlowCallout для выполнения вызовов к этому общему потоку.

Приведенное ниже определение общего потока включает политику Verify-API-Key , которая выполняется при вызове общего потока из политики FlowCallout в API-прокси.

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

Политика VerifyAPIKey в рамках предыдущего общего потока извлекает значение ключа и проверяет его.

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

Следующая политика FlowCallout, используемая в API-прокси, вызывает предыдущий общий поток для проверки ключа API. Пакет общих потоков verify-apikey-shared (здесь не показан) настраивает общий поток так же, как пакет APIProxy настраивает прокси.

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

Передача параметров в общий поток

Этот пример иллюстрирует, как передавать параметры из политики FlowCallout в общий поток. Здесь политика FlowCallout вызывает общий поток, предназначенный для выполнения общих функций обработки строк. Общий поток включает JavaScript, который объединяет входные данные, переводит их в нижний регистр или делает и то, и другое. Политика FlowCallout определяет параметры, которые указывают на входные и выходные строки, а также на то, что нужно сделать с входными данными.

1. Политика String-Handler FlowCallout вызывает общий поток, передавая параметры, указывающие переменную для хранения выходных данных общего потока, используемую операцию общего потока и используемые входные данные (здесь строковый литерал, но это также может быть переменная потока). Элементы Parameter указывают имена и значения переменных, создаваемых во время выполнения. Общий поток может получать эти переменные для использования в собственном коде.

   <?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. Следующий default общий поток включает политику JavaScript SharedStringFunctions , которая выполняется при вызове общего потока из политики FlowCallout.

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

3. В общем потоке выполнения следующая политика JavaScript SharedStringFunctions указывает файл JavaScript SharedStringFunctions.js с кодом для выполнения.

   <?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. Следующий JavaScript-скрипт, SharedStringFunctions.js, выполняется из политики JavaScript SharedStringFunctions . Этот скрипт извлекает значения из переменных, созданных из элементов Parameter политики FlowCallout.

   // 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. Процесс выполнения переходит от политики JavaScript к общему потоку, а затем к политике FlowCallout в исходном API-прокси.

Синтаксис

Этот элемент можно использовать с любым из следующих вариантов синтаксиса. Обратите внимание, что в случае использования литерального значения формат указанного значения будет зависеть от кода, который его использует.

<!- 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>

Пример

Эта политика FlowCallout, String-Handler передает параметры, определяющие место хранения выходных данных общего потока и используемые входные данные. Элементы Parameter указывают имена и значения переменных, создаваемых во время выполнения. Общий поток может получать эти переменные для использования в своем собственном коде.

<?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>

Синтаксис

<Parameters>
  <Parameter name="parameter-name" value='parameter-value' />
</Parameters>