Auto-installation can be used with integration records that are configured to authenticate through user credentials, token-based authentication or OAuth 2.0.
Whether using The Three-Step TBA Authorization Flow, calling The IssueToken Endpoint, or using OAuth 2.0, an Integration record is automatically installed in your account. The Require Approval during Auto-Installation of Integration preference affects whether this record is automatically enabled. You can manage the preference at Setup > Integration > Integration Management > SOAP Web Services Preferences. If the box for the Require Approval during Auto-Installation of Integration preference is not checked (set to false) the State field on the application is automatically set to Enabled, and all requests are permitted. However, if the box is checked (set to true) the State field on the integration record is set to Waiting for Approval. In the latter case, you must manually edit the record and set the State to Enabled. Until you set the state to Enabled, all requests sent by that application are blocked
The configuration of the Require Approval during Auto-Installation of Integration preference determines whether automatically installed integration records are enabled at the time they are installed.
This preference can be configured in either of the following ways:
- False (default) – The State field on each newly installed record is automatically set to Enabled, and all requests are permitted.
- True – The State field is set to Waiting for Approval. In this case, all requests sent by that application are blocked until you edit the record and set the State field to Enabled.
In other words, if you as an administrator want to review and manually approve each newly installed integration, you should set this preference to true. By contrast, if you are confident that all newly installed applications should be granted access, set this preference to false.
You can manage this preference at Setup > Integration > Integration Management > SOAP Web Services Preferences.