AWS API에 앱 연결하기

Lovable 앱에서 EC2, DynamoDB, Lambda, SQS, CloudWatch 같은 모든 Amazon Web Services API를 호출하도록 앱을 AWS API에 연결합니다.

Amazon Web Services(AWS)는 컴퓨트, 스토리지, 데이터베이스, 메시징, 모니터링 서비스를 제공하는 클라우드 플랫폼입니다. AWS API 커넥터를 사용하면 Lovable 앱이 AWS 계정의 IAM access key로 EC2, DynamoDB, Lambda, SQS, CloudWatch 등 모든 AWS 서비스의 API를 호출할 수 있습니다. 직접 관리하는 AWS 계정의 리소스를 읽거나 관리하는 내부 도구와 대시보드를 위해 설계되었습니다.

AWS API는 앱 + 채팅 커넥터로 제공됩니다. 하나의 공유 연결이 Chats, 빌드 중 프로젝트 채팅, 게시된 앱에서 모두 동작합니다.

AWS API를 연결하면 앱은 다음 작업이 가능합니다.

• EC2 인스턴스, DynamoDB 테이블, Lambda 함수처럼 계정 전반의 리소스를 나열하고 상세 정보 확인
• 대시보드와 보고서에 쓸 CloudWatch 지표와 로그 읽기
• DynamoDB 테이블의 항목 읽기·쓰기
• Lambda 함수 호출과 SQS 큐로 메시지 전송
• 요청할 때, 연결한 IAM 정책 범위 안에서 리소스 생성·변경·삭제
• 교차 계정 접근을 위해 다른 AWS 계정의 역할 수임

주요 활용 사례 및 예시 앱

다음 예시는 AWS API로 무엇을 만들 수 있는지 보여줍니다. 각 항목에는 시작용 프롬프트가 포함되어 있습니다.

AWS API 연결 방식

각 AWS API 연결은 하나의 IAM access key와 기본 리전을 사용하며, 워크스페이스의 여러 프로젝트가 이를 공유할 수 있습니다. Lovable의 커넥터 게이트웨이가 모든 요청을 그 키로 서명해 앱이 지정한 AWS 서비스로 전달하므로, 키는 서버에 남고 게시된 앱에는 전달되지 않습니다. IAM, Route 53, CloudFront, Organizations, AWS Budgets, Cost Explorer 같은 글로벌 서비스는 리전을 무시하고 각자의 글로벌 엔드포인트로 라우팅됩니다.

커넥터는 연결이 접근할 수 있는 서비스나 작업을 제한하지 않으며, 읽기·쓰기를 구분하지도 않습니다. access key에 적용된 IAM 정책이 유일한 통제 수단입니다. 그 키로 할 수 있는 일은 이 연결로 빌드한 앱도 할 수 있습니다. 정책을 앱에 필요한 서비스와 작업으로 정확히 한정하고, 가능하면 읽기 전용으로 만드세요.

프로젝트 채팅에서 이 연결로 빌드할 때 Lovable은 다음과 같이 동작합니다.

• Lovable은 기본적으로 읽기 전용 기능을 빌드하며, 리소스를 생성·변경·삭제하는 호출은 요청할 때만 추가합니다.
• 계정을 변경하는 호출을 추가하기 전에 Lovable은 무엇을 생성·수정·삭제하며 비용이 얼마인지 밝히고 확인을 요청합니다.
• Lovable은 리소스 생성을 반복문, 스케줄, 사용자별 트리거가 아니라 사용자가 확인하는 단일 작업으로 빌드합니다.
• AWS가 호출을 거부하면 Lovable은 재시도하지 않고 부여해야 할 IAM 작업을 알려 줍니다.

AWS API 연결 방법

AWS API 연결을 만들 수 있는 사람은 플랜과 워크스페이스 설정에 따라 달라집니다. 앱 + 채팅 커넥터는 Free, Pro, Business 플랜에서 기본으로 제공됩니다. Enterprise 플랜에서는 처음에 사실상 비활성화되어 있습니다. admin이 Connectors → Admin settings → App + chat connectors에서 바꾸기 전까지 연결과 클라이언트를 만들 수 있는 사람의 기본값은 No one입니다.

서로 다른 IAM access key로 AWS API 연결을 여러 개 만들 수 있습니다. AWS 계정이나 개발·프로덕션 같은 환경을 분리할 때 유용합니다.

연결을 만들면 사용하려는 프로젝트에 연결을 링크할 수 있습니다. 프로젝트에서 빌드하는 사람은 프로젝트 채팅에서 Lovable에 자기 프로젝트를 이 연결에 링크해 달라고 요청할 수 있습니다.

