FlowCallout 정책

공유 흐름에서 API 키 확인

이 예시에서 공유 흐름은 일반적인 보안 관련 작업을 수행하는 데 사용됩니다. 여기에서 공유 흐름은 API 키를 검증합니다. API 프록시 및 기타 공유 흐름에서 FlowHeadline을 사용할 수 있습니다. 정책을 사용하여 이 공유 흐름으로 호출을 보낼 수 있습니다.

다음 공유 흐름 정의에는 API 프록시의 FlowCallout 정책에서 공유 흐름이 호출될 때 실행되는 Verify-API-Key 정책이 포함되어 있습니다.

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

API 프록시에 사용되는 다음 FlowCallout 정책은 앞의 공유 흐름을 호출하여 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 정책을 호출합니다. 공유 흐름에는 입력을 연결하거나 입력을 소문자로 고치거나 또는 둘 모두에 해당하는 자바스크립트가 포함됩니다. FlowCallout 정책은 문자열 입력, 출력, 입력으로 수행하는 작업을 지정하는 매개변수를 정의합니다.

1. String-Handler Flow콜아웃 정책은 공유된 흐름을 호출합니다. 공유 흐름의 출력을 저장할 변수를 지정하는 매개변수 전달, 공유 흐름 사용할 입력 (여기서는 문자열 리터럴이지만 흐름 변수). 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 공유 흐름에는 공유 흐름이 FlowRenderer 정책에서 호출될 때 실행되는 SharedStringFunctions JavaScript 정책이 포함되어 있습니다.

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

3. 공유 흐름에서 다음 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는 SharedStringFunctions JavaScript 정책 이 스크립트는 Flow콜아웃 정책 Parameter 요소에서 생성된 변수입니다.

   // 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. 실행은 자바스크립트 정책에서 공유 흐름으로, 원래 API 프록시의 FlowCallout 정책으로 다시 이동합니다.

구문

이 요소는 다음 구문 양식 중 하나와 함께 사용할 수 있습니다. 리터럴 값을 사용할 경우 지정한 값의 형식은 이를 사용하는 코드에 따라 다릅니다.

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

예

이 String-Handler Flow콜아웃 정책은 공유 흐름의 출력과 사용할 입력을 저장할 수 있습니다. 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>