--- title: "新規ユーザーの追加" url: https://docs.catalyst.zoho.com/ja/sdk/python/v1/cloud-scale/authentication/add-new-user/ description: "このページでは、Pythonアプリケーションに新しいエンドユーザーを追加する方法について、サンプルコードスニペットとともに説明します。" last_updated: 2026-03-30T08:10:30Z service: Cloud Scale type: general related_links: - name: "Add New User - API" url: /ja/api/code-reference/cloud-scale/authentication/add-new-user/#AddNewUser - name: "Authentication Help" url: /ja/cloud-scale/help/authentication/introduction - name: "SDK Scopes" url: /ja/sdk/python/v1/sdk-scopes --- # 新規ユーザーの追加 Catalystアプリケーションにエンドユーザーを追加できます。組織が明示的に指定されていない場合、ユーザーはデフォルトの組織に自動的に割り当てられます。ユーザーが追加されると、Catalystによって一意の[user_ID](https://docs.catalyst.zoho.com/ja/cloud-scale/help/authentication/user-management/users/introduction/#authentication-and-user-basics)と[ZUID](https://docs.catalyst.zoho.com/ja/cloud-scale/help/authentication/user-management/users/introduction/#authentication-and-user-basics)が生成されます。 #### ディクショナリの作成 Catalystアプリケーションに新しいユーザーを追加する前に、ユーザーの姓、割り当てるロール、メールアドレス、アプリケーションプラットフォーム、現在の作業環境に基づくZAIDデータなどのユーザー詳細を含むディクショナリを作成する必要があります。これらの詳細を含むディクショナリは、`register_user()`メソッドにパラメータとして渡されます。 > **注意：** * ユーザーを登録するには、`email_id`と`first_name`の値を必ず指定する必要があります。 * `role_id`は、Catalystコンソールの_Authentication_の_Roles_セクションから取得できます。 * ZAIDは、Catalystコンソールの[環境設定](https://docs.catalyst.zoho.com/ja/deployment-and-billing/environments/introduction)から取得できます。 * 新しいユーザーを招待する際に、送信者のメールアドレス、件名、メールメッセージを設定できます。SDKコードで使用する前に、[Catalyst Mailコンポーネント](https://docs.catalyst.zoho.com/ja/cloud-scale/help/mail/email-configuration/)でメールアドレスを追加し、認証を完了させる必要があります。 ```python #辞書を作成する signup_config = { "platform_type": "web", "zaid": "81008807534807534", "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", "role_id": "1008807534", "email_id": "amelia.burrows@zylker.com", } ``` ### 新規ユーザーの追加 ディクショナリに必要なユーザー情報を設定した後、組織に新しいユーザーを追加できます。この場合、組織はユーザーに自動的に割り当てられます。 `register_user()`メソッドはユーザー作成プロセスを処理し、レスポンスを返します。以下で使用されているコンポーネントインスタンス`authentication_service`の詳細については、[こちらのセクション](https://docs.catalyst.zoho.com/ja/sdk/python/v1/cloud-scale/authentication/get-component-instance/)を参照してください。 > **注意：** [開発環境](https://docs.catalyst.zoho.com/ja/deployment-and-billing/environments/development-environment)では、アプリケーションに追加できるユーザーは25人までです。アプリケーションを本番環境にデプロイした後は、任意の数のエンドユーザーを追加できます。 **使用するパラメータ**
パラメータ名 データ型 定義
`signup_config` `Object` **必須**パラメータです。アプリケーションプラットフォーム、ZAID、登録後に送信するメール情報を含むユーザー登録の詳細を格納します。
`user_details` `Object` **必須**パラメータです。名、姓、メールID、ユーザーを追加する組織のIDなどのユーザー登録詳細を保持します。
```python #新しいユーザーを追加する authentication_service = app.authentication() response_data = authentication_service.register_user(signup_config, user_details) ``` サンプルレスポンスを以下に示します： ```json { "zaid":"81008807534807534", "user_details":{ "zuid":"1005641290", "org_id":"1005641456", "status":"ACTIVE", "is_confirmed":false, "email_id":"amelia.burrows@zylker.com", "first_name":"Amelia", "last_name":"Burrows", "created_time":"Aug 12, 2021 12:33 PM", "modified_time":"Aug 12, 2021 12:33 PM", "invited_time":"Aug 12, 2021 12:33 PM", "role_details":{ "role_name":"App User", "role_id":"2305000000006024" }, "user_type":"App User", "user_id":"2305000000007752", "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)を参照してください。