主資料夾格式 - Amazon AppStream 2.0

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

主資料夾格式

使用者資料夾的階層取決於使用者啟動串流工作階段的方式,如下列各節所述。

AWS SDKs和 AWS CLI

針對使用 CreateStreamingURLcreate-streaming-url 啟動的工作階段,使用者資料夾結構如下所示:

bucket-name/user/custom/user-id-SHA-256-hash/

其中,bucket-name 是在 Amazon S3 儲存貯體儲存中顯示的格式,user-id-SHA-256-hash 則是使用從傳遞給 CreateStreamingURL API 操作或 create-streaming-url 命令的 UserId 值中所產生小寫 SHA-256 雜湊十六進位字串建立的使用者專屬資料夾名稱。如需詳細資訊,請參閱 Amazon AppStream 2.0 API 參考中的 CreateStreamingURL,和 AWS CLI 命令參考中的 create-streaming-url

下列範例資料夾結構適用於使用 API 或 AWS CLI UserId testuser@mydomain.com 的工作階段存取,帳戶 ID 123456789012 位於美國西部 (奧勒岡) 區域 (us-west-2):

appstream2-36fb080bb8-us-west-2-123456789012/user/custom/a0bcb1da11f480d9b5b3e90f91243143eac04cfccfbdc777e740fab628a1cd13/

您可以使用網站或線上提供的開放原始碼編碼程式庫,產生 UserId 的小寫 SHA-256 雜湊值,來識別使用者的資料夾。

SAML 2.0

針對使用 SAML 聯合建立的工作階段,使用者資料夾的結構如下所示:

bucket-name/user/federated/user-id-SHA-256-hash/

在此案例中,user-id-SHA-256-hash 是使用從傳入 SAML 聯合請求的 NameID SAML 屬性值所產生小寫 SHA-256 雜湊十六進位字串建立的資料夾名稱。若要區別擁有相同名稱但屬於兩個不同網域的使用者,請附帶 NameID,以 domainname\username 的格式傳送 SAML 請求。如需詳細資訊,請參閱Amazon AppStream 2.0 與 2.0 SAML 整合

以下範例資料夾結構適用於使用 SAML 聯合進行的工作階段存取,其使用的 NameID 為 SAMPLEDOMAIN\testuser,帳戶 ID 123456789012,位於美國西部 (奧勒岡) 區域:

appstream2-36fb080bb8-us-west-2-123456789012/user/federated/8dd9a642f511609454d344d53cb861a71190e44fed2B8aF9fde0C507012a9901

當 NameID 字串的一部分或整個字串都是大寫時 (如範例中的網域名稱 SAMPLEDOMAIN),AppStream 2.0 會根據字串中使用的大寫產生雜湊值。使用此範例,SAMPLEDOMAIN\testuser 的雜湊值為 8DD9A642F511609454D344D53CB861A71190E44FED2B8AF9FDE0C507012A9901。在該使用者的資料夾中,此值會以小寫顯示如下:8dd9a642f511609454d344d53cb861a71190e44fed2B8aF9fde0C507012a9901。

您可以使用網站或線上可取得的開放原始碼編碼程式庫,產生 NameID 的 SHA-256 雜湊值,來識別使用者的資料夾。