Class MicrosoftGraphInvitationDeliveryOptions

Namespace: Cephalon.MultiTenancy.Governance.MicrosoftGraphDelivery.Configuration
Assembly: Cephalon.MultiTenancy.Governance.MicrosoftGraphDelivery.dll

Configures Microsoft Graph sendMail delivery for tenant invitations dispatched by the governance companion pack.

public sealed class MicrosoftGraphInvitationDeliveryOptions

Inheritance

object ← MicrosoftGraphInvitationDeliveryOptions

Inherited Members

object.Equals(object?), object.Equals(object?, object?), object.GetHashCode(), object.GetType(), object.ReferenceEquals(object?, object?), object.ToString()

Remarks

The Microsoft Graph sender posts one JSON sendMail request to Microsoft Graph. It does not own OAuth credential issuance, mailbox provisioning, Graph change notifications, provider polling, public onboarding, SMS, chat, CRM, or identity-provider invitation flows.

Constructors

MicrosoftGraphInvitationDeliveryOptions()

Initializes a new instance of the class.

public MicrosoftGraphInvitationDeliveryOptions()

Properties

AcceptedStatusCodes

Gets or sets response status codes that indicate Microsoft Graph accepted the request.

public IReadOnlyList<int> AcceptedStatusCodes { get; set; }

Property Value

IReadOnlyList<int>

Remarks

The default accepts 202 Accepted, which means Graph accepted the send request but not that downstream mail delivery has completed.

AccessToken

Gets or sets an optional static Microsoft Graph bearer token.

public string? AccessToken { get; set; }

Property Value

string?

Remarks

Production hosts should usually register instead of storing a short-lived token in configuration.

ApiVersion

Gets or sets the Microsoft Graph API version segment.

public string ApiVersion { get; set; }

Property Value

string

Remarks

The default is v1.0. Preview or beta endpoints should be used only by hosts that deliberately accept that external API stability posture.

BaseUrl

Gets or sets the Microsoft Graph API base URL.

public string BaseUrl { get; set; }

Property Value

string

Remarks

The default targets the global Microsoft Graph cloud. Sovereign-cloud hosts can set this to the appropriate Graph endpoint while keeping the same sendMail request contract.

Categories

Gets or sets Microsoft Graph message categories added to each request.

public IReadOnlyList<string> Categories { get; set; }

Property Value

IReadOnlyList<string>

Enabled

Gets or sets a value indicating whether the Microsoft Graph invitation sender should be registered.

public bool Enabled { get; set; }

Property Value

bool

Headers

Gets or sets custom Microsoft Graph internet message headers added to each request.

public IReadOnlyDictionary<string, string> Headers { get; set; }

Property Value

IReadOnlyDictionary<string, string>

Remarks

The sender keeps only single-line custom x-* headers and filters message-core headers before sending.

HtmlBodyTemplate

Gets or sets the optional HTML Microsoft Graph message body template.

public string? HtmlBodyTemplate { get; set; }

Property Value

string?

Remarks

When configured, the sender uses a Graph message body with contentType = HTML. Otherwise it sends a plain text body.

IncludeContextHeaders

Gets or sets a value indicating whether safe Cephalon context headers should be added to the Graph message.

public bool IncludeContextHeaders { get; set; }

Property Value

bool

RecipientEmailMetadataKey

Gets or sets the metadata key used to resolve the recipient email address when the invitee id is not an email address.

public string RecipientEmailMetadataKey { get; set; }

Property Value

string

Remarks

The sender checks dispatch metadata first and invitation metadata second. If neither contains a value and InviteeKind is email, the invitee id is treated as the recipient address.

SaveToSentItems

Gets or sets a value indicating whether Microsoft Graph should save the message to Sent Items.

public bool SaveToSentItems { get; set; }

Property Value

bool

Remarks

The default is false so service-style invitation dispatch does not fill the sender mailbox by default. Hosts can opt in when mailbox history is part of their compliance posture.

SenderId

Gets or sets the sender identifier used by TenantInvitationDeliveryRequest.SenderId.

public string SenderId { get; set; }

Property Value

string

SenderUserId

Gets or sets the mailbox user id or user principal name used in /users/{id | userPrincipalName}/sendMail.

public string? SenderUserId { get; set; }

Property Value

string?

Remarks

When omitted, the sender posts to /me/sendMail. Application-permission hosts normally configure this value and provide a token with Microsoft Graph Mail.Send permission.

SubjectTemplate

Gets or sets the Microsoft Graph message subject template.

public string SubjectTemplate { get; set; }

Property Value

string

SupportedChannels

Gets or sets delivery channels accepted by this sender.

public IReadOnlyList<string> SupportedChannels { get; set; }

Property Value

IReadOnlyList<string>

Remarks

When empty, the sender accepts every requested channel.

TextBodyTemplate

Gets or sets the plain-text Microsoft Graph message body template.

public string TextBodyTemplate { get; set; }

Property Value

string

TimeoutSeconds

Gets or sets the maximum time allowed for the Microsoft Graph API request.

public int TimeoutSeconds { get; set; }

Property Value

int

Methods

FromConfiguration(IConfiguration, string)

Binds Microsoft Graph invitation delivery options from configuration.

public static MicrosoftGraphInvitationDeliveryOptions FromConfiguration(IConfiguration configuration, string sectionPath = "Engine")

Parameters

configuration IConfiguration

The application configuration root.

sectionPath string

The configuration section path that contains the engine settings. The default is Engine.

Returns

MicrosoftGraphInvitationDeliveryOptions

The bound Microsoft Graph invitation delivery options.