---
layout: Conceptual
title: Azure Cosmos DB シェルのセキュリティに関するベスト プラクティス - Azure Cosmos DB | Microsoft Learn
canonicalUrl: https://learn.microsoft.com/ja-jp/azure/cosmos-db/shell/security
schema: Conceptual
ai-usage: ai-assisted
author: sajeetharan
breadcrumb_path: ../../breadcrumb/azure-nosql/toc.json
depot_name: Learn.azure-nosql
description: 認証、資格情報管理、RBAC、データ保護など、Azure Cosmos DB シェルを使用するためのセキュリティのベスト プラクティスについて説明します。
document_id: dfea90cf-e9a3-e31c-0e0f-f42abacae3a0
document_version_independent_id: dfea90cf-e9a3-e31c-0e0f-f42abacae3a0
feedback_help_link_type: get-help-at-qna
feedback_help_link_url: /answers/tags/187/azure-cosmos-db/
feedback_product_url: https://feedback.azure.com/d365community/forum/3002b3be-0d25-ec11-b6e6-000d3a4f0858
feedback_system: Standard
git_commit_id: 16c9484b7ce2c37b491a4022345ffba8598ff09f
gitcommit: https://github.com/MicrosoftDocs/nosql-docs-pr/blob/16c9484b7ce2c37b491a4022345ffba8598ff09f/azure/cosmos-db/shell/security.md
locale: ja-jp
ms.author: sasinnat
ms.date: 2026-11-05T00:00:00.0000000Z
ms.reviewer: mjbrown
ms.service: azure-cosmos-db
ms.subservice: nosql
ms.topic: article
original_content_git_url: https://github.com/MicrosoftDocs/nosql-docs-pr/blob/live/azure/cosmos-db/shell/security.md
permissioned-type: public
recommendation_types:
- Training
- Certification
recommendations: true
site_name: Docs
uhfHeaderId: MSDocsHeader-NoSQL
updated_at: 2026-11-19T03:53:00.0000000Z
ms.translationtype: MT
ms.contentlocale: ja-jp
loc_version: 2026-11-19T00:02:43.2428394Z
loc_source_id: Github-992077500#live
loc_file_id: Github-992077500.live.Learn.azure-nosql.cosmos-db/shell/security.md
page_type: conceptual
toc_rel: ../toc.json
word_count: 5041
asset_id: cosmos-db/shell/security
item_type: Content
platformId: 7924edb1-a81d-e224-87ff-af7b8d910eef
---

# Azure Cosmos DB シェルのセキュリティに関するベスト プラクティス - Azure Cosmos DB | Microsoft Learn

これらの包括的なセキュリティのベスト プラクティスを使用して、Azure Cosmos DB Shell のデプロイをセキュリティで保護します。

## 認証方法

### 1. Microsoft Entra ID (推奨)

**次の場合に最適です。** 開発、テスト、本番環境

**利点:**

- 最も安全な認証方法
- 資格情報がローカルに格納されていない
- トークンの自動更新
- 多要素認証 (MFA) をサポートします
- Azureの完全な監査証跡

**実装:**

接続引数なしで起動すると、Cosmos DB シェルは切断された状態で起動します。 Microsoft Entra IDを使用してアカウント エンドポイントに接続して認証します。

```bash
cosmosdbshell
CS > connect https://<account-name>.documents.azure.com:443/ --tenant=<tenant-id>
```

`connect`の実行後に、Azureサインイン用にブラウザーが開きます。 フローを完了すると、シェルはMicrosoft Entra ID資格情報を使用します。

**環境設定:**

```bash
connect <account_endpoint> --tenant=<tenant-id>
```

**セキュリティ上の利点:**

- 資格情報がディスクに保存されない
- トークンが自動的に更新される
- MFA は追加の保護を提供します
- RBAC は、アクセスできる内容を制御します

### 2. マネージド ID (本番)

**最適な用途:** Azure でホストされるアプリケーションと運用環境

**利点:**

- 資格情報の管理は必要ありません
- トークンの自動更新
- Azure サービス (App Service、Functions、AKS) で動作します
- ローテーションが必要なシークレットはありません
- Azureのセキュリティ強化

**実装:**

Azure リソースでマネージド ID を有効にします。

**App Service の場合:**

