사용자 정의 자격 증명 유형을 사용하는 방법

참고: 이 문서는 웹 서비스 데이터 작업 통합에 적용됩니다.

웹 서비스 데이터 작업 통합을 추가할 때 자격 증명 유형을 선택할 수 있습니다. 기본 인증, 사용자 정의 또는 사용자 정의(OAuth). 자세한 내용은 데이터 작업 통합 추가 그리고 자격 증명 유형.

이 문서에서는 사용자 정의 자격 증명 유형을 사용하는 방법에 대해 설명합니다. 

  1. 통합을 추가할 때 사용자 정의 자격 증명을 구성합니다.

    사용 중인 API의 필드 이름과 해당 필드 이름의 값을 추가하십시오.

    사용자 정의에 대한 자격 증명 구성

  2. 생성하는 모든 사용자 지정 작업의 요청에서 자격 증명의 필드 이름을 사용합니다. 

    다음 예는 날씨 가져오기라는 사용자 지정 작업에 대한 요청입니다. 신임장 다른 Velocity 매크로와 함께 사용할 수 있는 정적 키워드입니다. API_키 자격 증명 구성에 추가한 필드 이름입니다. 자세한 내용은 데이터 작업을 위한 속도 매크로.

    통합은 필드 이름의 값을 수정하지만 실제 값은 웹 서비스에 나타납니다. 예를 들어 API_키 가 12345이면 작업이 실행될 때 웹 서비스에 표시되는 requestUrlTemplate은 "https://api.openweathermap.org/data/2.5/weather?q=London&APPID=12345"입니다. 자세한 내용은 사용자 지정 작업 만들기, 사용자 지정 작업에 구성 추가, 그리고 구성 요청.

    주의: 내에서 입력 또는 출력 변수를 사용하지 않도록 하십시오. 요청 템플릿, 성공템플릿, 또는 요청 URL 템플릿. 특수 문자로 변수를 적절히 이스케이프하지 않으면 데이터 작업이 실행되지 않습니다.
    • 사용하다 esc.json문자열 JSON 본문 내에서 문자열을 이스케이프합니다.

      자세한 내용은 의 esc.jsonString 섹션을 참조하십시오. 데이터 작업을 위한 속도 매크로.

    • 사용하다 esc.url() 또는 urlTool.OptionalQueryParam() 경로 또는 쿼리 매개변수를 적절히 이스케이프하려면 요청 URL 템플릿 또는 요청 템플릿 사용하는 경우 x-www.form-urlencoded 가치.

      자세한 내용은 문자열 이스케이프 라이브러리 섹션을 참조하십시오. 데이터 작업을 위한 속도 매크로.

    이스케이프는 JSON 컨텍스트에 따라 다르므로 다음 예제에서는 의도적으로 이스케이프를 표시하지 않습니다.

    {
      "requestUrlTemplate": "https://api.openweathermap.org/data/2.5/weather?q=London&APPID=${credentials.API_Key}",
      "requestType": "GET",
      "headers": {},
      "requestTemplate": "${input.rawRequest}"
    }
    참고: 사용자 지정 작업을 테스트할 때 통합은 모든 권한 부여 정보를 수정합니다. 자세한 내용은 사용자 지정 작업 테스트.

통합에 대한 자세한 내용은 다음을 참조하십시오. 웹 서비스 데이터 작업 통합 정보.