다음을 사용하여 도구 인증을 구성합니다. AWS - AWS Tools for PowerShell

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

다음을 사용하여 도구 인증을 구성합니다. AWS

를 사용하여 개발할 AWS 때 코드가 인증되는 방식을 설정해야 합니다. AWS 서비스 AWS 리소스에 대한 프로그래밍 방식 액세스를 구성할 수 있는 방법은 환경 및 사용 가능한 AWS 액세스에 따라 다릅니다.

도구의 다양한 인증 방법을 보려면 AWS SDK 및 도구 참조 안내서의 인증 및 액세스를 참조하십시오. PowerShell

이 항목에서는 신규 사용자가 현지에서 개발 중이고 고용주로부터 인증 방법을 제공받지 않았으며 임시 자격 증명을 얻기 AWS IAM Identity Center 위해 사용할 것으로 가정합니다. 사용자 환경이 이러한 가정에 해당하지 않는 경우 이 주제의 일부 정보가 사용자에게 적용되지 않거나 일부 정보가 이미 제공되었을 수 있습니다.

이 환경을 구성하려면 몇 가지 단계를 수행해야 하며, 요약하면 다음과 같습니다.

IAM Identity Center 사용 및 구성

사용하려면 AWS IAM Identity Center먼저 활성화하고 구성해야 합니다. 이 작업을 수행하는 방법에 대한 자세한 내용은 AWS SDK 및 도구 참조 안내서의 IAM Identity Center 인증 항목의 1단계를 참조하십시오. PowerShell 특히 IAM Identity Center를 통한 액세스가 설정되어 있지 않습니다 아래에 있는 필요한 지침을 따르세요.

IAM ID 센터를 PowerShell 사용하기 위한 도구를 구성하십시오.

참고

도구 버전 4.1.538부터 SSO 자격 증명을 구성하고 AWS 액세스 포털 세션을 시작하는 데 권장되는 방법은 이 항목에 설명된 대로 Initialize-AWSSSOConfigurationInvoke-AWSSSOLogincmdlet을 사용하는 것입니다. PowerShell 해당 버전의 도구 PowerShell (또는 이후 버전) 에 액세스할 수 없거나 해당 cmdlet을 사용할 수 없는 경우에도 를 사용하여 이러한 작업을 수행할 수 있습니다. AWS CLI방법을 알아보려면 을 참조하십시오. 포털 AWS CLI 로그인에 사용

다음 절차는 도구에서 임시 자격 증명을 얻는 데 PowerShell 사용하는 SSO 정보로 공유 AWS config 파일을 업데이트합니다. 이 절차를 수행하면 AWS 액세스 포털 세션도 시작됩니다. 공유 config 파일에 이미 SSO 정보가 있고 도구를 사용하여 액세스 포털 세션을 시작하는 방법을 알고 싶다면 이 항목의 다음 섹션을 참조하십시오. PowerShell AWS 액세스 포털 세션 시작

  1. 아직 설치하지 않았다면 일반 cmdlet을 AWS Tools for PowerShell 포함하여 운영 체제와 환경에 맞게 파일을 열고 PowerShell 설치하십시오. 이를 위한 자세한 방법은 AWS Tools for PowerShell 설치 섹션을 참조하세요.

    예를 들어 Windows용 PowerShell 도구의 모듈화된 버전을 설치하는 경우 다음과 비슷한 명령을 실행할 가능성이 큽니다.

    Install-Module -Name AWS.Tools.Installer Install-AWSToolsModule AWS.Tools.Common
  2. 다음 명령을 실행합니다. 예제 속성 값을 IAM Identity Center 구성의 값으로 바꾸십시오. 이러한 속성과 검색 방법에 대한 자세한 내용은 AWS SDK 및 도구 참조 안내서의 IAM Identity Center 자격 증명 공급자 설정을 참조하십시오.

    $params = @{ ProfileName = 'my-sso-profile' AccountId = '111122223333' RoleName = 'SamplePermissionSet' SessionName = 'my-sso-session' StartUrl = 'https://provided-domain.awsapps.com/start' SSORegion = 'us-west-2' RegistrationScopes = 'sso:account:access' }; Initialize-AWSSSOConfiguration @params

    또는 cmdlet을 단독으로 사용해도 됩니다. 그러면 도구에 Initialize-AWSSSOConfiguration 속성 값을 PowerShell 입력하라는 메시지가 표시됩니다.

    특정 속성값에 대한 고려 사항:

    • 지침에 따라 IAM Identity Center를 활성화하고 구성한 경우 의 값은 다음과 같을 -RoleNamePowerUserAccess 있습니다. 하지만 PowerShell 업무용으로 특별히 IAM Identity Center 권한 세트를 생성한 경우에는 그 권한 세트를 대신 사용하십시오.

    • IAM ID 센터를 구성한 AWS 리전 곳에서 사용해야 합니다.

  3. 이때 공유 AWS config 파일에는 도구 항목에서 참조할 수 있는 구성 값 집합이 포함된 프로파일이 들어 있습니다. my-sso-profile PowerShell 이 파일의 위치를 찾으려면 AWS SDK 및 도구 참조 가이드에서 공유 파일의 위치를 참조하세요.

    Tools for PowerShell 에서는 요청을 보내기 전에 프로필의 SSO 토큰 공급자를 사용하여 자격 증명을 획득합니다. AWSsso_role_name값은 IAM Identity Center 권한 집합에 연결된 IAM 역할로, 애플리케이션에서 사용자에 대한 액세스를 허용해야 합니다. AWS 서비스

    다음 샘플은 위에 표시된 명령을 사용하여 만든 프로필을 보여줍니다. 일부 속성 값과 순서는 실제 프로필과 다를 수 있습니다. 프로필 sso-session 속성은 AWS 액세스 포털 세션을 시작하기 위한 설정이 포함된 이름이 지정된 my-sso-session 섹션을 나타냅니다.

    [profile my-sso-profile] sso_account_id=111122223333 sso_role_name=SamplePermissionSet sso_session=my-sso-session [sso-session my-sso-session] sso_region=us-west-2 sso_registration_scopes=sso:account:access sso_start_url=https://provided-domain.awsapps.com/start/
  4. 이미 활성 AWS 액세스 포털 세션이 있는 경우 도구에서 이미 로그인했음을 PowerShell 알려줍니다.

    그렇지 않은 경우 Tools for Tools를 사용하여 기본 웹 브라우저에서 SSO 인증 페이지를 자동으로 PowerShell 열려고 시도할 수 있습니다. 브라우저의 프롬프트를 따르십시오. 여기에는 SSO 인증 코드, 사용자 이름 및 암호, AWS IAM Identity Center 계정 및 권한 집합에 액세스할 수 있는 권한이 포함될 수 있습니다.

    의 도구는 SSO PowerShell 로그인에 성공했음을 알려줍니다.

