API 시작하기 - Amazon Bedrock

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

API 시작하기

이 섹션에서는 AWS API를 통해 Amazon Bedrock 요청을 하도록 환경을 설정하는 방법을 설명합니다.는 다음 도구를 AWS 제공하여 경험을 간소화합니다.

  • AWS Command Line Interface (AWS CLI)

  • AWS SDKs

  • Amazon SageMaker AI 노트북

API를 시작하려면 프로그래밍 방식 액세스 권한을 부여하는 자격 증명이 필요합니다. 다음 섹션이 관련된 경우 해당 섹션을 확장하고 지침을 따릅니다. 그렇지 않으면 나머지 섹션을 진행합니다.

이 없는 경우 다음 단계를 AWS 계정완료하여 생성합니다.

에 가입하려면 AWS 계정
  1. https://portal.aws.amazon.com/billing/signup을 엽니다.

  2. 온라인 지시 사항을 따릅니다.

    등록 절차 중 전화를 받고 전화 키패드로 확인 코드를 입력하는 과정이 있습니다.

    에 가입하면 AWS 계정AWS 계정 루트 사용자이 생성됩니다. 루트 사용자에게는 계정의 모든 AWS 서비스 및 리소스에 액세스할 권한이 있습니다. 보안 모범 사례는 사용자에게 관리 액세스 권한을 할당하고, 루트 사용자만 사용하여 루트 사용자 액세스 권한이 필요한 작업을 수행하는 것입니다.

AWS 는 가입 프로세스가 완료된 후 확인 이메일을 보냅니다. 언제든지 https://aws.amazon.com/으로 이동하고 내 계정을 선택하여 현재 계정 활동을 보고 계정을 관리할 수 있습니다.

보안 AWS 계정 루트 사용자
  1. 루트 사용자를 선택하고 AWS 계정 이메일 주소를 입력하여 계정 소유자AWS Management Console로에 로그인합니다. 다음 페이지에서 비밀번호를 입력합니다.

    루트 사용자를 사용하여 로그인하는 데 도움이 필요하면 AWS 로그인 User Guide루트 사용자로 로그인을 참조하세요.

  2. 루트 사용자의 다중 인증(MFA)을 활성화합니다.

    지침은 IAM 사용 설명서AWS 계정 루트 사용자(콘솔)에 대한 가상 MFA 디바이스 활성화를 참조하세요.

를 설치하려면 설치의 단계를 AWS CLI따르거나 최신 버전의 로 업데이트 AWS CLI합니다.

AWS SDK를 설치하려면 Tools to Build on AWS에서 사용하려는 프로그래밍 언어에 해당하는 탭을 선택합니다. AWS 소프트웨어 개발 키트(SDKs)는 널리 사용되는 여러 프로그래밍 언어에 사용할 수 있습니다. 각 SDK는 개발자가 선호하는 언어로 애플리케이션을 쉽게 구축할 수 있도록 하는 API, 코드 예시 및 설명서를 제공합니다. SDK는 다음과 같은 유용한 작업을 자동으로 수행합니다.

  • 서비스 요청에 대한 암호화 서명

  • 요청 재시도

  • 오류 응답 처리

프로그래밍 방식 액세스 권한을 부여하는 자격 증명 가져오기

사용자는 AWS 외부에서와 상호 작용하려는 경우 프로그래밍 방식 액세스가 필요합니다 AWS Management Console. 프로그래밍 방식 액세스를 부여하는 방법은 액세스 중인 사용자 유형에 따라 다릅니다 AWS.

사용자에게 프로그래밍 방식 액세스 권한을 부여하려면 다음 옵션 중 하나를 선택합니다.

프로그래밍 방식 액세스가 필요한 보안 주체는 무엇입니까? To By
IAM 사용자 장기 보안 인증의 기간을 제한하여 AWS CLI, AWS SDKs 또는 AWS APIs.

사용하고자 하는 인터페이스에 대한 지침을 따릅니다.

IAM 역할 임시 자격 증명을 사용하여 AWS CLI, AWS SDKs 또는 AWS APIs. IAM 사용 설명서AWS 리소스와 함께 임시 자격 증명 사용의 지침을 따릅니다.

작업 인력 ID

(IAM Identity Center가 관리하는 사용자)

임시 자격 증명을 사용하여 AWS CLI, AWS SDKs 또는 AWS APIs.

사용하고자 하는 인터페이스에 대한 지침을 따릅니다.

IAM 사용자에 액세스 키를 사용하기로 결정한 경우,는 제한적인 인라인 정책을 포함하여 IAM 사용자에 대한 만료를 설정할 것을 AWS 권장합니다.

중요

