AWS S3 模組

Adobe Workfront Fusion AWS S3模組可讓您對S3儲存貯體執行作業。

存取權要求

展開以檢視這篇文章中所述功能的存取權要求。
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 for Work Automation and Integration

產品 如果您的組織擁有 Select 或 Prime Workfront 封裝,但不包括 Workfront Automation and Integration,則您的組織必須購買 Adobe Workfront Fusion。

若要詳細了解此表格中的資訊,請參閱🔗文件中的存取權要求。

關於 Adobe Workfront Fusion 授權的資訊,請參閱 Adobe Workfront Fusion 授權。

先決條件

若要使用AWS S3模組,您必須有Amazon Web Service帳戶。

AWS S3 API資訊

AWS S3聯結器使用下列專案:

基礎 URL
code language-none
https://s3.{{parameters.region}}.amazonaws.com
API 標記
v1.5.21

將 AWS 連接至 Workfront Fusion connect-aws-to-workfront-fusion

使用同盟連線將AWS連線至Workfront Fusion

展開以檢視此連線型別的指示。

同盟連線可讓Workfront Fusion存取您的AWS帳戶,而不需要您在Fusion中建立IAM使用者或儲存存取金鑰。
而是要將Workfront Fusion註冊為AWS帳戶中的信任身分提供者,並設定允許哪一個Fusion連線使用特定IAM角色。 連線執行時,Fusion會顯示短暫的身分證明,而AWS會傳回自行過期的暫時憑證。 不會建立、儲存或旋轉任何長效金鑰。

note
NOTE
設定此連線需要兩次造訪AWS主控台。 您先建立角色,然後在Workfront Fusion中建立連線,然後返回AWS完成信任原則。 這是因為信任原則的一部分會識別一個特定連線,而該識別碼在建立連線之前並不存在。

使用同盟連線將AWS連線至Workfront Fusion的必要條件

若要建立此連線,您需要下列專案:

  • 在AWS IAM中建立身分提供者以及建立與編輯角色的許可權。 這通常表示原則或同等原則。 如果您沒有此存取權,請詢問雲端上的某人或
    安全團隊為您完成AWS步驟。
  • 能夠在Workfront Fusion中建立連線。

將Workfront Fusion新增為AWS中的身分提供者

此步驟會告知Workfront Fusion所發行的權杖值得信任。 您為每個AWS帳戶執行此動作一次。 如果您組織中的某人已新增此提供者,請跳至建立IAM角色。

  1. 登入AWS主控台,並移至​IAM > 身分識別服務提供者。

  2. 選取​新增提供者。

  3. 對於提供者型別,請選取​OpenID Connect。

  4. 在提供者URL中輸入下列內容,然後選取​取得指紋:

    code language-none
    https://oidc.automations.adobe.com
    
  5. 在對象中,輸入下列內容:

    code language-none
    sts.amazonaws.com
    
  6. 選取​新增提供者。

  7. 繼續建立IAM角色。

建立IAM角色

角色會定義在您的AWS帳戶中允許連線的功能。 您可以為每個連線建立一個角色,以便可以獨立授予和撤銷每個連線的存取權。

  1. 在IAM中,移至​ 角色 ​並選取​建立角色。

  2. 對於信任的實體型別,請選取​網頁身分識別。

  3. 在身分提供者中,選取oidc.automations.adobe.com。

  4. 在對象中,選取sts.amazonaws.com。

  5. 選取​下一步,然後附加此連線所需的許可權原則。
    僅授予連線實際使用的許可權。 例如,只讀取下列專案的連線:
    一個儲存貯體不需要AmazonS3FullAccess。

  6. 為角色提供一個清晰的、可辨識的名稱。 例如 WorkfrontFusionFederatedConnection。

  7. 選取​建立角色。

  8. 開啟您剛建立的角色,並從「摘要」區域複製其ARN。 看起來像這樣: arn:aws:iam::123456789012:role/WorkfrontFusionFederatedConnection

  9. 繼續在Workfront Fusion中建立連線。

在Workfront Fusion中建立連線

  1. 在模組的連線設定畫面中,選取同盟連線型別。
  2. 輸入您在建立IAM角色中複製的角色ARN。
  3. 選取「建立」。
    Workfront Fusion會顯示三個值。 您可以在下一個程式中使用它們。
