HTTP > OAuth 2.0 요청 만들기 모듈

Last update: Thu Nov 21 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

주제:

작성 대상:

사용자

NOTE

Adobe Workfront Fusion에는 Adobe Workfront 라이선스 외에 Adobe Workfront Fusion 라이선스가 필요합니다.

OAuth 2.0 인증이 필요한 서버에 Adobe Workfront Fusion HTTP(S) 요청을 하려면 먼저 OAuth 연결을 만들어야 합니다. Adobe Workfront Fusion은(는) 이 연결을 사용한 모든 호출에 적절한 인증 헤더가 있는지 확인하고 필요한 경우 관련 토큰을 자동으로 새로 고칩니다.

Workfront Fusion은(는) 다음 OAuth 2.0 인증 흐름을 지원합니다.

인증 코드 흐름
암시적 흐름

리소스 소유자 암호 자격 증명 흐름 및 클라이언트 자격 증명 흐름과 같은 다른 흐름은 이 모듈을 통해 자동으로 지원되지 않습니다.

OAuth 2.0 인증에 대한 자세한 내용은 OAuth 2.0 권한 부여 프레임워크를 참조하십시오.

NOTE

현재 전용 커넥터가 없는 Adobe 제품에 연결하는 경우 Adobe Authenticator 모듈을 사용하는 것이 좋습니다.

자세한 내용은 Adobe Authenticator 모듈을 참조하세요.

액세스 요구 사항

이 문서의 기능을 사용하려면 다음 액세스 권한이 있어야 합니다.

Adobe Workfront 플랜*

Pro 이상

Adobe Workfront 라이센스*

Plan, Work

Adobe Workfront Fusion 라이센스**

현재 라이선스 요구 사항: Workfront Fusion 라이선스 요구 사항이 없습니다.

또는

레거시 라이선스 요구 사항: 작업 자동화 및 통합을 위한 Workfront Fusion

제품

현재 제품 요구 사항: Select 또는 Prime Adobe Workfront 플랜이 있는 경우 조직에서 이 문서에 설명된 기능을 사용하려면 Adobe Workfront Fusion과(와) Adobe Workfront을(를) 구매해야 합니다. Workfront Fusion이(가) Ultimate Workfront 계획에 포함되어 있습니다.

또는

레거시 제품 요구 사항: 이 문서에 설명된 기능을 사용하려면 조직에서 Adobe Workfront Fusion과(와) Adobe Workfront을(를) 구매해야 합니다.

보유 중인 플랜, 라이선스 유형 또는 액세스 권한을 확인하려면 Workfront 관리자에게 문의하세요.

Adobe Workfront Fusion 라이선스에 대한 자세한 내용은 Adobe Workfront Fusion 라이선스를 참조하세요.

OAuth 요청에 대한 연결을 만드는 중

HTTP > OAuth 2.0 요청 모듈 만들기에서 연결을 만드는 일반적인 지침
HTTP >OAuth 2.0 요청 모듈로 만들기에서 Google에 대한 연결을 만들기 위한 지침
HTTP > OAuth 2.0 요청 모듈 만들기를 통해 Microsoft Graph API에 연결하기 위한 지침

HTTP > OAuth 2.0 요청 만들기 모듈에서 연결을 만들기 위한 일반 지침

Adobe Workfront Fusion과(와) 통신할 target 서비스에 OAuth 클라이언트를 만듭니다. 이 옵션은 특정 서비스의 개발자 섹션에서 찾을 수 있습니다.

클라이언트를 만들 때 Redirect URL 또는 Callback URL 필드에 적절한 URL을 입력하십시오.

table 0-row-2 1-row-2
아메리카 / APAC	https://app.workfrontfusion.com/oauth/cb/oauth2
EMEA	https://app-eu.workfrontfusion.com/oauth/cb/oauth2

