기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# Home 폴더 형식
<a name="home-folders-admin-folders"></a>

다음 섹션에서 설명한 것처럼 사용자 폴더의 계층 구조는 사용자가 스트리밍 세션을 시작하는 방법에 따라 다릅니다.

## AWS SDKs 및 AWS CLI
<a name="home-folders-admin-folders-aws"></a>

`CreateStreamingURL` 또는 `create-streaming-url`을 사용하여 시작한 세션의 경우 사용자 폴더 구조는 다음과 같습니다.

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

여기서 `bucket-name`은 [Amazon S3 버킷 스토리지](home-folders-s3.md)에 표시된 형식이고 `user-id-SHA-256-hash`는 CreateStreamingURL API 작업 또는 `UserId` 명령에 전달된 `create-streaming-url` 값에서 생성된 소문자 SHA-256 16진수 문자열을 사용하여 만든 사용자별 폴더 이름입니다. 자세한 내용은 Amazon WorkSpaces 애플리케이션 API 참조의 [CreateStreamingURL](https://docs.aws.amazon.com/appstream2/latest/APIReference/API_CreateStreamingURL.html) 및 *AWS CLI 명령* 참조의 [create-streaming-url](https://docs.aws.amazon.com/cli/latest/reference/appstream/create-streaming-url.html)을 참조하세요. *Amazon WorkSpaces * 

다음 예제 폴더 구조는 API를 사용하거나 미국 `UserId` 서부(오레곤) 리전(us-west-2)의 계정 ID 123456789012인 testuser@mydomain.com을 AWS CLI 사용하여 세션 액세스에 적용됩니다.

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

온라인에서 사용할 수 있는 웹 사이트 또는 오픈 소스 코딩 라이브러리를 사용하여 `UserId`의 소문자 SHA-256 해시 값을 생성함으로써 사용자의 폴더를 식별할 수 있습니다.

## SAML 2.0
<a name="home-folders-admin-folders-saml"></a>

SAML 연동을 사용하여 생성된 세션의 경우 사용자 폴더 구조는 다음과 같습니다.

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

여기서 `user-id-SHA-256-hash`는 SAML 연동 요청에서 전달된 `NameID` SAML 속성 값으로 생성된 소문자 SHA-256 16진수 문자열을 사용하여 만든 폴더 이름입니다. 서로 다른 두 도메인에 속한 동일한 이름을 가진 사용자를 구별하려면 `domainname\username` 형식의 `NameID`를 통해 SAML 요청을 보냅니다. 자세한 내용은 [Amazon WorkSpaces 애플리케이션과 SAML 2.0 통합](external-identity-providers.md) 단원을 참조하십시오.

다음 예제 폴더 구조는 미국 서부(오리건) 리전의 `NameID` SAMPLEDOMAIN\$1testuser, 계정 ID 123456789012의 SAML 연동을 사용하여 세션 액세스에 적용됩니다.

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

NameID 문자열의 일부 또는 전부가 대문자로 표시된 경우(도메인 이름 *SAMPLEDOMAIN*이 예제에 나와 있으므로) WorkSpaces 애플리케이션은 문자열에 사용된 대문자를 기반으로 해시 값을 생성합니다. 이 예제를 사용하여 SAMPLEDOMAIN\$1testuser의 해시 값은 8DD9A642F511609454D344D53CB861A71190E44FED2B8AF9FDE0C507012A9901입니다. 해당 사용자의 폴더에서 이 값은 8dd9a642f511609454d344d53cb861a71190e44fed2B8aF9fde0C507012a9901과 같이 소문자로 표시됩니다.

온라인에서 사용할 수 있는 웹 사이트 또는 오픈 소스 코딩 라이브러리를 사용하여 `NameID`의 SHA-256 해시 값을 생성함으로써 사용자의 폴더를 식별할 수 있습니다.