ユーザ

ユーザマネージャのうちユーザを管理する機能について説明します。 ユーザ管理機能は、[サイドメニュー] - [ユーザ] を進み、画面上部の[ユーザ]ボタンをクリックすると登録済みのユーザ一覧が表示されます。

ノート

ユーザは実行環境ごとに管理されます。

作成

1. 画面右上の[ユーザ作成]ボタンをクリックします。
2. ユーザ情報を入力します。

項目	入力	説明
Eメール	必須	サインインIDに使用する文字列になります。 最大文字数は、128文字です。 ただし、下記の制限があります。 ドメイン部の桁数は63桁まで ※DNSラベル（ドメイン名を構成するドット「.」で分けられた個々の部分の文字列）毎に63桁 @の前に「.（ドット）」を置くこと不可 「.（ドット）」の連続は不可
名前		最大文字数は、2048文字です。
一時パスワード	必須	最初のサインイン用の仮パスワードです。 最大文字数は、256文字です。
カスタム属性	任意	カスタム属性ID「custom\_01」～「custom\_10」の項目です。 独自に定義できる項目です。 最大文字数は、2048文字です。    表示ラベル、必須、表示／非表示は、カスタム属性設定に従います。

3. 発行メールを作成ユーザにメール送信したい場合、発行メール送信にチェックを入れます。

ノート

発行メールは入力したEメールに対して行われます。一時パスワードの要件はパスワードポリシーに従います。

4. [ユーザ追加]ボタンをクリックします。
5. 追加したユーザはユーザリストに表示されます。

ノート

• 他にもユーザに属性情報を追加したい場合はデータベースと連携管理を検討する必要があります。
• 一時パスワードの有効期限は、7日間です。 有効期限を過ぎてしまった場合は、一時パスワードの有効期限が切れた旨のメッセージが表示されます。ユーザマネージャによるパスワードリセット、または$fn.resetPassword関数によるパスワードのリセットを行ってください。

ユーザリスト

ユーザマネージャに登録されているユーザはリスト表示されます。各項目の意味は次の通りです。

項目	説明
ユーザID	サービス全体で一意となる36桁のGUIDです。
Eメール	実行環境で一意となるユーザ識別名でメール送信先かつサインイン文字列になります。
名前	ユーザを識別する名称です。
カスタム属性	カスタム属性ID「custom_01」～「custom_10」の項目です。 独自に定義できる項目です。 表示ラベル、表示／非表示は、カスタム属性設定に従います。
有効/無効	アカウントの有効/無効の状態を表示します。無効ユーザはサインインが不可になります。
ステータス	各ステータスの意味は以下になります。 ステータス名 説明 Unconfirmed ユーザは自分自身で サインアップ を行ったが、Eメール検証が未達成の状態 Confirmed • ユーザは自分自身で サインアップ を行い、Email Verification も検証済みでユーザは正常にサインインできる状態 • 管理者がユーザアカウントを発行し、ユーザは発行メールを受け取り、自分でパスワードを変更済みで正常にサインインできる状態 External Provider ユーザは外部IdP経由でサインインできます。 Reset Required ユーザは正常な状態であるが、パスワードを忘れていて、パスワード初期化のリクエストを行っている状態 Force Change Password 管理者がユーザアカウントを発行したが、ユーザは自分でまだパスワードを変更していないため、アカウントはサインインできない状態
更新日時	ユーザを更新した日時をローカルタイムで表示します。
作成日時	ユーザを作成した日時をローカルタイムで表示します。

ノート

• Eメールや名前は変更可能です。アプリケーションにユーザを特定する情報を登録する場合は、変更がないユーザIDを推奨します。
• 外部IdP経由でサインインする方法については、認証UIを参照してください。
• ステータスが「External Provider」の外部認証ユーザ情報は、外部IdP経由でのサインイン時にIdPから取得した情報で更新します。

操作メニュー

ユーザリスト右のボタンをクリックすると[メニュー]が開きます。各メニューの説明は次の通りです。

メニュー	説明
編集	ユーザ編集ダイアログが開き、ユーザ情報を更新します。
無効/有効	ユーザを無効化/有効化します。
リセットパスワード	リセットパスワードダイアログが開き、パスワードをリセットします。
削除	ユーザを削除します

ノート

ステータスが「External Provider」の外部認証ユーザは、[削除]のみ行うことができます。

カスタム属性設定

独自で定義できるカスタム属性項目の設定を行うことができます。 カスタム属性のラベル設定、必須設定、表示/非表示設定をすることができます。 カスタム属性の編集方法は以下の通りです。

1. [カスタム属性設定]のアイコンをクリックします。
2. 編集するカスタム属性行の[縦三点リーダー]をクリックし、[編集]メニューをクリックします。
3. 属性IDの更新ダイアログで、各設定を行い、[適用]ボタンをクリックします。
4. [更新]ボタンをクリックします。

エクスポート

ユーザマネージャに登録しているユーザ情報をファイルとしてローカルにダウンロードすることができます。

CSVファイルの仕様

項目	説明
カラム	userid,email,name,enabled,status,created,updated,custom_01,custom_02,custom_03,custom_04,custom_05,custom_06,custom_07,custom_08,custom_09,custom_10
区切り文字	,（カンマ）
フィールド	ダブルクォート（“）での囲みなし
ヘッダ行	1行目がヘッダ行
改行コード	LF
文字コード	UTF8（BOM付き）

ノート

• ユーザ情報にカンマが含まれる場合、カンマがタブに置き換わった状態でエクスポートされますので、ご注意ください。

インポート

CSVファイルにユーザ（単数または複数）の情報を記入し、ローカルからCSVファイルをアップロードすると、CSV記述のユーザを登録することができます。

CSVファイルの仕様

項目	説明
カラム	name,email,custom_01,custom_02,custom_03,custom_04,custom_05,custom_06,custom_07,custom_08,custom_09,custom_10
区切り文字	,（カンマ）
フィールド	ダブルクォート（“）で囲まれたデータは、囲まれたデータのみ抽出され、両端のダブルクォートは取り除かれます。 値にダブルクォートを含むデータは、ダブルクォートで囲ってください。
ヘッダ行	1行目をヘッダ行とみなし、2行目から読み込みを行います。
改行コード	CRLFとLF両方に対応
文字コード	UTF8（BOMなし/BOM付き両方対応）

ノート

• EmailがすでにCognitoユーザプールに登録されている場合、そのレコードの登録は自動的にスキップします。また、不適切なレコードについても自動スキップします。
• CSVファイル内のユーザ情報にカンマが含まれる場合、カンマがタブに置き換わってしまいますので、ご注意ください。