IRPCServerAdmin.GetNotificationSettings
Administration API / specialized admin session idempotent
Gets the server's notification settings and mail-sending configuration (without the SMTP password).
| Service | Server administration MFiles.IRPCServerAdmin |
|---|---|
| gRPC method | /MFiles.IRPCServerAdmin/GetNotificationSettings |
| HTTP (mf-http-grpc) | POST /grpc/v1/get-notification-settings |
| Request | GetNotificationSettingsRequest |
| Response | GetNotificationSettingsResponse |
| Book and level | Administration API, specialized |
| Kind | admin |
| Session | Required: the session ID from LogIn in the mfiles-session-id-bin metadata. |
| Idempotent | yes |
| Returns metadata structure version | no |
| Streaming | none (unary) |
Remarks
- Requires the system administrator server role (server right
edit_server_properties). Denied for other callers. oauth2_settingsis set only when OAuth 2.0 settings are stored.
Request: GetNotificationSettingsRequest
No fields.
Response: GetNotificationSettingsResponse
A structure that specifies the response type for the GetNotificationSettings method.
Nested message fields are expanded to depth 3; follow a type link for deeper levels and for the type's own page.
| Field | Type | Description |
|---|---|---|
notifications_enabled | bool | Tells if the notifications are enabled. |
digest_notification_message_hour_utc | uint32 | The hour (UTC, 0-23) when the daily digest messages are sent. |
digest_notification_message_minute_utc | uint32 | The minute (0-59) when the daily digest messages are sent. |
smtp_server | string | The SMTP server for delivering notifications. Can be an IP address or a DNS name. |
smtp_connection_parameters | SMTPConnectionParameters | Parameters for SMTP connection.Values: SMTPCONNECTION_PARAMETERS_STANDARD (0), SMTPCONNECTION_PARAMETERS_AUTHENTICATION_PLAIN (1), SMTPCONNECTION_PARAMETERS_AUTHENTICATION_LOGIN (2), SMTPCONNECTION_PARAMETERS_AUTHENTICATION_CRAM_MD5 (4). |
smtp_auth_username | string | User name for SMTP authentication. |
smtp_mail_from_address | string | The address of the sender when sending notifications. |
smtp_mail_from_display_name | string | The display name of the sender when sending notifications. |
smtp_port | uint32 | The port the SMTP server is listening. |
mail_source_auth_type | MailSourceAuthType | The authentication method to use.Values: MAIL_SOURCE_AUTH_TYPE_NONE (0), MAIL_SOURCE_AUTH_TYPE_BASIC (1), MAIL_SOURCE_AUTH_TYPE_OAUTH2 (2). |
oauth2_settings | Oauth2NotificationSettings | OAuth2 specific data. |
oauth2_settings.mail_source | MailSourceOauth2 | OAuth2 specific data. |
oauth2_settings.mail_source.type | MailSourceOauth2Type | OAuth2 service to use.Values: MAIL_SOURCE_OAUTH2_TYPE_NONE (0), MAIL_SOURCE_OAUTH2_TYPE_MICROSOFT_OAUTH2 (1), MAIL_SOURCE_OAUTH2_TYPE_GOOGLE_OAUTH2 (2). |
oauth2_settings.mail_source.status | MailSourceOauth2Status | Authentication status.Values: MAIL_SOURCE_OAUTH2_STATUS_NONE (0), MAIL_SOURCE_OAUTH2_STATUS_ERROR (1), MAIL_SOURCE_OAUTH2_STATUS_AUTHENTICATED (2), MAIL_SOURCE_OAUTH2_STATUS_EXPIRED (3). |
oauth2_settings.mail_source.user_info | string | Information about the authenticated user (account name etc.). |
oauth2_settings.mail_source.configuration | string | Configuration for authentication in JSON format as name-value pairs. Use names as defined in OAuth2 standard. |
oauth2_settings.mail_source.token_cache | bytes | Token cache. For Google OAuth2 this is in JSON format. For MSAL this is in its internal binary format. |
oauth2_settings.mail_source.proxy_address | string | Proxy address if used. |
oauth2_settings.mail_from_address | string | The address of the sender when sending notifications with OAuth2. |
oauth2_settings.authentication_timeout | uint32 | Maximum time in seconds to wait for the OAuth2 authentication to take place. |
oauth2_settings.mail_service_timeout | uint32 | Maximum time seconds to wait for the OAuth2 mail service request to be responded. |