New Playback:AllowAnonymousListening / Playback:AnonymousFragmentSeconds
settings control whether a request without a session can stream at all,
and if so, whether it's limited to a fragment instead of the full track:
- GET /tracks/{id}/stream and GET /youtube/tracks/{videoId}/stream no
longer require authorization outright; the handlers gate on the config
instead, so both keep working exactly as before when it's off (the
default).
- The fragment cap is enforced by the Streaming Gateway, not the client:
the stream ticket now carries an optional maxBytes claim (computed from
AnonymousFragmentSeconds and the transcoder's known bitrate), and
TicketValidationMiddleware clamps the Range it forwards to SeaweedFS to
stay under it — synthesizing one if the request didn't send one, and
answering 416 outright if the requested range starts past the cap.
- A YouTube track that hasn't been provisioned server-side yet streams
straight from YouTube's CDN, bypassing the Gateway entirely — there's no
way to cap that, so an anonymous request for one is refused (409) instead
of silently handing out an uncapped stream.
- ListeningHistory has a non-nullable UserId, so anonymous plays simply
don't get recorded rather than trying to force a row through the FK.
Also fixes a real, pre-existing bug this surfaced: the AppSettings.Development.json
of the Api, Worker, and StreamingGateway all pointed StreamTicket/Workers
paths at "../../deploy/..." — one directory short of deploy/'s actual
location at the repo root relative to each project's own folder. Docker
never hit this (it mounts an absolute /keys path), so it had apparently
never been exercised via `dotnet run` before.
15 lines
705 B
C#
15 lines
705 B
C#
namespace Musify.Application.Contracts
|
|
{
|
|
public interface IStreamTicketService
|
|
{
|
|
/// <param name="userId">Null for an anonymous listener — the ticket is issued without a
|
|
/// <c>sub</c> claim.</param>
|
|
/// <param name="keyPrefix">The storage key (prefix) the ticket authorizes reading from.</param>
|
|
/// <param name="maxBytes">When set, the Streaming Gateway clamps the byte range it will serve
|
|
/// for this ticket to <c>[0, maxBytes)</c> — used for the anonymous preview fragment.</param>
|
|
StreamTicket IssueTicket(long? userId, string keyPrefix, long? maxBytes = null);
|
|
}
|
|
|
|
public record StreamTicket(string Token, int ExpiresInSeconds);
|
|
}
|