Integrating MYOB Advanced with Microsoft Azure Active Directory

By integrating MYOB Advanced with Microsoft Azure Active Directory (Azure AD), you can provide single sign-on (SSO) and manage users and access in one place. This lets you create, delete, and manage user accounts by using Azure AD. During integration, you map Azure AD groups with user roles in MYOB Advanced to determine users’ access rights.

Do not use with MYOB Advanced Payroll versions earlier than 2023.1.1 On versions older than 2023.1.1, an issue prevents sites using Azure AD from completing pay runs. For more information, see MYOB Advanced Known Issues, reference CE00037056.

The help pages in this section explain all the steps involved in integrating MYOB Advanced with Azure AD.

Assign a role to a domain user

Configure Azure Active Directory

Enable Azure Active Directory in MYOB Advanced

Map Azure Active Directory groups to MYOB Advanced roles

How does it work?

User accounts of domain users in MYOB Advanced

After you have enabled integration with the identity management system, user accounts for domain users are created automatically when the users sign in to your MYOB Advanced instance for the first time.

The accounts of domain users in MYOB Advanced are based on their accounts in the domain. The password of a domain user in MYOB Advanced is the same as the domain account password. The email address and the first and last name of the user are populated from the domain account as well. However, the login, password, email address, and first and last name are managed through the domain and cannot be changed in MYOB Advanced.

You cannot restore the passwords of domain users by using MYOB Advanced tools. You should restore users’ domain credentials by using tools of Active Directory (AD).

To speed up authentication of users, the information about AD groups is automatically cached by MYOB Advanced. To update the list of the user groups in MYOB Advanced with current information from AD, click the Reload AD Groups button on the User Roles (201005) form. The Reload AD Groups button appears only when you integrated MYOB Advanced instance with Azure AD.

Domain user authentication

After the integration of MYOB Advanced with Azure AD has been set up, users use single sign-on (SSO) with the domain to sign in to MYOB Advanced. By default, each user performs the following steps:

On the Welcome page of your MYOB Advanced instance, the user selects the Azure AD icon () to open the Azure AD sign-in page.
On the sign-in page, the user enters the domain credentials in the following format: <User_Name>@<Domain_Name>, where <User_Name> is the user account name in the integrated domain and <Domain_Name> is the UPN suffix, also known as the domain name.

If you configured a multicompany instance and selected the Secure Tenant on Login option on the Tenant Setup page (see Managing Tenants Locally), then users with access to several companies, who sign in to MYOB Advanced using single sign-on with an external identity provider, will be logged in to the first company with enabled single sign-on.

Domain user authorisation

When a domain user tries to access MYOB Advanced, user authorisation occurs as follows:

The application instance sends an authentication request to the AD server to validate the user’s credentials.
When validation has completed successfully, the AD server sends MYOB Advanced the list of AD groups to which the user is assigned.
MYOB Advanced compares the list of AD groups with the internal MYOB Advanced roles, based on the mapping rules defined on the User Roles (SM201005) form.
The system finds any MYOB Advanced roles that are associated with AD groups to which the domain user account is assigned. If MYOB Advanced finds at least one role, the user is authenticated to sign in to the MYOB Advanced instance.
The user access rights within the MYOB Advanced application instance are based on the internal list of roles.

For more information about authentication in MYOB Advanced, see Managing User Access in the MYOB Advanced in-product help. For details about roles and access rights in MYOB Advanced, see Configuring User Roles in the MYOB Advanced in-product help.

To access the MYOB Advanced in-product help, go to any form and click the Open Help icon () in the top right.

Access rights of domain users

Domain users inherit access rights from the AD groups that you mapped to MYOB Advanced user roles. In addition, you can assign specific user roles to each domain user if the access rights for this user should differ from the AD group rights.

New domain users automatically get the rights to sign in to MYOB Advanced when they join a domain. The membership of these users in MYOB Advanced roles is then automatically updated to comply with the membership of the users in the domain groups.

The user type functionality cannot be applied to domain users.

Inherit licenses from existing users

Because AD authentication creates new user accounts, the licenses from the existing users need to be reallocated.

The AD user will automatically inherit licences when their Email Address (populated from Active Directory) matches the Login of the existing user. This means that if your existing users' logins match their AD email addresses, licencing within and between tenants will be automatically shared.

If your existing users have logins that do not match their email address, you will need to reallocate the licenses manually.

You can see how a user was created in the Source column when selecting a user on the Users form. Users created manually in MYOB Advanced are labelled Native.

Cannot be used alongside secure authentication

Secure authentication and Azure Active Directory are mutually exclusive. Only one can be enabled at a time.

If a user that has been associated with secure authentication wants to log in after enabling Azure AD, they will need to use the standard MYOB Advanced login and password.