CallEndpoint
CallEndpoint HTTP 호출합니다.
다음 표에서는 CallEndpoint 조치에 대한 매개변수를 표시합니다.
| 이름 | 데이터 유형 | 관계 | 필수 | 참고 |
|---|---|---|---|---|
| 메소드 | 열거 | 속성 | 예 | 가능한 값:
|
| URL | 문자열 | 속성 | 예 | 엔드포인트의 기본 URL (쿼리 파라미터 제외). |
| savePath | 문자열 | 속성 | 아니오 | 응답은 다음 형식의 JSON 오브젝트로 저장됩니다.savePath 값을 제공하지 않으면 엔드포인트 응답이 기본 위치에 저장되지 않습니다. 응답을 저장하려면 savePath 값을 제공해야 합니다. |
| sslConfiguration | SSL 구성 | 하위 요소 | 아니오 | 자세한 정보는 SSLConfiguration을 참조하십시오. |
| 인증 | 인증 | 하위 요소 | 아니오 | 인증 오브젝트는 다음 유형 중 하나여야 합니다.
|
| queryParameters | QueryParameter | 하위 요소 | 아니오 | 둘 이상의 조회 매개변수를 가질 수 있습니다. 자세한 정보는 QueryParameter를 참조하십시오. |
| requestHeaders | RequestHeaders | 하위 요소 | 아니오 | 둘 이상의 요청 헤더가 있을 수 있습니다. 자세한 정보는 RequestHeader를 참조하십시오. |
| requestCookie | RequestCookie | 하위 요소 | 아니오 | 새로운 기능 V2_1 요청 쿠키를 두 개 이상 가질 수 있습니다. 자세한 내용은 RequestCookie에서 확인하세요 |
| 본문 | RequestBody UrlEncodedFormRequestBody XmlRequestBody |
하위 요소 | 아니오 | 본문은 다음 유형 중 하나여야 합니다. |
다음 표는 SSLConfiguration의 매개변수를 표시합니다.
| 이름 | 데이터 유형 | 필수 | 참고 |
|---|---|---|---|
| 프로토콜 | 문자열 | 아니오 | 사용할 SSL 프로토콜입니다. 기본값은 TLSv1.2입니다. |
| allowUntrustedServerCertificate | 부울 | 아니오 | 신뢰할 수 없는 서버 인증서가 허용되는지 여부를 표시합니다. 기본값은 False입니다. |
XML예:
이 예에서는 신뢰할 수 없는 서버 인증서를 허용합니다.
<SSLConfiguration allowUntrustedServerCertificate="true" />
다음 표는 BasicAuthentication에 대한 매개변수를 표시합니다.
| 이름 | 데이터 유형 | 필수 |
|---|---|---|
| 사용자 이름 | 문자열 | 예 |
| password | 문자열 | 아니오 |
XML예:
이 예제는 인증 사용자 이름 및 비밀번호를 설정합니다.
<BasicAuthentication username="${/username}" password="${/password}" />
다음 표는 BearerAuthentication의 매개변수를 표시합니다.
| 이름 | 데이터 유형 | 필수 | 참고 |
|---|---|---|---|
| 토큰 | 문자열 | 예 | 액세스 토큰입니다. |
XML예:
이 예제는 인증을 위한 액세스 토큰을 설정합니다.
<BearerAuthentication token="${/access_token}" />
다음 표는 DigestAuthentication의 매개변수를 표시합니다.
| 이름 | 데이터 유형 | 필수 |
|---|---|---|
| 사용자 이름 | 문자열 | 예 |
| password | 문자열 | 예 |
| 범주 | 문자열 | 아니오 |
| 임시 | 문자열 | 아니오 |
| 알고리즘 | 문자열 | 아니오 |
| qop | 문자열 | 아니오 |
| Cnonce | 문자열 | 아니오 |
| nonceCount | 문자열 | 아니오 |
XML예:
이 예제는 인증을 위한 사용자 이름 및 비밀번호를 설정합니다.
<DigestAuthentication username="${/public_key}" password="${/private_key}" />
V2의 새로운 기능
다음 표는 Akamai EdgeGrid 인증을 위한 매개변수를 표시합니다.
| 이름 | 데이터 유형 | 필수 |
|---|---|---|
| accessToken | 문자열 | 예 |
| clientToken | 문자열 | 예 |
| clientSecret | 문자열 | 예 |
V2의 새로운 기능
다음 표는 Hawk 인증에 대한 매개변수를 표시합니다.
| 이름 | 데이터 유형 | 필수 |
|---|---|---|
| keyID | 문자열 | 예 |
| 키 | 문자열 | 예 |
| 알고리즘 | 문자열 | 예 |
| 해시 | 문자열 | 아니오 |
| 확장 | 문자열 | 아니오 |
| 앱 | 문자열 | 아니오 |
| Dlg | 문자열 | 아니오 |
다음 표는 QueryParameter에 대한 매개변수를 표시합니다.
| 이름 | 데이터 유형 | 필수 | 참고 |
|---|---|---|---|
| 이름 | 문자열 | 예 | |
| 값 | 문자열 | 예 | |
| omitIfEmpty | 부울 | 아니오 | 값이 비어 있는 경우 매개변수를 생략합니다. |
XML예:
이 예제는 조회의 이름 및 값을 설정하고 값이 비어 있는 경우 매개변수를 생략합니다.
<QueryParameter name="stream_position" value="${/bookmark}" omitIfEmpty="true" />
다음 표는 RequestHeader에 대한 매개변수를 표시합니다.
| 이름 | 데이터 유형 | 필수 | 참고 |
|---|---|---|---|
| 이름 | 문자열 | 예 | |
| 값 | 문자열 | 아니오 | |
| omitIfEmpty | 부울 | 아니오 | 값이 비어 있는 경우 헤더를 생략합니다. |
XML예:
이 예제는 요청 헤더의 이름 및 값을 설정합니다.
<RequestHeader name="authorization" value="client_id:${/client_id}, client_secret:${/client_secret}" />
새로운 기능 V2_1
다음 표는 요청 쿠키의 매개 변수를 보여줍니다.
| 이름 | 데이터 유형 | 필수 | 참고 |
|---|---|---|---|
| 이름 | 문자열 | 예 | |
| 값 | 문자열 | 예 | |
| 도메인 | 문자열 | 아니오 | 쿠키의 도메인을 설정합니다. 도메인의 기본값은 다음에서 캡처한 호스트 이름입니다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의 매개변수를 표시합니다.
| 이름 | 데이터 유형 | 필수 | 참고 |
|---|---|---|---|
| 유형 | 문자열 | 예 | 유효한 HTTP 요청 content-type이어야 합니다. 예를 들어, application/json입니다. |
| 인코딩 | 문자열 | 예 | 유효한 HTTP 본문 인코딩 유형이어야 합니다. 예를 들어, UTF-8. |
| 컨텐츠 | 문자열 | 예 | <RequestBody> 요소의 열기 태그와 닫기 태그 사이에 본문 콘텐츠를 포함하세요. |
XML예:
이 예제는 요청 본문에 대한 컨텐츠 유형, 본문 인코딩 및 컨텐츠를 설정합니다.
<RequestBody type="application/json" encoding="UTF-8">{ "grant_type": "client_credentials" }</RequestBody>
다음 표는 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에 대한 매개변수를 보여줍니다.
| 이름 | 데이터 유형 | 필수 | 참고 |
|---|---|---|---|
| 유형 | 문자열 | 아니오 | 유효한 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>