BIM 360
BIM 360 is a unified platform connecting your project teams and data in real-time, from design through construction, supporting informed decision-making and leading to more predictable and profitable outcomes.
The following sections explain prerequisites, resources, and instructions for integrating with SaaS Management.
Stored BIM 360 Information
The following table describes the available integration tasks and stored data within SaaS Management.
|
|
|
|
Application Roster
|
|
|
Application Access
|
|
Note:The information stored is subject to change as enhancements are made to the SaaS application.
Required Minimum Permissions for BIM 360
Administrator-level access and the BIM 360 OAuth Scope are required to connect your application to a specific BIM 360 Account. For more information, see BIM 360’s documentation topic, Get Access to a BIM 360 Account.
BIM 360 OAuth Scope
|
|
|
|
|
account:read
|
To read the list of users in your BIM 360 account. For more details, see Autodesk’s documentation topic, GET Users.
|
Application Roster
Application Access
|
BIM 360 Authentication Method
The required authentication method is OAuth 2.0 Client Credentials. For more information, see BIM 360’s documentation topic, Get a 2-Legged Token.
Required BIM 360 Credentials
The following credentials are required:
Integrating BIM 360 With SaaS Management
To integrate BIM 360 with SaaS Management, perform the following tasks for the US and EMEA regions.
Note:For additional BIM 360 information, see:
Creating an Application in Autodesk Forge
To create an application in Autodesk Forge, perform the following steps.
To create an application in Forge Portal:
|
2.
|
To register an application, go to the Profile menu on the top right of the page and click My Apps. |
|
3.
|
Click the CREATE APP button on the top-right of the My Apps page. The Create App page opens. |
|
4.
|
Select BIM 360 API for the APIs the application will access. |
|
5.
|
Enter the required fields to create an application: |
|
•
|
Callback URL: You can enter https://test.com. Three-legged flows specify a redirect_uri at runtime, which must match the pattern specified here to esnure the security of your app. The redirect_uri is the URL of your app that the Forge Platform sends the end user to after acquiring authorization for the app. |
Click CREATE APP.
|
6.
|
After you register your new application, you will see a Client ID and Client Secret, and Callback URL in the App Information section of your newly created application page. Save your Client ID and Client Secret to a file for future reference. You will need the Client ID for Getting Administrator Access to a BIM 360 Account. |
|
7.
|
There are two ways to connect your application to a specific BIM 360 account, depending on your account permissions. |
Getting Administrator Access to a BIM 360 Account
If you need administrator access to a BIM 360 account, perform the following steps.
To get adminstrator access to a BIM 360 account:
Note:You will need your Client ID to complete the following steps.
|
1.
|
Sign in to the appropriate Host Region portal. |
Note:Currently BIM 360 only supports the US and EMEA regions. For the APAC region, sign in to the appropriate portal where the account is hosted.
|
2.
|
On the Account Admin page: |
|
a.
|
Select the Settings tab. |
|
b.
|
Click the Custom Integrations tab. The Add Custom Integration dialog box appears. |
|
3.
|
In the Add Custom Integration dialog box: |
|
a.
|
Give your application access to BIM 360 Account Administrations. |
|
c.
|
Select I'm The Developer and click Next. |
|
d.
|
Copy and save the BIM 360 Account ID, and select the box beside it. |
Note:For further information on how to get the BIM 360 Account ID, see Getting the Account ID.
|
f.
|
Review your information and click Save. You will receive a Adding a Developer to a BIM 360 Account message stating that your application is connected to your BIM 360 account. |
Inviting Developers to a BIM 360 Account
To be invited to a BIM 360 account, the developer requesting account access performs the following steps.
To invite a developer to a BIM 360 account:
|
1.
|
Sign in to the appropriate Host Region portal and click the Custom Integrations tab. In the Add Custom Integration dialog box, give your application access to BIM 360 Account Administration. Then click Next. |
|
2.
|
Select Invite a Developer and enter your email address. An invitation email will be sent to you. |
|
3.
|
Click the link in the invitation email to sign in to your Autodesk account. |
|
4.
|
Enter and save your application’s Client ID, name, description, and logo. |
|
5.
|
Wait for your Account Administrator to approve your access to the requested BIM 360 account. |
Integrating BIM 360 With SaaS Management
To integrate BIM 360 with SaaS Management, add the BIM 360 application in SaaS Management. For more information, see Adding an Application.
BIM 360 API Endpoints
Application Roster and Application Access:
|
•
|
URI (US) https://developer.api.autodesk.com/hq/v1/accounts/:account_id/users |
|
•
|
URI (EMEA) https://developer.api.autodesk.com/hq/v1/regions/eu/accounts/:account_id/users |