> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sambanova.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# デバイス認証情報

本ガイドでは、SambaRack Manager でのデバイス認証情報 (device credential) の管理について説明します。SambaRack Manager が管理機能を実行するには、個々のデバイスの認証情報が必要です。認証情報は、AES-GCM 暗号化で保護された暗号化ファイル (`secrets.json.enc`) に保存されます。

> [!NOTE]
>
> SambaRack Manager は、ローカルのパスワード保管庫 (password vault) として機能します。デバイスのパスワードの変更、認証情報のプッシュ、デバイス認証の管理は行いません。

セットアップの全体の流れは次のとおりです。

1. SambaRack Manager ソフトウェアのインストール
2. 初期セットアップと動作確認
3. SambaRack Manager インベントリへの SambaRack の追加
4. **SambaRack Manager でのデバイス認証情報の設定** (このページ)

## 新規インストールの場合

SambaRack Manager を初めてセットアップする場合は、以下の手順を実施してください。

### ステップ 1: デバイス認証情報の設定

SambaRack ユニットは、デフォルトのパスワードが設定された状態で出荷されます。できるだけ早い段階でこれらを変更することを推奨します。デバイスタイプごとの具体的な手順については、各デバイスのハードウェア管理ガイドをご参照ください。

認証情報を設定する前に、[パスワード要件](#パスワード要件) セクションをご確認ください。

### ステップ 2: SambaRack Manager への認証情報の追加

デバイスの認証情報を設定し、パスワード要件に適合していることを確認したら、`snctl secret set` コマンドを使用して、すべてのデバイスタイプの認証情報を追加します。詳細は [シークレットの設定](#シークレットの設定) をご参照ください。

**このステップが完了すると、SambaRack Manager を使用する準備が整います。**

## コマンド

デバイス認証情報の管理には、以下のコマンドを使用します。

### シークレットの設定

デバイスタイプのパスワードを設定または更新します。

```bash theme={}
snctl secret set --device-type <device_type>
```

シークレットの値は、安全な方法で対話的に入力を求められます。

**このコマンドを使用するタイミング:**

* 新しいラックまたはデバイスを SambaRack Manager インベントリに追加したとき
* いずれかのデバイスの認証情報が変更されたとき
* デバイスまたはハードウェア FRU (Field Replaceable Unit) を交換したとき (新しいデバイスの認証情報をデフォルト値から変更する必要があります)

**例:**

```bash theme={}
snctl secret set --device-type host
Enter secret value: ••••••••
```

**デバイスタイプ:**

以下の各デバイスタイプについて、認証情報を設定します。

| デバイスタイプ | コマンド |
| - | - |
| BMC | `snctl secret set --device-type bmc` |
| ホスト | `snctl secret set --device-type host` |
| XRDU | `snctl secret set --device-type xrdu` |
| PDU | `snctl secret set --device-type pdu` |
| アクセススイッチ | `snctl secret set --device-type access_switch` |
| データスイッチ | `snctl secret set --device-type data_switch` |
| シリアルターミナル | `snctl secret set --device-type serial_terminal` |

### シークレットの取得 (マスク表示)

値を部分的にマスクした状態でシークレットを表示します。

```bash theme={}
snctl secret get --device-type <device_type>
```

**例:**

```bash theme={}
snctl secret get --device-type bmc
```

**出力例:**

シークレットが 4 文字以下の場合:

```yaml theme={}
bmc: ***
```

シークレットが 4 文字を超える場合:

```yaml theme={}
bmc: My***3!
```

### シークレットの取得 (マスクなし)

値全体を表示した状態でシークレットを表示します。

```bash theme={}
snctl secret get --device-type <device_type> --show-value
```

**例:**

```bash theme={}
snctl secret get --device-type bmc --show-value
```

**出力例:**

```yaml theme={}
bmc: MySecurePassword123!
```

> [!WARNING]
>
> `--show-value` は安全な環境でのみ使用してください。出力は決して共有しないでください。

## パスワード要件

本セクションでは、デバイス認証情報に関する重要な要件と制限について説明します。

### デバイスタイプごとの共通パスワード

同じタイプのデバイスは、すべて同じパスワードを使用する必要があります。例:

* すべての BMC で 1 つのパスワードを共有します
* すべての XRDU で 1 つのパスワードを共有します
* すべてのホストで 1 つのパスワードを共有します

> [!NOTE]
>
> これは現時点での制限です。デバイス単位またはラック単位のパスワードへの対応は、今後のリリースで予定されています。

### パスワード同期の要件

SambaRack Manager は、デバイスのパスワードと自動的には同期しません。変更が発生した場合は、手動で認証情報を更新する必要があります。

| 操作 | 必要な手順 | タイミング |
| - | - | - |
| デバイスパスワードの変更 | 先にデバイス側を更新し、その後 SambaRack Manager を更新する | 変更後すぐ |
| パスワードのローテーション | 先にデバイス側を更新し、その後 SambaRack Manager を更新する | メンテナンスウィンドウ中 |
| 認証エラーのトラブルシューティング | デバイスのパスワードが SambaRack Manager と一致していることを確認する | 操作が失敗したとき |

### 認証情報の不一致の防止

> [!WARNING]
>
> SambaRack Manager の認証情報がデバイスのパスワードと同期しなくなると、以下の操作が実行できなくなります。
>
> * ノードのパワーサイクル
> * BMC へのアクセス
> * ノード設定の変更
> * リモート操作の実行
>
> 重要な操作を行う前に、SambaRack Manager の認証情報が実際のデバイスパスワードと一致していることを必ず確認してください。