Advanced Topics

Working with Salesforce Sites

5min

If you have ever worked with Salesforce Sites, you know that the Site Guest User has limited access. This is a deliberate measure on Salesforce's part to prevent external users from being able to modify or delete data in your Salesforce instance. Moreover, to comply with Salesforce's security review process, we need to add an additional layer of security.

In the example below, we will update a customer record in NetSuite using the Global API. The process is basically the same, no matter what you want to do. You need to create a ReadOnly permission set for the objects you want to read from, plus sharing rules for the same objects.

Here is a very basic example of an invocable apex class calling our Global API. It will create the record in NetSuite first and immediately sync it back to Salesforce.

We need to set the "fromSalesforceSites" to "true" so Breadwinner can treat this action as a site guest user and process it correctly.

Apex


By default, the Site Guest User will not have access to Breadwinner's custom objects, so you must create a custom ReadOnly permission set. The 'Breadwinner Read Only' permission set cannot be assigned to the Site Guest User because it has the 'View All' object permission enabled, which is not allowed for the Site Guest User, so you must create your own.

Read access to the "NetSuite Object" and "Subsidiary" is required for all actions, and in this case, because we are updating the customer, we need to give read access to the NetSuite Company object, too.

Enable 'Read' at the Object Permissions level and check Read Access for all the fields at the Fields Permissions level for all objects that need access.

Document image




Assign that permission set to the Site Guest User.

We also need to create Sharing Rules for each object. More can be found here about sharing rules.

The image below is an example of sharing rules for the NetSuite Object

  • Go to Setup and type "Sharing" in the Quick Find box
  • Click on 'Sharing Settings'
  • Choose the object from the "Manage sharing settings for" dropdown
  • Click "New" in the "Sharing Rules" section
  • Step 1: Rule Name - choose a label & Rule Name
  • Step 2: Select your rule type - click the "Guest user access, based on criteria" option
  • Step 3: Criteria - For the criteria, we need to open this up to all records, so set this to something that will always be true. In the example below, we chose
    • Field: Created By ID,
    • Operator: not equal to,
    • Value <empty>.
  • Step 4: Share with <your site guest user>
  • Step 5: Default Access - ReadOnly
Document image


Update NetSuite records via Site Guest User:

The 'skipDML' option here is important if you are doing an update because the Site Guest User only has the ability to Read or Create, not update.

Because the skipDML is set to true, the update back into Salesforce will not occur immediately. Instead, it will happen during the regular sync.

Apex