Specifies the duration, in minutes, for which a Salesforce login session is reused before expiring.

Data Type

string

Default Value

"10"

Remarks

The provider creates a login session with Salesforce using the supplied authentication credentials. This session is reused for subsequent queries to avoid repeated authentication requests.

The SessionTimeout property controls how long this login session remains active. Setting SessionTimeout to 0 disables session reuse entirely, forcing the provider to authenticate on every request. This can be useful in scenarios requiring stricter security or when dealing with short-lived credential policies.

This property only applies to Basic Authentication and SSO connections. It is not used for OAuth-based authentication, as OAuth handles session expiration and token refresh differently.

Performance Considerations

Reusing sessions reduces the number of authentication calls to Salesforce, improving performance and reducing API overhead. However, setting a longer session timeout could potentially conflict with Salesforce’s own session policies if they are configured for shorter timeouts. Setting the timeout to 0 can increase authentication overhead but may be appropriate for applications requiring the most secure or up-to-date credential usage.

This property is useful for balancing performance optimization with security requirements in environments that rely on Basic Authentication or SSO.