CallEndpoint

CallEndpoint HTTP 호출합니다.

다음 표에서는 CallEndpoint 조치에 대한 매개변수를 표시합니다.

표 1. CallEndpoint 조치 매개변수
이름 데이터 유형 관계 필수 참고
메소드 열거 속성 가능한 값:
  • GET
  • POST
  • 넣기
  • 삭제
  • 패치
URL 문자열 속성 엔드포인트의 기본 URL (쿼리 파라미터 제외).
savePath 문자열 속성 아니오 응답은 다음 형식의 JSON 오브젝트로 저장됩니다.
/response
{
status_code: 200,
status_message: "OK",
headers: {
"Date": "Tue, 16 Jun 2020 17:31:29 GMT",
"Content-Type": "application/json",
},
body: ...
}

savePath 값을 제공하지 않으면 엔드포인트 응답이 기본 위치에 저장되지 않습니다. 응답을 저장하려면 savePath 값을 제공해야 합니다.

sslConfiguration SSL 구성 하위 요소 아니오 자세한 정보는 SSLConfiguration을 참조하십시오.
인증 인증 하위 요소 아니오 인증 오브젝트는 다음 유형 중 하나여야 합니다.
queryParameters QueryParameter 하위 요소 아니오 둘 이상의 조회 매개변수를 가질 수 있습니다. 자세한 정보는 QueryParameter를 참조하십시오.
requestHeaders RequestHeaders 하위 요소 아니오 둘 이상의 요청 헤더가 있을 수 있습니다. 자세한 정보는 RequestHeader를 참조하십시오.
requestCookie RequestCookie 하위 요소 아니오 새로운 기능 V2_1 요청 쿠키를 두 개 이상 가질 수 있습니다. 자세한 내용은 RequestCookie에서 확인하세요
본문

RequestBody

UrlEncodedFormRequestBody

XmlRequestBody

하위 요소 아니오 본문은 다음 유형 중 하나여야 합니다.

다음 표는 SSLConfiguration의 매개변수를 표시합니다.

표 2. SSLConfiguration 구조
이름 데이터 유형 필수 참고
프로토콜 문자열 아니오 사용할 SSL 프로토콜입니다. 기본값은 TLSv1.2입니다.
allowUntrustedServerCertificate 부울 아니오 신뢰할 수 없는 서버 인증서가 허용되는지 여부를 표시합니다. 기본값은 False입니다.

XML예:

이 예에서는 신뢰할 수 없는 서버 인증서를 허용합니다.

<SSLConfiguration allowUntrustedServerCertificate="true" />

다음 표는 BasicAuthentication에 대한 매개변수를 표시합니다.

표 3. BasicAuthentication 구조
이름 데이터 유형 필수
사용자 이름 문자열
password 문자열 아니오

XML예:

이 예제는 인증 사용자 이름 및 비밀번호를 설정합니다.

<BasicAuthentication username="${/username}" password="${/password}" />

다음 표는 BearerAuthentication의 매개변수를 표시합니다.

표 4. BearerAuthentication 구조
이름 데이터 유형 필수 참고
토큰 문자열 액세스 토큰입니다.

XML예:

이 예제는 인증을 위한 액세스 토큰을 설정합니다.

<BearerAuthentication token="${/access_token}" />

다음 표는 DigestAuthentication의 매개변수를 표시합니다.

표 5. DigestAuthentication 구조
이름 데이터 유형 필수
사용자 이름 문자열
password 문자열
범주 문자열 아니오
임시 문자열 아니오
알고리즘 문자열 아니오
qop 문자열 아니오
Cnonce 문자열 아니오
nonceCount 문자열 아니오

XML예:

이 예제는 인증을 위한 사용자 이름 및 비밀번호를 설정합니다.

<DigestAuthentication username="${/public_key}" password="${/private_key}" />

V2의 새로운 기능

다음 표는 Akamai EdgeGrid 인증을 위한 매개변수를 표시합니다.

표 6. Akamai EdgeGrid 인증 구조
이름 데이터 유형 필수
accessToken 문자열
clientToken 문자열
clientSecret 문자열

V2의 새로운 기능

다음 표는 Hawk 인증에 대한 매개변수를 표시합니다.

표 7. Hawk 인증 구조
이름 데이터 유형 필수
keyID 문자열
문자열
알고리즘 문자열
해시 문자열 아니오
확장 문자열 아니오
문자열 아니오
Dlg 문자열 아니오

다음 표는 QueryParameter에 대한 매개변수를 표시합니다.

표 8. QueryParameter 구조
이름 데이터 유형 필수 참고
이름 문자열
문자열  
omitIfEmpty 부울 아니오 값이 비어 있는 경우 매개변수를 생략합니다.

XML예:

이 예제는 조회의 이름 및 값을 설정하고 값이 비어 있는 경우 매개변수를 생략합니다.

<QueryParameter name="stream_position" value="${/bookmark}" omitIfEmpty="true" />

다음 표는 RequestHeader에 대한 매개변수를 표시합니다.

표 9. RequestHeader 구조
이름 데이터 유형 필수 참고
이름 문자열
문자열 아니오  
omitIfEmpty 부울 아니오 값이 비어 있는 경우 헤더를 생략합니다.

