お知らせ:

当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。

既存の組織への新規ユーザーの追加

新しい組織を作成せずに、既存の組織にエンドユーザーを追加できます。これは、ユーザーを追加する組織のOrgIDを指定することで実行できます。

ユーザーがサインアップすると、CatalystによってZUIDとUser IDなどの一意の識別値が作成されます。

注意:
  • 既存の組織にユーザーを追加するには、org_idemail_idlast_nameの値を必ず指定する必要があります。
  • ZAIDは、Catalystコンソールの環境設定から取得できます。
  • role_idを指定してロールに追加することもできます。これはCatalystコンソールのAuthenticationのRolesセクションから取得できます。
  • 新しいユーザーを招待する際に、送信者のメールアドレス、件名、メールメッセージを設定できます。SDKコードで使用する前に、Catalyst Mailコンポーネントでメールアドレスを追加し、認証を完了させる必要があります。

ディクショナリの作成

Catalystアプリケーションに新しいエンドユーザーを追加する前に、以下のように特定のユーザーの登録詳細を含むディクショナリを作成する必要があります。その後、設定したディクショナリをユーザーサインアッププロセスを処理するメソッドに渡すことができます。

copy
#辞書を作成する
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()メソッドの引数として渡す必要があります。このメソッドはユーザーサインアッププロセスを処理し、レスポンスを返します。

注意: 開発環境では、アプリケーションに追加できるユーザーは25人までです。アプリケーションを本番環境にデプロイした後は、任意の数のエンドユーザーを追加できます。

以下で使用されているコンポーネントインスタンスauthentication_serviceの詳細については、こちらのセクションを参照してください。

使用するパラメータ

パラメータ名 データ型 定義
signup_config Object 必須パラメータです。アプリケーションプラットフォーム、ZAID、登録後に送信するメール情報を含むユーザー登録の詳細を格納します。
user_details Object 必須パラメータです。名、姓、メールID、ユーザーを登録する組織のIDなどのユーザー登録詳細を保持します。
copy
#既存の組織に新しいユーザーを追加する
authentication_service = app.authentication()
response_data = authentication_service.add_user_to_org(signup_config, user_details)

サンプルレスポンスを以下に示します:

copy
{
   "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スコープの表を参照してください。

最終更新日 2026-03-30 13:40:30 +0530 IST