Security Roles

The Dynamics 365 App takes the access of each user from the Dynamics 365 security roles of that user. The Fours for Dynamics 365 solution adds eight security roles. Six roles are for people. Two roles are for the Fours application user, the Dynamics 365 user that Fours connects as.


Overview

The app reads the roles of the user who opens the pane or a dialog. A role counts when you assign it to the user directly or through a team. The app applies these roles inside Dynamics 365, on every request to Fours. A user without a Fours role cannot use the app, unless the user is a Dynamics 365 System Administrator. A System Administrator has the access of Fours Admin without a Fours role.

The roles for people are of three kinds:

  • A level role sets what the user can do: Fours Read Only, Fours User or Fours Admin.
  • Fours Approver lets the user approve offers.
  • A cloud role limits the user to some clouds: Fours AWS or Fours Microsoft.

Level roles

RoleAssign toWhat it allows
No Fours roleUsers who do not work with Fours, and who are not System AdministratorsNothing. The pane shows “You don’t have access to Fours”.
Fours Read OnlyUsers who only look at Fours dataSee the co-sells, offers, offer sets and agreements of an opportunity, on AWS and on Microsoft Azure. Open their details pages and co-sell records. Download the EULA, the offer PDF, the invoice and the agreement PDF. On an AWS co-sell record, open the AWS insights and ask their questions. Nothing that changes them.
Fours UserEveryone who works with offers and co-sellsEverything that Fours Read Only allows. Also create AWS and Azure offers, save drafts, and use the actions on offers. On an AWS agreement, opt out of auto-renewal and adjust the renewal uplift. On an Azure agreement, use Change seats, and Approve for a subscription that waits to start. Share co-sells with AWS and Microsoft, and change them on the co-sell record. On a Microsoft co-sell, this includes Accept, Decline, Next Stage, Won, Lost, Close as error, Invite Partner and Register Deal.
Fours AdminThe people who manage the Fours configuration of your organizationEverything that Fours User allows, plus the admin-only actions. A Fours Admin can save and delete the discount rules of your organization. On an AWS agreement, a Fours Admin can also request the cancellation, withdraw a pending request, and make a billing adjustment. On an Azure agreement, a Fours Admin can use Cancel subscription.

Approver role

RoleAssign toWhat it allows
Fours ApproverThe people who approve offers, when offer approval is onApprove, request a change to, or decline a submitted offer. See the Approvals tab. When offer approval is on, only a Fours Approver can create offers and offer sets.

Cloud roles

RoleWhat it does
Fours AWSLimits the level of the user to AWS.
Fours MicrosoftLimits the level of the user to Microsoft Azure.

A user with no cloud role works with every cloud, and so does a System Administrator. Any other user with a cloud role sees and changes only the records of that cloud. For example, a user with Fours User and Fours AWS creates AWS offers, and does not see the Azure offers of the opportunity. To give a user two clouds, assign both cloud roles.

Roles for the Fours application user

RoleAssign toWhat it allows
Fours IntegrationThe Fours application user onlyRead the data that Fours reads: opportunities, accounts, contacts, users, teams, business units, currencies and the table definitions. Write the Fours Configuration row when an admin connects Dynamics 365 in the Fours Console.
Fours Integration WriteThe Fours application user, only if Insulin writes to Dynamics 365Create, update and link opportunities, accounts, contacts, activities and notes. Read only the activities, notes and system jobs that the application user owns.

Do not assign these two roles to people. For the setup of the application user, see Install the Dynamics 365 App.