```json
{
  "identity": {
    "type": "SystemAssigned"
  }
}
```

**ターミナルから:**

```bash
cosmosdbshell --connect https://<account-name>.documents.azure.com:443/ --connect-managed-identity=<client-id>
```

**セキュリティ構成:**

1. Azure リソースでマネージド ID を有効にする
2. Cosmos DB RBAC ロールを ID に割り当てる
3. シェルで ID 資格情報が自動的に使用される
4. シークレットは必要ありません

**利点:**

- 認証情報の管理ゼロ
- トークンの自動ローテーション
- すべての操作の監査証跡
- セキュリティ標準に準拠

### 3. アカウント キー (開発のみ)

**最適な用途:** ローカルでの開発とテストのみ

**欠点:**

- ローカルに格納されているキー (セキュリティ リスク)
- 手動回転が必要
- 単一障害点
- MFA を使用できない
- 運用環境ではお勧めしません

**実装:**

```bash
cosmosdbshell --connect "<connection_string>"
```

**リスクを最小限に抑えた使用:**

- 開発/テストのみ
- ソース管理にコミットしない
- 環境変数を使用：

```bash
# Set environment variable
export COSMOS_CONNECTION_STRING="your-connection-string"

# Use in script
cosmosdbshell --connect "$COSMOS_CONNECTION_STRING"
```

## 資格情報の管理

### ベスト プラクティス

#### 1. 資格情報をハードコーディングしない

** ❌ 悪い例:**

```bash
#!/bin/bash
cosmosdbshell --connect "AccountEndpoint=https://myaccount.documents.azure.com/;AccountKey=<account-key>;"
```

** ✅ 良い:**

```bash
#!/bin/bash
cosmosdbshell --connect "$COSMOS_CONNECTION_STRING"
```

#### 2. 環境変数を使用する

**開発:**

```bash
# .env file (development only)
COSMOS_CONNECTION_STRING="your-connection-string"

# Load and use
source .env
cosmosdbshell --connect "$COSMOS_CONNECTION_STRING"
```

#### 3. セキュリティで保護された保管庫に格納する

**Azure Key Vault:**

```bash
# Store connection string
az keyvault secret set --vault-name myKeyVault \
  --name cosmos-connection-string \
  --value "your-connection-string"

# Retrieve and use
CONNECTION_STRING=$(az keyvault secret show \
  --vault-name myKeyVault \
  --name cosmos-connection-string \
  --query value -o tsv)

cosmosdbshell --connect "$CONNECTION_STRING"
```

**ローカル開発:**

- `.env` ファイルを使用する (`.gitignore`に追加)
- 環境変数を使用した読み込み
- シークレットをコミットしない

#### 4. キーを定期的にローテーションする

**キーローテーションプロセス:**

1. Azure ポータルで新しいキーを生成する
2. 新しいキーを使用してアプリケーションを更新する
3. 検証後に古いキーを削除する
4. すべてのアプリケーションが動作することを確認する

## RBAC (ロールベースのアクセス制御)

### 最小権限を適用する

目的の操作に必要な最小限のアクセス許可を付与します。 Azure Cosmos DBネイティブデータプレーンロールとAzure管理プレーンロールは別々です。

| データ プレーン ロール | 利用シーン |
| --- | --- |
| `Cosmos DB Built-in Data Reader` | ドキュメントの読み取りとクエリの実行。 |
| `Cosmos DB Built-in Data Contributor` | ドキュメントの作成、読み取り、更新、および削除。 |

管理プレーン アカウント Reader ロールでは、ドキュメント クエリ アクセスは許可されません。 [Azure Cosmos DB ロールベースのアクセス制御ガイド](../how-to-connect-role-based-access-control)を使用して、ネイティブ データ ロールを目的のプリンシパルに割り当てます。 ジェネリック `az role assignment create` コマンドを使用して、これらのネイティブ ロールを割り当てないでください。

### コンテナーごとにアクセスを制限する

可能な場合は、ネイティブ データ ロールの割り当てを意図したデータベースまたはコンテナーに限定します。 組み込みロールによってワークフローに必要な数より多くのアクションが付与される場合は、カスタム ネイティブ データ ロールを使用します。 管理操作には、別のAzureロールが必要な場合があります。データ アクセスはアカウント管理承認として扱わないでください。

