{
{"first", "John"},
{"middle", "Patrick"},
{"last", "Smith"}
}
},
required = true
},
new KeeperRecordField
{
type = "oneTimeCode",
value = new[]
{
"otpauth://totp/Example:alice@google.com?secret=JBSWY3DPEHPK3PXP&issuer=Example"
},
label = "My TOTP",
required = true
}
};
newRecord.notes = "\tThis custom type record was created\n\tvia .NET SDK copied from https://docs.keeper.io/secrets-manager/secrets-manager/developer-sdk-library/.net-sdk";
var recordUid = await SecretsManagerClient.CreateSecret(options, "[FOLDER_UID]", newRecord);
```
{% endtab %}
{% endtabs %}
### シークレットの削除
.Net KSM SDKでKeeperボルトのレコードを削除できます。
{% tabs %}
{% tab title="シークレットの削除" %}
```csharp
DeleteSecret(smOptions, recordsUids);
```
| パラメータ | 型 | 必須 |
|---|
smOptions | SecretsManagerOptions | はい |
recordsUids | string[] | はい |
{% endtab %}
{% tab title="使用例" %}
using SecretsManager;
// シークレットマネージャーを設定
var storage = new LocalConfigStorage("ksm-config.json");
//SecretsManagerClient.InitializeStorage(storage, "<One Time Access Token>");
var smOptions = new SecretsManagerOptions(storage);
// UIDレコードで特定のシークレットを削除
await SecretsManagerClient.DeleteSecret(smOptions, new string[] {"EG6KdJaaLG7esRZbMnfbFA"});
{% endtab %}
{% endtabs %}
### キャッシュ
ネットワークにアクセスできなくなった場合にシークレットへのアクセスを失わないよう、.Net SDKではシークレットをローカルマシン上の暗号化ファイルにキャッシュできます。
**キャッシュの設定と構成**
.Net SDKでキャッシュを設定するには、`SecretsManagerOptions` オブジェクトをインスタンス化する際に、2番目の引数としてキャッシュ用のポスト関数を含めます。
.Net SDKには標準のキャッシュ機能 `cachingPostFunction` が用意されており、キャッシュされたクエリをファイルに保存します。
```csharp
var options = new SecretsManagerOptions(storage, SecretsManagerClient.CachingPostFunction);
var secrets = await SecretsManagerClient.GetSecrets(options);
```
### フォルダ
フォルダは、作成・読み取り・更新・削除 (CRUD) のすべての操作に対応しています。
### フォルダの読み取り
フォルダの完全な階層構造をダウンロードします。
```csharp
Task GetFolders(SecretsManagerOptions options)
```
**レスポンス**
型: `KeeperFolder[]`
**使用例**
```csharp
using SecretsManager;
var options = new SecretsManagerOptions(new LocalConfigStorage("ksm-config.json"));
var folders = await SecretsManagerClient.GetFolders(options);
```
### フォルダの作成
`CreateOptions` とフォルダ名の指定が必要です。`CreateOptions` 内のフォルダUIDパラメータは必須で、共有フォルダのUIDを指定します。サブフォルダのUIDは任意であり、省略された場合は親 (共有フォルダ) 直下に通常のフォルダが新規作成されます。サブフォルダは必ずしも親共有フォルダの直接の子である必要はなく、階層を深く設定することも可能です。
```csharp
Task CreateFolder(SecretsManagerOptions options, CreateOptions createOptions, string folderName, KeeperFolder[] folders = null)
```
| パラメータ | 型 | 必須 | デフォルト | 説明 |
|---|
options | SecretsManagerOptions | はい | | 事前に設定されたオプション |
createOptions | CreateOptions | はい | | 親およびサブフォルダのUID |
folderName | string | はい | | フォルダ名 |
folders | KeeperFolder[] | いいえ | null | CreateOptionsで作成した親とサブフォルダの検索に使用するフォルダのリスト |
```csharp
public class CreateOptions {
public string FolderUid { get; }
public string SubFolderUid { get; }
}
```
```csharp
public class KeeperFolder {
public byte[] FolderKey { get; }
public string FolderUid { get; }
public string ParentUid { get; }
public string Name { get; }
}
```
**使用例**
```csharp
using SecretsManager;
var options = new SecretsManagerOptions(new LocalConfigStorage("ksm-config.json"));
var co = new CreateOptions("[PARENT_SHARED_FOLDER_UID]");
var folderUid = await SecretsManagerClient.CreateFolder(options, co, "new_folder");
```
### フォルダの更新
フォルダのメタデータ (現在はフォルダ名のみ) を更新します。
```csharp
Task UpdateFolder(SecretsManagerOptions options, string folderUid, string folderName, KeeperFolder[] folders = null)
```
| パラメータ | 型 | 必須 | デフォルト | 説明 |
|---|
options | SecretsManagerOptions | はい | | 事前に設定されたオプション |
folderUid | string | はい | | フォルダのUID |
folderName | string | はい | | 新しいフォルダ名 |
folders | KeeperFolder[] | いいえ | null | 親フォルダの検索に使用するフォルダのリスト |
**使用例**
```csharp
using SecretsManager;
var options = new SecretsManagerOptions(new LocalConfigStorage("ksm-config.json"));
await SecretsManagerClient.UpdateFolder(options, "[FOLDER_UID]", "new_folder_name");
```
### フォルダの削除
フォルダのリストを削除します。空でないフォルダを削除するには、`forceDeletion` フラグを使用します。
{% hint style="info" %}
`forceDeletion` を使用する場合、親フォルダとその子フォルダのUIDを同時に送信しないでください。削除の順序によってはエラーになることがあります（例: 親が子より先に強制削除される場合など）。リストが常にFIFO順で処理される保証はありません。
{% endhint %}
{% hint style="info" %}
ボルトに存在しないフォルダのUIDやKSMアプリケーションで共有されていないフォルダのUIDがあっても、エラーにはなりません。
{% endhint %}
```csharp
Task DeleteFolder(SecretsManagerOptions options, string[] folderUids, bool forceDeletion = false)
```
| パラメータ | 型 | 必須 | デフォルト | 説明 |
|---|
options | SecretsManagerOptions | はい | | 事前に設定されたオプション |
folderUids | string[] | はい | | フォルダUIDリスト |
forceDeletion | bool | いいえ | false | 空でないフォルダを強制的に削除 |
**使用例**
```csharp
using SecretsManager;
var options = new SecretsManagerOptions(new LocalConfigStorage("ksm-config.json"));
await SecretsManagerClient.DeleteFolder(options, new string[]{"[FOLDER_UID1]", "[FOLDER_UID2]"}, true);
```
### プロキシのサポート
.NET SDKでは、環境変数を使用する方法と、SecretsManagerOptionsに直接プロキシURLを渡す方法の2通りでプロキシを設定できます。
{% hint style="info" %}
Keeperでは、**環境変数**を使用したプロキシ設定を推奨しています。この方法により、設定情報をコード内に含めずに済み、ツールや環境間で一貫性を保ちながら、デプロイと保守を簡素化できます。
{% endhint %}
**環境変数による使用例**
```
HTTPS_PROXY=http://user:password@127.0.0.1:3128 dotnet run
```
**`SecretsManagerOptions` にURLを渡す使用例**
```csharp
var options = new SecretsManagerOptions(storage, null, false, "http://user:password@127.0.0.1:3128");
```
---
# 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/developer-sdk-library/.net-sdk.md?ask=
```
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.
