: 외부 서비스 (또는 비공개 백엔드)에 연결하기 위해서 bubble 팀이 특수 플러그인을 만들었습니다.
(1) API 커넥터 : API Connector
API 커넥터에 대해 자세히 알아보려면 아래의 전용 섹션을 확인하세요
API Connector (중급) : 버블 API 커넥터 설정 및 사용, HTTP method, endpoint > 바로가기
- API 커넥터는 JSON 기반 RESTful 웹 API를 노출하는 모든 서비스에 연결할 수 있도록 Bubble의 개발 팀에서 구축한 특수 플러그인입니다.
- 이를 사용하여 API call을 추가하여 외부 서비스에서 데이터를 가져오거나 데이터를 게시하여 앱 서비스 측에서 일부 작업을 트리거할 수 있습니다.
- API 커넥터를 통해 앱에 연결이 추가되면 아래의 예시와 같이 플러그인을 생성하여 플러그인으로 변환할 수 있습니다. 메인에서 Plugins > 이동 > Create a plugin 버튼 클릭
- 다른 버블 사용자들과 기능을 공유하는 방법인 만큼 공개 API를 최대한 플러그인으로 변환해 주세요.
API Connector 사용 시 주의:
- API 호출을 완료하는 데 30초 이상 걸리면 Bubble이 자동으로 이 호출을 다시 시도합니다.
- 작업이 완료되었다는 확인을 서비스에서 다시 받는 데 30초 이상 걸릴 수 있는 작업인 전자 메일 보내기와 같은 작업을 처리하는 경우가 해당됩니다.
- 이로 인해 확인이 처리되지 않은 경우 추가 이메일이 전송될 수 있습니다.
(2) 버블 앱 커넥터 : Bubble App Connector
버블 앱 커넥터를 사용하면 두 개의 Bubble 앱을 연결하여 한 앱에서 다른 앱의 API 및 데이터에 액세스 할 수 있습니다. 이렇게 하면 하나의 앱으로 OAuth에 가입하고 두 번째 앱의 사용자로 워크플로를 실행할 수 있습니다.
1. 설정:
- 앱 B에서 앱 커넥터를 사용하려면 첫 번째 앱 A로 API를 설정해야 합니다.
- 사용자가 앱 B에서 앱 A에 가입할 수 있도록 하려면 다음을 수행해야 합니다.
- Settings 탭에서 앱 A의 OAuth 자격 증명을 정의합니다. 이 작업이 완료되면 앱 B에 버블 앱 커넥터를 설치하고 앱 A를 추가할 수 있습니다.
앱을 추가하면 Bubble은 앱 A가 노출하는 다양한 공개 API 호출 및 공개된 Workflow(워크플로)를 자동으로 가져옵니다. 다양한 호출을 설치할 수 있으며 이를 'API에서 데이터 가져오기'의 데이터 소스로 사용하거나 워크플로의 작업으로 사용할 수 있습니다.
2. 인증 옵션:
call(연결)를 실행하기 위한 몇 가지 인증 옵션이 있습니다.
- call를 거는 사용자의 신원이 앱 A의 개인 정보 보호 역할에 따라 볼 수 있는 데이터에 영향을 미치기 때문에 인증이 중요합니다.
- 기본적으로 API 키를 선택하거나 인증 없음(인증을 요구하지 않음)을 선택할 수 있습니다.
- 이 것은 앱 A에 정의된 대로 실행됩니다.
- 사용자가 앱 B의 클라이언트 ID와 클라이언트 암호를 입력하면 앱 A에서 OAuth로 인증하도록 할 수 있으며 OAuth는 인증을 위한 또 다른 옵션입니다.
3. 인증 옵션 정리:
- 인증 없음: call은 API 키 없이 실행되며 call은 로그아웃된 사용자로 실행됩니다.
- API 키: call은 모든 데이터를 볼 수 있는 권한이 있는 앱 A의 관리자(admin)로 이루어집니다.
- OAuth: 앱 B에서 앱 A로 로그인한 사용자를 대신하여 call이 이루어지며 개인정보 보호 역할이 현재 사용자로 적용됩니다.
B에서 A로 앱 커넥터를 올바르게 설정하면 B에서 최종 사용자에게 A에서 자신의 계정으로 로그인할 수 있는 기능을 제공할 수 있습니다. 네트워크" 워크플로 작업("Google로 로그인" 기능과 유사)
(3) SQL 데이터베이스 커넥터
*Bubble은 PostGres, MySQL 및 Microsoft SQL에 대한 연결을 지원합니다.
Database Connector를 사용하면 Bubble 내에서 외부 데이터베이스에 연결하고 SQL 쿼리를 실행할 수 있습니다. 이러한 쿼리는 action, 데이터 소스(외부 API로 표시됨) 또는 둘 다로 트리거 될 수 있습니다.
*이 글은 SQL 커넥터의 간략한 정보만 제공합니다. 자세한 설명은 아래의 글로 이동하면 볼 수 있습니다.
SQL Database Connector (중급): SQL 데이터베이스 커넥터 설정, 외부 SQL 연결, 생성, 업데이트, 삭제 > 바로가기
SQL 데이터베이스 커넥트 사용:
이 플러그인을 사용하려면 먼저 SQL Database Connector Plugin을 설치해야 합니다.
그다음 연결하려는 데이터베이스를 나타내는 연결된 문장을 입력합니다.
문장은 다음과 같아야 합니다.
mssql://username:password@my-db-instance.endpoint.useast1.rds.amazonaws.com:PORT/db_name
연결을 암호화해야 하는 경우(예: Microsoft Azure 사용)? encrypt=true연결에 추가해야 합니다.
문장을 만들고 유효성을 검사하면 이를 사용하는 쿼리를 만들 수 있습니다.
모든 SQL 문이 허용되지만 SELECT 문의 경우 끝에 LIMIT N을 추가해야 합니다. 여기서는 N <= 100입니다.
쿼리를 테스트하고 저장한 후에는 방법에 따라 이제 쿼리를 action, 데이터 소스 또는 둘 다로 사용할 수 있습니다. SELECT 쿼리는 항목 목록을 반환합니다.