## データ保護

### 1. 転送中の暗号化

アカウントの HTTPS エンドポイントを使用します。 TLS ネゴシエーションでは、プラットフォームと SDK の構成が使用されます。シェルは、 `--tls-version` または `--min-tls-version` スタートアップ スイッチを提供しません。

接続を変更せずに接続と TLS 診断を検査するには、 `doctor` を使用します。 シェル フラグではなく、サポートされているAzure Cosmos DB アカウント設定を使用して、アカウント側のトランスポート要件を構成します。

### 2. 保存時の暗号化

**保存時の暗号化を有効にする:**

Azureは暗号化を自動的に処理しますが、次のことを確認します。

1. cosmos DB アカウント&gt;Azure ポータルに移動する
2. 保存時の暗号化 &gt; 設定
3. 暗号化が有効になっていることを確認する

**確認:**

```bash
# Check encryption settings
az cosmosdb show --resource-group myResourceGroup \
  --name myaccount \
  --query "encryption.keyWrapperProperties" -o table
```

### 3. カスタマー マネージド キー (CMK)

**セキュリティ強化のために:**

1. Azure Key Vault を作成する
2. 暗号化キーを生成する
3. CMK を使用するように Cosmos DB を構成する

**セットアップ:**

```bash
# Create key vault
az keyvault create --resource-group myResourceGroup \
  --name myKeyVault

# Create key
az keyvault key create --vault-name myKeyVault \
  --name cosmos-key

# Configure Cosmos DB (via Portal or Terraform)
```

## ネットワークのセキュリティ

### 1. IP ファイアウォール

**ファイアウォールを有効にする:**

1. Azure ポータルの&gt;Cosmos DB アカウント &gt; ファイアウォール
2. IP アドレスを追加する
3. 変更を保存する

**コマンドライン:**

```bash
# Add IP to firewall
az cosmosdb update --resource-group myResourceGroup \
  --name myaccount \
  --ip-range-filter "203.0.113.0/24"
```

### 2. 仮想エンドポイント

**VNet に制限する:**

```bash
# Enable virtual endpoint
az cosmosdb update --resource-group myResourceGroup \
  --name myaccount \
  --enable-virtual-network true
```

### 3. プライベート エンドポイント

**最大ネットワーク分離の場合:**

1. Azure ポータルでプライベート エンドポイントを作成する
2. DNS 設定を構成する
3. シェルがプライベート ネットワーク経由で接続する

**利点:**

- インターネット非公開
- 制限されたネットワーク アクセス
- エンタープライズ ネットワーク分離ポリシーをサポートします

## MCP サーバーのセキュリティ

オプションのシェル MCP サーバーは、ホストされた Azure サービスとしてではなく、ローカルで実行されます。 ホストとオリジンの検証を使用してループバックにバインドされます。 信頼されたローカル クライアントを `http://127.0.0.1:6128/` には Streamable HTTP で、または `/sse` にはレガシ SSE で接続します。 トンネルやポート フォワーディングで公開しないでください。

### 接続の識別情報とアクセス許可

MCP は、シェルの現在のAzure Cosmos DB接続を使用します。 Microsoft Entra IDまたはマネージド ID を使用してその接続を認証し、必要なデータ プレーンと管理プレーンのアクセス許可のみを付与します。 MCP を有効にしても、アカウント アクセスが追加されたり、別の MCP 認証境界が作成されたりすることはありません。

クライアントは、シェルの接続とナビゲーションを共有します。 account-root`info` を確認し、操作の前にデータベースとコンテナーに明示的に名前を付けます。 ドキュメントの内容とリソース名は、命令ではなくデータとして扱います。

### 破壊的操作

破壊的ツールには、明示的なユーザー確認が必要です。 強制引数は MCP ゲートをバイパスしません。 確認できないクライアントや、拒否されたプロンプト、または接続またはナビゲーション コンテキストの変更により、拒否されます。 別の実行ルートでバイパスしないでください。

対象アイテムの削除をプレビューし、実行時にその実際の ETag を使用します。 `batch` は、1 つのパーティション キー内でのみアトミックです。 `bulk` と `import` は、ロールバックなしで部分的に成功する可能性があります。 中断された書き込みを再試行する前に、結果を検査します。