클라이언트를 만든 후 해당 서비스에 Client ID 및 Client Secret 키 2개가 표시됩니다. 일부 서비스에서는 이러한 App Key 및 App Secret을(를) 호출합니다. Workfront Fusion에서 연결을 만들 때 키 및 암호를 제공할 수 있도록 안전한 위치에 저장합니다.

제공된 서비스의 API 설명서에서 Authorize URI 및 Token URI을(를) 찾으십시오. Workfront Fusion이(가) target 서비스와 통신하는 URL 주소입니다. 주소는 OAuth 권한 부여에 사용됩니다.

note note
NOTE
서비스에서 암시적 흐름을 사용하는 경우 `Authorize URI`만 필요합니다.

note info
INFO
예: Yahoo 주소:
URI 승인:
`https://api.login.yahoo.com/oauth2/request_auth`
토큰 URI:
`https://api.login.yahoo.com/oauth2/get_token`

(조건부) 대상 서비스가 범위(액세스 권한)를 사용하는 경우, 서비스가 개별 범위를 분리하는 방법을 확인하고 고급 설정에서 구분 기호를 적절히 설정했는지 확인하십시오. 구분 기호가 올바르게 설정되지 않으면 Workfront Fusion에서 연결을 만들지 못하고 잘못된 범위 오류가 표시됩니다.
위의 단계를 완료하면 Workfront Fusion에서 OAuth 연결을 만들 수 있습니다. OAuth 2.0 HTTP(S) 요청 및 응답 처리 모듈을 시나리오에 추가합니다.
모듈의 연결 필드에서 추가 를 클릭합니다.

다음 필드를 입력하여 연결을 만듭니다.

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 10-row-2 11-row-2 12-row-2 13-row-2 14-row-2 15-row-2 16-row-2 layout-auto html-authored no-header

연결 이름 연결의 이름을 입력합니다.

흐름 유형

토큰을 얻기 위한 플로우를 선택합니다.

인증 코드: 서비스의 API 설명서에서 Authorize URI 및 Token URI을(를) 입력합니다.
암시적: 서비스의 API 설명서에서 Authorize URI을(를) 입력합니다.

범위 개별 범위를 추가합니다. 해당 서비스의 개발자(API) 설명서에서 이 정보를 찾을 수 있습니다.

범위 구분 기호

위에 입력한 범위를 구분할 기준을 선택하십시오. 해당 서비스의 개발자(API) 설명서에서 이 정보를 찾을 수 있습니다.

경고: 구분 기호가 올바르게 설정되지 않으면 Workfront Fusion에서 연결을 만들지 못하고 잘못된 범위 오류가 표시됩니다.

클라이언트 ID 클라이언트 ID를 입력합니다. 연결할 서비스에서 OAuth 클라이언트를 만들 때 클라이언트 ID를 얻었습니다.

클라이언트 암호 클라이언트 암호를 입력합니다. 연결할 서비스에서 OAuth 클라이언트를 만들 때 클라이언트 암호를 받았습니다.

Authorize parameters

인증 호출에 포함할 매개 변수를 추가합니다. 다음 표준 매개 변수는 항상 자동으로 포함되며 추가할 필요가 없습니다.

표준 매개 변수:

response_type

인증 코드 흐름의 경우 code 이고 암시적 흐름의 경우 token 입니다.

redirect_uri

table 0-row-2 1-row-2 layout-auto html-authored no-header
아메리카 / APAC	https://app.workfrontfusion.com/oauth/cb/oauth2
EMEA	https://app-eu.workfrontfusion.com/oauth/cb/oauth2

client_id

계정을 만들 때 받은 클라이언트 ID

액세스 토큰 매개 변수

토큰 호출에 포함할 매개 변수를 추가합니다. 다음 표준 매개 변수는 항상 자동으로 포함되며 추가할 필요가 없습니다.

표준 매개 변수:

grant_type: authorization_code

redirect_uri:

table 0-row-2 1-row-2 layout-auto html-authored no-header
아메리카 / APAC	https://app.workfrontfusion.com/oauth/cb/oauth2
EMEA	https://app-eu.workfrontfusion.com/oauth/cb/oauth2