AWS 액세스 포털 세션 시작

액세스 AWS 서비스명령을 실행하기 전에 도구에서 IAM Identity Center 인증을 사용하여 자격 증명을 PowerShell 확인할 수 있도록 활성 AWS 액세스 포털 세션이 필요합니다. AWS 액세스 포털에 로그인하려면 에서 PowerShell 다음 명령을 실행합니다. 여기서 -ProfileName my-sso-profile 는 이 항목의 이전 섹션에서 설명한 절차를 따랐을 때 공유 config 파일에 생성된 프로필의 이름입니다.

Invoke-AWSSSOLogin -ProfileName my-sso-profile

이미 활성 AWS 액세스 포털 세션이 있는 경우 도구에서 이미 로그인했음을 PowerShell 알려줍니다.

그렇지 않은 경우 Tools for Tools를 사용하여 기본 웹 브라우저에서 SSO 인증 페이지를 자동으로 PowerShell 열려고 시도할 수 있습니다. 브라우저의 프롬프트를 따르십시오. 여기에는 SSO 인증 코드, 사용자 이름 및 암호, AWS IAM Identity Center 계정 및 권한 집합에 액세스할 수 있는 권한이 포함될 수 있습니다.

의 도구는 SSO PowerShell 로그인에 성공했음을 알려줍니다.

이미 활성 세션이 있는지 테스트하려면 필요에 따라 AWS.Tools.SecurityToken 모듈을 설치하거나 가져온 후 다음 명령을 실행합니다.

Get-STSCallerIdentity -ProfileName my-sso-profile

Get-STSCallerIdentitycmdlet에 대한 응답은 공유 파일에 구성된 IAM Identity Center 계정 및 권한 집합을 보고합니다. config

다음은 도구에서 IAM ID 센터를 사용하는 방법의 예입니다. PowerShell 이 예제에서는 다음을 가정합니다.

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

  • Initialize-AWSSSOConfiguration또는 Invoke-AWSSSOLogin cmdlet을 통해 로그인할 때 사용자는 Amazon S3에 대해 최소한 읽기 전용 권한을 가집니다.

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

필요에 따라 AWS.Tools.S3 모듈을 설치하거나 가져온 후 다음 PowerShell 명령을 사용하여 S3 버킷 목록을 표시합니다.

Get-S3Bucket -ProfileName my-sso-profile

추가 정보

  • 프로필 및 환경 변수 사용과 같은 도구 인증에 대한 PowerShell 추가 옵션은 AWS SDK 및 도구 참조 안내서의 구성 장을 참조하십시오.

  • 일부 명령에는 AWS 지역을 지정해야 합니다. -Regioncmdlet 옵션, [default] 프로필, AWS_REGION 환경 변수 등 여러 가지 방법으로 이 작업을 수행할 수 있습니다. 자세한 내용은 이 안내서의 AWS 지역 지정하기 내용과 AWS SDK 및 도구 참조 안내서의 AWS 지역을 참조하십시오.

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

  • 단기 AWS 자격 증명을 생성하려면 IAM 사용 설명서의 임시 보안 자격 증명을 참조하십시오.

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