【HULFT10 API Gatewayの歩き方】②ユーザーの登録、権限の違い

この【HULFT10 API Gatewayの歩き方】シリーズは、
「HULFTは知っているけど、HULFT10 API Gatewayって何？どう操作するの？」
といった方に向けた実践ガイドブックです。

ぜひご自身でも実際にHULFT10 API Gatewayを操作してみてください！
他のシリーズはこちら👉[【HULFT10 API Gatewayの歩き方】シリーズまとめ](https://qiita.com/shiori_n/items/13040029fe8af44c2659)

## 紹介で使用している製品
HULFT10 API Gateway v10.2.1

## 今回のテーマ：ユーザー設定
この章を読み進めることで、ユーザーの登録の流れや、ユーザーに付与する各権限の違いについてマスターできます。
1. ユーザー一覧画面
1. ユーザー登録方法
1. ユーザーの権限の違い
1. ユーザー削除方法

##  1. ユーザー一覧画面
HULFT10 API Gatewayの管理画面から設定メニューを開きます。
![画像8.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3769438/942d0899-4658-443b-b519-f999277268ad.png)

ローカルナビゲーションにある「ユーザー管理」をクリック
![画像9.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3769438/b1ad0356-2dc2-4103-baa6-52798cf0f586.png)

✅ **ユーザーの一覧画面が開けました！**
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3769438/ed58c062-bf83-4ae4-9bc3-b44f2c716928.png)

## 2. ユーザー登録方法
さっそく、「新規作成」ボタンからユーザーを登録しましょう。
![画像10.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3769438/1a37be5f-5e17-4336-abb8-88b170908263.png)

以下は[ユーザー新規作成]画面です。必要な情報を入力します。
![画像11.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3769438/e0fc26e8-056d-40d3-ad6e-9924be158dcc.png)

:::note info
必須項目は「**ユーザーID**」（ユーザー名）と「**初期パスワード**」のみ！
:::
:::note info
各項目の入力欄の下に入力要件が示されているため、直感的に入力できます！
:::

▼権限は「管理者」と「メンバー」が選択できます（権限の違いについては後述します）
![画像12.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3769438/19205f32-c03f-4a67-a1b8-05a39ce9f8bf.png)

ステータスは、ユーザーの有効化、無効化に関する設定です。

❶ユーザーステータス：無効にするとこのアカウントでログインや、アクセストークンの使用ができなくなります。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3769438/c1d5f2a7-8a45-4a80-9d94-c2e3f1301266.png)

❷有効期間の設定：チェックボックスに✅を入れると期間を設定できます。
![画像8.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3769438/171f0275-8635-4a1a-b1d8-4c71672f1152.png)

:::note info
カレンダーアイコンをクリックすることで、カレンダーから日付を選択できます！
:::

※アクセストークン：REST APIを利用する際に使うトークンです。

✅ **画面下部にある「保存」をクリックすると、ユーザーの登録が完了します！**
![画像9.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3769438/717f6bd9-9ca7-4457-9063-a75bffaf6e1b.png)

:::note warn
「保存」ボタンがグレーアウトし、押下できない場合は以下の可能性があるため
設定を見直してください。

・必須項目が未入力
・無効な値が入力されている
:::

💡試しに、一度ログアウトし、今登録したアカウントでログインしてみましょう！


## 3. ユーザーの権限の違い
ユーザーの権限には「root」、「管理者」、「メンバー」の3つがあります。

「root」は、最初にログインする際に利用するユーザーで、新規に作成するユーザーには割り当てられない特別な権限を持っています。

「管理者」と「メンバー」は、新規に作成するユーザーに割り当てることができ、それぞれ特徴があります。

✅ 以下が3つの権限の違いです。
![画像7.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3769438/2fa1acfc-17d3-4fbd-9777-b0c89198b878.png)

:::note info
以下の特徴があります。

・root：ほとんどの権限を有していますが、**アクセストークンが利用不可**なためREST APIも利用できません。（画面上での作業のみ利用可能）
・管理者：主に自分と**メンバー権限を持つ全ユーザー**を管理することができます。
・メンバー：**自分のアカウントのみ参照可能**です。
:::

### 💡Point
権限の使い分けは以下を想定しています。

<table>
  <tr>
    <th> root </th> <td>API Gatewayの管理、管理者権限のユーザーの管理 </td>
  </tr>
  <tr>
    <th> 管理者 </th> <td>API Gatewayで利用するHULFTの管理・運用、メンバー権限のユーザーの管理</td>
  </tr>
    <tr>
    <th> メンバー </th> <td>HULFTの運用</td>
  </tr>
</table>

:::note warn
HULFTの操作権限はHULFT本体の設定に依存しており、HULFT10 API Gatewayでは管理できません。
:::

## 4. ユーザー削除方法
先ほど作成したユーザー「admin」を削除するため、rootユーザーでログインしなおします。

①ユーザー一覧画面から先ほど作成したユーザーを選択し、
②画面右上にある削除アイコンをクリックします。
![画像3.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3769438/df5dd0a0-72ec-4bb3-a53e-8a6a23868db6.png)

ユーザーIDを確認し、「削除」をクリックします。
![画像5.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3769438/68c418e7-da54-41f0-8885-8112dd2b07e7.png)

✅ **ユーザー「admin」を削除できました！**
![画像6.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3769438/2ebaa0c2-3513-4537-beda-d20842c10f60.png)



## まとめ
今回はユーザーの登録～削除までの一連の流れを操作しました！
✅ ユーザー一覧画面を開く
✅ ユーザーを登録する
✅ ユーザーの権限の違いを知る
✅ ユーザーを削除する

次回は「HULFTの登録・接続方法」などをご説明いたします！

📢「こんなこと知りたい！」などリクエストがあればぜひコメントをお寄せください。

## 付録
#### ページネーション
HULFT API Gatewayでは全ての一覧画面でページネーションが利用できます。
![画像3.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3769438/cf4cccbe-d6ba-42d8-9e9f-c0988979055b.png)

私のPCだと13件のデータまで一覧で表示可能です。
ただこのままではデータが増えていくと、100件までデータをスクロールする必要が出てきます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3769438/480764db-da71-46c5-8a7f-934ed99eb6d7.png)

その際はページネーションの「件数」のプルダウンから表示する件数を選択することで一覧を見やすくできます！
![画像4.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3769438/624abeb4-beff-4d3f-bd17-46ad826d45f8.png)

【Before】
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3769438/480764db-da71-46c5-8a7f-934ed99eb6d7.png)
↓
↓
↓
【After】
![画像5.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3769438/d15c930a-72f7-4928-af21-5f4fab147470.png)