client_id: 계정을 만들 때 받은 클라이언트 ID가 요청 본문에 자동으로 포함됩니다
client_secret: 계정을 만들 때 받은 클라이언트 암호가 요청 본문에 자동으로 포함됩니다
code: 인증 요청에서 반환된 코드입니다.

참고:

OAuth 2.0 표준은 이 단계(client_secret_basic 및 client_secret_post) 동안 최소 두 가지 이상의 클라이언트 인증 방법을 지원합니다. Workfront Fusion은(는) client_secret_post 메서드를 통해 지정된 클라이언트 ID와 암호를 자동으로 보냅니다. 따라서 이러한 매개 변수는 토큰 요청 본문의 일부로 자동으로 포함됩니다.

OAuth 2.0 인증에 대한 자세한 내용은 OAuth 2.0 권한 부여 프레임워크를 참조하십시오.

토큰 매개 변수 새로 고침

토큰 호출에 포함할 매개 변수를 추가합니다. 다음 표준 매개 변수는 항상 자동으로 포함되며 추가할 필요가 없습니다.

표준 매개 변수:

grant_type: refresh_token
refresh_token: 연결 중인 서비스에서 얻은 가장 최근 새로 고침 토큰입니다
client_id: 계정을 만들 때 받은 클라이언트 ID가 요청 본문에 자동으로 포함됩니다
client_secret: 계정을 만들 때 받은 클라이언트 암호가 요청 본문에 자동으로 포함됩니다

참고:

OAuth 2.0 인증에 대한 자세한 내용은 OAuth 2.0 권한 부여 프레임워크를 참조하십시오.

사용자 지정 헤더

Token 및 RRefresh Token 단계의 헤더에 포함할 추가 키 및 값을 지정합니다.

참고:

OAuth 2.0 표준은 이 단계(client_secret_basic 및 client_secret_post) 동안 최소 두 가지 이상의 클라이언트 인증 방법을 지원합니다. Workfront Fusion은(는) client_secret_basic 메서드를 자동으로 지원하지 않습니다. 연결하는 서비스에서 클라이언트 ID와 클라이언트 암호가 단일 문자열로 결합된 다음 base64가 인증 헤더에 인코딩되어야 하는 경우 해당 헤더와 키 값을 여기에 추가해야 합니다.

OAuth 2.0 인증에 대한 자세한 내용은 OAuth 2.0 권한 부여 프레임워크를 참조하십시오.

토큰 배치

지정된 URL에 연결할 때 토큰을 header, query string 또는 둘 다에 전송할지 여부를 선택합니다.

토큰은 요청 헤더에서 가장 일반적으로 전송됩니다.

헤더 토큰 이름 헤더에 인증 토큰의 이름을 입력합니다. 기본값: Bearer.

쿼리 문자열 매개 변수 이름 쿼리 문자열에 인증 토큰의 이름을 입력합니다. 기본값: access_token.

연결 설정을 저장하려면 계속 을 클릭하세요.
OAuth 2.0 요청 모듈 설정을 계속합니다.

HTTP >OAuth 2.0 요청 모듈 만들기에서 Google에 대한 연결을 만드는 지침

다음 예제에서는 HTTP > OAuth 2.0 요청 모듈을 사용하여 Google에 연결하는 방법을 보여 줍니다.

Connect Adobe Workfront Fusion to Google Services 사용자 지정 OAuth 클라이언트 사용에 설명된 대로 프로젝트를 만들고, OAuth 설정을 구성하고, 자격 증명을 생성했는지 확인하십시오.
HTTP >OAuth 2.0 요청 만들기 모듈을 엽니다.
연결 상자 옆에 있는 추가 를 클릭합니다.

