Skip to main content

INotificationDeliveryService Interface

Abblix.Oidc.Server

Abblix.Oidc.Server.Features.BackChannelAuthentication.Interfaces

INotificationDeliveryService Interface

Provides HTTP-based notification services for CIBA ping and push modes.

public interface INotificationDeliveryService

Derived
HttpNotificationDeliveryService

Remarks

This interface supports both CIBA notification modes by sending HTTP POST requests with a notification payload to the client's registered endpoint.

  • Ping Mode: Sends auth_req_id to notify client that tokens are ready for retrieval.
  • Push Mode: Delivers complete token response directly to client endpoint.

Methods

INotificationDeliveryService.SendAsync(Uri, string, IBackChannelNotificationRequest, string) Method

Sends an HTTP POST notification to the client's registered endpoint.

System.Threading.Tasks.Task<bool> SendAsync(System.Uri clientNotificationEndpoint, string clientNotificationToken, Abblix.Oidc.Server.Features.BackChannelAuthentication.Interfaces.IBackChannelNotificationRequest payload, string mode);

Parameters

clientNotificationEndpoint System.Uri

The HTTPS URL of the client's notification endpoint.

clientNotificationToken System.String

Bearer token for authenticating the notification request.

payload IBackChannelNotificationRequest

The notification payload to send (e.g., ping notification or push token delivery).

mode System.String

The CIBA mode (e.g., "ping" or "push") for logging purposes.

Returns

System.Threading.Tasks.Task<System.Boolean>
true if the client endpoint accepted the notification (2xx response); false if delivery failed (non-success status or transport error). Push mode relies on this to avoid discarding the grant when token delivery did not reach the client.