공유 흐름 번들 구성 참조

이 페이지는 Apigee 및 Apigee Hybrid에 적용됩니다.

공유 흐름은 API 프록시와 비슷한 재사용 가능한 기능입니다. 자세한 내용은 재사용 가능한 공유 흐름 만들기를 참조하세요.

공유 흐름 번들 디렉터리 구조

아래 표시된 공유 흐름 번들 디렉터리 구조는 API 프록시 구성 디렉터리 구조와 유사합니다.

공유 흐름 번들 디렉터리 구조

공유 흐름 번들 구성은 다음 콘텐츠로 구성됩니다.

기본 구성	기본 구성 설정.
정책	Apigee 정책 스키마를 준수하는 XML 형식의 구성 파일입니다.
리소스	커스텀 로직을 실행하기 위해 정책에서 참고하는 스크립트, JAR 파일 및 XSLT 파일입니다.
공유 흐름	이 번들에 포함된 공유 흐름

기본 구성

기본 구성 파일은 번들의 루트 디렉터리에 있습니다. 이 이름이 번들의 이름입니다.

/sharedflowbundle/traffic-management-shared.xml

기본 구성은 공유 흐름 번들의 콘텐츠와 번들의 업데이트 기록을 추적하기 위한 정보를 정의합니다.

<SharedFlowBundle revision="2" name="traffic-management-shared">
    <ConfigurationVersion majorVersion="4" minorVersion="0"/>
    <CreatedAt>1478637529218</CreatedAt>
    <CreatedBy>gladys@example.com</CreatedBy>
    <Description>Shared flow to moderate API traffic</Description>
    <DisplayName>traffic-management-shared</DisplayName>
    <LastModifiedAt>1481573374023</LastModifiedAt>
    <LastModifiedBy>gladys@example.com</LastModifiedBy>
    <Policies>
        <Policy>Auth-Flow-Callout</Policy>
        <Policy>Extract-Token</Policy>
        <Policy>Spike-Arrest</Policy>
    </Policies>
    <Resources>
        <Resource>jsc://extract-token.js</Resource>
    </Resources>
    <SharedFlows>
        <SharedFlow>default</SharedFlow>
    </SharedFlows>
</SharedFlowBundle>

기본 구성 속성

이름	설명	기본값	필수 여부
`SharedFlowBundle`
`name`	조직 내에서 고유해야 하는 공유 흐름 번들의 이름입니다. 유효한 문자는 다음이 포함됩니다. `A-Za-z0-9_-`	해당 사항 없음	예
`revision`	공유 흐름 번들 구성의 버전 번호입니다. Apigee는 공유 흐름의 현재 버전을 자동으로 추적하므로 버전 번호를 명시적으로 설정할 필요가 없습니다.	해당 사항 없음	아니요

기본 구성 요소

