# フィールド/レコードタイプ

## フィールドタイプ

フィールドタイプは、フィールドのデータがどのように保存されるかを定義します。フィールドタイプは、デフォルトのレコードタイプおよびユーザーが作成したカスタムレコードで使用されます。

{% hint style="info" %}
各フィールドタイプには、適切な形式でデータを設定してください。SDKでは、デフォルトでは多くのフィールドに対して厳密な入力チェックは行われません。そのため、フィールドに応じた正しい形式でデータを設定することがベストプラクティスとされています。

また、Keeperが提供する他の製品では、フィールドタイプに基づいてレコードからデータを取得するため、正しいフィールド形式を使用することが重要です。
{% endhint %}

### accountNumber

文字列型の値です。値に対する検証は行われません。

### address

以下の要素を含む辞書型の値です。

* `street1` - 住所1
* `street2` - 住所2
* `city` - 市
* `state` - 州
* `zip` - 郵便番号
* `counrty` - [ISO3166 Alpha-2形式の国コード](https://www.iban.com/country-codes)

いずれのキーも必須ではありません。

例

```
{"street1":"100 Main Street", "city":"Town", "state":"RI", "zip":"55555",
    "country":"US"}
```

### bankAccount

以下の要素を含む辞書型の値です。

* `accountType` - 口座種別 (Checking / Savings / Other)
* `otherType` - その他の口座種別の説明
* `routingNumber` - 銀行のルーティング番号
* `accountNumber` - 口座番号

いずれのキーも必須ではありません。

例

```
{"accountType":"Checking", "routingNumber":"123456", "accountNumber":"55555555"}
```

### birthDate

エポックミリ秒形式の値です。作成方法 (例: ヘルパーモジュールを使用する場合) によっては、ISO8601形式の値を指定できます。ISO8601形式の値は、自動的にエポックミリ秒の値へ変換されます。

### cardRef

クレジットカードのレコードUIDの配列です。

例

```
["OlLZ6JLjnyMOS3CiIPHBjw", "XJ2VISBJ3JAeCwU_YGAXYg"]
```

### date

エポックミリ秒形式の値です。作成方法 (例: ヘルパーモジュールを使用する場合) によっては、ISO8601形式の値を使用できます。ISO8601形式の値は、エポックミリ秒形式に変換されます。

### email

文字列型の値で、通常はユーザーのメールアドレスを指定します。値に対する検証は行われません。

### expirationDate

エポックミリ秒形式の値です。作成方法 (例: ヘルパーモジュールを使用する場合) によっては、ISO8601形式の値を使用できます。ISO8601形式の値は、エポックミリ秒形式に変換されます。

### fileRef

ファイルUIDの配列です。レコードにファイルが添付されると、そのファイルのUIDがこの配列に追加されます。

### host

以下の要素を含む辞書型の値です。

* `hostName` - ホスト名またはIPアドレス
* `port` - 接続先のポート番号

いずれのキーも必須ではありません。

例

```
{"hostName": "localhost", "port":"22"}
```

以下の要素を含む辞書型の値です。

* `publicKey` - 公開鍵
* `privateKey` - 秘密鍵

いずれのキーも必須ではありません。

例

```
{"publicKey":"PUBLIC KEY", "privateKey":"PRIVATE KEY"}
```

### licenseNumber

文字列型の値です。値に対する検証は行われません。

### login

文字列型の値で、通常はユーザーのログイン名を指定します。値に対する検証は行われません。多くのKeeper関連サービスでは、ログイン情報としてこのフィールドタイプが参照されます。

### multiline

文字列型の値で、通常は改行を含むテキストに使用されます。値に対する検証は行われません。

### name

以下の要素を含む辞書型の値です。

* `first` - ファーストネーム
* `middle` - ミドルネーム
* `last` - ラストネーム

いずれのキーも必須ではありません。

例

```
{"first":"John", "middle":"Unknown", "last":"Smith"}
```

### note

複数行の入力に対応した文字列型の値です。値はマスク表示されます。値に対する検証は行われません。

### otp

TOTP用のワンタイムパスワードURLです。

### oneTimeCode

TOTP用のワンタイムコードURLです。

### password

文字列型の値です。値に対する検証は行われません。多くのKeeper関連サービスでは、パスワードの値としてこのフィールドタイプが参照されます。

### paymentCard

以下の要素を含む辞書型の値です。

* `cardNumber` - クレジットカード番号
* `cardExpirationDate` - MM/YYYY形式での有効期限
* `cardSecurityCode` - セキュリティコード

例

```
{"cardNumber":"5555 5555 5555 5555", "cardExpirationDate":"01/2023",
    "cardSecurityCode":"123"}
```

### phone

電話番号情報を含む辞書の配列です。各電話番号の辞書には、以下のキーと値が含まれます。

* `region` - 国番号
* `number` - 電話番号
* `ext` - 内線番号
* `type` - 電話番号の種別 (Mobile | Home | Work)

いずれのキーも必須ではありません。

例

```
[
    {"region": "+1", "number":"555-555-5555", "ext":"1234", "type":"Work"},
    {"number":"555-555-6666", "type":"Mobile"}
]
```

### pinCode

文字列型の値です。値に対する検証は行われません。

### secret

文字列型の値です。このタイプのフィールドは通常マスク表示されます。値に対する検証は行われません。

### securityQuestion

以下の要素を含む辞書型の値です。

* `question` - 秘密の質問
* `answer` - 秘密の質問への回答

例

```
{"question":"What Number?", "answer":"42"}
```

### text

文字列型の値です。値に対する検証は行われません。

### url

文字列型の値で、通常はウェブURLを指定します。値に対する検証は行われません。

## デフォルトのレコードタイプ

以下は、Keeperにあらかじめ用意されているデフォルトのレコードタイプと、それぞれのレコードタイプに含まれるフィールドの一覧です。レコードタイプには、標準フィールドとして使用される複数のフィールドタイプが定義されています。なお、カスタムフィールドはレコードタイプによって定義されるものではありません。

{% hint style="info" %}
すべてのデフォルトレコードタイプには、`fileRef` フィールドが含まれています。このフィールドには、レコードに添付されたファイルのUIDおよび写真のUIDが含まれます。ファイルのダウンロード方法については、使用しているSDKのドキュメントを参照してください。

なお、現時点ではSDKを使用したファイルの添付には制限があります。
{% endhint %}

### address (住所)

<figure><img src="/files/oJZ5S7RNPCHomY1z9r8k" alt=""><figcaption></figcaption></figure>

| フィールドタイプ | UIフィールド                                  |
| -------- | ---------------------------------------- |
| address  | <p>住所1<br>住所2<br>市<br>県<br>郵便番号<br>国</p> |

### bankAccount (銀行口座)

<figure><img src="/files/t1zeVuF33tv0VCYFC8B7" alt=""><figcaption></figcaption></figure>

| フィールドタイプ                     | UIフィールド                                   |
| ---------------------------- | ----------------------------------------- |
| bankAccount                  | <p>口座種別<br>その他の種類<br>口座番号<br>ルーティング番号</p> |
| name                         | <p>ファーストネーム<br>ミドルネーム<br>ラストネーム</p>       |
| login                        | ログイン                                      |
| password                     | パスワード                                     |
| url                          | ウェブサイトのアドレス                               |
| cardRef (値はbankCardのUIDレコード) | クレジットカード                                  |

### bankCard (クレジットカード)

<figure><img src="/files/kgFoGN6h1Uc72PfYZQrh" alt=""><figcaption></figcaption></figure>

| フィールドタイプ                  | UIフィールド                                       |
| ------------------------- | --------------------------------------------- |
| paymentCard               | <p>カード番号<br>有効期限の月<br>有効期限の年<br>セキュリティコード</p> |
| text                      | カードの所有者名                                      |
| pinCode                   | 暗証番号                                          |
| addressRef (値は住所のUIDレコード) | 住所 (UIについてはaddressのレコードタイプを参照)                |

### birthCertificate (出生証明書)

<figure><img src="/files/x5jWWg950c48KBTxDgqk" alt=""><figcaption></figcaption></figure>

* name - ファーストネーム、ミドルネーム、ラストネーム
* birthDate - 生年月日

| フィールドタイプ  | UIフィールド                             |
| --------- | ----------------------------------- |
| name      | <p>ファーストネーム<br>ミドルネーム<br>ラストネーム</p> |
| birthDate | 生年月日                                |

### contact (連絡先)

<figure><img src="/files/Kb37HJ8dJq2h0FB636po" alt=""><figcaption></figcaption></figure>

| フィールドタイプ                  | UIフィールド                             |
| ------------------------- | ----------------------------------- |
| name                      | <p>ファーストネーム<br>ミドルネーム<br>ラストネーム</p> |
| text                      | 会社名                                 |
| email                     | メール                                 |
| phone                     | <p>国<br>電話番号<br>内線番号<br>種別</p>      |
| addressRef (値は住所のUIDレコード) | 住所 (UIについてはaddressのレコードタイプを参照)      |

### databaseCredentials (データベース)

<figure><img src="/files/TQ52flUeQLbNVXLgdmXR" alt=""><figcaption></figcaption></figure>

| フィールドタイプ | UIフィールド                     |
| -------- | --------------------------- |
| text     | 種別                          |
| host     | <p>ホスト名またはIPアドレス<br>ポート</p> |
| login    | ログイン                        |
| password | パスワード                       |

### driverLicense (運転免許証)

<figure><img src="/files/DNKBmhHt5vwE2SGwMbRW" alt=""><figcaption></figcaption></figure>

| フィールドタイプ                  | UIフィールド                             |
| ------------------------- | ----------------------------------- |
| accountNumber             | 運転免許番号                              |
| name                      | <p>ファーストネーム<br>ミドルネーム<br>ラストネーム</p> |
| birthDate                 | 生年月日                                |
| addressRef (値は住所のUIDレコード) | 住所 (UIについてはaddressのレコードタイプを参照)      |
| expirationDate            | 有効期限                                |

### encryptedNotes (セキュアノート)

<figure><img src="/files/NDZh36xZqwhkzEpUR91Y" alt=""><figcaption></figcaption></figure>

| フィールドタイプ | UIフィールド |
| -------- | ------- |
| note     | メモ      |
| date     | 日付      |

### file (添付ファイル)

このレコードは、別のレコードにファイルが添付された際に作成されます。作成されたレコードのUIDは、`fileRef` フィールドタイプを通じて対象のレコードに関連付けられます。

なお、現時点では、すべてのSDKにおいてレコードへのファイル添付機能は未完了です。今後、内容が追加される予定です。

### healthInsurance (健康保険)

<figure><img src="/files/sntpWS2nyn79D2mogb3u" alt=""><figcaption></figcaption></figure>

|               |                                     |
| ------------- | ----------------------------------- |
| accountNumber | 口座番号                                |
| name          | <p>ファーストネーム<br>ミドルネーム<br>ラストネーム</p> |
| login         | ログイン                                |
| password      | パスワード                               |
| url           | ウェブサイトアドレス                          |

### login (ログイン)

<figure><img src="/files/19zsTlx96K6LOa3zqk9v" alt=""><figcaption></figcaption></figure>

| フィールドタイプ | UIフィールド    |
| -------- | ---------- |
| login    | ログイン       |
| password | パスワード      |
| url      | ウェブサイトアドレス |

### membership (メンバーシップ)

<figure><img src="/files/bOtwKS4cnfVr2pBaDyi0" alt=""><figcaption></figcaption></figure>

| フィールドタイプ      | UIフィールド                             |
| ------------- | ----------------------------------- |
| accountNumber | 口座番号                                |
| name          | <p>ファーストネーム<br>ミドルネーム<br>ラストネーム</p> |
| password      | パスワード                               |

### passport (パスポート)

<figure><img src="/files/poC1Fcw44xWHHm43V5J2" alt=""><figcaption></figcaption></figure>

| フィールドタイプ                  | UIフィールド                             |
| ------------------------- | ----------------------------------- |
| accountNumber             | パスポート番号                             |
| name                      | <p>ファーストネーム<br>ミドルネーム<br>ラストネーム</p> |
| birthDate                 | 生年月日                                |
| addressRef (値は住所のUIDレコード) | 住所 (UIについてはaddressのレコードタイプを参照)      |
| expirationDate            | 有効期限                                |
| date                      | 発行日                                 |
| password                  | パスワード                               |

### photo (画像)

このレコードは、画像が別のレコードに添付されたときに作成されます。UIDレコードは、`fieldRef`フィールドタイプを使用してレコードに添付されます。

現在、すべてのSDKでレコードへの画像添付は完了していません。コンテンツは追加予定です。

### serverCredentials (サーバー)

<figure><img src="/files/fBhmbv9Q8BtBD4NzwOzr" alt=""><figcaption></figcaption></figure>

| フィールドタイプ | UIフィールド                     |
| -------- | --------------------------- |
| host     | <p>ホスト名またはIPアドレス<br>ポート</p> |
| login    | ログイン                        |
| password | パスワード                       |

### softwareLicense (ソフトウェアライセンス)

<figure><img src="/files/uIqGM5re0uuN8k9lL5I8" alt=""><figcaption></figcaption></figure>

| フィールドタイプ       | UIフィールド       |
| -------------- | ------------- |
| licenseNumber  | ソフトウェアライセンスキー |
| expirationDate | 有効期限          |
| date           | 有効化した日        |

### ssnCard (IDカード)

<figure><img src="/files/D9VQqDArZilY4FRwwp9k" alt=""><figcaption></figcaption></figure>

| フィールドタイプ      | UIフィールド                             |
| ------------- | ----------------------------------- |
| accountNumber | ID番号                                |
| name          | <p>ファーストネーム<br>ミドルネーム<br>ラストネーム</p> |

### sshKeys (SSH鍵)

<figure><img src="/files/rnwC5iIjTIdWuzJhhAG7" alt=""><figcaption></figcaption></figure>

| フィールドタイプ | UIフィールド                     |
| -------- | --------------------------- |
| login    | ログイン                        |
| keyPair  | <p>公開鍵<br>秘密鍵</p>           |
| password | パスフレーズ                      |
| host     | <p>ホスト名またはIPアドレス<br>ポート</p> |

## カスタムのレコードタイプ

カスタムレコードタイプは、シークレットマネージャーで使用できます。

カスタムレコードタイプのスキーマは、Keeperコマンダーを使用して取得できます。

```
My Vault> rti --format json -lr "My Custom" --output my_record_type.json
[
  {
    "recordTypeId":18,
    "content": "{\"$id\":\"My Custom\",\"categories\":[\"login\"],
        \"description\":\"SSH key template\",\"fields\":
           [{\"$ref\":\"login\"},
            {\"$ref\":\"keyPair\"},
            {\"$ref\":\"password\",\"label\":\"passphrase\"},
            {\"$ref\":\"host\"},
            {\"$ref\":\"fileRef\"}]}"
  }
]
```

使用しているSDKに基づいて、JSONをインポートし、任意のヘルパーツールでカスタムのレコードを使用できます。


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.keeper.io/keeperpam/jp/secrets-manager/about/field-record-types.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
