新規ユーザーの追加

# 新規ユーザーの追加

Catalyst サーバーレスアプリケーションに{{%link href="/ja/cloud-scale/help/authentication/user-management/users/introduction/" %}}エンドユーザー{{%/link%}}を追加し、ユーザーの詳細を取得したり、アカウントを簡単に管理したりできます。ユーザーが Catalyst アプリケーションにサインアップすると、ZUID や User ID などの一意の識別値が作成されます。また、この方法ではユーザーは自動的に組織に割り当てられます。

#### JSON 設定の作成

Catalyst アプリケーションに新しいエンドユーザーを追加する前に、以下に示すように、特定のユーザーのメールアドレス、姓、アプリケーションプラットフォーム、割り当てるロールなどの登録情報を含む JSON オブジェクトを作成する必要があります。その後、この設定をユーザー登録メソッドに渡すことができます。

{{%note%}}{{%bold class="bold-primary" %}}Note:{{%/bold%}}

* ユーザーを登録するには、{{%badge%}}email_id{{%/badge%}} と {{%badge%}}first_name{{%/badge%}} の値を必ず指定する必要があります。
* {{%badge%}}role_id{{%/badge%}} は、Catalyst コンソールの _Authentication_ 内の _Roles_ セクションから取得できます。{{%/note%}}

{{%code class="language-javascript" scroll="set-scroll" %}}//Create a JSON object for adding a new user 
const signupConfig = {
	platform_type: 'web',
	template_details: {
		senders_mail:'dogogetu@tutuapp.bid',
		subject:'Welcome to %APP_NAME% ',
		message:'&lt;p&gt;Hello ,&lt;/p&gt; &lt;p&gt;Follow this link to join in %APP_NAME% .&lt;/p&gt; &lt;p&gt; &lt;a href=\'%LINK%\'&gt;%LINK%&lt;/a&gt; &lt;/p&gt; &lt;p&gt;If you did not ask to join the application, you can ignore this email.&lt;/p&gt; &lt;p&gt;Thanks,&lt;/p&gt; &lt;p&gt;Your %APP_NAME% team&lt;/p&gt;'
	},
	redirect_url: 'home.html' // 認証後、ユーザーはこのページに誘導されます。招待URLとして設定したカスタムドメインも指定できます。
}; 
var userConfig = {
	first_name: 'Dannie',
	last_name: 'Boyle',
	email_id: 'p.boyle@zylker.com',
	role_id : '3376000000159024'
};{{% /code%}}

### 新規ユーザーの追加

以下のコードを使用して、Catalyst アプリケーションに新しいエンドユーザーを追加できます。前のセクションで作成した JSON オブジェクトを {{%badge%}}registerUser(){{%/badge%}} メソッドの引数として渡す必要があります。

{{%badge%}}registerUser(){{%/badge%}} メソッドはユーザーのサインアッププロセスを処理し、Promise を返します。この Promise は JSON オブジェクトに解決されます。

以下で使用している {{%badge%}}userManagement{{%/badge%}} の参照は、{{%link href="/ja/sdk/nodejs/v2/cloud-scale/authentication/get-component-instance" %}}コンポーネントインスタンスページ{{%/link%}}で定義されています。

{{%note%}}{{%bold class="bold-primary" %}}Note :{{%/bold%}} {{%link href="/ja/deployment-and-billing/environments/development-environment" %}}開発環境{{%/link%}}では、アプリケーションに追加できるユーザーは 25 名までです。アプリケーションを本番環境にデプロイした後は、任意の数のエンドユーザーを追加できます。{{%/note%}}

{{%code class="language-javascript" scroll="set-scroll" %}}let userManagement = app.userManagement(); 
let registerPromise = userManagement.registerUser(signupConfig, userConfig);
//JSON設定をメソッドに渡す 
registerPromise.then(userDetails =&gt; { 
//Promiseを返す
console.log(userDetails); 
});{{% /code%}}

各バージョンで受信するサンプルレスポンスを以下に示します:

{{% panel_with_select header="Node JS" %}}
{{% divtag id="V2" class="language-javascript line-numbers"%}} 
    {
      zaid: "1005634498",
      user_details: {
        zuid: "1005641290",
        zaaid: "1005641456",
        org_id: "1005641456",
        status: "ACTIVE",
        is_confirmed: false,
        email_id: "p.boylie@zylker.com",
        first_name: "Dannie",
        last_name: "Boyle",
        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: null
    }{{% /divtag %}}

{{% divtag id="V1" class="language-json line-numbers"%}}
    {
      zaid: 1005634498,
      user_details: {
        zuid: 1005641433,
        zaaid: 1005641434,
        org_id: 1005641434,
        status: "ACTIVE",
        is_confirmed: false,
        email_id: "p.boyle@zylker.com",
        last_name: "Boyle",
        first_name: "Dannie",
        created_time: "Aug 12, 2021 12:27 PM",
        modified_time: "Aug 12, 2021 12:27 PM",
        invited_time: "Aug 12, 2021 12:27 PM",
      role_details: { role_name: "App User", role_id: 2305000000006024 },
        user_type: "App User",
        user_id: 2305000000007745,
        project_profiles: []
      },
    redirect_url: "https://aliencity-66446133.development.catalystserverless.com/app/",
      platform_type: "web",
      org_id: null
    }{{% /divtag %}} 
{{% /panel_with_select %}}

Catalyst サーバーレスアプリケーションにエンドユーザーを追加し、ユーザーの詳細を取得したり、アカウントを簡単に管理したりできます。ユーザーが Catalyst アプリケーションにサインアップすると、ZUID や User ID などの一意の識別値が作成されます。また、この方法ではユーザーは自動的に組織に割り当てられます。

JSON 設定の作成

Note:

ユーザーを登録するには、email_id と first_name の値を必ず指定する必要があります。
role_id は、Catalyst コンソールの Authentication 内の Roles セクションから取得できます。

copy

         //Create a JSON object for adding a new user 
const signupConfig = {
	platform_type: 'web',
	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 did not ask to join the application, you can ignore this email.</p> <p>Thanks,</p> <p>Your %APP_NAME% team</p>'
	},
	redirect_url: 'home.html' // 認証後、ユーザーはこのページに誘導されます。招待URLとして設定したカスタムドメインも指定できます。
}; 
var userConfig = {
	first_name: 'Dannie',
	last_name: 'Boyle',
	email_id: 'p.boyle@zylker.com',
	role_id : '3376000000159024'
};
    