--- title: "サードパーティアプリへのSDK統合" url: https://docs.catalyst.zoho.com/ja/sdk/java/v1/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 Java SDKのサードパーティアプリケーションへの統合 Catalyst環境外にデプロイされたアプリケーションで、Catalyst Java SDKのメソッドを統合して使用できます。たとえば、Flaskバックエンド（Catalyst外で実行）を使用してVercelにホストされた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/)に顧客データをプッシュしたりできます。それぞれのJava SDK操作を使用して実行します。 これらは、外部アプリケーションがCatalystプラットフォーム内にデプロイされることなく、Catalystコンポーネントと安全に連携できる一般的なユースケースのほんの一例です。 外部アプリケーションにCatalyst Java SDKを統合するためのコードスニペットを提供しています。ただし、アプリケーションにコードを実装する前に、以下の前提条件を確認してください。 ### SDK統合の前提条件 外部アプリケーションにCatalyst Java 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 Credentials:** Catalystのセルフクライアントポータルを介して外部アプリケーションを認証・認可し、Catalystコンポーネントにアクセスするために必要です。以下が必要になります： 1. Client ID 2. Client Secret 3. Refresh Token これらの値を取得した後、Java SDKをアプリケーションに統合できます。 ### 統合手順 それでは、これらの各値を取得し、コードスニペットに設定する方法を見ていきましょう。 以下の手順に従ってください： 1. **Catalystコンソールでプロジェクトを作成する：** [コンソール](https://console.catalyst.zoho.com/)で[Catalystプロジェクト](https://docs.catalyst.zoho.com/ja/getting-started/catalyst-projects/#introduction-to-catalyst-projects)を新規作成できます。[このヘルプページ](https://docs.catalyst.zoho.com/ja/getting-started/catalyst-projects/#create-a-catalyst-project)に記載されている手順を使用してください。 2. **Project IDを取得する：** プロジェクトを作成したら、**Project ID**を控えておく必要があります。Project IDはプロジェクト作成時に自動的に生成されるプロジェクトの一意のIDです。 Catalystコンソールの右上隅にある**設定**アイコンをクリックして確認できます。 ![click-settings](https://catalyst-docs-development.zohostratus.in/images/sdk/sdk-integration/click-settings.webp) **設定**画面で、**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が割り当てる一意のポータル識別子です。 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**値を取得できます。 > **Note:** Google、Microsoft、LinkedIn、FacebookなどのソーシャルログインプロバイダーがZAIDの取得に対応しています。ただし、ZohoログインはZAIDの取得には対応していません。[特定のソーシャルログインのZAIDを取得する方法](https://docs.catalyst.zoho.com/ja/cloud-scale/help/authentication/social-logins/configuring-social-logins/)を参照してください。 ![socials](https://catalyst-docs-development.zohostratus.in/images/sdk/sdk-integration/socials.webp) 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)に記載されている手順を使用して、アクセストークンをリフレッシュすることもできます。 上記のすべての値を控えた後、以下に示すようにコードスニペットに設定し、Java SDKをアプリケーションに統合できます。以下のSpringBootコードは、[Catalyst CloudScale Stratus](https://docs.catalyst.zoho.com/ja/cloud-scale/help/stratus/introduction/)からバケットを取得する例で示しています。 ### コードスニペット ```java package com.example.demoapp; import org.springframework.boot.CommandLineRunner; import org.springframework.boot.SpringApplication; import org.springframework.boot.autoconfigure.SpringBootApplication; import org.springframework.stereotype.Component; import java.util.List; import java.util.logging.Logger; import org.json.simple.JSONObject; import com.zc.common.ZCProject; import com.zc.common.ZCProjectConfig; import com.catalyst.config.ZCThreadLocal; import com.zc.api.APIConstants.ZCAuthType; import com.zc.api.APIConstants.ZCUserScope; import com.zc.auth.ZCAuth; import com.zc.component.USER_TYPE; import com.zc.component.object.ZCObject; import com.zc.component.object.ZCRowObject; import com.zc.component.object.ZCTable; @SpringBootApplication public class DemoappApplication { private static final Logger logger = Logger.getLogger(DemoappApplication.class.getName()); public static void main(String[] args) { SpringApplication.run(DemoappApplication.class, args); } @Component public static class DataProcessor implements CommandLineRunner { @Override public void run(String... args) { try { ZCThreadLocal.putValue("user_type", USER_TYPE.ADMIN); JSONObject oAuthParams = new JSONObject(); oAuthParams.put("client_id", CLIENT_ID); //ここにクライアントIDを入力してください oAuthParams.put("client_secret", CLIENT_SECRET); //ここにクライアントシークレットを入力してください oAuthParams.put("refresh_token", REFRESH_TOKEN); //ここにリフレッシュトークンを入力してください oAuthParams.put("grant_type", "refresh_token"); ZCAuth auth = ZCAuth.getInstance(oAuthParams); auth.setScope(ZCUserScope.ADMIN); System.out.println("Auth Object: " + auth); ZCProjectConfig config = ZCProjectConfig.newBuilder() .setProjectId(PROJECT_ID) //ここにプロジェクトIDを入力してください .setProjectKey(ZAID) //ここにZAIDを入力してください .setZcAuth(auth) .setProjectDomain("https://api.catalyst.zoho.com") .setEnvironment("Development") //"Development"または"Production"を設定してください .build(); ZCProject project = ZCProject.initProject(config, ""); ZCStratus stratus = ZCStratus.getInstance(project); List buckets = stratus.listBuckets(); } catch (Exception e) { logger.severe("Error during data processing: " + e.getMessage()); } } } } ```