XML예:

이 예제는 요청 헤더의 이름 및 값을 설정합니다.

<RequestHeader name="authorization" value="client_id:${/client_id}, client_secret:${/client_secret}" />

새로운 기능 V2_1

다음 표는 요청 쿠키의 매개 변수를 보여줍니다.

표 10. RequestCookie 구조
이름 데이터 유형 필수 참고
이름 문자열
문자열  
도메인 문자열 아니오 쿠키의 도메인을 설정합니다. 도메인의 기본값은 다음에서 캡처한 호스트 이름입니다callendpoint url속성을 작성하거나 제거하지 마십시오. 기본값은url속성을 작성하거나 제거하지 마십시오. 쿠키가 반환하는 도메인이 URL 동일하지 않은 경우, 도메인을 지정해야 합니다.
경로 문자열 아니오 쿠키의 경로를 설정합니다. 기본값은url속성을 작성하거나 제거하지 마십시오. 쿠키가 반환하는 경로가 URL 와 일치하지 않으면 경로를 지정해야 합니다.
시크릿(secret) 부울 아니오 값 필드를 암호화합니다. 기본값은 false로 설정되어 있습니다.

XML예:

이 예에서는 요청 쿠키의 필수 필드(이름 및 값)를 설정합니다.
<RequestCookie name=” ${/<savePath>/cookies/<cookie_name>/name}” value=”${/< savePath>/cookies/ <cookie_name> /value}”>
이 예제에서는 쿠키의 모든 필수 및 선택 필드를 설정합니다.
<RequestCookie name=” ${/<savePath>/cookies/<cookie_name>/name}” value=”${/< savePath>/cookies/ <cookie_name> /value}” domain=”${/<savePath>/cookies/<cookie_name>/domain}”> path = ”  ${/<savePath>/cookies/<cookie_name>/path}” secret = “true”>

다음 표는 RequestBody의 매개변수를 표시합니다.

표 11. RequestBody 구조
이름 데이터 유형 필수 참고
유형 문자열 유효한 HTTP 요청 content-type이어야 합니다. 예를 들어, application/json입니다.
인코딩 문자열 유효한 HTTP 본문 인코딩 유형이어야 합니다. 예를 들어, UTF-8.
컨텐츠 문자열 <RequestBody> 요소의 열기 태그와 닫기 태그 사이에 본문 콘텐츠를 포함하세요.

XML예:

이 예제는 요청 본문에 대한 컨텐츠 유형, 본문 인코딩 및 컨텐츠를 설정합니다.

<RequestBody type="application/json" encoding="UTF-8">{ "grant_type": "client_credentials" }</RequestBody>

다음 표는 UrlEncodedFormRequestBody에 대한 매개변수를 보여줍니다.

표 12. UrlEncodedFormRequestBody 구조
이름 데이터 유형 필수 참고
매개변수 맵 < 문자열, 문자열> 이름/값 쌍의 콜렉션입니다.

XML예:

이 예는 URL 인코딩된 양식 요청 본문에 대한 이름/값 쌍을 설정합니다.

<UrlEncodedFormRequestBody>
                <Parameter name="grant_type" value="urn:ietf:params:oauth:grant-type:jwt-bearer" />
                <Parameter name="client_id" value="${/client_id}" />
                <Parameter name="client_secret" value="${/client_secret}" />
                <Parameter name="assertion" value="${/jwt_assertion}" />
            </UrlEncodedFormRequestBody>

다음 표는 XmlRequestBody에 대한 매개변수를 보여줍니다.

표 13. XmlRequestBody 구조
이름 데이터 유형 필수 참고
유형 문자열 아니오 유효한 HTTP 요청 content-type이어야 합니다. 예를 들어, application/json입니다.
인코딩 문자열 아니오 유효한 HTTP 본문 인코딩 유형이어야 합니다. 예를 들어, UTF-8.
컨텐츠 XML 본문의 실제 XML 콘텐츠는 <XmlRequestBody> 요소 안에 하위 요소로 중첩되어야 합니다.

XML예:

이 예제는 XML 요청 본문의 컨텐츠를 설정합니다.

<XmlRequestBody>
                <authRequest>
                    <maaS360AdminAuth>
                        <billingID>${/billing_id}</billingID>
                        <platformID>${/platform_id}</platformID>
                        <appID>${/app_id}</appID>
                        <appVersion>${/app_version}</appVersion>
                        <appAccessKey>${/app_access_key}</appAccessKey>
                        <userName>${/username}</userName>
                        <password>${/password}</password>
                    </maaS360AdminAuth>
                </authRequest>
            </XmlRequestBody>

XML 예제:

이 조치 호출은 요청 헤더 및 요청 본문을 사용하여 https://${/host}/auth/oauth2/token 에 대한 POST 요청을 작성하고 /get_access_token의 상태에 응답을 저장합니다.

<CallEndpoint url="https://${/host}/auth/oauth2/token" method="POST" savePath="/get_access_token">
    <RequestHeader name="authorization" value="client_id:${/client_id}, client_secret:${/client_secret}" />
    <RequestBody type="application/json" encoding="UTF-8">{ "grant_type": "client_credentials" }</RequestBody>
</CallEndpoint>