アカウント / 認証

ToukaCloud の認証は Keycloak というオープンソースの IAM プラットフォームをベースにしています。アカウント作成からログイン、プロフィール管理まで、 セキュアで統一されたインターフェースを提供します。

• Keycloak アカウント: メール / ユーザー名とパスワードで認証
• Direct Access Grants: API や CLI からの直接ログイン対応
• セキュアトークン: JWT トークンベースのセッション管理
• プロフィール: 個人情報と支払い情報の一元管理

新しいアカウントを作成します。以下の手順に従ってください。

2.1 サインアップ画面へアクセス

1. ログイン画面 を開く
2. 下部の「アカウントを作成」リンク（または Sign up）をクリック

2.2 必須項目を入力

• ユーザー名: 英数字とアンダースコア。一度作成したら変更不可
• メールアドレス: 有効なメールアドレス。重複登録は不可
• パスワード: 最低 8 文字。大文字・小文字・数字の混在推奨
• パスワード確認: 同じパスワードを再入力

2.3 アカウント作成

1. 利用規約とプライバシーポリシーに同意
2. 「アカウントを作成」ボタンをクリック
3. 成功時は自動で ログイン画面 にリダイレクト

ユーザー名またはメールアドレスとパスワードでログインします。 ToukaCloud は Keycloak の Direct Access Grants に対応しており、 Web UI だけでなく API 経由でのログインも可能です。

3.1 Web UI でのログイン

1. ログイン画面 を開く
2. ユーザー名またはメールアドレスを入力
3. パスワードを入力
4. 「ログイン」ボタンをクリック
5. 成功すると ホーム（/）にリダイレクト

3.2 API 経由でのログイン（Direct Access Grants）

プログラムから Keycloak トークンを取得する場合、以下の API を使用します:

POST https://cloud.auth.max3584.net/realms/cloudserver/protocol/openid-connect/token

Content-Type: application/x-www-form-urlencoded

grant_type=password
&client_id=cloudserver
&client_secret=<your-client-secret>
&username=your_username
&password=your_password
&scope=openid profile email

レスポンス例:

{
  "access_token": "eyJhbGciOiJSUzI1NiIsInR5cC...",
  "expires_in": 300,
  "refresh_expires_in": 1800,
  "refresh_token": "eyJhbGciOiJIUzI1NiIsInR...",
  "token_type": "Bearer",
  "id_token": "eyJhbGciOiJSUzI1NiIsImtp...",
  "scope": "openid profile email"
}

3.3 トークンのリフレッシュ

POST https://cloud.auth.max3584.net/realms/cloudserver/protocol/openid-connect/token

Content-Type: application/x-www-form-urlencoded

grant_type=refresh_token
&client_id=cloudserver
&client_secret=<your-client-secret>
&refresh_token=eyJhbGciOiJIUzI1NiIsInR...

パスワードを忘れた場合、Keycloak の password reset 機能でリセットできます。 （現在 UI 実装は準備中ですが、Keycloak Admin API を経由して管理者がリセット要求することは可能です）

4.1 ログイン画面からのリセット（計画中）

今後、ログイン画面に「パスワード忘れ」リンクが追加される予定です。

4.2 管理者経由でのリセット（未実装）

現在、アカウント削除同様に管理者への問い合わせが必要です。 サポートチャネルを通じて「アカウント: example@example.com のパスワードリセット要求」と伝えてください。

ユーザープロフィール画面では、個人情報の編集とアカウント設定ができます。

5.1 プロフィール画面へアクセス

1. ログイン後、サイドバーまたはメニューの「プロフィール」をクリック
2. または直接 /profile にアクセス

5.2 編集できる情報

• メールアドレス: 変更後は検証（未実装）が必要な場合あり
• 表示名（名前）: オプション。プロフィール表示用
• 姓・名（First/Last Name）: 個別設定可能

5.3 注意事項

• ユーザー名は作成後変更できません
• メールアドレスの重複登録はできません
• 変更は即座に反映されます（確認メールなし）

ToukaCloud のサブスクリプション料金や追加アドオン費用の支払いに使用するクレジットカード情報を管理します。 Stripe による安全な決済処理を採用しており、カード情報は ToukaCloud では保存されません。

6.1 支払い情報画面へアクセス

1. プロフィール画面を開く
2. 「請求情報」タブをクリック
3. または直接 /profile/billing にアクセス

6.2 クレジットカード情報を追加

1. 「支払い方法を追加」ボタンをクリック
2. Stripe Payment Element のモーダルが開く
3. カード番号・有効期限・CVC を入力
4. 「保存」ボタンをクリック
5. 成功すると一覧に登録されたカードが表示される

6.3 カードの更新 / 削除

• 登録済みカードの右側の操作メニューから削除可能
• デフォルトカードはライセンス購入やアドオン購入時に自動使用
• 複数枚登録可能ですが、決済時はデフォルト設定されたカードが使用される

Container / レガシー VPS に接続する際の SSH 公開鍵を管理します。 事前に複数の鍵を登録しておくことで、Container 作成時に簡単に選択できます。

7.1 SSH 鍵一覧へアクセス

1. プロフィール画面を開く
2. 「SSH 鍵」セクションを下にスクロール
3. または /profile ページ内で確認

7.2 新しい SSH 鍵を追加

1. 「新しい SSH 鍵を追加」ボタンをクリック
2. 鍵の名前を入力（例：GitHub鍵、開発用ノート PC）
3. SSH 公開鍵の内容をペースト
4. 「追加」をクリック

7.3 対応形式

以下の SSH 鍵形式がサポートされています：

• ssh-rsa (RSA 2048 bit 以上推奨)
• ssh-dss (DSA - 非推奨)
• ecdsa-sha2-nistp256 (ECDSA)
• ssh-ed25519 (Ed25519 - 推奨)

7.4 SSH 鍵の削除

1. 鍵一覧から削除対象の鍵を探す
2. 右側のゴミ箱アイコン（🗑️）をクリック
3. 確認ダイアログで「削除」を選択
4. 削除後は復元できません

7.5 鍵の自動抽出

SSH 公開鍵をペーストすると、コメント部分（鍵の右端）が自動で鍵名として提案されます。 例: ssh-ed25519 AAAAC3... user@laptop → 鍵名: user@laptop

アカウントを削除する場合、以下のポリシーに従います。この操作は取り消せません。

8.1 削除前の確認事項

• すべての Container / レガシー VPS は自動削除されます
• コンテナレジストリ内のイメージもすべて削除されます
• ライセンスのサブスクリプションはキャンセルされます
• 過去の請求履歴は保持されます（税務・法的理由）

8.2 アカウント削除方法

現在、アカウント削除はセルフサービスで実装されていません。 削除を希望する場合は、サポートチャネル（メール等）を通じて以下を明記して問い合わせてください:

件名: アカウント削除要求

本文:
メールアドレス: your-email@example.com
ユーザー名: your-username

以下のポリシーに同意します:
- すべての Container / イメージが削除される
- ライセンスのサブスクリプションがキャンセルされる
- この操作は取り消せない

本当に削除してください。

8.3 ライセンスキャンセル後の扱い

ライセンス（サブスクリプション）をキャンセルすると以下が発生します：

• 新しい Container デプロイが不可になります
• 既存 Container は引き続き実行されます（自動削除されない）
• 30 日間ログインがないと、アカウントが自動削除されることがあります
• その際、すべての Container / データは自動削除されます