このガイドでは、HTTPを通じてDICOMファイルを受け取るASP.NET Coreの匿名化マイクロサービスを構築する方法を学び、構成可能なプロフィールを使用して匿名的化し、未識別された結果を返します。
テーブルコンテンツ
アーキテクチャの概要
マイクロサービスは、問題の明確な分離を備えた層化されたアーキテクチャに従います. API 層は ASP.NET Core コントローラーを通じて HTTP リクエストと回答を処理します. サービス レイヤーは Aspose.Medical Anonymizer を使用してビジネス論理を含みます。
このアーキテクチャは、水平スケール、簡単なテスト、病院情報システムとPACSサーバーとのシンプルな統合を可能にします。
プロジェクトを設定する
新しい ASP.NET Core Web API プロジェクトを作成し、必要なパッケージをインストールすることから始まります。
dotnet new webapi -n DicomAnonymizationService
cd DicomAnonymizationService
dotnet add package Aspose.Medical
大ファイルアップロードのプロジェクトを設定する Program.cs:
var builder = WebApplication.CreateBuilder(args);
// Configure for large DICOM files
builder.WebHost.ConfigureKestrel(options =>
{
options.Limits.MaxRequestBodySize = 500_000_000; // 500MB
});
builder.Services.Configure<FormOptions>(options =>
{
options.MultipartBodyLengthLimit = 500_000_000;
});
// Register services
builder.Services.AddScoped<IDicomAnonymizationService, DicomAnonymizationService>();
builder.Services.AddControllers();
var app = builder.Build();
app.MapControllers();
app.Run();
サービスレイヤーの実施
匿名化サービスのインターフェイスと実装を作成する:
using Aspose.Medical.Dicom;
using Aspose.Medical.Dicom.Anonymization;
public interface IDicomAnonymizationService
{
Task<byte[]> AnonymizeAsync(Stream inputStream, string? profileName = null);
Task<byte[]> AnonymizeAsync(byte[] inputBytes, string? profileName = null);
}
public class DicomAnonymizationService : IDicomAnonymizationService
{
private readonly ILogger<DicomAnonymizationService> _logger;
private readonly Dictionary<string, ConfidentialityProfileOptions> _profiles;
public DicomAnonymizationService(ILogger<DicomAnonymizationService> logger)
{
_logger = logger;
_profiles = new Dictionary<string, ConfidentialityProfileOptions>
{
["basic"] = ConfidentialityProfileOptions.BasicProfile,
["research"] = ConfidentialityProfileOptions.BasicProfile |
ConfidentialityProfileOptions.RetainPatientChars,
["internal"] = ConfidentialityProfileOptions.RetainUIDs |
ConfidentialityProfileOptions.RetainDeviceIdent,
["clean"] = ConfidentialityProfileOptions.CleanGraph |
ConfidentialityProfileOptions.CleanDesc
};
}
public async Task<byte[]> AnonymizeAsync(Stream inputStream, string? profileName = null)
{
using var memoryStream = new MemoryStream();
await inputStream.CopyToAsync(memoryStream);
return await AnonymizeAsync(memoryStream.ToArray(), profileName);
}
public Task<byte[]> AnonymizeAsync(byte[] inputBytes, string? profileName = null)
{
return Task.Run(() =>
{
// Create anonymizer with selected profile
Anonymizer anonymizer = CreateAnonymizer(profileName);
// Load DICOM from bytes
using var inputStream = new MemoryStream(inputBytes);
DicomFile dcm = DicomFile.Open(inputStream);
// Anonymize
DicomFile anonymizedDcm = anonymizer.Anonymize(dcm);
// Write to output stream
using var outputStream = new MemoryStream();
anonymizedDcm.Save(outputStream);
_logger.LogInformation("Anonymized DICOM file using profile: {Profile}",
profileName ?? "default");
return outputStream.ToArray();
});
}
private Anonymizer CreateAnonymizer(string? profileName)
{
if (string.IsNullOrEmpty(profileName) || !_profiles.ContainsKey(profileName.ToLower()))
{
return new Anonymizer();
}
var options = _profiles[profileName.ToLower()];
var profile = ConfidentialityProfile.CreateDefault(options);
return new Anonymizer(profile);
}
}
APIコントローラーの構築
ファイルアップロードを処理し、匿名のDICOMファイルを返すコントローラを作成する:
using Microsoft.AspNetCore.Mvc;
[ApiController]
[Route("api/[controller]")]
public class AnonymizeController : ControllerBase
{
private readonly IDicomAnonymizationService _anonymizationService;
private readonly ILogger<AnonymizeController> _logger;
public AnonymizeController(
IDicomAnonymizationService anonymizationService,
ILogger<AnonymizeController> logger)
{
_anonymizationService = anonymizationService;
_logger = logger;
}
/// <summary>
/// Anonymize a single DICOM file
/// </summary>
[HttpPost]
[RequestSizeLimit(500_000_000)]
public async Task<IActionResult> AnonymizeFile(
IFormFile file,
[FromQuery] string? profile = null)
{
if (file == null || file.Length == 0)
{
return BadRequest("No file uploaded");
}
try
{
_logger.LogInformation("Processing file: {FileName}, Size: {Size}",
file.FileName, file.Length);
using var stream = file.OpenReadStream();
byte[] anonymizedBytes = await _anonymizationService.AnonymizeAsync(stream, profile);
string outputFileName = $"anonymized_{file.FileName}";
return File(anonymizedBytes, "application/dicom", outputFileName);
}
catch (Exception ex)
{
_logger.LogError(ex, "Error anonymizing file: {FileName}", file.FileName);
return StatusCode(500, $"Anonymization failed: {ex.Message}");
}
}
/// <summary>
/// Anonymize DICOM data from request body
/// </summary>
[HttpPost("stream")]
[RequestSizeLimit(500_000_000)]
public async Task<IActionResult> AnonymizeStream([FromQuery] string? profile = null)
{
try
{
byte[] anonymizedBytes = await _anonymizationService.AnonymizeAsync(
Request.Body, profile);
return File(anonymizedBytes, "application/dicom", "anonymized.dcm");
}
catch (Exception ex)
{
_logger.LogError(ex, "Error anonymizing stream");
return StatusCode(500, $"Anonymization failed: {ex.Message}");
}
}
/// <summary>
/// List available anonymization profiles
/// </summary>
[HttpGet("profiles")]
public IActionResult GetProfiles()
{
var profiles = new[]
{
new { name = "basic", description = "Standard anonymization removing most identifiers" },
new { name = "research", description = "Retains patient characteristics for research" },
new { name = "internal", description = "Retains UIDs for internal tracking" },
new { name = "clean", description = "Removes burned-in graphics and descriptions" }
};
return Ok(profiles);
}
}
設定可能なプロファイル
プロフィールを設定することを許可する appsettings.json:
{
"AnonymizationProfiles": {
"default": "basic",
"profiles": {
"basic": ["BasicProfile"],
"research": ["BasicProfile", "RetainPatientChars"],
"internal": ["RetainUIDs", "RetainDeviceIdent"],
"clean": ["CleanGraph", "CleanDesc"],
"maximum": ["BasicProfile", "CleanGraph", "CleanDesc"]
}
}
}
設定クラスを作成し、設定から読み取るためにサービスを更新します。
public class AnonymizationProfileOptions
{
public string Default { get; set; } = "basic";
public Dictionary<string, string[]> Profiles { get; set; } = new();
}
// In Program.cs
builder.Services.Configure<AnonymizationProfileOptions>(
builder.Configuration.GetSection("AnonymizationProfiles"));
セキュリティ上の考慮事項
このサービスを導入する際、これらのセキュリティ対策を実施します。
すべての通信がトランジットで暗号化されていることを保証するために HTTPS を有効にします. TLS 1.2 またはそれ以上を設定し、HTTP にリダイレクトします。
実施認証 JWT トークンまたは API キーを使用して、認定されたクライアントへのアクセスを制限します。
[Authorize]
[ApiController]
[Route("api/[controller]")]
public class AnonymizeController : ControllerBase
{
// Controller code...
}
**ディスクに暗号化されていないオリジナルのファイルを保存することを避け、可能な限りメモリに処理し、一時的なストレージが必要な場合は暗示されたボリュームを使用します。
監査のログインを有効にするは、誰がそれらを要求したかを含むすべての匿名化作業を追跡し、以下の場合:
_logger.LogInformation(
"Anonymization completed - User: {User}, Profile: {Profile}, FileSize: {Size}",
User.Identity?.Name, profile, file.Length);
パフォーマンス最適化(Performance Optimization)
いくつかのテクニックは、高パワーシナリオのパフォーマンスを向上させることができます。
**オリジナルのデータをメモリに保存する必要がない場合に現地匿名化を使用する:
anonymizer.AnonymizeInPlace(dcm);
バッチ作業のためのパラレル処理を有効にする:
[HttpPost("batch")]
public async Task<IActionResult> AnonymizeBatch(List<IFormFile> files)
{
var results = await Parallel.ForEachAsync(
files,
new ParallelOptions { MaxDegreeOfParallelism = Environment.ProcessorCount },
async (file, ct) =>
{
using var stream = file.OpenReadStream();
return await _anonymizationService.AnonymizeAsync(stream);
});
// Return results...
}
**RabbitMQ や Azure Service Bus のようなメッセージ キーを使用して非常に大きなバッグのためのクエウを要求して、サービスを圧倒せずに充電スピックを処理します。
結論( )
あなたは今、ASP.NET Core で DICOM 匿名化マイクロサービスを構築するための完全なスケジュールを持っています. このサービスは、HTTP を介して DICom ファイルを受け入れ、Aspose.Medical を使用して構成可能な匿名的化プロファイルを適用し、研究または共有のための準備が整った未識別ファイルを取り戻します。
重要な取り組みには、維持性のために層化されたアーキテクチャを使用し、柔軟性のための構成可能なプロファイルを実施すること、認証および暗号化でサービスを確保すること、並行処理でパフォーマンスを最適化することなどがあります。
完全なソースコードと追加の例については、参照してください。 メディカル・ドキュメンタリー火を試してみると、 無料の暫定ライセンスを取得.