table 0-row-2 1-row-2 2-row-2 html-authored no-header
核發者 一律為https://oidc.automations.adobe.com。 這符合您在AWS中新增的身分提供者。
主旨 識別這個連線。 它看起來像fusion:6e5b1c2a345bd8d1ed98b6b4f1459818:28964。 您建立的每個連線都不同。
客群 一律為sts.amazonaws.com。
  1. 請保持此面板開啟並複製主旨值。

    note
    NOTE
    請勿關閉面板或選取「取消」。 連線要等到您完成其餘程式後才會完成。 如果關閉面板,您必須刪除連線並重新開始,因為新的連線會收到新的主旨。
  2. 繼續將連線新增至角色的信任原則。

將連線新增至角色的信任原則

在您完成此程式之前,角色一般會信任Workfront Fusion,但尚未允許此特定連線使用它。

  1. 在新的瀏覽器標籤中,返回AWS主控台並開啟您建立的角色。

  2. 選取​ 信任關係 ​標籤,然後選取​編輯信任原則。

  3. 以下列專案取代原則,並以您自己的值取代:

    • 將123456789012取代為您的AWS帳戶ID
    • 將sub值取代為您從Workfront Fusion複製的主旨。
    code language-none
    {
      "Version": "2012-10-17",
      "Statement": [
        {
          "Effect": "Allow",
          "Principal": {
            "Federated": "arn:aws:iam::123456789012:oidc-provider/oidc.automations.adobe.com"
        },
        "Action": "sts:AssumeRoleWithWebIdentity", "Condition": {
         "StringEquals": {
           "oidc.automations.adobe.com:sub": "fusion:6e5b1c2a345bd8d1ed98b6b4f1459818:28964",
           "oidc.automations.adobe.com:aud": "sts.amazonaws.com"
         }
        }
       }
     ]
    }
    
  4. 選取​更新原則。

  5. 繼續驗證連線。

note tip
TIP
若要讓多個連線使用相同的角色,請將主體以陣列列出。 如果Token符合清單中的任一值,AWS可允許使用該角色:
code language-none
"oidc.automations.adobe.com:sub": [ "fusion:6e5b1c2a345bd8d1ed98b6b4f1459818:28964", "fusion:6e5b1c2a345bd8d1ed98b6b4f1459818:29011"
    ]
請勿以萬用字元取代子值。 如此一來,組織中的所有連線都能使用角色,包括其他人稍後建立的連線

驗證連線

  1. 返回Workfront Fusion瀏覽器索引標籤,其中連線面板仍處於開啟狀態。

  2. 按一下「儲存」。

    Workfront Fusion聯絡AWS,後者會檢查信任原則並傳回暫時憑證。 如果所有專案皆已正確設定,連線將會成功驗證,您可以繼續設定模組。
    如果驗證失敗,面板會保持開啟並顯示錯誤。 請更正AWS中的問題,然後再次選取「儲存」。 您不需要重新建立連線,而且主旨不會變更。

從這時開始,連線就會更新自己的認證。 沒有要旋轉的索引鍵,也沒有您需要維護的過期專案。

疑難排解

table 0-row-3 1-row-3 2-row-3 3-row-3 html-authored
錯誤 其含義 檢查內容
InvalidIdentityToken AWS無法比對權杖與已註冊的身分提供者。 請確認您已將「新增Workfront Fusion」中所述的身分提供者新增為AWS中的身分提供者,並確認其URL完全為https://oidc.automations.adobe.com,且沒有尾隨斜線。
AccessDenied擔任角色 身分提供者已註冊,但信任原則不符合此連線。 檢查信任原則中的子值是否為與Workfront Fusion中顯示的主旨相同的字元對字元,且aud為sts.amazonaws.com。 從不同連線複製的主體是最常見的原因。
連線可正常運作,之後會失敗 檢查角色的許可權原則是否已變更,或角色是否已刪除並重新建立。 重新建立角色不會變更其ARN,但會重設其信任原則。

使用API使用者將AWS連線至Workfront Fusion

展開以檢視此連線型別的指示。

