포털 로그인에 AWS CLI 사용 - AWS Tools for PowerShell (버전 4)
AWS CLI를 통해 Tools for PowerShell이 IAM Identity Center를 사용하도록 구성합니다.AWS 액세스 포털 세션 시작예시추가 정보

버전 5(V5) AWS Tools for PowerShell 가 릴리스되었습니다.

새 버전의 도구 사용을 시작하려면 AWS Tools for PowerShell 사용 설명서(V5), 특히 V5로 마이그레이션 주제를 참조하세요.

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

포털 로그인에 AWS CLI 사용

Tools for PowerShell의 버전 4.1.538부터 SSO 자격 증명을 구성하고 AWS 액세스 포털 세션을 시작하는 데 권장되는 방법은 AWS를 사용하여 도구 인증 구성에 설명된 대로 Initialize-AWSSSOConfiguration 및 Invoke-AWSSSOLogin cmdlet을 사용하는 것입니다. 해당 버전의 Tools for PowerShell(또는 이후 버전)에 액세스할 수 없거나 이러한 cmdlet을 사용할 수 없는 경우에도 AWS CLI를 사용하여 이러한 작업을 수행할 수 있습니다.

AWS CLI를 통해 Tools for PowerShell이 IAM Identity Center를 사용하도록 구성합니다.

아직 활성화하지 않은 경우 계속하기 전에 IAM Identity Center를 활성화하고 구성해야 합니다.

AWS CLI를 통해 IAM Identity Center를 사용하도록 Tools for PowerShell을 구성하는 방법에 대한 정보는 AWS SDK 및 도구 참조 가이드의 IAM Identity Center 인증에 대한 항목의 2단계에 나와 있습니다. 이 구성을 완료하면 시스템에 다음 요소가 포함되어야 합니다.

  • AWS CLI는 애플리케이션을 실행하기 전에 AWS 액세스 포털 세션을 시작하는 데 사용합니다.

  • PowerShell용 도구에서 참조할 수 있는 구성 값 집합이 있는 [default] 프로필이 포함된 공유 AWS config 파일입니다. 이 파일의 위치를 찾으려면 AWS SDK 및 도구 참조 가이드에서 공유 파일의 위치를 참조하세요. PowerShell용 도구는 AWS에 요청을 보내기 전에 프로필의 SSO 토큰 공급자를 사용하여 자격 증명을 얻습니다. sso_role_name 값은 IAM 신원 센터 권한 집합에 연결된 IAM 역할로, 애플리케이션에서 사용되는 AWS 서비스 서비스에 대한 액세스를 허용해야 합니다.

    다음 샘플 config 파일은 SSO 토큰 공급자 구성으로 설정된 [default] 프로필을 보여줍니다. 프로필의 sso_session 설정은 이름이 지정된 sso-session 섹션을 참조합니다. sso-session 섹션에는 AWS 액세스 포털 세션을 시작하기 위한 설정이 포함되어 있습니다.

    [default]
sso_session = my-sso
sso_account_id = 111122223333
sso_role_name = SampleRole
region = us-east-1
output = json

[sso-session my-sso]
sso_region = us-east-1
sso_start_url = https://provided-domain.awsapps.com/start
sso_registration_scopes = sso:account:access
중요

SSO 확인이 작동하려면 PowerShell 세션에 다음 모듈이 설치되어 있고 가져와야 합니다.

  • AWS.Tools.SSO

  • AWS.Tools.SSOOIDC

이전 버전의 Tools for PowerShell을 사용하고 있으며 이러한 모듈이 없는 경우 ‘Assembly AWSSDK.SSOOIDC could not be found...’와 유사한 오류가 발생합니다.

AWS 액세스 포털 세션 시작

AWS 서비스에 액세스하는 명령을 실행하기 전에 Tools for Windows PowerShell에서 IAM Identity Center 인증을 사용하여 보안 인증을 확인하려면 활성 AWS 액세스 포털 세션이 있어야 합니다. 구성된 세션 길이에 따라 결국 액세스가 만료되고 Windows PowerShell용 도구에 인증 오류가 발생합니다. AWS 액세스 포털에 로그인하려면 AWS CLI에서 다음 명령을 실행합니다.