다음 경고에 유의하세요.

  • 계정의 루트 자격 증명을 사용하여 AWS 리소스에 액세스하지 마세요. 이 보안 인증은 계정 액세스에 제한이 없고 취소하기 어렵습니다.

  • 금지 사항. 애플리케이션 파일에 리터럴 액세스 키나 보안 인증 정보를 넣지 않습니다. 이를 어기는 경우, 예를 들어 프로젝트를 퍼블릭 리포지토리에 업로드하면 뜻하지 않게 보안 인증이 노출될 위험이 있습니다.

  • 금지 사항. 프로젝트 영역에 보안 인증이 포함된 파일을 포함하지 마십시오.

  • 액세스 키를 안전하게 관리하세요. 계정 식별자를 찾는 데 도움이 되더라도 액세스 키를 권한 없는 당사자에게 제공하지 마세요. 이로 인해 다른 사람에게 계정에 대한 영구 액세스를 제공하게 될 수 있습니다.

  • 공유 자격 증명 파일에 저장된 모든 AWS 자격 증명은 일반 텍스트로 저장됩니다.

자세한 내용은의 AWS 액세스 키 관리 모범 사례를 참조하세요 AWS 일반 참조.

IAM 사용자를 생성합니다.
  1. AWS Management Console 홈 페이지에서 IAM 서비스를 선택하거나 https://console.aws.amazon.com/iam/ IAM 콘솔로 이동합니다.

  2. 탐색 창에서 사용자사용자 생성을 차례로 선택합니다.

  3. IAM 콘솔의 지침에 따라 프로그래밍 방식 사용자(에 대한 액세스 권한 없음 AWS Management Console)와 권한 없음을 설정합니다.

제한된 기간으로 사용자 액세스 제한

생성하는 모든 IAM 사용자 액세스 키는 장기 보안 인증 정보입니다. 이러한 자격 증명이 잘못 처리된 경우 만료되도록 하려면 키가 더 이상 유효하지 않은 날짜를 지정하는 인라인 정책을 생성하여 이러한 자격 증명을 시간 제한으로 만들 수 있습니다.

  1. 방금 생성한 IAM 사용자를 엽니다. 권한 탭에서 권한 추가를 선택한 다음 인라인 정책 생성을 선택합니다.

  2. JSON 편집기에서 다음 권한을 지정합니다. 이 정책을 사용하려면 예제 정책의 aws:CurrentTime 타임스탬프 값 값을 자체 종료일로 바꿉니다.

    참고

    IAM은 액세스 키를 12시간으로 제한할 것을 권장합니다.

    { "Version": "2012-10-17", "Statement": [ { "Effect": "Deny", "Action": "*", "Resource": "*", "Condition": { "DateGreaterThan": { "aws:CurrentTime": "2024-01-01T00:00:000" } } } ] }
액세스 키 생성
  1. 사용자 세부 정보 페이지에서 보안 자격 증명 탭을 선택합니다. 액세스 키 섹션에서 액세스 키 생성을 선택합니다.

  2. 이러한 액세스 키를 기타로 사용할 계획임을 표시하고 액세스 키 생성을 선택합니다.

  3. Retrieve access key page(액세스 키 검색) 페이지에서 Show(표시)를 선택하여 사용자의 비밀 액세스 키 값을 표시합니다. 자격 증명을 복사하거나 .csv 파일을 다운로드할 수 있습니다.

중요

이 IAM 사용자가 더 이상 필요하지 않은 경우 이를 제거하고 AWS 보안 모범 사례에 따라 액세스 시 AWS IAM Identity Center를 통해 임시 자격 증명을 사용하도록 인간 사용자에게 요구하는 것이 좋습니다 AWS.

사용자 또는 역할에 Amazon Bedrock 권한 연결

프로그래밍 방식 액세스를 위한 자격 증명을 설정한 후에는 사용자 또는 IAM 역할이 Amazon Bedrock 관련 작업 세트에 액세스할 수 있도록 권한을 구성해야 합니다. 이러한 권한을 설정하려면 다음을 수행합니다.

  1. AWS Management Console 홈 페이지에서 IAM 서비스를 선택하거나 https://console.aws.amazon.com/iam/ IAM 콘솔로 이동합니다.

  2. 사용자 또는 역할을 선택한 다음 사용자 또는 역할을 선택합니다.

  3. 권한 탭에서 권한 추가를 선택한 다음 AWS 관리형 정책 추가를 선택합니다. AmazonBedrockFullAccess AWS 관리형 정책을 선택합니다.

  4. 사용자 또는 역할이 모델을 구독하도록 허용하려면 인라인 정책 생성을 선택한 다음 JSON 편집기에서 다음 권한을 지정합니다.

    { "Version": "2012-10-17", "Statement": [ { "Sid": "MarketplaceBedrock", "Effect": "Allow", "Action": [ "aws-marketplace:ViewSubscriptions", "aws-marketplace:Unsubscribe", "aws-marketplace:Subscribe" ], "Resource": "*" } ] }

Amazon Bedrock 모델에 대한 액세스 요청

Amazon Bedrock 파운데이션 모델에 대한 액세스 요청의 단계에 따라 Amazon Bedrock 콘솔을 통해 Amazon Bedrock 모델에 대한 액세스를 요청합니다.

Amazon Bedrock에 API 호출 시도

모든 사전 조건을 충족한 후 다음 주제 중 하나를 선택하여 Amazon Bedrock 모델을 사용하여 모델 호출 요청을 테스트합니다.