若要將AWS S3連線至Workfront Fusion,您必須將您的AWS帳戶連線至Workfront Fusion。 若要這麼做,您必須先在AWS IAM中建立API使用者。

  1. 登入您的AWS IAM帳戶。

  2. 瀏覽至​識別與存取管理 > 存取管理 > 使用者。

  3. 按一下​新增使用者。

  4. 輸入新使用者的名稱,並在存取型別區段中選取​ 程式化存取 ​選項。

  5. 按一下​直接附加現有原則,然後在搜尋列中搜尋​AmazonS3FullAccess。 當它出現時,按一下它,然後按一下​下一步。

  6. 繼續其他對話方塊畫面,然後按一下[建立使用者]。​

  7. 複製提供的​ 存取金鑰識別碼 ​和​秘密存取金鑰。

  8. 前往Workfront Fusion並開啟AWS S3模組的​ 建立連線 ​對話方塊。

  9. 在步驟7的個別欄位中輸入存取金鑰識別碼和秘密存取金鑰,然後按一下[繼續]​以建立連線。

已建立連線。 您可以繼續設定模組。

AWS S3 模組及其欄位

當您設定 AWS S3 模組時,Workfront Fusion 會顯示下列欄位。 除了這些欄位以外,也可能因為其他因素,例如您在應用程式或服務中的存取層級,而顯示其他 AWS S3 欄位。 在模組中,粗體標題表示那是必要欄位。

若在欄位或函式上方看到對應按鈕,可以使用按鈕設定該欄位的變數和函式。 如需詳細資訊,請參閱將資訊從一個模組對應到另一個模組。

對應切換

動作

建立貯體

此動作模組會在AWS中建立貯體。

連線
關於將您的 AWS 帳戶連接至 Workfront Fusion 的說明,請參閱這篇文章中的將 AWS 連接至 Workfront Fusion。
名稱
輸入新儲存貯體的名稱。
區域
選取您的區域端點。 如需詳細資訊,請參閱AWS檔案中的區域端點。

取得檔案

此動作模組會從貯體下載檔案。

連線
關於將您的 AWS 帳戶連接至 Workfront Fusion 的說明,請參閱這篇文章中的將 AWS 連接至 Workfront Fusion。
區域
選取您的區域端點。 如需詳細資訊,請參閱AWS檔案中的區域端點。
Bucket
選取要從中下載檔案的貯體。
路徑
輸入檔案的路徑。 範例:/photos/2019/February/image023.jpg。

進行API呼叫

此動作模組會對AWS S3 API進行自訂呼叫。

如需Amazon S3 API的詳細討論,請參閱Amazon S3 REST API簡介。

連線
關於將您的 AWS 帳戶連接至 Workfront Fusion 的說明,請參閱這篇文章中的將 AWS 連接至 Workfront Fusion。
區域
選取您的區域端點。 如需詳細資訊,請參閱AWS檔案中的區域端點。
URL
輸入主機URL。 路徑必須相對於 https://s3.<selected-region>.amazonaws.com/。
方法

選取設定API呼叫所需的HTTP要求方法。 如需詳細資訊,請參閱Adobe Workfront Fusion中的HTTP要求方法。

標頭

新增請求標頭。 對於每個要新增的標頭,按一下 新增專案 並輸入標頭。 您可以使用以下常見的請求標頭。 如需更多要求標頭,請參閱AWS S3 API檔案。

Workfront Fusion 會自動新增授權標頭。

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 layout-auto
標頭名稱 說明
Content-Length 根據RFC 2616的訊息長度(沒有標頭)。 載入XML的PUT和作業(例如記錄和ACL)需要此標頭。
Content-Type 資源的內容型別(若請求內容位於內文中)。 範例:text/plain。
Content-MD5 根據RFC 1864,訊息的base64已編碼128位元MD5摘要(沒有標頭)。 此標頭可用作訊息完整性檢查,以確認資料與原來傳送的資料相同。 雖然這是選擇性的,但建議您使用Content-MD5機製作為端對端的完整性檢查。 如需REST要求驗證的詳細資訊,請參閱AWS檔案中的簽署及驗證REST要求。
日期 根據請求者的目前日期和時間。 範例:Wed, 01 Mar 2006 12:00:00 GMT。 當您指定Authorization 標頭時,必須指定x-amz-date或Date 標頭。
Expect

