--- title: "既存組織への新規ユーザーの追加" url: https://docs.catalyst.zoho.com/ja/sdk/python/v1/cloud-scale/authentication/add-new-user-to-existing-org/ description: "このページでは、Pythonアプリケーションで既存の組織に新しいユーザーを追加する方法について、サンプルコードスニペットとともに説明します。" last_updated: 2026-03-30T08:10:30Z service: Cloud Scale type: general related_links: - name: "Add New User to Existing Org - API" url: /ja/api/code-reference/cloud-scale/authentication/add-user-to-existing-org/#AddaNewUsertoanExistingOrganization - name: "Authentication Help" url: /ja/cloud-scale/help/authentication/introduction - name: "SDK Scopes" url: /ja/sdk/python/v1/sdk-scopes --- # 既存の組織への新規ユーザーの追加 新しい組織を作成せずに、既存の組織にエンドユーザーを追加できます。これは、ユーザーを追加する組織の[**OrgID**](https://docs.catalyst.zoho.com/ja/getting-started/catalyst-organizations/)を指定することで実行できます。 ユーザーがサインアップすると、Catalystによって[ZUIDとUser ID](https://docs.catalyst.zoho.com/ja/cloud-scale/help/authentication/user-management/users/introduction/#authentication-and-user-basics)などの一意の識別値が作成されます。 > **注意：** * 既存の組織にユーザーを追加するには、`org_id`、`email_id`、 `last_name`の値を必ず指定する必要があります。 * ZAIDは、Catalystコンソールの[環境設定](https://docs.catalyst.zoho.com/ja/deployment-and-billing/environments/introduction)から取得できます。 * `role_id`を指定してロールに追加することもできます。これはCatalystコンソールのAuthenticationのRolesセクションから取得できます。 * 新しいユーザーを招待する際に、送信者のメールアドレス、件名、メールメッセージを設定できます。SDKコードで使用する前に、[Catalyst Mailコンポーネント](https://docs.catalyst.zoho.com/ja/cloud-scale/help/mail/email-configuration/)でメールアドレスを追加し、認証を完了させる必要があります。 ## ディクショナリの作成 Catalystアプリケーションに新しいエンドユーザーを追加する前に、以下のように特定のユーザーの登録詳細を含むディクショナリを作成する必要があります。その後、設定したディクショナリをユーザーサインアッププロセスを処理するメソッドに渡すことができます。 ```python #辞書を作成する signup_config = { "platform_type": "web", "zaid": "1008807534", "template_details": { "senders_mail": "dogogetu@tutuapp.bid", "subject": "Welcome to %APP_NAME%", "message": "<p>Hello ,</p> <p>Follow this link to join in %APP_NAME% .</p> <p><a href='%LINK%'>%LINK%</a></p> <p>If you didn't ask to join the application, you can ignore this email.</p> <p>Thanks,</p> <p>Your %APP_NAME% team</p>", }, } user_details = { "first_name": "Amelia", "last_name": "Burrows", "email_id": "amelia.burrows@gmail.com", "org_id": "1005641456", } ``` ### 既存組織への新規ユーザーの追加 以下のコードを使用して、既存の組織に新しいエンドユーザーを追加できます。前のセクションで作成したディクショナリを`add_user_to_org()`メソッドの引数として渡す必要があります。このメソッドはユーザーサインアッププロセスを処理し、レスポンスを返します。 > **注意：** [開発環境](https://docs.catalyst.zoho.com/ja/deployment-and-billing/environments/development-environment)では、アプリケーションに追加できるユーザーは25人までです。アプリケーションを本番環境にデプロイした後は、任意の数のエンドユーザーを追加できます。 以下で使用されているコンポーネントインスタンス`authentication_service`の詳細については、[こちらのセクション](https://docs.catalyst.zoho.com/ja/sdk/python/v1/cloud-scale/authentication/get-component-instance/)を参照してください。 **使用するパラメータ**
パラメータ名 データ型 定義
`signup_config` Object **必須**パラメータです。アプリケーションプラットフォーム、ZAID、登録後に送信するメール情報を含むユーザー登録の詳細を格納します。
`user_details` Object **必須**パラメータです。名、姓、メールID、ユーザーを登録する組織のIDなどのユーザー登録詳細を保持します。
```python #既存の組織に新しいユーザーを追加する authentication_service = app.authentication() response_data = authentication_service.add_user_to_org(signup_config, user_details) ``` サンプルレスポンスを以下に示します： ```json { "zaid":"1008807534", "user_details":{ "zuid":"1005643749", "org_id":"1005641456", "status":"ACTIVE", "is_confirmed":false, "email_id":"amelia.burrows@gmail.com", "first_name":"Amelia", "last_name":"Burrows", "created_time":"Aug 12, 2021 03:56 PM", "modified_time":"Aug 12, 2021 03:56 PM", "invited_time":"Aug 12, 2021 03:56 PM", "role_details":{ "role_name":"App User", "role_id":"2305000000006024" }, "user_type":"App User", "user_id":"2305000000009002", "project_profiles":[ ] }, "redirect_url":"https://aliencity-66446133.development.catalystserverless.com/app/", "platform_type":"web", "org_id":"1005641456" } ``` > **情報：** 上記の操作を実行するために必要な権限レベルについては、[SDKスコープの表](https://docs.catalyst.zoho.com/ja/sdk/python/v1/sdk-scopes)を参照してください。