How the roles combine

  • A user gets the highest level of all the level roles that the user has. For example, a user with Fours Read Only and Fours User has the access of Fours User.
  • Fours Approver works beside Fours User or Fours Admin. A user with only Fours Approver also gets the access of Fours User.
  • Fours Admin does not make a user an approver. A Fours Admin who approves offers also needs Fours Approver.
  • A cloud role works beside a level role. A user with only a cloud role cannot use the app.
  • A cloud role also limits a Fours Admin who is not a System Administrator.
  • The Dynamics 365 System Administrator role gives the access of Fours Admin, with or without a Fours role. A cloud role never limits a System Administrator, who works with every cloud, even with a cloud role. A System Administrator who approves offers also needs Fours Approver. The diagram below shows how the app decides the access of a user.
  • Your organization can hold co-sell referrals for approval in Fours. Then a new co-sell that a Fours User shares waits for approval. A co-sell that a Fours Admin shares or resubmits does not wait.

Access to the opportunity

The app also checks the opportunity in Dynamics 365, whatever the Fours roles of the user. A user sees and acts on the co-sells, offers, offer sets and agreements of an opportunity only if the user can read that opportunity in Dynamics 365. A record that is not linked to an opportunity belongs to your organization, and the Fours roles alone decide who can use it. There is one exception. Request cancellation, Cancel subscription, Change seats and Approve work only on an agreement that is linked to an opportunity that the user can read.

Lists leave out the records of opportunities that the user cannot read. For example, the Approvals tab and the agreement search of New offer > Amendment show only the records of opportunities that the user can read, or of no opportunity.


Assign a role to a user

Do these steps as a System Administrator. Repeat them for each user.

Do not clear the Sales roles of the user. The Fours roles grant no Dynamics 365 privileges, so the user still needs the Sales roles.

  1. Go to the Power Platform admin center.
  2. Select your environment, and then select Settings.
  3. Select Users + permissions > Users.
  4. Select the user, and then select Manage security roles.
  5. Select one level role for the user.
  6. To limit the user to some clouds, also select Fours AWS, Fours Microsoft, or both.
  7. Select Save.

To give a role to many users at one time, assign it to a Dynamics 365 team. In step 3, select Users + permissions > Teams instead, and then select the team. The app counts the roles that a user gets through a team.


Make sure that the role works

Ask the user to reload the opportunity page. Then ask the user to select Fours on the command bar. The pane shows what the role allows:

  • A user with no Fours role, who is not a System Administrator, sees “You don’t have access to Fours”. The pane then asks the user to get the Fours Read Only or Fours User role from an administrator.
  • A user with Fours Read Only sees “View only” at the top of the pane. The pane shows the tabs of the opportunity, with no Co-sell and New offer menus. The cards have no Continue editing, Amend, Sync now, Resubmit, Share, Share again with AWS or Share again with Microsoft buttons. Copy offer URL and the card titles still work. The menu of each card keeps only Export PDF. A co-sell record shows no buttons that change the co-sell.
  • A user with Fours User sees the tabs of the opportunity, and can create offers and save drafts.
  • A user with a level role and Fours AWS, who is not a System Administrator, sees only the AWS co-sells, offers and agreements of the opportunity.
  • A Fours User who tries to save a discount rule sees “Saving or deleting rules needs the Fours Admin security role in Dynamics.”
  • When offer approval is on, a Fours Approver sees the Approvals tab on every opportunity.

If a user does something that the roles do not allow, the app refuses it. The message includes “Fours request rejected:” and one of these reasons:

The user hasThe message contains
Fours Read Only, and tries to change a record“your Fours Read Only security role in Dynamics can only view”
Fours User, and tries an action for a Fours Admin only“only users with the Fours Admin security role in Dynamics can do this”
A cloud role, and opens a record of another cloud“which your Fours security roles in Dynamics do not include”
A cloud role, and Fours cannot tell which cloud the request is for“Fours could not tell which cloud this is for”
No read access to the opportunity of an offer, an offer set or an agreement“this is linked to an opportunity you don’t have access to in Dynamics”
Any role, and uses Request cancellation, Cancel subscription, Change seats or Approve on an agreement that is not linked to an opportunity that the user can read“the agreement is not linked to an opportunity you can read”

For the setup steps around the roles, see Install the Dynamics 365 App. For offer approval, see Offer Approval.

Spotted something wrong or out of date on this page? Tell us and we'll correct it.