이름	설명	기본값	필수 여부
`SharedFlowBundle`
`ConfigurationVersion`	이 공유 흐름이 준수하는 공유 흐름 번들 구성 스키마의 버전입니다. 현재 지원되는 값은 `majorVersion 4` 및 `minorVersion 0`뿐입니다. 이 설정은 향후에 공유 흐름 번들 형식을 만드는 데 사용될 수 있습니다	4.0	아니요
`CreatedAt`, `CreatedBy`	공유 흐름 번들이 생성된 날짜/시간(에포크 시간) 및 번들을 만든 사용자의 이메일입니다.
`Description`	공유 흐름의 텍스트 설명입니다. 이 설명을 제공하면 Apigee UI에 설명이 표시됩니다.	해당 사항 없음	아니요
`DisplayName`	사용자 친화적인 이름으로 공유 흐름 구성의 `name` 속성과 다를 수 있습니다.	해당 사항 없음	아니요
`LastModifiedAt`, `LastModifiedBy`	공유 흐름 번들이 마지막으로 수정된 날짜/시간(에포크 시간)이며 수정한 사용자 이메일과 함께 표시됩니다.
`Policies`	이 공유 흐름의 `/policies` 디렉터리에 있는 정책 목록입니다. 일반적으로 Edge 관리 UI를 사용하여 공유 흐름을 만든 경우에만 이 요소가 표시됩니다. 이 요소는 단순히 공유 흐름의 콘텐츠를 볼 수 있도록 설계된 '매니페스트' 설정입니다.	해당 사항 없음	아니요
`Resources`	이 공유 흐름의 `/resources` 디렉터리에 있는 리소스(자바스크립트, Python, 자바, XSLT)의 목록입니다. 일반적으로 Apigee UI를 사용하여 공유 흐름을 만든 경우에만 이 요소가 표시됩니다. 이 요소는 단순히 공유 흐름의 콘텐츠를 볼 수 있도록 설계된 매니페스트 설정입니다.	해당 사항 없음	아니요
`SharedFlows`	이 번들에 포함된 공유 흐름입니다. 참고: 현재 이 요소는 하위 요소 `<SharedFlow>` 하나만 지원합니다. 즉, 공유 흐름 하나만 공유 흐름 번들에 추가할 수 있습니다.	해당 사항 없음	예

정책

/sharedflowbundle/policies

API 프록시와 마찬가지로 공유 흐름 번들의 /policies 디렉터리에는 번들의 공유 흐름에 연결할 수 있는 모든 정책에 대한 구성 XML이 포함되어 있습니다. 정책은 요소의 하위 집합을 공유하지만 이 하위 집합은 정책에 맞는 요소로 보강됩니다. 정책을 구성하는 방법에 대한 자세한 내용은 정책 참조 개요를 참조하세요.

리소스

/sharedflowbundle/resources

리소스는 정책을 사용하여 공유 흐름에 연결할 수 있는 스크립트, 코드, XSL 변환입니다. 관리 UI의 공유 흐름 편집기에 있는 스크립트 섹션에 표시됩니다.

지원되는 리소스 유형은 리소스 관리를 참조하세요.

공유 흐름

/sharedflowbundle/sharedflows/default.xml

SharedFlow 구성은 흐름 요소를 실행해야 하는 시퀀스를 정의합니다. <SharedFlow> 요소의 <Step> 하위 요소는 각각 정책 호출과 같은 시퀀스의 일부를 지정합니다.

다음 SharedFlow 구성은 하향식 순서로(관리 콘솔에서는 왼쪽에서 오른쪽으로) 실행할 세 가지 정책을 지정합니다. SpikeArrest 정책이 가장 먼저이고 FlowCallout 정책이 마지막입니다.

<SharedFlow name="default">
    <Step>
        <Name>Spike-Arrest</Name>
    </Step>
    <Step>
        <Name>Extract-Token</Name>
    </Step>
    <Step>
        <Name>Auth-Flow-Callout</Name>
    </Step>
</SharedFlow>

공유 흐름 구성 속성

이름	설명	기본값	필수 여부
`SharedFlow`
`name`	공유 흐름의 이름은 조직 내에서 고유해야 합니다. 유효한 문자는 다음이 포함되어 있습니다. `A-Za-z0-9_-`	해당 사항 없음	예
`revision`	공유 흐름 구성의 버전 번호입니다. Apigee는 공유 흐름의 현재 버전을 자동으로 추적하므로 버전 번호를 명시적으로 설정할 필요가 없습니다.	해당 사항 없음	아니요

공유 흐름 구성 요소

이름	설명	기본값	필수 여부
`SharedFlow`	공유 흐름의 정책 시퀀스입니다.	해당 사항 없음	예
`Step`	흐름 시퀀스 단계입니다.	해당 사항 없음	예
`Name`	단계에서 참조하는 항목의 이름입니다. 이 요소의 값은 정책의 이름 속성 값과 같은 항목의 고유 식별자와 동일해야 합니다.	해당 사항 없음	예