---
author: OOMOL
author_url: https://oomol.com/ja/about/
title: SaaS integration の概要
description: product の各 user が第三者アカウントを接続し、backend からその user の Connector actions
  を実行できるようにします。
lang: ja
canonical_url: https://oomol.com/ja/docs/saas/
markdown_url: https://oomol.com/ja/docs/saas.md
---

# SaaS integration の概要

product の各 user が自分の Gmail、Slack、Notion、その他の provider account を認証する必要がある場合は、Connector for SaaS を使用します。product が user experience と user mapping を管理し、OOMOL Connector が connected account を保存して backend から要求された actions を実行します。

この方法では、`oo_proj_…` 形式の project API key を使用します。key は 1 つの Connector project を表し、backend に保管します。

## resource model

| Resource | 目的 |
| --- | --- |
| Project | provider configs、keys、connected accounts、logs、usage を分離します |
| Provider config | project 内で 1 つの provider を認証する方法を定義します |
| External user ID | connected accounts を product の user に対応付けます |
| Connected account ID または alias | action に使用する account を選択します |
| Project API key | backend からの request を認証します |

## integration flow

1. OOMOL Console で project と provider config を作成します。
2. project API key を作成し、backend の secret manager に保存します。
3. external user 用の authorization link を backend から作成します。
4. user を provider authorization flow に進めます。
5. 返された connected account ID または alias を product user と一緒に保存します。
6. backend からその user と account の actions を実行します。

## responsibilities

product は users を認証し、接続可能な provider を決定し、user と account の mapping を保存し、backend が要求できる actions を管理します。project API key を browser や mobile client に置かないでください。

OOMOL Console では、この integration path の project configuration、connected-account records、execution logs、usage を確認できます。

## 開発を始める

Console の設定と REST flow については、[Connector for SaaS ガイド](/ja/docs/connector-saas/)を参照してください。backend が TypeScript で書かれている場合は、[ProjectConnector で end-user accounts を接続する](/ja/docs/project-connector/)を使用します。