3849c16666
b3 of the multi-provider email roadmap. Adds ImapConnection model + table (reconciler pattern, SQLite+MySQL), ImapService (MailKit-backed IMAP client), ImapProvider implementing the existing IEmailProvider contract unchanged, and ImapController for credential-based connect (no OAuth — user supplies host/username/password directly, verified by a live connect before storage). Scope, documented inline with ponytail: comments: - INBOX only, no multi-folder support. - Thread grouping approximates the References/In-Reply-To chain root rather than the IMAP THREAD extension, which not every server implements. - External message ids are IMAP UIDs, scoped to the connection's current UIDVALIDITY. Security: ran the security-audit skill against this diff (credential handling + arbitrary-host connect is exactly the class of change the standing security gate exists for). Found and fixed a real SSRF: the connect endpoint let an authenticated user point the server at an arbitrary host:port with no internal-range check, and connect-vs-auth failure was distinguishable to the caller -- together a working oracle to fingerprint internal services (loopback/RFC1918/link-local/cloud metadata) from the server's network position. Fixed with EnsureHostIsExternalAsync (DNS-resolve + reject internal ranges, re-checked on every reconnect to close the DNS-rebinding gap) and a single generic failure message that no longer distinguishes connect vs auth failure. 7 regression tests added. Dependency: MailKit 4.17.0 (MIT license) on JobTrackerBackend.csproj -- stdlib has no IMAP client; hand-rolling IMAP4rev1 (TLS, SASL, MIME parsing) would be a large, security-sensitive protocol implementation nobody asked for, so this is the correct dependency, not a stdlib substitute. 168/168 green (161 existing + 7 new SSRF regression tests; the earlier 14 IMAP feature tests are included in the 161). Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
64 lines
2.6 KiB
C#
64 lines
2.6 KiB
C#
using JobTrackerApi.Services;
|
|
|
|
namespace JobTrackerApi.Services.EmailProviders
|
|
{
|
|
/// <summary>
|
|
/// Generic IMAP implementation of <see cref="IEmailProvider"/> for mailboxes with no
|
|
/// dedicated OAuth provider. Adapts <see cref="IImapService"/> to the provider-neutral
|
|
/// contract, mapping IMAP DTOs to the neutral shapes.
|
|
/// </summary>
|
|
public sealed class ImapProvider : IEmailProvider
|
|
{
|
|
private readonly IImapService _imap;
|
|
|
|
public ImapProvider(IImapService imap)
|
|
{
|
|
_imap = imap;
|
|
}
|
|
|
|
public string ProviderKey => "imap";
|
|
|
|
public async Task<EmailConnectionInfo?> GetConnectionAsync(string ownerUserId, CancellationToken cancellationToken)
|
|
{
|
|
var connection = await _imap.GetConnectionAsync(ownerUserId, cancellationToken);
|
|
return connection is null ? null : new EmailConnectionInfo("imap", connection.Username ?? "");
|
|
}
|
|
|
|
public async Task<IReadOnlyList<EmailMessageSummary>> SearchAsync(string ownerUserId, string? query, int maxResults, CancellationToken cancellationToken)
|
|
{
|
|
var messages = await _imap.ListMessagesAsync(ownerUserId, query, maxResults, cancellationToken);
|
|
return messages.Select(ToSummary).ToList();
|
|
}
|
|
|
|
public async Task<IReadOnlyList<EmailMessageSummary>> ListThreadMessagesAsync(string ownerUserId, string threadId, CancellationToken cancellationToken)
|
|
{
|
|
var messages = await _imap.ListThreadMessagesAsync(ownerUserId, threadId, cancellationToken);
|
|
return messages.Select(ToSummary).ToList();
|
|
}
|
|
|
|
public async Task<EmailMessageDetail> GetMessageAsync(string ownerUserId, string messageId, CancellationToken cancellationToken)
|
|
{
|
|
var detail = await _imap.GetMessageAsync(ownerUserId, messageId, cancellationToken);
|
|
var attachments = detail.Attachments
|
|
.Select(a => new EmailAttachmentRef(a.FileName, a.MimeType, a.SizeBytes, a.ContentId, a.Inline))
|
|
.ToList();
|
|
|
|
return new EmailMessageDetail(
|
|
detail.Id,
|
|
detail.ThreadKey,
|
|
detail.Subject,
|
|
detail.From,
|
|
detail.To,
|
|
detail.Date,
|
|
detail.Snippet,
|
|
detail.BodyText,
|
|
detail.BodyHtml,
|
|
detail.Labels,
|
|
attachments);
|
|
}
|
|
|
|
private static EmailMessageSummary ToSummary(ImapMessageSummary m)
|
|
=> new(m.Id, m.ThreadKey, m.Subject, m.From, m.To, m.Date, m.Snippet);
|
|
}
|
|
}
|