---
title: "サードパーティアプリケーションへのSDK統合"
url: https://docs.catalyst.zoho.com/ja/sdk/nodejs/v2/integrate-sdk-in-third-party-apps/
last_updated: 2026-08-17T12:16:04Z
service: All Services
type: general
related_links:
  - name: "Catalyst Environments"
    url: /ja/deployment-and-billing/environments/introduction/
  - name: "Catalyst Cloud Scale Authentication"
    url: /ja/cloud-scale/help/authentication/introduction/
  - name: "Catalyst Cloud Scale Stratus"
    url: /ja/cloud-scale/help/stratus/introduction/
---

# サードパーティアプリケーションへのCatalyst Node.js SDK統合

Catalyst Node.js SDKのメソッドを、Catalyst環境の外部にデプロイされたアプリケーションに統合して使用できます。たとえば、Vercelでホストされ、Flaskバックエンド（Catalyst外で稼働）を使用するReactアプリが[Catalyst Cloud Scale Stratus](https://docs.catalyst.zoho.com/ja/cloud-scale/help/stratus/introduction/)にドキュメントをアップロードしたり、Amazon Web Services EC2で実行されるデータパイプラインが[Catalyst Cloud Scale ZCQL](https://docs.catalyst.zoho.com/ja/cloud-scale/help/zcql/introduction/)クエリを使用して[Catalyst Cloud Scale Data Store](https://docs.catalyst.zoho.com/ja/cloud-scale/help/data-store/introduction/)に顧客データをプッシュしたりすることが、それぞれのNode.js SDK操作を使用して可能です。

これらは、外部アプリケーションがCatalystプラットフォーム内にデプロイされることなく、Catalystコンポーネントと安全にやり取りできる一般的なユースケースのほんの一例です。

Catalyst Node.js SDKを外部アプリケーションと統合するためのコードスニペットを用意しています。ただし、アプリケーションにコードを実装する前に、以下の前提条件をご確認ください。

### SDK統合の前提条件

Catalyst Node.js SDKを外部アプリケーションと統合するには、以下の情報が必要です：

* **Project ID:**

[Catalystプロジェクト](https://docs.catalyst.zoho.com/ja/getting-started/catalyst-projects/)の一意の識別子です。

* **ZAID (Zoho Account ID):**

プロジェクトを[Catalyst環境](https://docs.catalyst.zoho.com/ja/deployment-and-billing/environments/introduction/)（[開発](https://docs.catalyst.zoho.com/ja/deployment-and-billing/environments/development-environment/)または[本番](https://docs.catalyst.zoho.com/ja/deployment-and-billing/environments/production-environment/)）にリンクするためにCatalystが割り当てる一意のポータル識別子です。

* **Environment:**

Catalystプロジェクトの[ターゲット環境](https://docs.catalyst.zoho.com/ja/deployment-and-billing/environments/introduction/)（[開発](https://docs.catalyst.zoho.com/ja/deployment-and-billing/environments/development-environment/)または[本番](https://docs.catalyst.zoho.com/ja/deployment-and-billing/environments/production-environment/)）です。

* **OAuthクレデンシャル:**

外部アプリケーションがCatalystのセルフクライアントポータルを介してCatalystコンポーネントにアクセスするための認証・認可に必要です。以下が必要になります：

1. Client ID
2. Client Secret
3. Refresh Token

これらの値を取得した後、アプリケーションへのNode.js SDKの統合に進むことができます。

### 統合手順

それでは、各値の取得方法とコードスニペットでの設定方法を見ていきましょう。

以下に示す手順に従ってください：

1. **Catalystコンソールでプロジェクトを作成する:** [コンソール](https://console.catalyst.zoho.com/)で、[このヘルプページ](https://docs.catalyst.zoho.com/ja/getting-started/catalyst-projects/#create-a-catalyst-project)に記載されている手順に従って、新しい[Catalystプロジェクト](https://docs.catalyst.zoho.com/ja/getting-started/catalyst-projects/#introduction-to-catalyst-projects)を作成できます。

2. **Project IDを取得する:** プロジェクトを作成したら、**Project ID**を控えておく必要があります。Project IDはプロジェクト作成時に自動的に生成されるプロジェクトの一意のIDです。

Catalystコンソールの右上にある**Settings**アイコンをクリックして確認できます。

![click-settings](https://catalyst-docs-development.zohostratus.in/images/sdk/sdk-integration/click-settings.webp)

**Settings**画面で、**Project Settings**に移動し、**General**を選択します。以下のスクリーンショットに示すように、このセクションからProject IDを確認して控えておくことができます。

![project-id](https://catalyst-docs-development.zohostratus.in/images/sdk/sdk-integration/project-id.webp)

3. **ZAIDを取得する:** このセクションで提供されるコードスニペットに、プロジェクトの**ZAID**を含める必要があります。**ZAID**は、プロジェクトを必要なCatalyst環境（[開発](https://docs.catalyst.zoho.com/ja/deployment-and-billing/environments/development-environment/)または[本番](https://docs.catalyst.zoho.com/ja/deployment-and-billing/environments/production-environment/)）にリンクするためにCatalystが割り当てる一意のポータル識別子です。

[Catalyst環境の詳細はこちら](https://docs.catalyst.zoho.com/ja/deployment-and-billing/environments/introduction/)。

ZAIDを取得するには、[Catalyst CloudScale Authentication](https://docs.catalyst.zoho.com/ja/cloud-scale/help/authentication/introduction/)コンポーネントのセットアップが必須です。ただし、アプリケーションの認証フローでの使用は任意です。ZAIDを取得するには：

i. コンソールで[Catalyst CloudScale](https://docs.catalyst.zoho.com/ja/cloud-scale/)サービスに移動し、**Security & Identity**の下で**Authentication**を選択します。

![select-authentication](https://catalyst-docs-development.zohostratus.in/images/sdk/sdk-integration/select-authentication.webp)

ii. [Native Catalyst Authentication](https://docs.catalyst.zoho.com/ja/cloud-scale/help/authentication/native-catalyst-authentication/introduction/)をセットアップする必要があります。Catalystが認証プロセス全体を管理するため、追加のコーディングやインフラストラクチャ管理は不要です。

iii. **Set Up**をクリックします。

![click-setup](https://catalyst-docs-development.zohostratus.in/images/sdk/sdk-integration/click-setup.webp)

iv. **Hosted authentication**タイプを選択します。これにより、アプリケーションの専用ページにログイン要素をホストできます。コンソールから認証を設定・デザインでき、Catalystがアプリケーション用にレンダリングし、すべてのバックエンド要件を処理します。

![hosted-authentication](https://catalyst-docs-development.zohostratus.in/images/sdk/sdk-integration/hosted-authentication.webp)

v. [Public Signup](https://docs.catalyst.zoho.com/ja/cloud-scale/help/authentication/public-signup/)オプションを有効にして、ログインコンポーネントにサインアップ機能を表示し、新規ユーザーがアプリケーションに登録してアクセスできるようにする必要があります。詳細なセットアップガイドについては、[Hosted Authenticationのヘルプページ](https://docs.catalyst.zoho.com/ja/cloud-scale/help/authentication/native-catalyst-authentication/hosted-authentication-type/introduction/)を参照してください。

![public-signup](https://catalyst-docs-development.zohostratus.in/images/sdk/sdk-integration/public-signup.webp)

vi. 確認画面で、**Yes, proceed**をクリックします。

![confirmation](https://catalyst-docs-development.zohostratus.in/images/sdk/sdk-integration/confirmation.webp)

vii. 以下に一覧表示されているサポート対象のソーシャルログインオプションのいずれかを有効にし、選択したプロバイダーから対応する**ZAID**値を取得できます。

[特定のソーシャルログインのZAIDの取得方法はこちら](https://docs.catalyst.zoho.com/ja/cloud-scale/help/authentication/social-logins/configuring-social-logins/)。

> **注意:** Google、Microsoft、LinkedIn、FacebookなどのソーシャルログインプロバイダーはZAIDの取得に対応していますが、ZohoログインはこのZAID取得の目的には対応していません。

![socials](https://catalyst-docs-development.zohostratus.in/images/sdk/sdk-integration/socials.webp)

[このHosted Authenticationタイプの詳細はこちら](https://docs.catalyst.zoho.com/ja/cloud-scale/help/authentication/native-catalyst-authentication/hosted-authentication-type/introduction/)。

4. **セルフクライアントアプリケーションを登録する:** アプリケーションのユーザーに代わってCatalystリソースにアクセスするためのアプリケーションの認証・認可に、**Refresh Token**、**Client ID**、**Client Secret**を取得する必要があります。

上記の必要な項目を取得するには、まず[APIコンソール](https://api-console.zoho.com)でアプリケーションをセルフクライアントとして登録する必要があります。

i. APIコンソールにログインし、**Self-client**をクリックします。

![self-client](https://catalyst-docs-development.zohostratus.in/images/sdk/sdk-integration/self-client.webp)

ii. アプリケーションがCatalystで実行する必要がある操作に基づいて、セルフクライアントアプリケーションのスコープを設定します。

[利用可能なスコープの詳細はこちら](https://docs.catalyst.zoho.com/ja/api/oauth2/scopes/#Scopes)。

iii. 必要なスコープを指定し、適切な説明を追加して、**Create**をクリックします。

![create](https://catalyst-docs-development.zohostratus.in/images/sdk/sdk-integration/create.webp)

iv. グラントトークンが生成されます。これは一度きりのプロセスであり、コンソールから再度取得できないため、必ずコピーして安全に保管してください。

[グラントトークンの生成の詳細はこちら](https://docs.catalyst.zoho.com/ja/api/oauth2/generate-grant-token/#GenerateGrantToken)。

![generated-code](https://catalyst-docs-development.zohostratus.in/images/sdk/sdk-integration/generated-code.webp)

v. **Client Secret**タブに切り替えて、Client IDとClient Secretの詳細を控えておきます。

![client-secret](https://catalyst-docs-development.zohostratus.in/images/sdk/sdk-integration/client-secret.webp)

vi. [このヘルプページ](https://docs.catalyst.zoho.com/ja/api/oauth2/generate-access-and-refresh-token/#GenerateAccessandRefreshToken)のリクエストを使用して、アクセストークンとリフレッシュトークンを生成できます。また、[このページ](https://docs.catalyst.zoho.com/ja/api/oauth2/refresh-access-token/#RefreshAccessToken)に記載されている手順を使用して、アクセストークンを更新することもできます。

上記のすべての値を控えた後、以下に示すようにコードスニペットに設定し、Node.js SDKをアプリケーションに統合できます。以下のコードは、[Catalyst CloudScale Stratus](https://docs.catalyst.zoho.com/ja/cloud-scale/help/stratus/introduction/)からバケットを取得する例で示しています。

### コードスニペット

```javascript
var catalyst = require("zcatalyst-sdk-node"); 
const express = require("express"); 
const app = express(); 
const port = 3006; 
const project_id = "PROJECT_ID"; //ここにプロジェクトIDを入力してください
const project_key = "ZAID"; //ここにZAIDを入力してください
const environment = "Development"; //"Development"または"Production"を指定してください
const credentials = { 
refresh_token: "YOUR_REFRESH_TOKEN", //ここにリフレッシュトークンを入力してください
client_id: "CLIENT_ID", //ここにクライアントIDを入力してください
client_secret: "CLIENT_SECRET", //ここにクライアントシークレットを入力してください
}; 
const CatalystCred = catalyst.credential.refreshToken(credentials); 
app.get("/listbuckets", async (req, res) => { 
try { 
req.project_id = project_id; 
req.project_key = project_key; 
req.environment = environment; 
req.credential = CatalystCred; 
let catalystApp = catalyst.initializeApp(req); 
const stratus = catalystApp.stratus(); 
const bucket_data = await stratus.listBuckets(); 
res.send(bucket_data); 
res.end(); 
} 
catch (err) { 
console.log(err.toString()); 
res.send(err); 
res.end(); 
} 
}); 
app.listen(port, async () => { 
console.log(`Server running on http://localhost:${port}`); 
}); 
```