1. User Guide
  2. Personal Settings
  3. Authorized Applications
  4. Authorizing Applications to Access SuiteProjects Pro on Your Behalf

Authorizing Applications to Access SuiteProjects Pro on Your Behalf

Integration applications let you connect SuiteProjects Pro with other applications and they extend what you can do with SuiteProjects Pro. Integration applications may use the OAuth 2.0 authorization protocol to gain access to your company's SuiteProjects Pro account.

The first time an application using the OAuth 2.0 protocol attempts to access SuiteProjects Pro on your behalf, you will need to give this application your explicit permission.

To authorize an application, you will typically use the following steps:

  1. The application opens a browser and directs you to the same trusted sign-in page you normally use to sign in to SuiteProjects Pro — the SuiteProjects Pro sign-in page or your company Single Sign-on form appears.

  2. Enter your sign-in details and click Log in.

    An authorization page will appear indicating that the application <application name> would like to access your SuiteProjects Pro data.

  3. Read the content of the authorization page attentively. It should describe what the application does and how it will help you. It should also say what the application can do, for example:

    • The application will be able to access all data you have access to.

    • The application will be able to perform all actions permitted by your role and user privileges.

    Important:

    For Administrators — Business rules configured for your company's SuiteProjects Pro account are applied when an integration application interacts with your SuiteProjects Pro data through the REST API. However, they are not applied when an integration application interacts with your SuiteProjects Pro data through the SOAP API or XML API — application developers must enforce business rules within their integration application if required. Business rules include SuiteProjects Pro account configuration settings and access control mechanisms, as well as any user scripts deployed on your company's SuiteProjects Pro account.

  4. Click ALLOW to authorize the application or click CANCEL if you do not want the application to access SuiteProjects Pro on your behalf.

Note:

The steps may vary depending on the method you use to sign in to SuiteProjects Pro:

  • If you normally enter your company ID, user ID and password on the SuiteProjects Pro sign-in page, or if you enter your company ID on the SuiteProjects Pro sign-in page and then your password on your company single sign-on page, the above steps apply.

  • If you normally need to enter all sign-in details on your company single sign-on page to access SuiteProjects Pro without going to the SuiteProjects Pro sign-in page first (Identity Provider initiated Single Sign-on), you must sign in and launch SuiteProjects Pro before the application attempts to access SuiteProjects Pro on your behalf. The authorization page appears automatically. Follow steps 3 and 4 above. You do not need to re-enter your sign-in details.

Integration applications are registered and managed by your account administrator. They need to be enabled on your account before they can attempt to connect to SuiteProjects Pro and request your permission.

Oauth2.0 user authorization dialog
Note:

Integration applications are registered and managed by your account administrator. They need to be enabled on your company's SuiteProjects Pro account before they can attempt to connect to SuiteProjects Pro and request your permission.

Account administrators can disable an application at any time.

  • If you have authorized an application and this application is disabled by an administrator, the application will no longer be able to interact with SuiteProjects Pro.

  • If an administrator enables this application again, you will need to give this application your explicit permission again before you can continue to work with it in connection with SuiteProjects Pro.

After you authorize an application, it will be able to interact with SuiteProjects Pro on your behalf until you revoke the authorization.

To view the application you have authorized, go to User Menu > Personal Settings > Authorized Applications. All your authorized applications are listed in a grid. Details include the name of the application and the date and time when it was last updated.

Note:

All times are given as Eastern Standard Time (EST).

To revoke an application, click REVOKE in the top right corner of the corresponding box, then click REVOKE in the confirmation message. The application no longer shows in the authorized applications list. If a revoked application attempts to access SuiteProjects Pro on your behalf, you will be prompted to give this application your explicit permission again.

User personal settings controlling authorized applications