사전 준비

AWS API를 연결하기 전에 다음을 확인하세요.

• 앱이 다룰 리소스가 있는 AWS 계정
• 해당 계정에서 IAM user를 만들고 정책을 연결하고 access key를 생성할 권한
• Lovable 워크스페이스에서 연결을 만들 권한(연결과 클라이언트를 만들 수 있는 사람 참조)

1단계: 최소 권한 정책을 적용한 IAM user 만들기

연결은 IAM user로 인증합니다. Lovable 전용 user를 만들고, 앱을 포괄하는 가장 좁은 정책을 연결한 뒤 access key를 생성하세요. Lovable은 계정 root 자격 증명을 거부합니다. root 키는 권한 범위를 좁힐 수 없고 AWS 계정 전체를 노출하기 때문입니다.

IAM user와 access key를 만들려면 다음을 진행합니다.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "ReadOnlyStarter",
      "Effect": "Allow",
      "Action": [
        "ec2:Describe*",
        "cloudwatch:GetMetricData",
        "cloudwatch:ListMetrics"
      ],
      "Resource": "*",
      "Condition": {
        "StringEquals": { "aws:RequestedRegion": "YOUR-REGION" }
      }
    },
    {
      "Sid": "DenyAccountAdministration",
      "Effect": "Deny",
      "Action": ["iam:*", "organizations:*", "account:*"],
      "Resource": "*"
    }
  ]
}

더 자세한 내용은 AWS 문서의 IAM 보안 모범 사례를 참조하세요.

2단계: AWS API를 Lovable에 연결하기

access key를 만들었다면 Lovable에서 연결을 생성합니다.

연결되면 프로젝트에서 빌드하는 사람은 프로젝트 채팅에서 Lovable에 프로젝트를 AWS API에 링크해 달라고 요청할 수 있습니다(구성된 연결 수준 접근 권한 기준). 그러면 Lovable 앱이 IAM 정책의 한도 안에서 커넥터 게이트웨이를 통해 AWS 서비스 API를 호출할 수 있습니다.

제한 사항

AWS API 커넥터는 다음을 할 수 없습니다.

• Lovable 안에서 연결을 읽기 전용 작업이나 특정 AWS 서비스로 제한하기. access key의 IAM 정책이 이 연결로 빌드한 앱의 동작 범위를 정하는 유일한 통제 수단입니다.
• 임시 자격 증명(session token)이나 IAM 역할로 직접 연결하기. 연결에는 IAM user의 장기 access key가 필요합니다. 다만 앱은 교차 계정 접근을 위해 이 연결로 AssumeRole을 호출할 수 있습니다.
• AWS China 또는 AWS GovCloud (US) 파티션에 접근하기. 상용 리전만 사용할 수 있습니다.
• 6 MiB보다 큰 요청 본문 전송하기. 더 큰 Lambda 배포 패키지나 CloudFormation 템플릿은 먼저 S3에 업로드한 뒤 요청에서 참조하세요.
• SNS 알림이나 EventBridge 이벤트처럼 AWS에서 오는 이벤트 수신하기. 연결은 외부로 나가는 호출만 합니다.
• 최종 사용자별 AWS 로그인 지원하기. 각 연결은 단일 IAM user를 나타내며, 연결된 모든 프로젝트가 이를 공유합니다.

IAM에서 access key를 비활성화하거나 삭제했다면, API 호출이 다시 성공하기 전에 새 키로 연결을 업데이트하세요.

문제 해결

연결이 실패하거나 AWS 요청이 예상하지 못한 status를 반환하면 다음을 확인하세요.

AWS API 연결 관리

연결은 Connectors에서 관리합니다. **AWS API**를 선택한 뒤 연결을 엽니다.

• Unlink projects를 사용하면 다른 프로젝트에서는 연결을 계속 쓸 수 있게 두면서 특정 프로젝트에서 AWS API 접근만 제거할 수 있습니다. 단계는 연결에서 프로젝트 링크 해제를 참조하세요.
• Delete the connection은 워크스페이스에서 연결을 완전히 제거합니다. 삭제는 영구적입니다. 연결된 모든 프로젝트에서 자격 증명이 제거되고, AWS API를 사용하는 앱 기능은 새 연결을 추가할 때까지 동작을 멈춥니다. 단계와 삭제 권한은 연결 삭제를 참조하세요.

관련 주제

• AWS Athena에 앱 연결하기
• AWS S3에 앱 연결하기
• Amazon Redshift에 앱 연결하기
• Databricks에 앱 연결하기
• App user 커넥터: 사용자가 자기 계정을 연결하게 하기