Set Up mySparkrock Authentication for Sparkrock 365

OAuth is the industry-standard protocol for authorization, providing specific authorization flows for web applications and more. To establish the OAuth connection between Sparkrock 365 and mySparkrock, some setup is required.

Create the mySparkrock Application in Microsoft Entra Applications

On the Microsoft Entra Applications page, the mySparkrock application must be created.

Note

Note:
To complete all steps in this task, you must be an Microsoft Entra ID administrator.

To create the mySparkrock Application in Microsoft Entra Applications

1. Choose , enter microsoft entra applications, and then choose the related link.

   The Microsoft Entra Applications page opens.

2. On the action bar, choose Create mySparkrock Application.

   A new row appears for the mySparkrock application.

3. Ensure that the mySparkrock application record is selected, and then on the action bar, choose Manage > Edit.

   The Microsoft Entra Application Card page opens.

4. If required, update fields.

5. To grant consent for mySparkrock to access data from Sparkrock 365, on the action bar, choose Grant Consent.

   Log into Microsoft Entra ID, and then perform the required setup. For more information, see Using Service-to-Service (S2S) Authentication.

Create the mySparkrock User Card for the Internal User ID of MYSPARKROCK

To establish the connection between mySparkrock and Sparkrock 365, the following setup is required:

• A mySparkrock user named MYSPARKROCK must exist.

• For the MYSPARKROCK user, on the related mySparkrock User Card page, on the General FastTab, the Internal User ID must have a value of MYSPARKROCK.

To create a mySparkrock user named MYSPARKROCK

1. Choose , enter mysparkrock users, and then choose the related link.

   The mySparkrock Users page opens.

2. On the action bar, choose New.

   The mySparkrock User Card page opens.

3. In User Name, specify MYSPARKROCK.

4. To prevent this user from being selected as an alternate, turn on Blocked As Alternate.

5. In Internal User ID, specify MYSPARKROCK.

6. On the Companies FastTab, specify values for fields as required.

7. To complete the setup of the mySparkrock User Setup Card page, select the Edit mySparkrock User Setup link.

   The mySparkrock User Setup Card page opens.

8. In User Profile Code, specify a value.

9. To complete the setup of the mySparkrock User Setup Card page, choose Close.

Create a user setup record in Payroll Setup

For mySparkrock authentication to work correctly for payroll, on the Payroll Setup page, on the Payroll Users Setup FastTab, there must be a record with the User ID of MYSPARKROCK. Permissions can be assigned to the record with the User ID of MYSPARKROCK as required.

To create a record that has a User ID of MYSPARKROCK in Payroll Setup

1. Choose , enter payroll setup, and then choose the related link.

   The Payroll Setup page opens.

2. On the Payroll Users Setup FastTab, choose Manage > New Line.

   A new row appears.

3. In User ID, specify MYSPARKROCK.

4. In other fields on the line, specify values as required.

Verify the setup of notification job queue entries

To ensure that notifications work correctly, the following job queue entries must be set up on the Job Queue Entry Card page:

• Notification Entry Dispatcher : Prevents the following error message from appearing on the Job Queue Log Entries page when there are notifications:

  Required property is missing.

  Also, prevents mySparkrock users from receiving the following error message when requesting an approval:

  You don't have permission to run scheduled tasks.

• SRP Update Notif. User ID : Ensures that notifications, including notifications for mySparkrock, are sent from a business central user who has the required permissions to send notifications.

To verify the setup of notification job queue entries

1. Choose , enter job queue entries, and then choose the related link.

   The Job Queue Entries page opens.

2. Verify that a job queue entry exists with the following setup:

   • Object Type To Run is equal to Codeunit.

   • Object ID to Run is equal to 1509.

   • Object Caption to Run is equal to Notification Entry Dispatcher.

   • User ID is equal to MYSPARKROCK.

   • Recurring Job is turned on.

   • No. of Minutes between Runs is equal to 50000.

3. Verify that a job queue entry exists with the following setup:

   • Object Type To Run is equal to Codeunit.

   • Object ID to Run is equal to 23022111.

   • Object Caption to Run is equal to SRP Update Notif. User ID.

   • Recurring Job is turned on.

   For more information about job queues, see Use Job Queues to Schedule Tasks.

4. Verify that the user ID that is associated with the SRP Update Notif. User ID job queue entry has the following setup on the User Card page:

   • On the User Permission Sets FastTab, a row where Permission Set is equal to Super.

   • On the Licenses FastTab, a row where Name is equal to Dynamics 365 Business Central Essential.

   For more information about permission sets and licenses, see Create Users According to Licenses.

Verify that the User ID of the SRP Update Notif. User ID job queue entry has the required setup for shared mailboxes

If you are using shared mailboxes on the Email Accounts page, to ensure that the shared mailbox functionality works correctly, verify the setup of the User ID of the SRP Update Notif. User ID queue entry.

To verify that the User ID of the SRP Update Notif. User ID job queue entry has the required setup for shared mailboxes

1. Verify that the User ID that is associated with the SRP Update Notif. User ID job queue entry is licensed for Microsoft 365 or Office 365 with access to Microsoft Exchange Online.

2. Verify that the User ID that is associated with the SRP Update Notif. User ID job queue entry is a member of one or more of the configured shared mailboxes in the Microsoft 365 admin center.

   For more information about shared mailboxes, see Shared mailboxes.

See also

Set Up mySparkrock

Feedback

To send feedback about this page, select the following link:

feedback-product-docs@sparkrock.com