다음 값을 입력합니다.

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 layout-auto html-authored no-header
연결 이름	연결의 이름을 입력합니다.
흐름 유형	Authorization Code
권한 부여 URI	`https://accounts.google.com/o/oauth2/v2/auth`
토큰 URI	`https://www.googleapis.com/oauth2/v4/token`
범위	개별 범위를 추가합니다. 범위에 대한 자세한 내용은 Google 설명서의 Google API에 대한 OAuth 2.O 범위를 참조하십시오.
범위 구분 기호	SPACE
클라이언트 ID	Google 클라이언트 ID를 입력하십시오. 클라이언트 ID를 만들려면 사용자 지정 OAuth 클라이언트를 사용하여 Connect Adobe Workfront Fusion에서 Google Services에 OAuth 자격 증명 만들기를 참조하십시오.
클라이언트 암호	Google 클라이언트 암호를 입력하십시오. 클라이언트 암호를 만들려면 사용자 지정 OAuth 클라이언트를 사용하여 Google 서비스에 대해 Connect Adobe Workfront Fusion에서 OAuth 자격 증명 만들기를 참조하십시오.
Authorize parameters	`access_type` - `offline` 키-값 쌍을 추가합니다. 참고: 토큰 새로 고침 등의 인증 문제가 발생하면 `prompt` - `consent` 키-값 쌍을 추가해 보십시오.

연결 설정을 저장하려면 계속 을 클릭하세요.
OAuth 2.0 요청 모듈 설정을 계속합니다.

HTTP > OAuth 2.0 요청 만들기 모듈을 통해 Microsoft Graph API에 연결하는 지침

