provider.coms

Provider File

oneOf	Email provider
	Communications ASP SMS provider

Email provider

type	object
properties
providerType	type	string
	enum	EMAIL
	default	EMAIL
authenticationConfiguration	The type of authentication to connect to the provider
	oneOf	OUTLOOK_OAUTH2
		PASSWORD
		NONE
isTemplateGeneratedByOspComposer	Name of the playbook that generated this file. If present, the file is managed by the Composer and may be overwritten on regeneration. Used for selective clean. Do not edit or set manually.
	type	string
moduleId	The ID of the linked communications module
	type	string
sendingProtocol	The configuration of the sending protocol
	oneOf	Outgoing Email protocol.
templateId	The id of the template to use for this file
	type	string
templateVariables	The variables and their values to be replaced from the template
	type	object
	additionalProperties
variablesFiles	The variables files to use to replace the variables. The first file of the list will take precedence over the following one. Template variables take precedence over the contents of the files.
	type	array
	items	type	string
additionalProperties	False

OUTLOOK_OAUTH2

type	object
properties
type	type	string
	enum	OUTLOOK_OAUTH2
	default	OUTLOOK_OAUTH2
authority	The authority refers to the Directory (tenant) ID login url. For example : https://login.microsoftonline.com/{Your Directory (tenant) ID}
	type	string
clientId	The Application (client) ID.
	type	string
passwordProvider	The password to connect to the SMTP Oauth2 provider.
	oneOf	PLAINTEXT
		SECRET
		ENCRYPTED
scope	The scopes are admin defined. If not asked to change, you should let the default one. Default value is [[”https://outlook.office365.com/.default”]]
	type	array
	default	https://outlook.office365.com/.default
	items	type	string
securityType	The type of security used on the connection with the mail server (use : CLEAR for OAUTH2) otherwise probably TLS. Default value is [“CLEAR”]
	type	string
	enum	TLS, SSL, CLEAR
	default	CLEAR
username	The username to connect to the SMTP Oauth2 provider.
	type	string
additionalProperties	False

PLAINTEXT

type	object
properties
type	type	string
	enum	PLAINTEXT
	default	PLAINTEXT
password	The password to use in plaintext. It can be for example thisIs@TestPassword123.
	type	string
additionalProperties	False

SECRET

type	object
properties
type	type	string
	enum	SECRET
	default	SECRET
secretPath	The path of the secret containing the password. This is a path to the secret containing the password.
	type	string
additionalProperties	False

ENCRYPTED

type	object
properties
type	type	string
	enum	ENCRYPTED
	default	ENCRYPTED
encryptedPassword	The password encrypted Base64(IV+AES256(password, input)) the password must be a shared secret available for the osp-configuration-dispatcher see documentation ↗️ see toolbox ↗️
	type	string
secretPath	The full path to the secret exposed by the orchestrator; this password is used to encrypt the encryptedPassword. see documentation ↗️ see toolbox ↗️
	type	string
additionalProperties	False

PASSWORD

type	object
properties
type	type	string
	enum	PASSWORD
	default	PASSWORD
passwordProvider	The password to connect to the SMTP provider.
	oneOf	PLAINTEXT
		SECRET
		ENCRYPTED
securityType	The type of security used on the connection with the mail server (use : CLEAR for OAUTH2) otherwise probably TLS. Default value is [“CLEAR”]
	type	string
	enum	TLS, SSL, CLEAR
	default	CLEAR
username	The username to connect to the SMTP provider.
	type	string
additionalProperties	False

NONE

type	object
properties
type	type	string
	enum	NONE
	default	NONE
securityType	The type of security used on the connection with the mail server (use : CLEAR for OAUTH2) otherwise probably TLS. Default value is [“CLEAR”]
	type	string
	enum	TLS, SSL, CLEAR
	default	CLEAR
additionalProperties	False

Outgoing Email protocol.

type	object
properties
type	type	string
	enum	SMTP
	default	SMTP
connectionRetry	The timeout for connection retry. Default value is [{“unit”:”SECONDS”,”value”:10}]
	default	unit	SECONDS
		value	10
	DurationConfigurationEntity
port	The port to which the provider will be connected to.
	type	integer
smtpHostServer	The host address where the provider will be connected to.
	type	string
additionalProperties	False

DurationConfigurationEntity

type	object
properties
unit	The unit of time expressed
	type	string
	enum	NANOSECONDS, MICROSECONDS, MILLISECONDS, SECONDS, MINUTES, HOURS, DAYS
value	The amount of time expressed with the unit
	type	integer
additionalProperties	False

Communications ASP SMS provider

type	object
properties
providerType	type	string
	enum	ASPSMS
	default	ASPSMS
connectTimeout	The connection timeout to connect to the ASP SMS API Default value is [{“unit”:”SECONDS”,”value”:10}]
	default	unit	SECONDS
		value	10
	DurationConfigurationEntity
flashingSMS	The message appears directly on the screen of the mobile phone. A flashing message isn’t saved directly on the mobile phone. The recipient has to choose to save it. Otherwise the message irrevocably disappears from the screen. Default value is [false]
	type	boolean
	default	False
forceGSM7Bit	Force sending GSM7bit characters only to avoid extra cost by accidentally using Unicode Characters. Default value is [true]
	type	boolean
	default	True
isTemplateGeneratedByOspComposer	Name of the playbook that generated this file. If present, the file is managed by the Composer and may be overwritten on regeneration. Used for selective clean. Do not edit or set manually.
	type	string
moduleId	The ID of the linked communications module
	type	string
passwordProvider	The password for access to the ASP SMS API.
	oneOf	PLAINTEXT
		SECRET
		ENCRYPTED
readTimeout	The read timeout (time to answer from the ASP SMS API) Default value is [{“unit”:”SECONDS”,”value”:10}]
	default	unit	SECONDS
		value	10
	DurationConfigurationEntity
templateId	The id of the template to use for this file
	type	string
templateVariables	The variables and their values to be replaced from the template
	type	object
	additionalProperties
username	The username for access to the ASP SMS API.
	type	string
variablesFiles	The variables files to use to replace the variables. The first file of the list will take precedence over the following one. Template variables take precedence over the contents of the files.
	type	array
	items	type	string
additionalProperties	False