In setting up OpenID Connect (OIDC) you will generate some data to send to Subsplash. Subsplash will set up part of the authentication and then send data back to you to complete setting up your Communication Transport.
​
If you have any trouble setting up this plugin beyond the scope of this documentation, please contact your Customer Success Manager (CSM) or Account Manager (AM) and we will work through it with you. If you are not yet using Subsplash, please visit https://subsplash.com to learn more and connect with us.
​

This is available in your Subsplash Dashboard (https://dashboard.subsplash.com). Your App Key will be displayed near the bottom of this page.
​

You will generate a Client Id and a Client Secret in Rock to send to Subsplash.
​

Shared via a secure document during the setup process.
​
Note: this Client Id and Client Secret are different from the ones you generate in Rock.

If you are a Subsplash Giving user and use our Rock Integration you may recall setting up a REST key in doing so, please note that the same REST key should not be used for the notification plugin.
​
In your Rock Dashboard, navigate to Admin Tools > Security:

Click on REST Keys:

Add a REST Key by clicking on the plus sign on the right:

Create a new REST Key with the Name "Subsplash Plugin", click Generate Key to set the key, then click Save:

Navigate back to Admin Tools > Security and click on REST Controllers:

Find the Subsplash Controller (Controller Type: com.subsplash.Rest.Controllers.SubsplashController) and click on the Security lock icon on the right end of the row and you will see a modal popup (Note: clicking on the name or type will take you to a different screen):

Add View and Edit permissions. With View selected, click Add User and find the Subsplash Plugin user created above:

With Edit selected, click Add User and find the Subsplash Plugin user. Check that they have Allow selected. Click Done to close the modal:

To start, navigate to Admin Tools > Security > OpenID Connect Clients. Your page should look like the following screenshot:

Click on the “+” button on the bottom right corner to add a new OpenID Connect Client, and follow the steps below to create a new OIDC client:

You can use the following screenshot as a reference to make sure you have everything, and when ready click “Save”:

Once completed, send the Subsplash App Key, Rock Client Id, and Client Secret via the secured document created by Subsplash. If you have not received this document, please contact your CSM. After you share that data, Subsplash will complete the setup on our side and share the remaining information needed via the secured document to complete Setting up your Communication Transport.

Rock, by default, has login screens set to the Stark theme under “External Website”. If you were to leave this setting where it is, then your mobile sign-in pages would look like the following screenshots.

If you like the look of these screens and would like to keep them as is, you can skip this part and set up your communication transport. If you would like to configure the login user experience that the user will see when authenticating with the Subsplash app, there are 2 different options:

To set up your communication transport, navigate to Admin Tools > Communication > Communication Transports

Click on the “Subsplash” communication transport, and a panel should pop up. Fill out the information we provided you, and make sure the “Active” dropdown is set to Yes. The following screenshot is an example of what it should look like once all settings are completed.

For your reference, you should have the following from us:

If anything is missing, please reach out to us again.
​
Once you have completed all settings, click “Save”.
​
Next, you need to activate push notifications. To do this, navigate to “Communication Mediums”. You can find the Communication Mediums page in Admin Tools > Communication > Communication Mediums
​
On the communication mediums page, click on “Push Notifications”. Then make sure “Active” is set to “Yes”, and select “Subsplash” as your “Transport Container”. The following screenshot shows what that looks like:

Version 1.1 of the Subsplash Plugin for RockRMS now allows for one-way sync of videos from your Subsplash Media library to RockRMS. Any media item uploaded and published in the Subsplash dashboard will automatically be synced into Rock and become available to embed as a Media Element. Subsplash does not currently support Libraries or Folders so all media will be imported into a “Media Items” folder.

In your Rock admin (v13 or newer), go to the toolbox menu, and select “CMS Configuration” in the menu. Then select Media Accounts and click the “+” button to add a new account that will be synced with Subsplash. Set the Account Type to “Subsplash Media Account” and then enter the following fields from the information you received from Subsplash:

By default, Rock’s “Sync Media” job will run every 2 hours and is configured to run a Full Sync every 24 hours and a quick sync otherwise. The quick sync will sync any media items that have been created or updated since the last time the job ran. This can be adjusted by updating the “Sync Media” job in the toolbox menu by navigating to System Settings → Job Administration → Sync Media.
​

There are a couple of different ways to embed media. Using Subsplash’s media embed within a Content Channel is simple and easy but will require fetching a CustomUrl from Subsplash Dashboard. To find/change the Custom URL, follow these instructions:

Using the default Rock short code, in a content channel is also possible by fetching the attribute’s raw value (guid) and passing it to the shortcode:

Analytics for the Rock embed will be captured in Rock and then synced to Subsplash automatically when the Sync Media job runs. This sync is one-way and will show up in the Subsplash Dashboard as a Web Embed view:

​