HTTP > 提出 OAuth 2.0 請求模組
若要向需要OAuth 2.0授權的伺服器發出Adobe Workfront Fusion HTTP(S)請求,您首先需要建立OAuth連線。 Adobe Workfront Fusion會確保使用此連線進行的所有呼叫都有適當的授權標頭,並視需要自動重新整理關聯的權杖。
Workfront Fusion支援下列OAuth 2.0驗證流程:
- 授權代碼流程
- 隱含流量
其他流程(例如「資源擁有者密碼證明資料流程」和「使用者端證明資料流程」)不自動透過此模組支援。
如需OAuth 2.0驗證的詳細資訊,請參閱OAuth 2.0授權架構。
存取權要求
| table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header | |
|---|---|
| Adobe Workfront 封裝 |
任何 Adobe Workfront Workflow 封裝及任何 Adobe Workfront Automation and Integration 封裝 Workfront Ultimate Workfront Prime 和 Select 封裝,以及額外購買的 Workfront Fusion。 |
| Adobe Workfront 授權 |
標準 工作或更高層級 |
| Adobe Workfront Fusion 授權 |
作業型:無 Workfront Fusion 授權要求 連接器型 (舊版):Workfront Fusion for Work Automation and Integration |
| 產品 | 如果您的組織擁有 Select 或 Prime Workfront 封裝,但不包括 Workfront Automation and Integration,則您的組織必須購買 Adobe Workfront Fusion。 |
若要詳細了解此表格中的資訊,請參閱🔗文件中的存取權要求。
關於 Adobe Workfront Fusion 授權的資訊,請參閱 Adobe Workfront Fusion 授權。
建立OAuth要求的連線
在HTTP > 發出OAuth 2.0請求模組中建立連線的一般指示
-
在target服務中建立您希望Adobe Workfront Fusion與之通訊的OAuth使用者端。 此選項很可能在指定服務的開發人員區段中找到。
-
建立使用者端時,請在
Redirect URL或Callback URL欄位中輸入適當的URL:table 0-row-2 1-row-2 美洲/APAC https://app.workfrontfusion.com/oauth/cb/oauth2EMEA https://app-eu.workfrontfusion.com/oauth/cb/oauth2 -
建立使用者端後,指定的服務會顯示2個金鑰:
Client ID和Client Secret。 某些服務會呼叫這些App Key和App Secret。 將金鑰和秘密儲存在安全位置,以便您在Workfront Fusion中建立連線時提供它們。
-
-
在指定服務的API檔案中尋找
Authorize URI和Token URI。 這些是Workfront Fusion用來與target服務通訊的URL位址。 這些位址用於OAuth授權。note NOTE 如果服務使用隱含流量,您只需要使用 Authorize URI。 -
(視條件而定)如果目標服務使用範圍(存取許可權),請檢查服務如何分隔個別範圍,並確定您在進階設定中相應地設定分隔符號。 如果分隔符號未正確設定,Workfront Fusion將無法建立連線,且您會收到無效的範圍錯誤。
-
完成上述步驟後,您就可以開始在Workfront Fusion中建立OAuth連線。 新增HTTP >產生OAuth 2請求模組至您的情境。
-
在模組的[連線]欄位中,按一下[新增]。
-
填寫以下欄位以建立連線:
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 17-row-2 18-row-2 layout-auto html-authored no-header 連線名稱 輸入連線的名稱。 環境 選取您是使用生產或非生產環境。 類型 選取您是使用服務帳戶還是個人帳戶。 流程型別 選取取得權杖的流程。
- 授權碼:從服務的API檔案輸入
Authorize URI和Token URI。 - Implicit:從服務的API檔案輸入
Authorize URI。
範圍 新增個別範圍。 您可以在特定服務的開發人員(API)檔案中找到此資訊。 範圍分隔符號 選取上面輸入的範圍應該用分隔符號。 您可以在特定服務的開發人員(API)檔案中找到此資訊。
警告:如果分隔符號未正確設定,Workfront Fusion將無法建立連線,且您會收到無效的範圍錯誤。
用戶端 ID 輸入使用者端識別碼。 您在要連線的服務中建立OAuth使用者端時,已取得使用者端ID。 用戶端密碼 輸入使用者端密碼。 您在要連線的服務中建立OAuth使用者端時,已取得使用者端密碼。 Authorize引數 新增您要納入授權呼叫中的任何引數。 下列標準引數一律會自動納入,不需要新增。
標準引數:
-
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 歐洲、中東和非洲地區 https://app-eu.workfrontfusion.com/oauth/cb/oauth2 -
client_id
建立帳戶時收到的使用者端ID
存取權杖引數 新增您要包含在Token呼叫中的任何引數。 下列標準引數一律會自動納入,不需要新增。
標準引數:
-
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 歐洲、中東和非洲地區 https://app-eu.workfrontfusion.com/oauth/cb/oauth2 -
client_id:您在建立帳戶時收到的使用者端識別碼會自動包含在要求內文中
-
client_secret:您在建立帳戶時收到的使用者端密碼會自動包含在要求內文中
-
代碼:授權要求傳回的代碼
注意:
OAuth 2.0標準在此步驟期間支援至少2種使用者端驗證方法(
client_secret_basic和client_secret_post)。 Workfront Fusion會透過client_secret_post方法自動傳送指定的使用者端ID和密碼。 因此,這些引數會自動包含在權杖請求內文中。如需OAuth 2.0驗證的詳細資訊,請參閱OAuth 2.0授權架構。
重新整理權杖引數 新增您要包含在Token呼叫中的任何引數。 下列標準引數一律會自動納入,不需要新增。
標準引數:
-
grant_type:
refresh_token -
refresh_token:您連線的服務所取得的最新重新整理權杖
-
client_id:您在建立帳戶時收到的使用者端識別碼會自動包含在要求內文中
-
client_secret:您在建立帳戶時收到的使用者端密碼會自動包含在要求內文中
注意:
OAuth 2.0標準在此步驟期間支援至少2種使用者端驗證方法(
client_secret_basic和client_secret_post)。 Workfront Fusion會透過client_secret_post方法自動傳送指定的使用者端ID和密碼。 因此,這些引數會自動包含在權杖請求內文中。如需OAuth 2.0驗證的詳細資訊,請參閱OAuth 2.0授權架構。
自訂標頭 指定要包含在Token和RRefresh Token步驟標頭中的任何其他金鑰和值。
注意:
OAuth 2.0標準在此步驟期間支援至少2種使用者端驗證方法(
client_secret_basic和client_secret_post)。 Workfront Fusion不自動支援client_secret_basic方法。 如果您要連線的服務預期使用者端ID和使用者端密碼會合併為單一字串,然後將base64編碼為授權標頭,則您應該在此處新增該標頭和金鑰值。如需OAuth 2.0驗證的詳細資訊,請參閱OAuth 2.0授權架構。
權杖位置 選取在連線至指定的URL時,要以標頭、查詢字串或兩者來傳送權杖。
Token最常在請求標頭中傳送。
標頭權杖名稱 在標頭中輸入授權權杖的名稱。 預設值: Bearer。查詢字串引數名稱 在查詢字串中輸入授權權杖的名稱。 預設值: access_token。 - 授權碼:從服務的API檔案輸入
-
按一下「繼續」,儲存連線並返回模組。
在HTTP > 建立OAuth 2.0要求模組中與Google連線的指示
下列範例顯示如何使用HTTP > 建立OAuth 2.0要求模組以連線至Google。
-
請確定您已建立專案、設定OAuth設定,並產生您的認證,如文章使用自訂OAuth使用者端將Adobe Workfront Fusion連線至 Google Services 中所述。
-
開啟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 9-row-2 10-row-2 layout-auto html-authored no-header 連線名稱 輸入此連線的名稱。 環境 選取您是使用生產或非生產環境。 類型 選取您是使用服務帳戶還是個人帳戶。 流程型別 授權碼 授權URI https://accounts.google.com/o/oauth2/v2/auth權杖URI https://www.googleapis.com/oauth2/v4/token範圍 新增個別範圍。 如需有關範圍的詳細資訊,請參閱Google檔案中的Google API的OAuth 2.O範圍。 範圍分隔符號 空格 用戶端 ID 輸入您的Google使用者端識別碼。
若要建立使用者端ID,請參閱文章Connect Adobe Workfront Fusion中的使用自訂OAuth使用者端建立至Google Services的OAuth認證。
用戶端密碼 輸入您的Google使用者端密碼。
若要建立使用者端密碼,請參閱文章Connect Adobe Workfront Fusion中的使用自訂OAuth使用者端建立Google服務的OAuth認證。
Authorize引數 新增
access_type-offline機碼值組。
注意:如果您遇到驗證問題(例如權杖重新整理時),請嘗試新增
prompt-consent金鑰值組。 -
按一下 繼續 以儲存連線設定。
設定發出OAuth 2.0請求模組
建立OAuth 2.0連線後,繼續視需要設定模組。 所有授權權杖會自動包含在此請求中,以及使用相同連線的任何其他請求中。
當您設定HTTP > 發出OAuth 2.0請求模組時,Workfront Fusion會顯示下列欄位。 在模組中,粗體標題表示那是必要欄位。
若在欄位或函式上方看到對應按鈕,可以使用按鈕設定該欄位的變數和函式。 如需詳細資訊,請參閱在Adobe Workfront Fusion中將資訊從一個模組對應到另一個模組。