Microsoft Graph API에 대한 지침은 [HTTP] > OAuth 2.0 요청 만들기 모듈(https://experienceleague.adobe.com/workfront-fusion/connections/call-the-ms-graph-rest-api.html?lang=ko)을 통해 MS Graph REST API 에 문의하십시오. Adobe Workfront Fusion

OAuth 2.0 요청 모듈 설정

요청에 대한 연결 만들기 OAuth 요청에 설명된 대로 Oauth 2.0 연결을 설정했으면 원하는 대로 모듈을 계속 설정합니다. 모든 인증 토큰은 이 요청 및 동일한 연결을 사용하는 다른 모든 요청에 자동으로 포함됩니다.

HTTP >OAuth 2.0 요청 만들기 모듈을 구성할 때 Workfront Fusion에 아래 나열된 필드가 표시됩니다. 모듈의 굵은 제목은 필수 필드를 나타냅니다.

필드나 함수 위에 맵 단추가 표시되면 이 단추를 사용하여 해당 필드에 대한 변수와 함수를 설정할 수 있습니다. 자세한 내용은 한 모듈에서 다른 모듈로 정보를 매핑 Adobe Workfront Fusion을 참조하십시오.

Connection

연결 설정에 대한 자세한 내용은 이 문서에서 OAuth 요청에 대한 연결 만들기를 참조하십시오.

모든 상태를 오류로 평가(2xx 및 3xx 제외)

이 옵션을 사용하여 오류 처리를 설정합니다.

자세한 내용은 Adobe Workfront Fusion에서 오류 처리를 참조하십시오.

URL

API 끝점, 웹 사이트 등과 같이 요청을 보낼 URL을 입력합니다.

메서드

API 호출을 구성하는 데 필요한 HTTP 요청 메서드를 선택합니다. 자세한 내용은 Adobe Workfront Fusion에서 HTTP 요청 메서드를 참조하십시오.

Headers

표준 JSON 개체 형태로 요청의 헤더를 추가합니다. For example, {"Content-type":"application/json"}

쿼리 문자열

원하는 쿼리 키-값 쌍을 입력합니다.

Body type

HTTP Body는 사용할 데이터 바이트가 있는 경우 헤더 바로 다음에 오는 HTTP 트랜잭션 메시지로 전송됩니다.

Raw

원시 본문 유형은 일반적으로 개발자 설명서에서 전송할 데이터를 지정하지 않는 경우에도 대부분의 HTTP 본문 요청에 적합합니다.

Content type 필드에서 데이터를 구문 분석하는 형식을 지정합니다.

선택한 콘텐츠 유형에도 불구하고 데이터는 개발자 설명서에서 규정하거나 요구하는 모든 형식으로 입력됩니다.
Application/x-www-form-urlencoded

이 본문 형식은 application/x-www-form-urlencoded을(를) 사용하여 데이터를 POST 하는 것입니다.

application/x-www-form-urlencoded의 경우 서버로 전송된 HTTP 메시지의 본문은 기본적으로 하나의 쿼리 문자열입니다. 키와 값은 키와 값 사이에 =이(가) 있고 &(으)로 구분된 키-값 쌍으로 인코딩됩니다.

이진 데이터의 경우 대신 use multipart/form-data을(를) 사용합니다.

예:

결과 HTTP 요청 형식의 예:

field1=value1&field2=value2
Multipart/form-data

Multipart/form-data는 파일 및 데이터를 전송하는 데 사용되는 HTTP multipart 요청입니다. 일반적으로 서버에 파일을 업로드하는 데 사용됩니다.

요청에 전송할 필드를 추가합니다. 각 필드에는 키-값 쌍이 포함되어야 합니다.
- Text
  
  요청 본문 내에 보낼 키와 값을 입력합니다.
- 파일
  
  키를 입력하고 요청 본문에 보낼 소스 파일을 지정합니다.
  
  이전 모듈(예: HTTP >파일 가져오기 또는 Google 드라이브 >파일 다운로드)에서 업로드할 파일을 매핑하거나 파일 이름 및 파일 데이터를 수동으로 입력합니다.

구문 분석 응답

JSON > Parse JSON 또는 XML > Parse XML 모듈을 사용할 필요가 없도록 응답을 자동으로 구문 분석하고 JSON 및 XML 응답을 변환하려면 이 옵션을 활성화합니다.

구문 분석된 JSON 또는 XML 컨텐츠를 사용하기 전에 모듈에서 응답 컨텐츠를 인식하고 이를 후속 모듈에 매핑할 수 있도록 모듈을 한 번 수동으로 실행하십시오.

시간 초과

요청 시간 제한(초)을 입력합니다(1-300). 기본값은 40초입니다.

다른 HTTP 모듈과 쿠키 공유

이 옵션을 활성화하면 시나리오의 모든 HTTP 모듈과 서버의 쿠키를 공유할 수 있습니다.

자체 서명된 인증서

자체 서명된 인증서를 사용하여 TLS를 사용하려면 인증서를 업로드하십시오.

확인되지 않은(자체 서명된) 인증서를 사용하는 연결을 거부합니다.

확인되지 않은 TLS 인증서를 사용하는 연결을 거부하려면 이 옵션을 활성화합니다.

리디렉션 따르기

3xx 응답이 있는 URL 리디렉션을 따르려면 이 옵션을 활성화하십시오.

모든 리디렉션 팔로우

모든 응답 코드와 함께 URL 리디렉션을 따르려면 이 옵션을 활성화합니다.

배열로 동일한 쿼리 문자열 키를 여러 개 직렬화할 수 없음

기본적으로 Workfront Fusion은(는) 배열과 동일한 URL 쿼리 문자열 매개 변수 키에 대해 여러 값을 처리합니다. 예를 들어 www.test.com?foo=bar&foo=baz은(는) www.test.com?foo[0]=bar&foo[1]=baz(으)로 변환됩니다. 이 기능을 비활성화하려면 이 옵션을 활성화합니다.

Request compressed content

웹 사이트의 압축된 버전을 요청하려면 이 옵션을 활성화하십시오.

압축된 콘텐츠를 요청하기 위해 Accept-Encoding 헤더를 추가합니다.

Use Mutual TLS

HTTP 요청에서 상호 TLS를 사용하려면 이 옵션을 활성화하십시오.

상호 TLS에 대한 자세한 내용은 HTTP 모듈에서 상호 TLS 사용(Adobe Workfront Fusion)을 참조하십시오.

recommendation-more-help

5f00cc6b-2202-40d6-bcd0-3ee0c2316b43