Skip to main content

service_authentication_policies

Creates, updates, deletes, gets or lists a service_authentication_policies resource.

Overview​

Nameservice_authentication_policies
TypeResource
Idovh.email_exchange.service_authentication_policies

Fields​

The following fields are returned by SELECT queries:

successful operation

NameDatatypeDescription
idintegerAuthentication policy id
block_legacy_auth_active_syncbooleanBlock legacy authentication on ActiveSync (wire: blockLegacyAuthActiveSync)
block_legacy_auth_autodiscoverbooleanBlock legacy authentication on Autodiscover (wire: blockLegacyAuthAutodiscover)
block_legacy_auth_imapbooleanBlock legacy authentication on Imap (wire: blockLegacyAuthImap)
block_legacy_auth_mapibooleanBlock legacy authentication on Mapi (wire: blockLegacyAuthMapi)
block_legacy_auth_offline_address_bookbooleanBlock legacy authentication on Offline Address Book (wire: blockLegacyAuthOfflineAddressBook)
block_legacy_auth_popbooleanBlock legacy authentication on Pop (wire: blockLegacyAuthPop)
block_legacy_auth_web_servicesbooleanBlock legacy authentication on Web Services (wire: blockLegacyAuthWebServices)
block_modern_auth_active_syncbooleanBlock modern authentication on ActiveSync (wire: blockModernAuthActiveSync)
block_modern_auth_autodiscoverbooleanBlock modern authentication on Autodiscover (wire: blockModernAuthAutodiscover)
block_modern_auth_imapbooleanBlock modern authentication on Imap (wire: blockModernAuthImap)
block_modern_auth_mapibooleanBlock modern authentication on Mapi (wire: blockModernAuthMapi)
block_modern_auth_offline_address_bookbooleanBlock modern authentication on Offline Address Book (wire: blockModernAuthOfflineAddressBook)
block_modern_auth_popbooleanBlock modern authentication on Pop (wire: blockModernAuthPop)
block_modern_auth_web_servicesbooleanBlock modern authentication on Web Services (wire: blockModernAuthWebServices)

Methods​

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
getselectexchange_service, id, organization_nameGet an authentication policy. Returns, for each protocol, whether legacy and modern authentication are blocked: ActiveSync, Autodiscover, IMAP, MAPI, offline address book, POP and web services.
listselectexchange_service, organization_nameblock_legacy_auth_active_sync, block_legacy_auth_autodiscover, block_legacy_auth_imap, block_legacy_auth_mapi, block_legacy_auth_offline_address_book, block_legacy_auth_pop, block_legacy_auth_web_services, block_modern_auth_active_sync, block_modern_auth_autodiscover, block_modern_auth_imap, block_modern_auth_mapi, block_modern_auth_offline_address_book, block_modern_auth_pop, block_modern_auth_web_services, x_pagination_modeList authentication policies. Returns the IDs of the authentication policies. Filter them by the legacy or modern authentication blocked on a protocol, such as blockLegacyAuthImap.

Parameters​

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
api_hoststringThe OVHcloud API host. Selected by OVH_ENDPOINT (ovh-eu, ovh-ca or ovh-us; default ovh-eu). (default: api.eu.ovhcloud.com, x-stackQL-envVarSelector: {"envVar":"OVH_ENDPOINT","default":"ovh-eu","values":{"ovh-eu":"api.eu.ovhcloud.com","ovh-ca":"api.ca.ovhcloud.com","ovh-us":"api.us.ovhcloud.com"}})
exchange_servicestringThe internal name of your exchange service (wire: exchangeService)
idintegerAuthentication policy id
organization_namestringThe internal name of your exchange organization (wire: organizationName)
block_legacy_auth_active_syncbooleanFilter the value of blockLegacyAuthActiveSync property (=) (wire: blockLegacyAuthActiveSync)
block_legacy_auth_autodiscoverbooleanFilter the value of blockLegacyAuthAutodiscover property (=) (wire: blockLegacyAuthAutodiscover)
block_legacy_auth_imapbooleanFilter the value of blockLegacyAuthImap property (=) (wire: blockLegacyAuthImap)
block_legacy_auth_mapibooleanFilter the value of blockLegacyAuthMapi property (=) (wire: blockLegacyAuthMapi)
block_legacy_auth_offline_address_bookbooleanFilter the value of blockLegacyAuthOfflineAddressBook property (=) (wire: blockLegacyAuthOfflineAddressBook)
block_legacy_auth_popbooleanFilter the value of blockLegacyAuthPop property (=) (wire: blockLegacyAuthPop)
block_legacy_auth_web_servicesbooleanFilter the value of blockLegacyAuthWebServices property (=) (wire: blockLegacyAuthWebServices)
block_modern_auth_active_syncbooleanFilter the value of blockModernAuthActiveSync property (=) (wire: blockModernAuthActiveSync)
block_modern_auth_autodiscoverbooleanFilter the value of blockModernAuthAutodiscover property (=) (wire: blockModernAuthAutodiscover)
block_modern_auth_imapbooleanFilter the value of blockModernAuthImap property (=) (wire: blockModernAuthImap)
block_modern_auth_mapibooleanFilter the value of blockModernAuthMapi property (=) (wire: blockModernAuthMapi)
block_modern_auth_offline_address_bookbooleanFilter the value of blockModernAuthOfflineAddressBook property (=) (wire: blockModernAuthOfflineAddressBook)
block_modern_auth_popbooleanFilter the value of blockModernAuthPop property (=) (wire: blockModernAuthPop)
block_modern_auth_web_servicesbooleanFilter the value of blockModernAuthWebServices property (=) (wire: blockModernAuthWebServices)
x_pagination_modestringSent as CachedObjectList-Pages by default so the list returns the full objects rather than their identifiers. (wire: X-Pagination-Mode)

SELECT examples​

Get an authentication policy. Returns, for each protocol, whether legacy and modern authentication are blocked: ActiveSync, Autodiscover, IMAP, MAPI, offline address book, POP and web services.

SELECT
id,
block_legacy_auth_active_sync,
block_legacy_auth_autodiscover,
block_legacy_auth_imap,
block_legacy_auth_mapi,
block_legacy_auth_offline_address_book,
block_legacy_auth_pop,
block_legacy_auth_web_services,
block_modern_auth_active_sync,
block_modern_auth_autodiscover,
block_modern_auth_imap,
block_modern_auth_mapi,
block_modern_auth_offline_address_book,
block_modern_auth_pop,
block_modern_auth_web_services
FROM ovh.email_exchange.service_authentication_policies
WHERE exchange_service = '{{ exchange_service }}' -- required
AND id = '{{ id }}' -- required
AND organization_name = '{{ organization_name }}' -- required
;