### 履歴とクライアント データの処理

再生可能なシェル履歴には、MCP コマンドと接続文字列が含まれることがあります。 履歴ファイルとローカル エクスポートを機密データとして保護します。 ドキュメントの取得を許可する前に、あなたのクライアントのモデル プロバイダーのデータ処理を確認します。 サポートされている設定、ツールの制限、およびページネーションについては、[シェル MCP のセットアップ](model-context-protocol-setup)に関するページを参照してください。

## 監査と監視

### 1. 監査ログを有効にする

**Azure の監査ログ:**

```bash
# View audit logs
az monitor activity-log list \
  --resource-group myResourceGroup \
  --query "[?resourceId=='<cosmos-resource-id>']"
```

### 2. MCP アクティビティの監視

シェル ターミナルと MCP クライアントのツール呼び出し診断を調べます。 拡張機能では、MCP `logLevel` 設定は利用できません。 分散トレースが必要な場合は、アップストリーム構成に従ってシェルのオプションの `--otel` トレースを使用します。

共有する前に診断情報を確認してください。リソース名とクエリ結果は機微な情報である可能性があります。 シェル履歴は、サービス側の監査ログの代替にはなりません。

### 3. クエリ メトリック

**クエリのパフォーマンスを監視する:**

```bash
# Review query metrics
query "SELECT TOP 5 c.id FROM c" --database=MyDatabase --container=MyContainer --max=5 --metrics
```

**追跡すべきメトリック:**

- 使用される要求ユニット (RU)
- 実行時間
- アイテム数

## コンプライアンスと標準

### 1. データ レジデンシ

**データがリージョン内に保持されることを確認する:**

```bash
# Deploy Cosmos DB in specific region
az cosmosdb create --resource-group myResourceGroup \
  --name myaccount \
  --locations regionName="East US" \
  --databases only
```

### 2. コンプライアンス基準

Azure Cosmos DBは、広範なコンプライアンス認定を維持します。

