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