當您的應用程式使用100-continue時,它會在收到確認後才傳送要求內文。 如果郵件根據標題遭到拒絕,則不會傳送郵件內文。 此標頭只有在傳送內文時才能使用。

有效值: 100-continue

主機

對於路徑樣式要求,值為s3.amazonaws.com。 對於虛擬樣式要求,值為BucketName.s3.amazonaws.com。 如需詳細資訊,請參閱AWS檔案中的虛擬託管。

HTTP 1.1需要此標頭(大部分的Toolkit會自動新增此標頭);HTTP/1.0要求則選填。

x-amz-content-sha256 使用簽名版本4驗證請求時,此標頭會提供請求承載的雜湊。 以區塊上傳物件時,請將值設為STREAMING-AWS4-HMAC-SHA256-PAYLOAD,表示簽章僅涵蓋標題且沒有裝載。 如需詳細資訊,請參閱AWS檔案中的授權標頭的簽章計算。
x-amz-date 根據請求者的目前日期和時間。 範例:Wed, 01 Mar 2006 12:00:00 GMT。 當您指定Authorization 標頭時,必須指定x-amz-date或Date 標頭。 如果您同時指定兩者,則以x-amz-date標頭指定的值優先。
x-amz-security-token

此標題可用於下列情況:

  • 提供Amazon DevPay作業的安全性權杖。 每個使用Amazon DevPay的請求都需要兩個x-amz-security-token標頭:一個用於產品權杖,另一個用於使用者權杖。 當Amazon S3收到驗證要求時,會將計算的簽章與提供的簽章做比較。 用來計算簽章的多值標頭格式不正確,可能會導致驗證問題。
  • 提供使用臨時安全性憑證時的安全性權杖。 使用您從IAM取得的臨時安全性認證提出請求時,您必須使用此標頭提供安全性權杖。 若要深入瞭解臨時安全性認證,請前往提出要求。

使用Amazon DevPay的請求和使用臨時安全性認證簽署的請求需要此標頭。

查詢字串
新增所需的查詢字串,例如引數或表單欄位。
正文

以標準 JSON 物件的形式新增 API 呼叫的正文內容。

注意:

在 JSON 中使用條件陳述式 (例如 if) 時,請將引號放在條件陳述式的外面。

上傳檔案

此動作模組會將檔案上傳至AWS S3貯體。

連線
關於將您的 AWS 帳戶連接至 Workfront Fusion 的說明,請參閱這篇文章中的將 AWS 連接至 Workfront Fusion。
區域
選取您的區域端點。 如需詳細資訊,請參閱AWS檔案中的區域端點。
資料夾
指定您要上傳檔案的目標資料夾。
來源檔案
從先前的模組中選取來源檔案,或對應來源檔案的名稱和資料。
Headers (選擇性)

針對您要新增的每個標頭,按一下 新增專案 並輸入標頭的鍵和值。

如需可用的標頭,請參閱AWS檔案中的PutObject。

搜尋

列出檔案

從指定位置傳回檔案清單。

連線
關於將您的 AWS 帳戶連接至 Workfront Fusion 的說明,請參閱這篇文章中的將 AWS 連接至 Workfront Fusion。
區域
選取您的區域端點。 如需詳細資訊,請參閱AWS檔案中的區域端點。
Bucket
選取您要搜尋檔案的Amazon S3儲存貯體。
前置詞
輸入要在其中查閱檔案之資料夾的路徑,例如 workfrontfusion/work.

列出資料夾

從指定位置傳回資料夾清單。

連線
關於將您的 AWS 帳戶連接至 Workfront Fusion 的說明,請參閱這篇文章中的將 AWS 連接至 Workfront Fusion。
區域
選取您的區域端點。 如需詳細資訊,請參閱AWS檔案中的區域端點。
Bucket
選取您要搜尋資料夾的Amazon S3貯體。
前置詞 (選擇性)
要在其中查閱資料夾的資料夾路徑,例如 workfrontfusion/work.
recommendation-more-help
workfront-fusion-help-workfront-fusion