- 最新の認定と監査レポートについては、「[Microsoft Azureコンプライアンスオファリング](https://servicetrust.microsoft.com/DocumentPage/7adf2d9e-d7b5-4e71-bad8-713e6a183cf3)」を参照してください。
- このサービスに固有のコンプライアンス情報については、[Azure Cosmos DBのコンプライアンスに関する説明を](../compliance)参照してください。

### 3. データの保持

**機密データの Time-to-Live (TTL) を設定する:**

保持期間を変更する前に、既存のコンテナーの構成を調べます。 サンプル リソース名を使用する名前に置き換えます。

```bash
ttl show --database=MyDatabase --container=sensitive_data
ttl set 2592000 --database=MyDatabase --container=sensitive_data
```

2 番目のコマンドは、既定の項目 TTL を各項目の最終変更後30日に設定します。 既存のデータの有効期限が切れる可能性があります。項目レベルの TTL 設定は、既定値をオーバーライドできます。 期限切れのアイテムはクエリ結果に表示されなくなりますが、物理的な削除は非同期的に行われます。 保持の変更を適用する前に、[TTL の動作](../time-to-live)を確認します。

## セキュリティ チェックリスト

- [ ] 認証にMicrosoft Entra IDを使用する
- [ ] Azure アカウントで MFA を有効にする
- [ ] 最小特権 RBAC を実装する
- [ ] IP ファイアウォールを有効にする
- [ ] 暗号化された接続を使用する (TLS 1.2 以降)
- [ ] 監査ログを有効にする
- [ ] MCP サーバーのアクティビティの監視
- [ ] 資格情報をKey Vaultに格納する
- [ ] キーを定期的にローテーションする
- [ ] 運用環境でプライベート エンドポイントを使用する
- [ ] 保存時の暗号化を有効にする
- [ ] コンプライアンス要件を確認する
- [ ] セキュリティ ポリシーを文書化する
- [ ] ユーザーにセキュリティプラクティスをトレーニングする

## セキュリティ上の一般的な間違い

### ❌ キーをコードに格納する

```bash
# DON'T do this
cosmosdbshell --connect "AccountEndpoint=https://myaccount.documents.azure.com/;AccountKey=<account-key>;"
```

### ✅ 環境変数を使用する

```bash
# DO this
export COSMOS_CONNECTION_STRING="..."
cosmosdbshell --connect "$COSMOS_CONNECTION_STRING"
```

### ❌ 運用環境でのアカウント キーの使用

```bash
# DON'T use keys in production with hardcoded connection strings
cosmosdbshell --connect "AccountEndpoint=https://myaccount.documents.azure.com:443/;AccountKey=<your-account-key>;"
```

### ✅ マネージド ID を使用する

```bash
# DO use managed identity
cosmosdbshell --connect https://<account-name>.documents.azure.com:443/ --connect-managed-identity=<client-id>
```

### ❌ ローカル MCP をリモートで公開する

パブリック プロキシ、トンネル、またはポートフォワーディングを介してループバックにバインドされたシェル サーバーを公開しないでください。

### ✅ MCP アクセスを制限する

サーバーをローカルに保ち、信頼できるクライアントのみ接続し、狭い範囲のアクセス許可を持つ ID を使用します。 [サポートされている拡張機能の設定のみを](visual-studio-code#configure-shell-settings)設定します。

## セキュリティ リソース

- [Azure のセキュリティのベスト プラクティス](/ja-jp/azure/security/fundamentals/best-practices-and-patterns)
- [Cosmos DB のセキュリティ](/ja-jp/azure/cosmos-db/database-security)
- [Key Vaultのベスト プラクティス](/ja-jp/azure/key-vault/general/best-practices)
- [Cosmos DB の RBAC](/ja-jp/azure/cosmos-db/role-based-access-control)

## AI ツール

これらのアクションを使用して、シークレットを共有せずに文書化されたセキュリティ ガイダンスについて説明します。

ドキュメントのみの取得には、[Microsoft Learn MCP サーバー](/ja-jp/training/support/mcp)を使用します。 コンパクト ガイド インデックスの場合は、 [Shell ドキュメント インデックス (`llms.txt`)](llms.txt) を使用します。 インデックスによってクローラーのアクセス許可が変更されたり、取得が保証されたりすることはありません。

シェル MCP には個別のセットアップが必要であり、構成されたアクセス許可でデータを読み取ったり変更したりできるため、承認する前にツールの呼び出しを確認してください。 資格情報や機密データを共有しないでください。

> 
> **[AI エージェントを接続する](/ja-jp/azure/cosmos-db/shell/model-context-protocol-setup)** シェル MCP を有効にする前に、認証とアクセス許可を確認します。
> 
> **[Markdown として読み取る](/ja-jp/azure/cosmos-db/shell/security?accept=text/markdown)** アシスタントに貼り付けるためにテキスト バージョンを開きます。
> 
> **[ChatGPT に質問する](https://chatgpt.com/?hint=search&amp;q=Read%20https%3A%2F%2Flearn.microsoft.com%2Fen-us%2Fazure%2Fcosmos-db%2Fshell%2Fsecurity%20and%20explain%20the%20documented%20Shell%20security%20guidance.%20Use%20sanitized%20configuration%20only.%20Cite%20the%20source%20and%20state%20if%20you%20cannot%20access%20it.)** 認証、アクセス制御、およびMCPに関する注意事項を説明してください。
> 
> **[Claudeに質問する](https://claude.ai/new?q=Read%20https%3A%2F%2Flearn.microsoft.com%2Fen-us%2Fazure%2Fcosmos-db%2Fshell%2Fsecurity%20and%20explain%20the%20documented%20Shell%20security%20guidance.%20Use%20sanitized%20configuration%20only.%20Cite%20the%20source%20and%20state%20if%20you%20cannot%20access%20it.)** 認証、アクセス制御、およびMCPの注意事項について説明します。

ChatGPT と Claude は、パブリック記事の URL とスターター プロンプトのみを受け取ります。 ここで、サインインを求められる場合があります。 取得に失敗した場合は、Markdown テキストをコピーしてください。 これらのリンクでデータベース アクセスを構成することはできません。 アシスタントの説明は、デプロイ環境に対するセキュリティ評価ではありません。

## Support

セキュリティ上の懸念事項または脆弱性の報告について:

- [セキュリティの問題を報告する](https://azure.microsoft.com/support/)
- [Azure セキュリティ アドバイザリ](https://msrc.microsoft.com/)