---
title: SaaS 통합 개요
description: 제품의 각 사용자가 타사 계정을 연결하고 백엔드에서 해당 사용자를 위해 Connector 작업을 실행할 수 있도록 합니다.
lang: ko
canonical_url: https://oomol.com/ko/docs/saas/
markdown_url: https://oomol.com/ko/docs/saas.md
---

# SaaS 통합 개요

제품의 각 사용자가 자신의 Gmail, Slack, Notion 또는 다른 provider 계정을 인증해야 할 때 SaaS용 Connector를 사용하세요. 제품이 사용자 경험과 사용자 매핑을 소유하며, OOMOL Connector는 연결된 계정을 저장하고 백엔드에서 요청한 작업을 실행합니다.

이 경로는 `oo_proj_…` 형식의 프로젝트 API 키를 사용합니다. 이 키는 하나의 Connector 프로젝트를 나타내며 백엔드에 보관됩니다.

## 리소스 모델

| 리소스 | 용도 |
| --- | --- |
| Project | provider 구성, 키, 연결된 계정, 로그, 사용량을 격리합니다 |
| Provider config | 프로젝트 내에서 하나의 provider가 인증되는 방식을 정의합니다 |
| External user ID | 연결된 계정을 제품의 사용자에 매핑합니다 |
| Connected account ID 또는 alias | 작업에 사용할 계정을 선택합니다 |
| Project API key | 백엔드의 요청을 인증합니다 |

## 통합 흐름

1. OOMOL Console에서 프로젝트와 provider 구성을 생성합니다.
2. 프로젝트 API 키를 생성하고 백엔드 시크릿 관리자에 저장합니다.
3. 백엔드에 외부 사용자용 인증 링크 생성을 요청합니다.
4. 사용자를 provider 인증 흐름으로 안내합니다.
5. 반환된 connected account ID 또는 alias를 제품 사용자 옆에 저장합니다.
6. 백엔드에서 해당 사용자와 계정을 위해 작업을 실행합니다.

## 책임

제품은 사용자를 인증하고, 연결할 수 있는 provider를 결정하며, 사용자-계정 매핑을 저장하고, 백엔드가 요청할 작업을 제어합니다. 프로젝트 API 키를 브라우저와 모바일 클라이언트 외부에 보관하세요.

OOMOL Console은 이 통합 경로를 위한 프로젝트 구성, 연결된 계정 기록, 실행 로그, 사용량 보기를 제공합니다.

## 빌드 시작하기

Console 설정과 REST 흐름은 [Connector for SaaS 가이드](/ko/docs/connector-saas/)를 사용하세요. 백엔드가 TypeScript로 작성된 경우 [ProjectConnector로 최종 사용자 계정 연결](/ko/docs/project-connector/)을 사용하세요.