aws sso login

[default] 프로필을 사용하므로 --profile 옵션으로 명령을 직접 호출할 필요가 없습니다. SSO 토큰 공급자 구성에서 명명된 프로필을 사용하는 경우 aws sso login --profile named-profile 명령을 대신 사용합니다. 이름이 지정된 프로필에 대한 자세한 내용은 AWS SDK 및 도구 참조 안내서의 프로필 섹션을 참조하세요.

이미 활성 세션이 있는지 테스트하려면 다음 AWS CLI 명령을 실행합니다(명명된 프로필에 대해 동일한 고려 사항 사용).

aws sts get-caller-identity

이 명령에 대한 응답은 공유 config 파일에 구성된 IAM Identity Center 계정 및 권한 집합을 보고해야 합니다.

참고

이미 활성 AWS 액세스 포털 세션이 있고 aws sso login을 실행하는 경우 보안 인증 정보를 제공하지 않아도 됩니다.

로그인 과정에서 데이터 AWS CLI 액세스를 허용하라는 메시지가 표시될 수 있습니다. AWS CLI는 Python용 SDK를 기반으로 구축되므로 권한 메시지에는 botocore 이름의 변형이 포함될 수 있습니다.

예시

다음은 PowerShell용 도구와 함께 IAM Identity Center를 사용하는 방법의 예제입니다. 이 예제에서는 다음을 가정합니다.

  • 이 주제의 앞부분에서 설명한 대로 IAM Identity Center를 사용하도록 설정하고 구성했습니다. SSO 속성은 [default] 프로필에 있습니다.

  • aws sso login을 사용하여 AWS CLI를 통해 로그인하는 경우 해당 사용자는 최소한 Amazon S3에 대한 읽기 전용 권한이 있습니다.

  • 해당 사용자는 일부 S3 버킷을 볼 수 있습니다.

다음 PowerShell 명령을 사용하여 S3 버킷 목록을 표시합니다.

Install-Module AWS.Tools.Installer
Install-AWSToolsModule S3
# And if using an older version of the AWS Tools for PowerShell:
Install-AWSToolsModule SSO, SSOOIDC

# In older versions of the AWS Tools for PowerShell, we're not invoking a cmdlet from these modules directly, 
# so we must import them explicitly:
Import-Module AWS.Tools.SSO
Import-Module AWS.Tools.SSOOIDC

# Older versions of the AWS Tools for PowerShell don't support the SSO login flow, so login with the CLI
aws sso login

# Now we can invoke cmdlets using the SSO profile
Get-S3Bucket

위에서 언급한 것처럼 [default] 프로필을 사용하므로 -ProfileName 옵션을 사용하여 Get-S3Bucket cmdlet을 직접 호출할 필요가 없습니다. SSO 토큰 공급자 구성에서 명명된 프로필을 사용하는 경우 Get-S3Bucket -ProfileName named-profile 명령을 사용합니다. 이름이 지정된 프로필에 대한 자세한 내용은 AWS SDK 및 도구 참조 안내서의 프로필 섹션을 참조하세요.

추가 정보

  • 프로필 및 환경 변수 사용과 같은 PowerShell용 도구 인증에 대한 자세한 옵션은 AWS SDK 및 도구 참조 가이드의 구성 장을 참조하세요.

  • 일부 명령은 AWS 리전을 지정해야 합니다. -Region cmdlet 옵션, [default] 프로필, AWS_REGION 환경 변수 등 여러 가지 방법으로 이를 수행할 수 있습니다. 자세한 정보는 이 가이드의 AWS 리전 지정 섹션과 AWS SDK 및 도구 참조 가이드의 AWS 리전을 참조하세요.

  • 모범 사례에 대해 자세히 알아보려면 IAM 사용 설명서에서 IAM의 보안 모범 사례를 참조하세요.

  • 단기 AWS 보안 인증 정보를 만들려면 IAM 사용 설명서에서 임시 보안 인증 정보를 참조하세요.

  • 다른 보안 인증 공급자에 대해 알아보려면 AWS SDK 및 도구 참조 가이드에서 표준화된 보안 인증 공급자를 참조하세요.