文件WorkfrontWorkfront 指南

HTTP > 提出OAuth 2.0請求 模組

Last update: Fri Feb 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 主題：

建立對象：

  • undefined
NOTE
Adobe Workfront Fusion 需要 Adobe Workfront Fusion 除了授權之外， Adobe Workfront 授權。

為了進行 Adobe Workfront Fusion HTTP(S)請求傳送至需要OAuth 2.0授權的伺服器，您首先需要建立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 授權*
計畫，工作
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請求 模組

  1. 在中建立OAuth使用者端 target 您想要使用的服務 Adobe Workfront Fusion 以進行通訊。 此選項很可能位於 開發人員 特定服務的區段。

    1. 建立使用者端時，請在 Redirect URL 或 Callback 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

    2. 建立使用者端後，指定的服務會顯示2個金鑰： Client ID 和 Client Secret. 有些服務會呼叫這些專案 App Key 和 App Secret . 將金鑰和秘密儲存在安全位置，以便您在Workfront Fusion中建立連線時提供它們。

  2. 尋找 Authorize URI 和 Token URI 在指定服務的API檔案中。 這些是URL位址，透過 Workfront Fusion 與 target 服務。 這些位址用於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

  3. （視條件而定）如果目標服務使用範圍（存取許可權），請檢查服務如何分隔個別範圍，並確定您在進階設定中相應地設定分隔符號。 如果分隔符號未正確設定， Workfront Fusion 無法建立連線，且您收到無效的範圍錯誤。

  4. 完成上述步驟後，您就可以開始在中建立OAuth連線 Workfront Fusion. 將OAuth 2.0 HTTP(S)請求和回應處理模組新增至您的案例。

  5. 在模組的「連線」欄位中，按一下 新增.

  6. 填寫以下欄位以建立連線：

    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
    連線名稱 輸入連線的名稱。
    流程型別

    選取取得權杖的流程。

    • 授權碼：輸入 Authorize URI 和 Token URI 來自服務的API檔案。
    • Implicit：輸入 Authorize URI 來自服務的API檔案。
    範圍 新增個別範圍。 您可以在特定服務的開發人員(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
      EMEA 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
      EMEA https://app-eu.workfrontfusion.com/oauth/cb/oauth2

    • client_id：您在建立帳戶時收到的使用者端ID會自動包含在要求內文中

    • client_secret：您在建立帳戶時收到的使用者端密碼會自動包含在要求內文中

    • 程式碼：授權請求傳回的代碼

    注意：

    OAuth 2.0標準在此步驟期間支援至少2種使用者端驗證方法(client_secret_basic 和 client_secret_post)。 Workfront Fusion 透過，自動傳送指定的使用者端ID和密碼 client_secret_post 方法。 因此，這些引數會自動包含在權杖請求內文中。

    如需有關OAuth 2.0驗證的詳細資訊，請參閱 OAuth 2.0授權架構.
    重新整理權杖引數

    新增您要包含在Token呼叫中的任何引數。 下列標準引數一律會自動納入，不需要新增。

    標準引數：

    • grant_type： refresh_token

    • refresh_token：您所連線的服務所取得的最新重新整理權杖

    • client_id：您在建立帳戶時收到的使用者端ID會自動包含在要求內文中

    • client_secret：您在建立帳戶時收到的使用者端密碼會自動包含在要求內文中

    注意：

    OAuth 2.0標準在此步驟期間支援至少2種使用者端驗證方法(client_secret_basic 和 client_secret_post)。 Workfront Fusion 透過，自動傳送指定的使用者端ID和密碼 client_secret_post 方法。 因此，這些引數會自動包含在權杖請求內文中。

    如需有關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.

  7. 按一下 繼續 以儲存連線設定。

  8. 繼續至 OAuth 2.0要求模組設定.

建立與的連線的指示 Google 在 HTTP >建立OAuth 2.0請求模組

下列範例顯示如何使用 HTTP > 建立OAuth 2.0 要連線的要求模組 Google.

  1. 請確定您已建立專案、設定OAuth設定並產生您的認證，如所述 連線 Adobe Workfront Fusion 至 Google Services 使用自訂Oauth使用者端.

  2. 開啟 HTTP >提出OAuth 2.0請求 模組。

  3. 按一下 新增 連線方塊旁。

  4. 輸入下列值：

    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
    連線名稱 輸入連線的名稱。
    流程型別 授權碼
    授權URI https://accounts.google.com/o/oauth2/v2/auth
    權杖URI https://www.googleapis.com/oauth2/v4/token
    範圍 新增個別範圍。 如需有關範圍的詳細資訊，請參閱 OAuth 2.O範圍 Google API 在 Google 檔案。
    範圍分隔符號 空格
    使用者端ID

    輸入您的 Google 使用者端ID。

    若要建立使用者端ID，請參閱 建立OAuth認證 在 Connect Adobe Workfront Fusion 至 Google Services 使用自訂Oauth使用者端.
    使用者端密碼

    輸入您的 Google 使用者端密碼。

    若要建立使用者端密碼，請參閱 建立OAuth認證 在 Connect Adobe Workfront Fusion 至 Google 使用自訂OAuth使用者端的服務.
    Authorize引數

    新增 access_type - offline 機碼值組。

    注意：如果您遇到驗證問題（例如重新整理權杖），請嘗試新增 prompt - consent 機碼值組。

  5. 按一下 繼續 以儲存連線設定。

  6. 繼續至 OAuth 2.0要求模組設定.

連線說明 Microsoft Graph API 透過 HTTP > 提出OAuth 2.0請求 模組

有關指示 Microsoft Graph API，請參閱 呼叫 MS Graph REST API 透過 Adobe Workfront Fusion HTTP > 提出OAuth 2.0請求 模組.

OAuth 2.0要求模組設定

當您建立 Oauth 2.0連線，如中所述 為建立連線 OAuth 請求，繼續視需要設定模組。 所有授權權杖會自動包含在此請求中，以及使用相同連線的任何其他請求中。

當您設定 HTTP >提出OAuth 2.0請求 模組， Workfront Fusion 顯示下列欄位。 模組中的粗體標題表示必填欄位。

如果您在欄位或函式上方看到對應按鈕，則可以使用它來設定該欄位的變數和函式。 如需詳細資訊，請參閱 在中將資訊從一個模組對應到另一個模組 Adobe Workfront Fusion.

Connection
如需有關設定連線的資訊，請參閱 建立OAuth要求的連線 本文章內容。
[！UICONTROL將所有狀態評估為錯誤（2xx和3xx除外）

使用此選項來設定錯誤處理。

如需詳細資訊，請參閱 中的錯誤處理 Adobe Workfront Fusion.

URL
輸入您要傳送請求的URL，例如API端點、網站等。
方法
選取設定API呼叫所需的HTTP要求方法。 如需詳細資訊，請參閱 中的HTTP要求方法 Adobe Workfront Fusion.
Headers
以標準JSON物件的形式新增請求的標頭。 例如， {"Content-type":"application/json"}
查詢字串
輸入所需的查詢索引鍵/值組。
主體型別

HTTP內文是HTTP交易訊息中傳輸的資料位元組，緊接在標題之後（如果有任何要使用的話）。

  • Raw

    Raw內文型別通常適用於大多數HTTP內文要求，即使在開發人員檔案未指定要傳送的資料的情況下亦然。

    在Content type欄位中指定剖析資料的表單。

    儘管選取了內容型別，資料仍會以開發人員檔案規定或要求的任何格式輸入。

  • Application/x-www-form-urlencoded

    此內文型別使用來POST資料 application/x-www-form-urlencoded.

    的 application/x-www-form-urlencoded，傳送至伺服器的HTTP訊息本文基本上是一個查詢字串。 索引鍵和值會以分隔的索引鍵/值組進行編碼 & 和 = 介於鍵和值之間。

    針對二進位資料， use multipart/form-data 而非。

    範例：

    產生的HTTP要求格式範例：

    field1=value1&field2=value2

  • Multipart/form-data

    Multipart/form-data是用於傳送檔案和資料的HTTP多部分要求。 它通常用於將檔案上傳到伺服器。

    新增要在請求中傳送的欄位。 每個欄位都必須包含索引鍵值配對。

    • Text

      輸入要在要求內文中傳送的索引鍵和值。

    • 檔案

      輸入金鑰，並指定您要在要求內文中傳送的來源檔案。

      從上一個模組對應您要上傳的檔案(例如HTTP >Get a File或Google Drive >Download a File)，或手動輸入檔案名稱和檔案資料。

剖析回應

啟用此選項可自動剖析回應並轉換JSON和XML回應，因此您不需要使用JSON > Parse JSON或XML > Parse XML模組。

在使用剖析JSON或XML內容之前，請手動執行一次模組，以便模組可以識別回應內容並允許您將它對應到後續模組中。

逾時
輸入請求逾時秒數(1-300)。 預設值為40秒。
與其他HTTP模組共用Cookie
啟用此選項即可將伺服器的Cookie與案例中的所有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. 啟動此選項以停用此功能。
要求壓縮內容

啟用此選項以請求網站的壓縮版本。

這會新增 Accept-Encoding 標頭來請求壓縮的內容。

使用雙向TLS

啟用此選項以在HTTP請求中使用雙向TLS。

如需雙向TLS的詳細資訊，請參閱 在的HTTP模組中使用雙向TLS Adobe Workfront Fusion.

recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43